projctl コマンド

目的

プロジェクト・ベースの拡張アカウンティング・アクティビティーをサポートします。

構文

projctl add projname projnumber [comment] [ { -d projpath | -p [DN] } ]

projctl merge sourceprojpath [ -d targetprojfile ]

projctl rm projname [ { -d projpath | -p [DN] } ]

projctl chg projname [ -p pid [, pid] ] [-f]

projctl exec projname <cmd line> [-f]

projctl chattr agg projname {-s|-u} [ { -d projpath | -p [DN] } ]

projctl qpolicy [ -g [ DN] ]

projctl qprojs [-n]

projctl qproj [projectname]

projctl qapp appname

projctl { chkusr | chkgrp | chkprojs | {{chkadm | chkall} [-d admpath]}}

projctl ldusr [ -r ] [ -a ]

projctl unldusr [ -a ]

projctl ldgrp [ -r ] [ -a ]

projctl unldgrp [ -a ]

projctl ldprojs -g [ -r ] [ -a ]

projctl ldprojs -g [DN] -d projpath

projctl ldprojs -p [DN] -d projpath

projctl unldprojs -g [DN] [ -f ] [ -a ]

projctl unldprojs -p [DN]

projctl ldadm -g [name] [ -r ] [ -a ]

projctl ldadm -g [name:]DN | name ] -d admpath

projctl ldadm -p [ [name:]DN | name ] -d admpath

projctl unldadm -g [ -a ]

projctl unldadm -p [ [name:]DN | name ]

projctl ld [ -r ]

projctl ldall [ -d admpath ] [ -r ] [ -a ]

projctl unldall [ -f ] [ -a ]

説明

projctl コマンドのさまざまなサブコマンドは、 新規プロジェクトの追加、新規プロジェクトの除去、および特定のアカウンティング・ポリシー のロードなどの、プロジェクト・ベースの拡張アカウンティング・アクティビティーを実行します。 projctl コマンドのこれらのさまざまなオプションについて、以下に説明します。

フラグ

パラメーター

サブコマンド

add サブコマンド

add サブコマンドは、プロジェクトの定義をプロジェクト定義ファイルに 追加します。–d フラグが指定されると、プロジェクト定義は、指定されたパスの下のプロジェクト定義ファイルに追加されます。 デフォルトでは、/etc/project/projdef システム・プロジェクト定義ファイルに 追加されます。これ以外のパスの下のプロジェクト定義ファイルは、.projdef: という 名前にする必要があります。 新規プロジェクトがシステム・プロジェクト定義ファイルに追加されるが、プロジェクトが カーネルに既にロードされている場合は、指定された新規プロジェクトはカーネル・プロジェクト・レジストリーに 追加されます。それ以外の場合、 エントリーはファイル内にのみ作成されます。 add サブコマンドは、プロジェクト名、プロジェクト番号、および プロジェクト・コメント用のオプション引数を、パラメーターとして入手します。 デフォルトでは、プロジェクトの集約プロパティーは、このコマンドを使用して 作成されたすべてのプロジェクトに対して no に設定されます。

-p を指定した場合は、新規プロジェクト定義が LDAP サーバー上のデフォルト・ プロジェクト DN または指定された DN に追加されます。 -p を指定しない場合は、.config がソース情報を提供します。-p オプションの実行には、root 権限が必要です。

ProjectName:ProjectNumber:AggregationStatus::Comment

:: Project Definition File
:: Dated: 23-JUN-2003
AIX:3542:yes::To Classify AIX Legacy Applications
Test_Project:0x10000:yes::To Classify Testing work

chattr agg サブコマンド

chattr agg サブコマンドは、指定されたプロジェクトの集約プロパティーを 使用可能にしたり使用不可にしたりします。 -s フラグが使用されると、集約は使用可能になります。 -u フラグが使用されると、集約は使用不可になります。 –d フラグが指定されると、プロジェクト定義は、指定されたパスの下のプロジェクト定義ファイル内で更新されます。 デフォルトでは、システム・プロジェクト定義ファイル (/etc/project/projdef) を 更新します。更新がシステム・プロジェクト定義ファイルに対するもので、それがカーネルに既にロードされている場合は、指定された新規プロジェクトはカーネル・プロジェクト・レジストリーにおいても更新されます。 それ以外の場合、変更はプロジェクト定義ファイルに対してのみ行われます。

-p を指定した場合は、LDAP サーバー上のデフォルト・プロジェクト DN または指定された DN に関するプロジェクト定義が変更されます。 -p を指定しない場合は、.config がソース情報を提供します。 -p オプションの実行には、root 権限が必要です。

chg サブコマンド

chg サブコマンドにより、ユーザーは、自分のプロセス用に 使用することが許可されているプロジェクトのリストを変更することができます。 対象とするプロジェクト名が、このサブコマンドの入力として指定されます。 プロセス ID が入力として提供された場合は、これらのプロセスは 指定されたプロジェクトの下に分類されることになります。 入力として提供されたプロセス ID がない場合は、 プロジェクト変更は、projctl コマンドを開始したプロセスに 対して行われます。

デフォルトでは、chg サブコマンドは、使用可能なルールの有効範囲内で プロジェクト割り当てを変更します。 ルールをオーバーライドしてプロジェクトを直接にプロセスに割り当てる には、-f 強制オプションを指定する必要があります。

chk サブコマンド

chk サブコマンドは、さまざまなプロジェクト・ポリシーの 妥当性を検査します。サブコマンドは、プロジェクトおよびポリシーを安全にカーネルにロードできるように、 これらを妥当性検査します。 さまざまなプロジェクト・ポリシーをサポートするために、 いくつかの chk サブコマンドがあります。 サブコマンドを以下に示します。

exec サブコマンド

exec サブコマンドは、ユーザーが、コマンドの処理対象となりうる プロジェクトのリストからのプロジェクト名のいずれかを使用して、 任意のコマンドを起動することができるようにします。 chg オプションと同様に、ルールをオーバーライドし任意のプロジェクトを使用して コマンド・ラインを実行するために使用される、-f 強制オプションを使用する必要があります。 コマンドを割り当てる対象となりうるプロジェクトのリストを取得する には、projctl qapp サブコマンドを使用します。

ld サブコマンド

merge サブコマンド

merge サブコマンドは、デフォルトでは、指定されたパスの下のプロジェクト定義ファイルで定義されたプロジェクトを、システム・プロジェクト定義 /etc/project/projdef ファイルと マージします。ターゲット・プロジェクト・ファイル名が -d オプションを使用して渡される場合は、指定されたパスの下のプロジェクト定義がターゲット・プロジェクト定義ファイルとマージされます。 マージ操作は、ターゲット・プロジェクト定義ファイルと指定されたパスの下のプロジェクト定義ファイル との間で矛盾するエントリーがあると、失敗します。merge コマンドは、重複するエントリーがあればスキップして、 ターゲット・プロジェクト定義ファイル内の固有なエントリーを維持します。

qapp サブコマンド

qapp サブコマンドは、現行環境内でアプリケーションが切り換える対象となりうる プロジェクトのリストを、表示します。 指定されたアプリケーションを開始させるのに使用できるすべてのプロジェクトのリストを、 表示します。

qpolicy サブコマンド

qpolicy サブコマンドは、現在ロードされているポリシーを表示します。 このコマンドはカーネルを照会して、ロードされたポリシーのタイプに関する情報を取得し、 それらを表示します。 -g を指定した場合は、このコマンドは、LDAP デフォルト管理 DN または指定された DN からポリシーをリストします。

qproj サブコマンド

qproj サブコマンドは、引数として渡されるプロジェクト名の 詳細を表示します。 引数が渡されない場合は、このサブコマンドは、呼び出しプロセスを割り当てる対象になりうる、 システム内のすべてのプロジェクト定義をリストします。 表示フォーマットは、qprojs サブコマンドと同じになります。

qprojs サブコマンド

qprojs サブコマンドは、カーネル・レジストリー内に現在ロードされている すべてのプロジェクト定義のリストを表示します。 -n オプションは、プロジェクト名を基にソートされたリストを提供します。 表示には、プロジェクト名、プロジェクト番号、およびプロジェクトの集約状況が入っています。

rm サブコマンド

rm サブコマンドは、プロジェクト定義ファイルから、 ローカルに定義されたプロジェクトの定義を除去します。–d フラグが指定されると、プロジェクト定義は、指定されたパスの下のプロジェクト定義ファイルから除去されます。 デフォルトでは、システム・プロジェクト定義ファイル (/etc/project/projdef) から プロジェクト定義を除去します。更新がシステム・プロジェクト定義ファイルに対するもので、それが カーネルに既にロードされている場合は、指定されたプロジェクトはカーネル・プロジェクト・レジストリーから 除去されます。 それ以外の場合、エントリーはファイルからのみ、除去されます。

unld サブコマンド

終了状況

例

1. システム・プロジェクト定義ファイルにプロジェクト newproj を追加するには、 次のように入力します。

   projctl add newproj 34 "Test Project"

2. パス /tmp/myproj の下のプロジェクト定義ファイルから、 プロジェクト test1 を除去するには、次のように入力します。

   projctl rm test1 –d /tmp/myproj

3. プロジェクト newproj の集約状況を使用可能にするには、次のように入力します。

   projctl chattr agg newproj –s

4. ps コマンドをプロジェクト newproj の下で実行し、 既存のルールをオーバーライドするには、次のように入力します。

   projctl exec newproj "/usr/bin/ps" –f

5. 現在ロードされたポリシーを検索するには、次のように入力します。

   projctl qpolicy

   出力:

   Project definitions are loaded.
   Project definition file name:  /etc/project/projdef
   User policies are loaded.

6. 管理ポリシーをパス /tmp/myproj からロードするには、次のように入力します。

   projctl ldadm –d /tmp/myproj

7. すべてのプロジェクト・ポリシーを、今、およびシステム・リブート時にアンロードするには、 次のように入力します。

   projctl unldall -a

8. 新規プロジェクトを別の DN (ここで DN は ou=projects,ou=aacct,ou=cluster1,cn=aixdata です) 上の LDAP リポジトリーに追加するには、次のように入力します。

   projctl add newproj 34 -p ou=projects,ou=aacct,ou=cluster1,cn=aixdata

9. LDAP プロジェクトを、デフォルト DN から /etc/project/ldap パスの下のローカル・ファイルにダウンロードするには、次のように入力します。

   projctl ldprojs -g -d /etc/project/ldap

10. デフォルト DN 内のラベル newdef の下に保管されている LDAP 管理ポリシーをカーネルにロードするには、次のように入力します。

    projctl ldadm -g newdef 

位置

/usr/bin/projctl

ファイル