lsrsrc 命令

用途

显示资源或资源类的属性和值。

语法

要显示资源的属性和值：

lsrsrc [-s "selection_string"] [ -a | -N { node_file | "-" }] [ -A p | d | b ] [-p 属性] [ -l | -i | -t | -d | -D 定界符 ] [-x] [-h] [-TV] [resource_class] [attr...]

lsrsrc -r [-s "selection_string"] [ -a | -N { node_file | "-" }] [ -l | -i | -t | -d | -D 定界符 ] [-x] [-h] [-TV] [resource_class]

要显示资源类的属性和值：

lsrsrc -c [ -A p | d | b ] [-p property] [ -l | -i | -t | -d | -D 定界符 ] [-x] [-a] [-h] [-TV] resource_class [attr...]

lsrsrc -C domain_name ... [ -A p | d | b ] [-p property] [ -l | -i | -t | -d | -D 定界符 ] [-x] [-h] [-TV] resource_class [attr...]

要显示包含所有资源类的列表：

lsrsrc

描述

lsrsrc 命令显示资源或资源类的持久属性和动态属性及其值。

您可以使用 -N node_file 标志来指示节点名在文件中，而不是在 selection_string中指定多个节点名。 使用 -N "-" 从标准输入中读取节点名。

为了获得最佳性能，请指定 -A p 标志或仅指定持久属性作为参数。

指定 -r 标志以仅显示与指定资源类的资源相关联的资源句柄。

要显示资源类的属性和值的列表，请指定 -c 标志。

缺省情况下，资源属性和值以长格式显示。 使用 -t， -d或 -D 标志以表格式或定界符格式的输出显示资源。

如果系统上安装了 Cluster Systems Management (CSM)，可以将 CSM 定义的节点组用作节点名值来引用多个节点。 有关使用 CSM 节点组和使用 CSM nodegrp 命令的信息，请参阅 CSM: Administration Guide 和 CSM: Command and Technical Reference 。

lsrsrc 命令不会列出任何具有定义为 ct_none (例如Quantum) 的数据类型的属性。 RMC 不会返回定义为 Quantum的属性的属性值。 要列出属性定义，请使用 lsrsrcdef 命令。

标志

-a

指定该命令适用于集群内的所有节点。 集群作用域由 CT_MANAGEMENT_SCOPE 环境变量确定。 如果没有设置此变量，那么首先会选择管理域作用域（若存在），其次选择对等域作用域（若存在），然后选择本地作用域，直到命令作用域有效为止。 该命令对找到的第一个有效域运行一次。 例如，如果同时存在管理域和对等域，那么未设置 CT_MANAGEMENT_SCOPE 的 lsrsrc -a 将列出管理域。 在这种情况下，要列示对等域，请将 CT_MANAGEMENT_SCOPE 设置为 2。

--Ap|d|b

指定一个属性类型。 缺省情况下只显示持久属性。 仅当命令行中没有指定属性名时，才可以使用该标志。

p

只显示持久属性。

d

只显示动态属性。

b

同时显示持久和动态属性。

为了获得最佳性能，请指定 -A p 标志。

-c

显示资源类的属性。 此标志覆盖 -r 标志。

--C 域名...

显示管理服务器上定义的一个或多个 RSCT 对等域上全球化资源类的类属性。 全局化类在对等域和管理域中用作包含有关域信息的资源类。 要在管理服务器上定义的所有对等域上显示全球化资源类的类属性，请使用带有 -a 标志的 -c 标志而不是 -C。 此命令以属性 ActivePeerDomain的形式返回对等域的名称。 这不是实际的属性，而是表示正在显示的是哪个对等域。

-d

指定定界符格式的输出。 缺省定界符是冒号 (:)。 如果要更改缺省定界符，请使用 -D 标志。

--D 分隔符

指定使用特定定界符的定界符格式输出。 使用此标志来指定除缺省冒号 (:) 以外的内容。 例如，当要显示的数据包含冒号时。 使用该标志可以指定含一个或多个字符的定界符。

-i

生成 resource_data_input_file 的模板，然后在进行适当编辑后，可以将其用作 mkrsrc 命令的输入。 以长（节）格式显示输出。 显示可被用来定义资源的全部要求和可选属性。 属性数据类型以成对的值 attr=value 显示。 建议您使用此标志时，将 lsrsrc 命令的输出定向到文件。 此标志覆盖 -s 和 -A d 标志。

-l

指定长格式输出。 在单独行中显示每个属性。 此为缺省显示格式。 如果发出 lsrsrc 命令时带有 -l 标志，但没有资源类名，那么当该命令返回已定义的资源类名列表时，将忽略 -l 标志。

--N{节点文件| "-" }

指定从文件或标准输入读取节点名。 使用 -N node_file 指示节点名存在于某个文件中。

• 这是 node_file 中每一行的节点名。
• 列 1 中的基本系统 (#) 指示该行为注释。
• 节点名左侧的任何空白字符都会加以忽略。
• 节点名右侧的任何字符都会加以忽略。

使用 -N "-" 从标准输入中读取节点名。

CT_MANAGEMENT_SCOPE 环境变量确定集群的作用域。 如果未设置 CT_MANAGEMENT_SCOPE，那么首先会选择管理域作用域（如果存在管理域），其次选择对等域作用域（如果存在对等域），最后选择本地作用域，直到作用域对于该命令有效为止。 该命令对找到的第一个有效域运行一次。 例如，如果既存在管理域，也存在对等域，并且未设置 CT_MANAGEMENT_SCOPE，那么此命令适用于管理域。 如果希望此命令适用于对等域，请将 CT_MANAGEMENT_SCOPE 设为 2。

--p 财产

显示指定 property 的属性。 缺省情况下，只显示公共属性。 要显示所有属性而不考虑属性，请使用 -p 0 标志。 如果在命令行上未指定任何属性，请将此标志与 -A 标志结合使用。

持久属性特性：

0x0001

read_only

0x0002

reqd_for_define (必需)

0x0004

inval_for_define (无效)

0x0008

option_for_define (可选)

0x0010

selectable

0x0020

public

动态属性特性：

0x0020

public

可以为特性指定十进制或十六进制。 要显示具有一个或多个属性的所有属性的属性及其值，请将相关属性一起 "OR" ，然后使用 -p 标志指定 "OR" ed 值。 例如，要显示 reqd_for_define 或 option_for_define的所有持久属性的属性及其值，请输入:

lsrsrc -p 0x0a

-r

显示跟指定的选择字符串匹配的资源或所有资源（如果没有指定选择字符串）的资源句柄。

--s "selection_string"

指定一个选择字符串。 所有选择字符串必须在双引号或单引号内。 如果选择字符串包含有双引号，可以将整个选择字符串写在单引号内。 例如：

-s 'Name == "testing"'

-s 'Name ?= "test"'

只有持久属性可以由选择字符串列示。 有关如何指定选择字符串的信息，请参阅 RSCT: Administration Guide 。

-t

指定表格式。 在单独列中显示每个属性，每行一个资源。

-x

取消报头打印。

-h

将命令的用法语句写到标准输出。

-T

将命令的跟踪消息写到标准错误。 仅供您的软件服务组织使用。

-V

将命令的详细消息写到标准输出。

参数

资源类

指定和您想要显示的资源一起显示的资源类名。

attr...

指定一个或多个属性名。 可以同时指定持久属性名和动态属性名来控制要显示的属性及其顺序。 可以指定零个和多个属性。 属性必须用空格隔开。

安全性

用户需要 lsrsrc 中指定的 resource_class 的读许可权才能运行 lsrsrc。 许可权在联系系统的访问控制表 (ACL) 文件中指定。 请参阅 RSCT: 管理指南 ，以获取有关 ACL 文件以及如何修改该文件的信息。

退出状态

0

命令已成功运行。

1

RMC 发生错误。

2

命令行接口 (CLI) 脚本发生错误。

3

在命令行上指定了不正确的标志。

4

在命令行上指定了不正确的参数。

5

发生了一个由于不正确的命令行输入而导致的 RMC 错误。

环境变量

CT_CONTACT

当 CT_CONTACT 环境变量设为一个主机名或 IP 地址时，该命令将联系指定主机上的资源监视和控制 (RMC) 守护程序。 如果没有设置该环境变量，那么该命令会联系其运行所在的本地系统上的 RMC 守护程序。 该命令显示或修改的资源类或资源位于建立连接的系统上。

CT_IP_AUTHENT

如果存在 CT_IP_AUTHENT 环境变量，那么 RMC 守护程序将使用基于 IP 的网络认证，与 CT_CONTACT 环境变量中的 IP 地址所指定系统上的 RMC 守护程序联系。 仅当 CT_CONTACT 设为 IP 地址时，CT_IP_AUTHENT 才有意义；它不依赖于域名系统（DNS）服务。

CT_MANAGEMENT_SCOPE

确定用来与 RMC 守护程序进行会话的管理作用域，以监视和控制资源和资源类。 管理作用域确定了能够监视和控制资源和资源类的可能的目标节点集。 有效值为：

0

指定本地作用域。

1

指定本地作用域。

2

指定对等域作用域。

3

指定管理域作用域。

如果此环境变量未设置，那么使用本地作用域。

实现细节

该命令是AIX® 的Reliable Scalable Cluster Technology(RSCT)文件集的一部分。

标准输出

当指定 -h 标志时，此命令的用法语句将写入标准输出。 所有详细消息都写到标准输出。

标准错误

所有跟踪消息都写到标准错误。

示例

位置

/opt/rsct/bin/lsrsrc