artexget 命令

在线编辑

用途

artexget 命令列示所指定概要文件或系统的配置和调整参数信息。

语法

artexget [-v] [-d] [-p | -r | -n] [-l {dynamic | 破坏性 | reboot}] [-f {txt |csv | xml}] [-m comment] [-V V] [-g categories] [-g level] profile

artexget [-q] [-d] [-p | -r | -n] [-l {dynamic | 破坏性 | reboot}] [-f {txt |csv | xml}] [-m comment] [-V V] [-g categories] [-g level] profile

描述

artexget 命令列示概要文件或系统的配置和调整参数信息。 如果未指定 -p、-r 或 -n 选项中的任何一项，那么该命令会输出参数 profile 中的参数/值对。 如果指定 -r 选项，那么该命令会输出系统的当前参数值。 如果指定 -n 选项，那么该命令会在下一次系统重新启动后输出参数值。 如果指定 -p 选项，那么该命令会在下一次系统重新启动后根据概要文件中的 applyType 属性值输出当前参数值或参数值。

此命令还可根据选择标准列示部分参数。 如果未指定选择标准，那么该命令会输出概要文件中列示的所有参数的列表。 如果指定了 dynamic 选择标准 (-l dynamic)，那么此命令将输出不要求执行重新引导或破坏性操作即可使更改生效的参数的列表。 破坏性操作可以是停止并接着重新启动服务或者取消挂装并接着挂装文件系统。 如果指定了破坏性选择条件 (-l disruptive) ，那么该命令将输出需要破坏性操作才能使更改生效的参数列表。 如果指定了 reboot 选择标准 (-l reboot)，那么此命令将输出要求执行重新引导才能使更改生效的参数的列表。

此命令会采用三种不同的格式将输出显示到 stdout。 可以使用重定向器 (>) 将此输出保存到文件中。 如果未指定任何输出格式，那么输出将以 XML 格式显示。 如果指定“逗号分隔的值”(CSV) 格式 (-f csv)，那么输出将以 CSV 格式显示，该格式可在电子表格中打开。 如果指定了文本格式 (-f txt)，那么输出将以表格格式显示。

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

指定的概要文件可以在使用相对路径或绝对路径的情况下存在于本地文件系统中，也可以存在于轻量级目录访问协议 (LDAP) 服务器上。

标志

项 描述
-d 创建一个概要文件，当与 artexset 命令的 -d 标志一起使用时，该概要文件将参数的所有实例设置为相同的值。 如果不使用 -d标志，那么输出概要文件仅包含所有实例将共享相同值的那些参数，并从该概要文件中除去其他参数。
-f 指定输出格式。 -f 标志具有以下变量：
  • txt 变量指定纯文本格式。
  • csv 变量指定逗号分隔的值格式。
  • xml 格式指定 XML 格式。 此为缺省格式。
-g 类别 显示类别的指定列表（以逗号分隔）的调试消息。 当编写新的目录文件时，此选项很有用。 可用的类别如下：
  • ALL：包括所有下列类别。
  • COMMANDS: 显示有关正在运行的 AIX® 命令的信息。
  • DISCOVERY：显示有关正在运行的 discovery 命令的信息。
  • THREADS：显示有关正在框架内运行的线程的信息。
  • PARSING：显示有关对概要文件和目录文件的解析的信息。
  • FLOW：显示有关操作的进度的信息。
注: 缺省类别为 ALL。
-g 级别 指定调试跟踪的详细程度，以 0（无调试跟踪）到 3（最详细级别）这一范围中整数的形式表示。 缺省级别是 0。
-l {dynamic | 破坏性 | reboot} 指定要在输出中列示的可调值。 -l 标志具有以下选项：
  • dynamic 变量指示列示没有任何条件即可使更改立即生效的可调参数。
  • disruptive 变量指示列示要求执行破坏性操作（例如中断服务或者重新启动资源）才能使更改生效的可调参数。
  • reboot 变量指示列示要求重新引导系统才能使更改生效的可调参数。
命令 评论 允许用户对概要文件添加注释。 如果使用了 -m 标志，那么指定的注释将覆盖先前注释。 这是一个可选标志。
-n 列示下一次系统重新启动后参数的值。 如果未指定 -p、-r 或 -n 选项，那么将列示概要文件描述的可调值。
-p 根据概要文件中的 applyType 属性值，列示参数的当前值或系统下一次重新启动后的参数值。
-q 允许用户忽略不致命的警告消息。 所忽略的消息不会显示在屏幕上。 这是一个可选标志。
注: 此标志不能与-v 标志一起使用。
-r 列示正在运行的系统上的当前值。
-v 显示在处理 artexget 命令期间运行的 AIX 命令生成的警告和错误消息。 这些消息将显示在 stderr 上。 这是一个可选标志。
注: 此标志不能与 -q 标志一起使用。
-v Version 设置所生成的概要文件的用户修订版号。 缺省情况下，条目概要文件的用户修订版号将递增。 如果使用了标志 -V，那么指定的用户修订版号将覆盖概要文件版本号中的现有修订版号。

参数

项 描述
profile 这是必需文件。 指定的文件包含可调参数的列表。 可为标准输入指定 -（短划线）的概要文件名称。

退出状态

项 描述
0 该命令已成功完成。
>0 发生错误。

安全性

访问控制：此命令仅应对 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/artexget.default
X /usr/lib/security/artexget.sys

审计事件：

事件 信息
USER_Create 用户

示例

以下示例说明如何输出存储在 LDAP 服务器上的 profile1.xml 概要文件中的参数和值对。

artexget ldap://profile1.xml

以下示例说明如何在下一次系统重新启动后使用 local_profile.xml 概要文件输出系统的参数值。

artexget -n local_profile.xml

以下示例说明如何使用 local_profile.xml 概要文件以文本格式输出系统的当前参数值。

artexget -r -f txt local_profile.xml