strtune コマンド

オンライン編集

目的

このコマンドには、以下のようないくつかの関連機能があります。
  • ストリーム・チューナブル・パラメーターを獲得または設定する。
  • コンポーネント・トレースを使用してトレースするオブジェクトを定義する。
  • ストリーム・モジュールのチューナブル値をリストする。
  • アクティブ・キューのチューナブル値をリストする。

構文

ストロン {N 名前 | -Q (Q) アドレス} - チューナブル名[=値] - チューナブル名[=値] ...

ストロン [N 名前 | -Q (Q) アドレス [-a 値]] - TrcLevel[=値]

ストリチューン [-M ]

strtune [-Q］

strtune [-f tunefile ]

説明

このコマンドは、値の表示またはリストに使用されるときは、その使用に制限はありませんが、このコマンドを使用してチューナブル値を変更したり、あるいはトレースするオブジェクトを定義するときは、root 権限を持つ必要があります。

フラグ

-名
ストリーム・モジュール名またはデバイス名を定義します。
--q アドレス

アクティブ・キュー・アドレスを定義します。

コマンドは、tunable を設定する場合は、キューの同期レベルによって、キュー・ペアかキューのみを変更します。 同期レベルは、SQLVL_QUEUE ではない場合は、すべてのキュー・ペアにも伝搬されます。

-チューナブル名
チューナブル・パラメーターの名前を定義します。 使用できる値は、次のとおりです。
  • hiwat。キューのフロー制御の最高水準点を定義します。
  • lowat。キューのフロー制御の最低水準点を定義します。
  • minpsz。最小パケット・サイズを定義します。
  • maxpsz。最大パケット・サイズを定義します。 -1 の値は、無限のパケット・サイズを示します。

strtune コマンドは、-o オプションを複数回リストすることによって、いくつかの tunable を初期化できます。

VALUE
新規の値が指定されない場合、コマンドは tunable の値を表示します。 チューナブル・パラメーター値を変更できるのは、root 権限を持つユーザーに限られます。
-名
ストリーム・モジュール名を定義します。 コマンド内に -n または -q フラグが存在しない場合、コマンドは、pse グローバル・トレース・レベル (pse_trclevel) を含むグローバル変数を表示または変更します。
--q アドレス

アクティブ・キュー・アドレスを定義します。 コマンド内に -n または -q フラグが存在しない場合、コマンドは、pse グローバル・トレース・レベル (pse_trclevel) を含むグローバル変数を表示または変更します。

コマンドは、トレース・レベルを設定する場合は、キューの同期レベルによって、キュー・ペアかキューのみを変更します。 同期レベルは、SQLVL_QUEUE ではない場合は、すべてのキュー・ペアにも伝搬されます。

--o トラクルレベル
トレース・レベルを表示または変更します。 -o フラグは、複数回リストできません。
VALUE
新規の値が指定されない場合、コマンドは tunable の値を表示します。 チューナブル・パラメーター値を変更できるのは、root 権限を持つユーザーに限られます。
-a
新規の値をストリーム内のすべてのキューに伝搬させるには (ストリーム・ヘッドからドライバーへ)、このフラグを使用して strtune コマンドを強制実行します。 同期レベルは、SQLVL_QUEUE ではない場合は、すべてのキュー・ペアにも伝搬されます。
-M
モジュールごとの名前、ID 名、および関連するチューナブル・パラメーター (minpsz、maxpsz、lowat、hiwat、trclevel) 値を表示します。
-Q
アクティブ・キューごとの名前、ID 名、および関連するチューナブル・パラメーター (minpsz、maxpsz、lowat、hiwat、trclevel) 値を表示します。
--f チューンファイル
tunefile 変数は、チューナブル・パラメーター設定値を含むファイルへのファイル・パスを保持しています。 tunefile ファイルの各行は、1 つのコマンドとして管理されます。tunefile に何らかの変更コマンドがある場合は、ユーザーに、インプリメントされる変更に対する root 権限が必要です。

終了状況

0
正常終了。
>0
エラーが発生しました。

例

  1. ldterm モジュールの hiwat チューナブル値を表示するには、次のように入力します。
    strtune -n ldterm -o hiwat
  2. root 権限を持っていて、ldterm モジュールの hiwat の値を 8192 に設定するには、次のように入力します。
    strtune -n ldterm -o hiwat=8192
  3. 以下の行を実行するには、次のように入力します。
    -n udp6 -o lowat=256
-n dlpi -o hiwat=4096 -o lowat=128 -o minpsz=128
    これらは、/tmp/ff ファイルにリストされています。
    strtune -f /tmp/ff
    これにより、以下のコマンドが実行されます。
    strtune -n udp6 -o lowat=256
strtune -n dlpi -o hiwat=4096 -o lowat=128 -o minpsz=128

ファイル

src/bos/usr/sbin/strtune/strtune.c
strtune コマンドが入っています。