freebsd-dev/usr.bin/truss/truss.1

.\" $FreeBSD$
.\"
.Dd November 23, 1997
.Dt TRUSS 1
.Os FreeBSD
.Sh NAME
.Nm truss
.Nd trace system calls
.Sh SYNOPSIS
.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 DESCRIPTION
.Nm Truss
traces the system calls called by the specified process or program.
Output is to the specified output file, or standard error by default.
It does this by stopping and restarting the process being monitored via
.Xr procfs 5 .
.Pp
The options are as follows:
.Bl -tag -width indent
.It Fl S
Do not display information about signals received by the process.
(Normally,
.Nm
displays signal as well as system call events.)
.It Fl o Ar file
Print the output to the specified
.Ar file
instead of standard error.
.It Fl p Ar pid
Follow the process specified by 
.Ar pid
instead of a new command.
.It Ar command Op args
Execute
.Ar command
and trace the system calls of it.
(The
.Fl p
and
.Ar command
options are mutually exclusive.)
.El
.Sh EXAMPLES
# Follow the system calls used in echoing "hello"
.Dl $ truss /bin/echo hello
# Do the same, but put the output into a file
.Dl $ truss -o /tmp/truss.out /bin/echo hello
# Follow an already-running process
.Dl $ truss -p 1
.Sh SEE ALSO
.Xr kdump 1 ,
.Xr ktrace 1 ,
.Xr procfs 5
.Sh HISTORY
The
.Nm
command was written by
.An Sean Eric Fagan
for
.Fx .
It was modeled after
similar commands available for System V Release 4 and SunOS.
Add $FreeBSD$ lines to man pages that are missing them to make it easier for translation teams. PR: docs/13418 Submitted by: Alexey Zelkin <phantom@cris.net> 1999-08-28 23:23:38 +00:00			`.\" $FreeBSD$`
			`.\"`
mdoc(7) police: use canonical form of .Dd macro. 2000-12-11 15:47:53 +00:00			`.Dd November 23, 1997`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Dt TRUSS 1`
			`.Os FreeBSD`
			`.Sh NAME`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Nm truss`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Nd trace system calls`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 19:21:22 +00:00			`.Nm`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Op Fl S`
			`.Op Fl o Ar file`
			`.Fl p Ar pid`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 19:21:22 +00:00			`.Nm`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Op Fl S`
			`.Op Fl o Ar file`
			`command`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Op args`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Sh DESCRIPTION`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Nm Truss`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`traces the system calls called by the specified process or program.`
			`Output is to the specified output file, or standard error by default.`
			`It does this by stopping and restarting the process being monitored via`
			`.Xr procfs 5 .`
			`.Pp`
			`The options are as follows:`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Bl -tag -width indent`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.It Fl S`
			`Do not display information about signals received by the process.`
			`(Normally,`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Nm`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`displays signal as well as system call events.)`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.It Fl o Ar file`
			`Print the output to the specified`
			`.Ar file`
			`instead of standard error.`
			`.It Fl p Ar pid`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`Follow the process specified by`
			`.Ar pid`
			`instead of a new command.`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.It Ar command Op args`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`Execute`
			`.Ar command`
			`and trace the system calls of it.`
			`(The`
			`.Fl p`
			`and`
			`.Ar command`
			`options are mutually exclusive.)`
Prepare for mdoc(7)NG. 2000-12-19 16:00:12 +00:00			`.El`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Sh EXAMPLES`
			`# Follow the system calls used in echoing "hello"`
			`.Dl $ truss /bin/echo hello`
			`# Do the same, but put the output into a file`
			`.Dl $ truss -o /tmp/truss.out /bin/echo hello`
			`# Follow an already-running process`
			`.Dl $ truss -p 1`
			`.Sh SEE ALSO`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Xr kdump 1 ,`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Xr ktrace 1 ,`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Xr procfs 5`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`.Sh HISTORY`
			`The`
Sort Xrefs. Use err(3). Remove uneeded #include. Correct usage: one of {-p pid, command} is required. Open output file when command line is fully analyzed: incorrect `truss -o f' command does not create an empty file anymore. 1998-01-05 07:30:26 +00:00			`.Nm`
			`command was written by`
			`.An Sean Eric Fagan`
			`for`
Fxi various man pages to stop abusing the .Bx macro to generate the string "FreeBSD". Use the .Fx macro instead. Also did some minor re-wording/formatting to work around a deficiency with the .Fx macro when it comes to puncuation characters other than periods and commas. 2000-01-23 01:48:16 +00:00			`.Fx .`
			`It was modeled after`
Truss program. Requires procfs. 1997-12-06 05:23:12 +00:00			`similar commands available for System V Release 4 and SunOS.`