95 lines
2 KiB
Groff
95 lines
2 KiB
Groff
.\" %FreeBSD: src/usr.bin/truss/truss.1,v 1.15 2002/11/26 17:33:36 ru Exp %
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.Dd November 23, 1997
|
|
.\"
|
|
.\" WORD: trace トレース(する)[ktrace.1, mtrace.8]
|
|
.\"
|
|
.Dt TRUSS 1
|
|
.Os
|
|
.Sh 名称
|
|
.Nm truss
|
|
.Nd システムコールをトレースする
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl faedDS
|
|
.Op Fl o Ar file
|
|
.Fl p Ar pid
|
|
.Nm
|
|
.Op Fl faedDS
|
|
.Op Fl o Ar file
|
|
command
|
|
.Op args
|
|
.Sh 解説
|
|
.Nm
|
|
ユーティリティは、指定したプロセスやプログラムが呼び出すシステムコールを
|
|
トレースします。出力は指定した出力ファイルか、デフォルトでは
|
|
標準エラー出力へ送られます。処理は
|
|
.Xr procfs 5
|
|
でプロセスを監視し、それを停止させたり再開させて行なわれます。
|
|
.Pp
|
|
オプションは以下のとおりです :
|
|
.Bl -tag -width indent
|
|
.It Fl f
|
|
元々のトレース対象プロセスが
|
|
.Xr fork 2 ,
|
|
.Xr vfork 2
|
|
等で作成した子孫プロセスを
|
|
トレースします。
|
|
.It Fl a
|
|
各
|
|
.Xr execve 2
|
|
システムコールで渡された引数文字列を表示します。
|
|
.It Fl e
|
|
各
|
|
.Xr execve 2
|
|
システムコールで渡された環境文字列を表示します。
|
|
.It Fl d
|
|
出力中に、トレース開始からの経過時間を示す、
|
|
タイムスタンプを含めます。
|
|
.It Fl D
|
|
出力中に、最後に記録されたイベントからの経過時間を示す、
|
|
タイムスタンプを含めます。
|
|
.It Fl S
|
|
プロセスが受信するシグナルについての情報は表示しません。
|
|
(通常、
|
|
.Nm
|
|
はシステムコールイベントと同様、シグナル情報も表示します。)
|
|
.It Fl o Ar file
|
|
出力を標準エラー出力ではなく、指定したファイル
|
|
.Ar file
|
|
へ送ります。
|
|
.It Fl p Ar pid
|
|
新しくコマンドを起動するのではなく、指定したプロセス ID
|
|
.Ar pid
|
|
のプロセスを追います。
|
|
.It Ar command Op args
|
|
コマンド
|
|
.Ar command
|
|
を実行し、そのシステムコールをトレースします。
|
|
(オプション
|
|
.Fl p
|
|
と
|
|
.Ar command
|
|
は互いに排他的にしか使用できません。)
|
|
.El
|
|
.Sh 使用例
|
|
# "hello" を echo する際に使われるシステムコールを追います
|
|
.Dl $ truss /bin/echo hello
|
|
# 同じことをしますが、出力をファイルに書き込みます
|
|
.Dl $ truss -o /tmp/truss.out /bin/echo hello
|
|
# すでに動作しているプロセスを追います
|
|
.Dl $ truss -p 1
|
|
.Sh 関連項目
|
|
.Xr kdump 1 ,
|
|
.Xr ktrace 1 ,
|
|
.Xr procfs 5
|
|
.Sh 歴史
|
|
.Nm
|
|
コマンドは
|
|
.An Sean Eric Fagan
|
|
が
|
|
.Fx
|
|
用に作成しました。
|
|
System V Release 4 や SunOS で利用可能な
|
|
類似のコマンドをモデルにしました。
|