artexdiff 命令

用途

artexdiff 命令将比较两个概要文件之间的参数以及值,或概要文件和系统之间的参数以及值。

语法

artexdiff [-a] [-q|-v] [-r|-n] [-u|-c] [-f {csv|xml}] [-g category] [-g 级别] profileA

artexdiff [-a] [-q|-v] [-r|-n] [-u|-c] [[-d|-s] -f txt ] [-g category] [-g 级别] profileA

artexdiff [-a] [-q|-v] [-r|-n] [-p [-V version] [-m comment]] [-g category] [-g 级别] profileA

artexdiff [-a] [-q|-v] [-u|-c] [-f {csv|xml}] [-g category] [-g 级别] profileA 概要文件

artexdiff [-a] [-q|-v] [-u|-c] [[-d|-s] -f txt] [-g category] [-g 级别] profileA 概要文件

描述

artexdiff 命令用于比较概要文件之间的参数以及值,或概要文件和系统之间的参数以及值。

如果是在概要文件和系统之间进行比较,那么将比较正在运行的系统的当前参数值。 如果检索不到当前值,那么它将比较 nextboot 值。 如果指定 –n 选项,那么将比较系统的 nextboot 值以及概要文件中指定的参数。 如果指定了 -r 选项,那么将检索当前值。

此命令会采用三种不同的格式将输出显示到 stdout。 可以使用重定向器 (>) 将此输出保存到文件中。 如果未指定任何输出格式,那么它将以 XML 格式显示。 如果指定“逗号分隔的值”(CSV) 格式 (-f csv),那么输出将以 CSV 格式显示,该格式可在电子表格中打开。 如果指定文本格式 (-f txt),那么输出将以表格格式显示。 指定文本格式时,输出格式可为 diff 命令输出格式(-d 选项)或 sdiff 命令输出格式(-s 选项)。 因此,-s-d 标志只能与 -f txt 标志结合使用。 如果指定 –p 选项,那么此命令将以概要文件格式生成 XML 输出,该输出所包含的概要文件参数和值不同于系统参数和值。 通过调用 artexset 命令,使用概要文件格式的 XML 输出来设置系统。 这将确保系统与输入概要文件兼容。 如果指定 –p 选项,那么输出始终为概要文件格式的 XML。

如果指定了 -p 选项,那么可以对输出概要文件添加注释和版本号。 如果指定了带有注释的 –m 选项,那么注释将包括在输出概要文件中。 如果指定了带有用户修订版号的 –V 选项,那么将更新输出概要文件的版本号,并且修订版号将更改为用户指定的修订版号。 否则,输出概要文件版本的修订版号将设置为 0。

-u-c 标志指定的选择标准指示如何列示比较结果。 如果未指定任何选择标准,那么会显示所有比较结果。 如果指定 –c 选项,那么仅会显示比较中不同的参数。 如果指定 –u 选项,那么仅会显示具有相同值的参数。

指定的概要文件可以在使用相对路径或绝对路径的情况下存在于本地文件系统中,也可以存在于 LDAP 服务器上。

artexget -d 命令将创建一个概要文件,该概要文件具有属于同一设备、但是不属于特定实例的压缩属性。 artexdiff 命令可以通过在系统上搜索要比较的设备来将此概要文件与系统进行比较。 如果概要文件不具备 setDiscover 属性,那么该概要文件仍然可以执行与系统比较的设备发现。 artexdiff 命令具有下列限制:
  • 如果将压缩概要文件与除了系统之外的另一个概要文件进行比较,那么即使 setDiscover 参数设置为 true,也不会发现设备。 在这种情况下,将按原样比较每个概要文件的内容,并且不会执行发现操作。
  • 此外,如果在概要文件中填充了某些实例和类,那么这些实例和类会导致解析器错误,因为新的概要文件不是有效概要文件。

标志

描述
指示 artexdiff 输出将记录在 AIX® 审计日志中。
-c 指定此项以仅输出通过比较所找到的不同值。 如果未指定 -u-c,那么将在输出中记录所有参数值。
-d 指定此项以将比较结果输出至类似 diff 命令的格式。
-f 指定输出格式。 可能的格式包括:
  • txt 选项指示使用纯文本格式。 仅当设置了此 -f 标志时才能使用标志 –d–s
  • csv 选项指示使用逗号分隔的值格式。
  • xml 选项指示使用 XML 格式。 此为缺省格式。
-g 类别 显示类别的指定列表(以逗号分隔)的调试消息。 当编写新的目录文件时,此选项很有用。 可用的类别如下:
  • ALL:包括所有下列类别。
  • 命令: 打印有关正在运行的 AIX 命令的信息。
  • DISCOVERY:显示有关正在运行的 discovery 命令的信息。
  • THREADS:显示有关正在框架内运行的线程的信息。
  • PARSING:显示有关对概要文件和目录文件的解析的信息。
  • FLOW:显示有关操作的进度的信息。
注: 缺省类别为 ALL。
-g 级别 指定调试跟踪的详细程度,以 0(无调试跟踪)到 3(最详细级别)这一范围中整数的形式表示。 缺省级别是 0。
命令 评论 允许用户对概要文件添加注释。 如果使用了 -m 标志,那么指定的注释将被添加到所生成的概要文件中。
注意:该可选标记只能与 -p标记一起使用。
-n 指定此项以使用系统的 nextboot 值进行比较。 此选项仅在比较包含系统时才有效。
-p 以概要文件格式生成 XML 输出,该输出所包含的概要文件参数和值不同于系统参数和值。 仅当在概要文件和系统之间进行比较时此选项才有效。
-q 允许用户忽略不致命的警告消息。 所忽略的消息不会显示在屏幕上。 这是一个可选标志。
注意:该标记不能与 -v标记一起使用。
-r 指定此项以使用系统的当前值进行比较。 此选项仅在比较包含系统时才有效。
-s 指定此项以将比较结果输出至类似 sdiff 命令的格式。
-U 指定此项以仅输出通过比较所找到的相同值。 如果未指定 -u-c,那么将在输出中记录所有参数值。
-v 显示在处理 artexdiff 命令期间运行的 AIX 命令生成的警告和错误消息。 这些消息将显示在 stderr 上。 这是一个可选标志。
注: 此标志不能与 -q 标志一起使用。
-V V 设置所生成的概要文件的用户修订版号。 缺省情况下,生成的概要文件的修订版号设置为 0。 这是一个可选标志。
注意:该标记只能与 -p标记一起使用。

参数

描述
profileA 指定概要文件的文件名,该概要文件列示收集所有其他信息以进行比较所根据的可调值。 可为标准输入指定 -(短划线)的概要文件名称。
profile 指定概要文件的文件名以与 profileA 参数记录的概要文件进行比较。 如果未对 profile 参数指定任何概要文件,那么将针对 profileA 和系统执行比较。 可为标准输入指定 -(短划线)的概要文件名称。

退出状态

描述
0 命令成功完成且未找到差异。
第 1 年 找到不同处。
>1 发生错误。

安全性

访问控制:此命令仅应对 root 用户和安全组的成员授予执行 (x) 访问权。 该命令应该作为一个程序安装在“可信计算库”(TCB)上。 带有 setuid (SUID) 位设置的 root 用户应该拥有此命令。

RBAC 用户和 Trusted AIX 用户注意:该命令可执行特权操作。 只有特权用户才能执行特权限定的操作。 有关权限与特权的更多信息,请参阅安全性中的“特权限定的命令数据库”。 有关与该命令相关联的特权和权限的列表,请参阅 lssecattr 命令或 getcmdattr 子命令。 要获取命令的全部功能,除 accessauths 以外,角色还应具有以下权限:
  • aix.security.user.audit
  • aix.security.role.assign
  • aix.security.group.change
  • aix.security.user.change

访问的文件:

方式 文件
rw /etc/passwd
rw /etc/security/user
rw /etc/security/user.roles
rw /etc/security/limits
rw /etc/security/environ
rw /etc/group
rw /etc/security/group
R /usr/lib/security/artexdiff.default
X /usr/lib/security/artexdiff.sys

审计事件:

事件 信息
USER_Create 用户

示例

以下示例说明如何比较两个概要文件之间的参数以及值。

artexdiff profile1.xml profile2.xml

以下示例说明如何比较存储在 LDAP 服务器上的 ldap_profile.xml 概要文件和系统之间的参数以及值。

artexdiff ldap://ldap_profile.xml

以下示例说明如何使用输入概要文件参数和值(不同于系统参数和值)来创建新的概要文件。

artexdiff -p profile.xml > diff_profile.xml