truss コマンド

目的

プロセスのシステム・コール、動的にロードされたユーザー・レベル機能のコール、 受信されたシグナル、引き起こされたマシン・フォールトをトレースします。

構文

truss [ -f] [ -c] [ -a] [ -l ] [ -d ] [ -D ] [ -e] [ -i] [ { -t | -x} [!] Syscall [...] ] [ -s [!] Signal [...] ] [ { -m }[!] Fault  [...]] [ { -r | -w} [!] FileDescriptor [...] ] [ { -u } [!]LibraryName [...]:: [!]FunctionName [ ... ] ] [ -o Outfile] {Command| -p pid [. . .]}

説明

truss コマンドは指定のコマンドを実行するか、 リストされたプロセス ID に接続して、 システム・コール、受信されたシグナル、プロセスが引き起こしたマシン・フォールトのトレースを生成します。 トレース出力の各行は、Fault、Signal 名、 Syscall 名のいずれかをパラメーターと戻り値で報告します。 システム・ライブラリーに定義済みのサブルーチンは、 カーネルに対して行われたシステム・コールとまったく同じであるとは限りません。 truss コマンドはこれらのサブルーチンではなく、サブルーチンが行う基礎システム・コールを報告します。可能であれば、システム・コール・パラメーターが、関係のあるシステム・ヘッダー・ファイルの定義を使用してシンボルとして表示されます。パス名ポインターのパラメーターについては、truss は指し示されている文字列を表示します。 デフォルトでは、未定義のシステム・コールは、名前、8 つのすべての有効な引数、 16 進形式の戻り値と一緒に表示されます。

-o フラグを truss で使用する場合、 または標準エラーが非端末ファイルにリダイレクトされる場合は、 truss はハングアップ、割り込みおよびシグナルのプロセスを無視します。 これによって、端末から interrupt シグナルと quit シグナルを受け取る対話式プログラムのトレースが促進されます。

トレース出力が端末に送信され続ける場合や、 既存のプロセスがトレースされる (-p フラグを使用して) 場合は、 truss はすべてのトレースされているプロセスを解放して終了することによって、 hangup、interrupt、 および quit シグナルに応答します。 これによって、ユーザーは過度のトレース出力を終了させ、 以前に存在していたプロセスを解放できるようになります。 解放されたプロセスは通常に機能し続けます。

リスト引数を取るオプションの場合は、 リストの指定可能なすべてのメンバーを指定する簡略表現として名前 all を使用できます。 リストが ! で始まる場合は、 オプションの意味は否定されます (例えば、トレースではなく除外になる)。 同じオプションを複数回指定できます。 リスト中の同じ名前については、 後続のオプション (右側にあるオプション) が前のオプション (左側にあるオプション) をオーバーライドします。

ページ不在以外のマシン・フォールトが発生すると、 フォールトを引き起こしたプロセスにシグナルが送付されます。 受信されたシグナルの報告は、そのシグナルがプロセスによってブロックされていない限り、 マシン・フォールトの報告の直後に続きます。

他の制御プロセスとの衝突を避けるために、truss は、 検出したプロセスが /proc インターフェースを使用して別のプロセスによって制御されている場合は、 そのプロセスをトレースしません。

マルチプロセス用のトレース出力は、厳密な時間順に処理されるわけではありません。 例えば、パイプに対する読み取りは、対応する書き込みの前に報告されることがあります。 しかし、各プロセスについては、出力は厳密は時間順です。 トレース出力にはタブ文字が含まれていて、標準タブ停止位置は 8 つの位置ごとに設定されています。

システムは、子のトレース中にユーザーごとのプロセス・スロットを使い尽くすことがあります。 これは、複数のプロセスのトレース中は、truss が、 トレースされている各プロセス用の 1 つの制御プロセスとして実行され、 指定のプロセスに使用されているプロセス・スロットの数が倍になるためです。 マルチプロセスに対してトレースを実行する前に、 1 ユーザー当たり 25 のプロセスというシステムが課す通常の制限を考慮に入れる必要があります。

オペレーティング・システムは、プロセスのトレースに特定のセキュリティー制限を強制します。 トレースするコマンドへのアクセス権がなければなりません。 set-uid および set-gid プロセスは、 特権ユーザーだけがトレースできます。 truss コマンドは、特権ユーザーによって実行されない場合は、 set-id または読み取り不能なオブジェクト・ファイルを実行するプロセスの制御を失います。 これらのトレースされないプロセスは、実行時点から truss とは関係なく通常どおり継続します。

truss 出力に記載した lightweight processes (LWP) は、実際にはカーネル・ スレッドです。-l オプションを使用すると、トレース出力 の各行に LWP ID (つまりスレッド ID) を表示します。

AIX® ライブラリーのユーザー・ライブラリー機能には、静的にロードされた機能呼び出しと動的にロードされた機能呼び出しの両方があります。 トレース に -u オプションを付けると、動的にロードした機能 呼び出し専用に使用されます。

動的ロード機能呼び出しに対するユーザー・レベルの機能呼び出しに は、-u オプションがあります。このオプションを 使用すると、機能呼び出しの開始/終了トレースを生成します。

フラグ

セキュリティー

例

1. 端末上の find コマンドのトレースを生成するには、次のようにタイプします。

   truss find . -print >find.out

2. lseek、close、statx、open システム・コールをトレースするには、次のようにタイプします。

   truss -t lseek,close,statx,open find . -print > find.out

3. find コマンドの通常の出力にスレッド ID を表示するには、 次のように入力します。

   truss -l find . -print >find.out 

4. find コマンドの通常の出力にタイム・スタンプを表示するには、 次のように入力します。

   truss -d find . -print >find.out 

5. find コマンドの通常の出力にデルタ時間を表示するには、 次のように入力します。

   truss -D find . -print >find.out 

6. ls コマンドを実行したとき に、libc.a ライブラリーで malloc() 機能 呼び出しをトレースして、strlen() 機能呼び出しを除外する には、次のように入力します。

   truss -u libc.a::malloc,!strlen ls 

7. ls コマンドを実行するときに、libc.a ライブラリー内で「m」で始まる名前のすべての機能呼び出しをトレースし、libc.a ライブラリー内の strlen() 機能呼び出しを除外するには、次のコマンドを入力します。

   truss -u libc.a::m*,!strlen ls 

8. ls コマンドを実行し、libc.a ライ ブラリーで、「m」で始まる名前について、すべての機能呼び出しをトレースするには、 次のように入力します。

   truss -u libc.a::m* ls

9. 実行可能な foo を実行して、libcurses.a ライ ブラリーのすべての機能呼び出しをトレースし、libc.a から の呼び出しを除外するには、次のように入力します。

   truss -u libcurses.a,!libc.a::* foo 

10. 実行可能な foo を実行して、libcurses.a から の refresh() 機能呼び出しをトレース と、libc.a からの malloc() 機能 呼び出しをトレースするには、次のように入力します。

     truss -u libc.a::malloc -u libcurses.a::refresh foo

ファイル

/proc ファイルシステム