75 lines
1.6 KiB
Groff
75 lines
1.6 KiB
Groff
.\" %FreeBSD: src/usr.bin/truss/truss.1,v 1.5.2.3 2000/12/19 16:22:32 ru Exp %
|
|
.\"
|
|
.Dd November 23, 1997
|
|
.\" jpman %Id: truss.1,v 1.3 1998/10/12 11:31:39 horikawa Stab %
|
|
.\"
|
|
.\" WORD: trace トレース(する)[ktrace.1, mtrace.8]
|
|
.\"
|
|
.Dt TRUSS 1
|
|
.Os FreeBSD
|
|
.Sh 名称
|
|
.Nm truss
|
|
.Nd システムコールをトレースする
|
|
.Sh 書式
|
|
.Nm
|
|
.Op Fl S
|
|
.Op Fl o Ar file
|
|
.Fl p Ar pid
|
|
.Nm
|
|
.Op Fl S
|
|
.Op Fl o Ar file
|
|
command
|
|
.Op args
|
|
.Sh 解説
|
|
.Nm
|
|
は指定したプロセスやプログラムが呼び出すシステムコールを
|
|
トレースします。出力は指定した出力ファイルか、デフォルトでは
|
|
標準エラー出力へ送られます。処理は
|
|
.Xr procfs 5
|
|
でプロセスを監視し、それを停止させたり再開させて行なわれます。
|
|
.Pp
|
|
オプションは以下のとおりです :
|
|
.Bl -tag -width indent
|
|
.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 で利用可能な
|
|
類似のコマンドをモデルにしました。
|