errctrl コマンド

目的

システム・コンポーネントのエラー検査属性を変更したり表示したりします。 永続属性値は、まだ作成されていないコンポーネントに対しても指定できます。

構文

errctrl [ -nru ] ComponentSelector ... サブコマンド ...

errctrl -p [ -ru ] ComponentSelector ... サブコマンド ...

errctrl -P [ -ru ] ComponentSelector ... サブコマンド ...

errctrl -x { -P | -p } [-ru ] ComponentSelector ...

errctrl -q [-rupP] {ComponentSelector ...}

errctrl {-h | -?}

errctrl -P {errcheckon | errcheckoff}

説明

errctrl コマンドは、一部またはすべてのコンポーネントのエラー検査属性値を変更したり表示したりします。 コンポーネントは、名前、別名、またはタイプやサブタイプで選択されます。

ComponentSelector のサポートされる値は次のとおりです。

-c

componentPatternList

-l

aliasPatternList

-t

typePatternList

これらのリストは、引用符で囲まれたスペースまたはコンマで区切られた 1 つ以上のパターンから構成されます。 パターンには fnmatch サブルーチンで記述されている特殊文字を指定できます。 パターン文字の疑問符 (?)、アスタリスク (*)、および大括弧 ([]) はサポートされますが、文字クラスおよび照合シーケンスは大括弧 ([]) 内では許可されません。 -c all を指定すると、他の ComponentSelector が使用されていない場合は、すべてのコンポーネントが選択されます。

errctrl コマンドを -p または -P フラグと一緒に使用すると、永続属性のカスタマイズを指定できます。 永続属性のカスタマイズについて詳しくは、 永続的なカスタマイズを参照してください。

すべてのコンポーネントに対して、エラー検査を即時および永続的に使用可能または使用不可にするには、errcheckon または errcheckoff サブコマンドを -P フラグと一緒に指定します。 この形式のコマンドでは、他のフラグまたはサブコマンドは使用できません。 再始動後も設定を永続的にするには、bosboot コマンドが必要です。

変更される属性は、コマンド・ラインに指定されるサブコマンドにより決まります。 1 つの呼び出しに複数のサブコマンドを指定することができます。 以下のサブコマンドが使用可能です。

他のサブコマンドは、個々のコンポーネントで認識されます。 コンポーネントで認識されないサブコマンドは無視されます。

現在の属性値は、 -Q (Q) フラグを使用して表示できます。 ComponentSelector が使用されていない場合は、エラー検査がサポートされているすべてのコンポーネントに対して属性値が表示されます。

ネットワーク・メモリーのメモリー・オーバーレイ検出システムは、netmalloc コンポーネントに詳細なエラー・レベルを設定して使用可能にすることができます。 すべてのネットワーク・メモリー割り当てとフリー・イベントに関する詳細なネットワーク・メモリー・ポリス・バッファー情報を収集するには、netmalloc コンポーネントのエラー・レベルを 5 以上 (デフォルト: 3 (normal)) に上げます。 エラー・レベルを 7 (detail) 以上に上げても、ネットワーク・メモリーのオーバーレイ検出システムを使用可能にすることができます。 すべてのネットワーク・メモリー割り当てとフリー・イベントに対して net_malloc_police オプションとアウトスタンディング・メモリー割り当て (OSTD) ロギングのみを使用可能にするには、エラー・レベルを 5 に上げます。

errlevel の変更について詳しくは、 例 を参照してください。 netmalloc コンポーネントでトレース・データを収集するためにトレース・レベルを上げる方法について詳しくは、 CtcTRL コマンドを参照してください。

永続カスタマイズ

-p フラグと -P フラグにより、まだ作成されていないシステム・コンポーネントに属性値を指定できます。 このため、新規に作成されるコンポーネントの属性は、コンポーネントがアクティブになる前にカスタマイズすることができます。 -p フラグは、 AIX®を再始動する前に、将来作成されるコンポーネントのカスタマイズを指定するために使用されます。 -P フラグは、次回の再始動後に有効になるカスタマイズを指定するために使用されます。 これらのカスタマイズは、/var/adm/ras/raspertune ファイルに追加されます。 カスタマイズを有効にするには、 ボスブート コマンドを実行してこれらのカスタマイズをブート・イメージに保存し、 AIX を再始動する必要があります。

ComponentSelector にはパターン・マッチング文字を使用できます。 このように、永続的なカスタマイズを複数のコンポーネントに適用することができます。 また、複数の異なる ComponentSelector を使用することで、複数のカスタマイズを同一のコンポーネントに適用できます。 競合する属性値が複数のカスタマイズに指定されている場合は、最後のカスタマイズが優先されます。 指定された ComponentSelector にカスタマイズが既に存在する場合は、新しいカスタマイズで古いカスタマイズが置き換えられます。

errctrl -p -l hdisk0 errchecknormal
errctrl -p -l hdisk1 errchecknormal

-p または -P フラグで指定されたカスタマイズは、その使用後に削除されません。 従って、1 つのカスタマイズを複数の新規コンポーネントに作用させることができます。 永続カスタマイズは -x フラグで削除できます。 ComponentSelector は、カスタマイズが作成されたときに指定されたとおりに指定する必要があります。 例えば、カスタマイズが ComponentSelector -l hdisk0 で作成された場合、そのカスタマイズは ComponentSelector -l hdisk[0] で削除することはできません。これは両方の ComponentSelector が同じコンポーネントの別名と一致する場合でも同様です。 永続カスタマイズが削除される場合、そのカスタマイズがアクティブなときに作成されたコンポーネントの属性は変更されません。

-x (X) フラグおよび -P フラグを使用して削除された永続的なカスタマイズは、 ボスブート コマンドを実行して AIXを再始動しない限り、有効なままです。 -P フラグで作成された永続カスタマイズは、-x と -p フラグを使用することで再始動後に削除されます。 この場合、 AIXを再始動すると、カスタマイズが再びアクティブになります。

errctrl -p -l hdisk0 -u errcheckdetail
errctrl -p -l hdisk0 -r errcheckdetail

errctrl -p -l hdisk0 errcheckdetail
errctrl -p -l hdisk0 -r errcheckdetail
errctrl -p -l hdisk0 -u errcheckdetail

再帰的に下るカスタマイズ (-r フラグにより指定) は、他のすべてのカスタマイズよりも優先されます。この場合、再帰的に下るカスタマイズではない他のカスタマイズに対してそれらが指定される順序は関係ありません。

永続カスタマイズを照会するには、-q フラグを -P または -p フラグと一緒に使用します。 -q フラグを -P フラグと一緒に指定すると、/var/adm/ras/raspertune ファイルからの行が表示されます。 -q フラグを -p および -r フラグと一緒に指定すると、元々 -r フラグで指定された永続カスタマイズが表示されます。 -r フラグを指定しないと、-q と -p フラグにより、-u フラグで指定された永続カスタマイズと -u フラグなしで指定された永続カスタマイズが表示されます。

永続カスタマイズでは、複数のサブコマンドを指定できます。 競合するサブコマンドが使用される場合は、最後のサブコマンドが使用されます。 例えば、errchecknormal サブコマンドと errcheckdetail サブコマンドが同じエラー検査属性に対して異なる値を指定している場合は、最後に指定されたサブコマンドが使用されます。

フラグ

終了状況

セキュリティー

例

1. すべての JFS2 ユーザー・データ・コンポーネントに対して詳細なエラー検査をオンにするには、次のように入力します。

   errctrl -c 'jfs2.filesystem.*.userdata' errcheckdetail

2. 新規 JFS2 ファイルシステムのユーザー・データ・コンポーネントに対して永続カスタマイズを指定するには、次のように入力します。

   errctrl -p -c 'jfs2.filesystem.*.userdata' errcheckminimal

   現在のユーザー・データ・コンポーネントに対しては無効です。
3. 再始動後も持続するカスタマイズを指定するには、次のように入力します。

   errctrl -P -c 'jfs2.filesystem.*.userdata' errcheckminimal

   ボスブート コマンドを実行して AIXを再始動すると、すべての JFS2 ユーザー・データ・コンポーネントに対して最小限のエラー検査が有効になります。
4. 現在および将来のすべての JFS2 ユーザー・データ・コンポーネントに対して最小限のエラー検査を設定するには、以下のようにします。 以下のように入力します。

   errctrl -npP -c 'jfs2.filesystem.*.userdata' errcheckminimal

5. イーサネット・コンポーネントに対して複数の永続属性値を指定するには、次のように入力します。

   errctrl -P -c ethernet errcheckminimal medsevdisposition=80

6. 例 2 で指定されたカスタマイズを削除するには、次のように入力します。

   errctrl -p -x -c 'jfs2.filesystem.*.userdata'
   

7. すべての永続的、再帰的な属性のカスタマイズをリストするには、次のように入力します。

   errctrl -q -p -r

8. JFS2 コンポーネントとその子孫に対して現行のエラー検査属性値をリストするには、次のように入力します。

   errctrl -q -c jfs2 -r

9. ネットワーク・メモリーのメモリー・オーバーレイ検出システム (MODS) を使用可能にするには (netmalloc コンポーネントに対してエラー・レベルを詳細レベルに上げる)、次のように入力します。

   errctrl errcheckdetail -c netmalloc

   または

   errctrl errchecklevel=7 -c netmalloc

   注: これにより、すべてのネットワーク・メモリー割り振りおよび空きイベントに対して ネット・マルロケーション警察 オプションも有効になります。
10. すべてのネットワーク・メモリー割り当てとフリー・イベントに対して net_malloc_police オプションを使用可能にするには、netmalloc コンポーネントのエラー・レベルを 5 以上に上げます。次のように入力します。

    errctrl errchecklevel=5 -c netmalloc

    このコマンドにより、ネットワーク・メモリーに対するアウトスタンディング・メモリー割り当て (OSTD) ロギングも使用可能になります。
11. netmalloc のポリス割り当てとフリー・イベントの頻度を 25% に変更するには、police_frequency 関数の可能性を 256 に変更します。次のように入力します。

    errctrl police_frequency=256 –c netmalloc.police 

場所

/usr/sbin/errctrl

ファイル