ナビゲーションリンクをスキップ | |
印刷ビューの終了 | |
マニュアルページセクション 1M: システム管理コマンド Oracle Solaris 11.1 Information Library (日本語) |
- リソースプール構成ファイルの作成および変更
/usr/sbin/poolcfg -c command [-d | [filename]]
/usr/sbin/poolcfg -f command_file [-d | [filename]]
/usr/sbin/poolcfg -h
poolcfg ユーティリティーは、プールやセットに対する構成操作を行います。これらの操作は既存の構成に対して実行され、「指定された構成ファイルを変更する」という方法を取ります。-d オプションを使用した場合、カーネル状態に対して変更が加えられます。結果として得られた構成を実際に有効化するには、pooladm(1M) ユーティリティーを使用します。
プール構成ファイルは、poolcfg 自体を使ったか、あるいは libpool(3LIB) を使って直接構築された構造化ファイルです。
プールの動的な場所と書き込み権を指定した poolcfg の呼び出しは、その動的な場所が書き込みのためにすでに開かれているとハングアップします。
このユーティリティーによって作成された構成は、pooladm がターゲットホスト上でこの構成をインスタンス化するために使用できます。
サポートしているオプションは、次のとおりです。
command に特定の編集コマンドを指定します。「使用法」を参照してください。
カーネル状態に対して直接操作を行います。filename は使用できません。
command_file からコマンドを取得します。command_file はいくつかの編集コマンドから構成されます。コマンドは 1 行に 1 つずつ記述されます。
編集コマンドの構文に関する詳細情報を表示します。
スクリプトは、複数の編集コマンドで構成されます。スクリプト内の各行に、編集コマンドを 1 つずつ記述します。次のような書式を使用します。
構成 (または指定された部分) を、人間が読める形式で標準出力に表示します。エンティティーが指定されなかった場合、システムの情報が表示されます。したがって、poolcfg -c 'info' afile は、poolcfg -c 'info system name' afile と同等の呼び出しになります。
指定されたタイプと名前のエンティティーを作成します。
指定されたエンティティーを削除します。
指定されたエンティティー上の指定された一連のプロパティーを変更します。
特定のプールに 1 つ以上のリソースを接続するか、1 つ以上の既存の接続を置き換えます。
1 つ以上の個別コンポーネントを特定のリソースに転送します。
特定数のリソースを src から tgt に転送します。
特定数のリソースを src から tgt に転送します。
システムエンティティーを 1 つ作成します。このエンティティーには、1 つのプールエンティティーと現在のシステム構成に一致するリソースが格納されます。発見されたすべてのリソースタイプのすべてのリソースがファイル内に記録されます。その際、単一のプールが各リソースタイプのデフォルトリソースを参照するように記録されます。
poolcfg がカーネルに対して直接操作を行う場合、このコマンドは何も行いません。-d オプションを参照してください。
このコマンドはできるだけ使用しないでください。構成を作成するために推奨されている方法は、pooladm(1M) の -s オプションを使って動的構成をエクスポートすることです。
システム上の特定のエンティティーの名前を別の名前に変更します。
プロパティーリストは次のように指定します。
( proptype name = value [ ; proptype name = value ]* )
ここで、特定のプロパティータイプと名前のペアについて、シーケンス内で最後に定義されたものが有効となります。プロパティーを削除するには、~ proptype name を使用します。
リソースリストは次のように指定します。
( resourcetype name [ ; resourcetype name ]* )
ここで、特定のリソースについて、シーケンス内で最後に指定されたものが有効となります。リソースリストでは、削除用の構文は存在しません。
コンポーネントリストは次のように指定します。
( componenttype name [ ; componenttype name ]* )
ここで、特定のコンポーネントについて、シーケンス内で最後に指定されたものが有効となります。コンポーネントリストでは、削除用の構文は存在しません。
マシンレベルのエンティティー
リソース関連付けの集合に名前を付けたもの
プロセッサセットリソース
2 つの値 true、false のいずれかを取ります。
64 ビット符号付き整数値。
64 ビット符号なし整数値。
文字列は引用符 (") で区切ります。formats(5) で定義されている文字エスケープシーケンスがサポートされます。
科学用の表記はサポートされません。
例 1 poolcfg スクリプトの記述
次の poolcfg スクリプトは、Accounting という名前のプールと、プロセッサセット small-1 を作成します。まず、プロセッサセットが作成されます。次に、プールが作成され、それにプロセッサセットが関連付けられます。
create pset small-1 ( uint pset.min = 1 ; uint pset.max = 4) create pool Accounting associate pool Accounting ( pset small-1 )
例 2 pool_0 のレポート
次のコマンドは、pool_0 に関するレポートを、人間が読める形式で標準出力に出力します。
# poolcfg -c 'info pool pool_0' /etc/pooladm.conf
例 3 pool_0 とその関連付けの削除
次のコマンドは、pool_0 とその関連付けを削除します。ただし、すでに関連付けられていたリソースは削除しません。
# poolcfg -c 'destroy pool pool_0' /etc/pooladm.conf
例 4 現在の構成の表示
次のコマンドは現在の構成を表示します。
$ poolcfg -c 'info' /etc/pooladm.conf system example_system int system.version 1 boolean system.bind-default true string system.comment Discovered by libpool pool pool_default boolean pool.default true boolean pool.active true int pool.importance 5 string pool.comment string.pool.scheduler FSS pset pset_default pset pset_default int pset.sys_id -1 string pset.units population boolean pset.default true uint pset.max 4294967295 uint pset.min 1 string pset.comment boolean pset.escapable false uint pset.load 0 uint pset.size 2 cpu int cpu.sys_id 0 string cpu.comment cpu int cpu.sys_id 2 string cpu.comment
例 5 カーネル内で ID 2 の cpu をプロセッサセット pset1 に移動する
次のコマンドは、カーネル内で、ID 2 の cpu をプロセッサセット pset1 に移動します。
# poolcfg -dc 'transfer to pset pset1 ( cpu 2 )'
例 6 カーネル内で 2 つの cpu をプロセッサセット pset1 からプロセッサセット pset2 に移動する
次のコマンドでは、カーネル内で、2 つの cpu をプロセッサセット pset1 からプロセッサセット pset2 に移動します。
# poolcfg -dc 'transfer 2 from pset pset1 to pset2'
属性についての詳細は、マニュアルページの attributes(5) を参照してください。
|
呼び出しは「確実」です。出力は「不確実」です。
pooladm(1M), poolbind(1M), libpool(3LIB), attributes(5), formats(5)