オプションの変更

D スクリプト内にオプションを設定するときは、#pragma D、文字列 option、オプション名を順に指定します。値をとるオプションの場合は、オプション名とオプション値を等号 (=) で結びます。以下に、有効なオプション設定の例を示します。

#pragma D option nspec=4
#pragma D option grabanon
#pragma D option bufsize=2g
#pragma D option switchrate=10hz
#pragma D option aggrate=100us
#pragma D option bufresize=manual

dtrace(1M) コマンドでは、-x オプションの引数として、コマンド行でオプションを設定することもできます。次に例を示します。

# dtrace -x nspec=4 -x grabanon -x bufsize=2g \
    -x switchrate=10hz -x aggrate=100us -x bufresize=manual

無効なオプションを指定すると、dtrace は、オプション名が無効であるというメッセージを表示して終了します。

# dtrace -x wombats=25
dtrace: failed to set option -x wombats: Invalid option name
#

同様に、オプションに無効な値を指定すると、dtrace は値が無効であるというメッセージを表示します。

# dtrace -x bufsize=100wombats
dtrace: failed to set option -x bufsize: Invalid value for specified option
#

同じオプションを繰り返し指定した場合、先に指定されたオプションは、あとから指定されたオプションで上書きされます。grabanon など、一部のオプションは設定することだけが可能です。こうしたオプションを設定した場合、あとで設定を解除することはできません。

匿名状態を要求する DTrace コンシューマは、匿名を有効化するためのオプションを使用できます。匿名トレースの有効化については、第 36 章匿名トレースを参照してください。