lslpcmd コマンド

目的

ドメイン内の 1 つ以上のノードの最小特権 (LP) リソースに関する情報をリストします。

構文

LP リソース情報を表示するには、次のように入力します。
  • ローカル・ノードの場合:

    lslpcmd [ -A | resource_name1 [ , resource_name2 , … ] | -R RunCmdName1 [ , RunCmdName2 , … ] ] [-h] [-TV]

  • ドメイン内のすべてのノードの場合:

    lslpcmd -a [ -A | resource_name1 [ , resource_name2 , … ] | -R RunCmdName1 [ , RunCmdName2 , … ] ] [-h] [-TV]

  • ドメイン内の一部のノードの場合:

    lslpcmd -n host1 [,host2,…] [ -A | resource_name1 [ , resource_name2 , … ] | -R RunCmdName1 [ , RunCmdName2 , … ] ] [-h] [-TV]

説明

lslpcmd コマンドは、ドメイン内の 1 つ以上のノードの LP リソースに関する情報を表示します。 LP リソースは、root のみが使用できるコマンドまたはスクリプトで、 これらのコマンドまたはスクリプトへのアクセスは、LP のアクセス制御リスト (ACL) 内 のアクセス権に基づいてユーザーに権限付与されます。このコマンドを使用して、resource_name1,[resource_name2,…] パラメーターを指定することにより、1 つ以上の LP コマンドの属性を表示します。このパラメーターを省略すると、lslpcmd コマンドはすべての LP コマンドの名前をリストします。 すべての LP コマンドと、その属性と値をすべてリストするには、-A フラグを使用します。 特定の RunCmdName 値をもつ 1 つ以上の LP リソースをリストするには、-A フラグを使用します。

lslpcmd コマンドは、定義された LP リソースに関する以下の情報をリストします。
フィールド 説明
Name LP リソースの名前。
CommandPath LP リソースの完全修飾パス。
Description LP リソースの説明。
Lock ロック設定。有効な値は 0 (ロックが設定されない) と 1 (ロックが設定される) です。
CheckSum CommandPath が指す LP リソースの CheckSum 値。 LP リソースが存在しない場合、または LP リソースが使用可能になった後で ユーザーが CheckSum 値を更新しなかった場合は、LP リソース・ マネージャーは値 0 を割り当てます。
RunCmdName runlpcmd コマンドのパラメーターとして使用される LP リソース名。
FilterScript フィルター・スクリプトに至るパス。
FilterArg FilterScript に渡すための引数のリスト。

このコマンドはどのノードでも実行できます。このコマンドをドメイン内のすべてのノードで実行したい場合には、-a フラグを使用します。ドメイン内の一部のノードでこのコマンドを実行したい場合には、-n フラグを使用します。 それ以外の場合、このコマンドはローカル・ノードで実行されます。

フラグ

-a
ドメイン内のすべてのノード上の 1 つ以上の LP リソースに関する情報を表示します。 CT_MANAGEMENT_SCOPE 環境変数の設定値によって、クラスター有効範囲が決まります。 CT_MANAGEMENT_SCOPE が設定されていない場合、LP リソース・マネージャーは次の順序で有効範囲設定値を使用します。
  1. 管理ドメイン (存在する場合)
  2. ピア・ドメイン (存在する場合)
  3. Local 有効範囲
lslpcmd コマンドは、LP リソース・マネージャーが検出した最初の有効範囲に対して 1 回実行されます。例えば、管理ドメインとピア・ドメインが存在していて、かつ、その CT_MANAGEMENT_SCOPE 環境変数が設定されていないと仮定します。 この場合、lslpcmd -a は管理ドメインで実行されます。 lslpcmd -a をピア・ドメインで実行するには、CT_MANAGEMENT_SCOPE を 2 に 設定する必要があります。
-n host1[,host2,…]
LP リソースがリストされるドメインの中のノード (複数可) を指定します。デフォルトでは、LP リソースは、ローカル・ノードで 変更されます。-n フラグが有効なのは、管理ドメインまたはピア・ドメインの中だけで す。 CT_MANAGEMENT_SCOPE 変数が設定されていない場合、LP リソース・マネージャーは次の順序で有効範囲設定値を使用します。
  1. 管理ドメイン (存在する場合)
  2. ピア・ドメイン (存在する場合)
  3. Local 有効範囲

lslpcmd コマンドは、LP リソース・マネージャーが検出した最初の有効範囲に対して 1 回実行されます。

-A
すべての LP リソース、およびその属性と値を表示します。
-R
同じ RunCmdName 値をもつ LP リソースのすべての属性を表示します。
-h
コマンドの使用方法の文を標準出力に書き込みます。
-T
コマンドのトレース・メッセージを標準エラーに書き込みます。
-V
コマンドの詳細メッセージを標準出力に書き込みます。

パラメーター

resource_name1[,resource_name2,...]
情報を表示したい 1 つ以上の LP リソースを指定します。

セキュリティー

lslpcmd コマンドを実行するには、以下の許可が必要です。
  • IBM.LPCommands リソース・クラスの Class ACL の中の読み取り許可。
  • Resource ACL の中の読み取り許可。

    代わりに、この許可が Resource Shared ACL の中に存在する場合は、Resource ACL が Resource Shared ACL の使用を指示できます。

アクセス権は、連絡先システムの LP ACL で指定されています。 LP ACL に関する一般情報については lpacl ファイルを、LP ACL の変更については「RSCT: Administration Guide」を参照してください。

終了状況

0
コマンドは正常に実行されました
1
RMC でエラーが発生しました。
2
コマンド・ライン・インターフェース (CLI) スクリプトでエラーが発生しました。
3
コマンド・ラインに間違ったフラグが指定されました。
4
コマンド・ラインに間違ったパラメーターが指定されました。
5
コマンド・ラインの入力に誤りがあるため、RMC でエラーが発生しました。
6
リソースが見つかりません。

環境変数

CT_CONTACT
RMC デーモンとのセッションに使用されるシステムを決定します。 CT_CONTACT にホスト名または IP アドレスが設定されていると、このコマンドは指定されたホスト上の RMC デーモンと連絡を取ります。 CT_CONTACT が設定されていない場合、このコマンドは、コマンドが実行されているローカル・システムの RMC デーモンと連絡を取ります。RMC デーモン・セッションのターゲットおよび管理有効範囲によって、処理される LP リソースが決まります。
CT_MANAGEMENT_SCOPE
LP リソースを処理するために RMC デーモンとのセッションに使用される管理有効範囲を決定します。 管理有効範囲は、そのリソースを処理可能な候補となり得るターゲット・ノードのセットを決定します。 有効な値は、次のとおりです。
0
Local 有効範囲を指定します。
1
Local 有効範囲を指定します。
2
ピア・ドメイン 有効範囲を指定します。
3
管理ドメイン 有効範囲を指定します。

この環境変数が設定されていない場合は、Local 有効範囲が使用されます。

実装上の固有な条件

このコマンドは、AIX® 用 Reliable Scalable Cluster Technology (RSCT) ファイルセットの一部です。

標準出力

-h フラグが指定されている場合は、このコマンドの使用方法の説明文が標準出力に書き込まれます。 -V フラグが指定されると、このコマンドの詳細メッセージが標準出力に書き込まれます。

標準エラー

トレース・メッセージはすべて、標準エラーに書き込まれます。

例

  1. ローカル・ノード上のすべての LP リソースの名前をリストするには、次のように入力します。 
    lslpcmd
    出力は次のようになります。 
    lpcommand1
lpcommand2
  2. ローカル・ノード上のすべての LP リソースの名前と属性をリストするには、 次のように入力します。 
    lslpcmd -A
    出力は次のようになります。 
    Name=lpcommand1
CommandPath=/tmp/my_command
Description=
Lock=1
CheckSum=112
RunCmdName=lpcommand1
FilterScript=
FilterArg=
----------------------------------
Name=lpcommand2
CommandPath=/tmp/cmds/this_command
Description=
Lock=0
CheckSum=0
RunCmdName=lpcommand2
FilterScript=
FilterArg=
----------------------------------
  3. ローカル・ノード上の LP リソース lpcommand1 の属性をリストするには、 次のように入力します。 
    lslpcmd lpcommand1
    出力は次のようになります。 
    Name=lpcommand1
CommandPath=/tmp/my_command
Description=
Lock=1
CheckSum=100
RunCmdName=lpcommand1
FilterScript=
FilterArg=
  4. ローカル・ノード上の rpower という RunCmdName 値をもつ LP リソースの属性をリストするには、 次のように入力します。 
    lslpcmd -R rpower
    出力は次のようになります。 
    Name=lpcommand1
CommandPath=/opt/csm/bin/rpower
Description=
Lock=1
CheckSum=112
RunCmdName=rpower
FilterScript=/tmp/test1
FilterArg=node1,node2,node3
-------------------------------
Name=lpcommand2
CommandPath=/opt/csm/bin/rpower
Description=
Lock=0
CheckSum=112
RunCmdName=rpower
FilterScript=/tmp/test1
FilterArg=node4,node5,node6
-------------------------------
⋮

Location

/opt/rsct/bin/lslpcmd
lslpcmd コマンドが入っています。