.fi
.sp
..
-.TH STRACE 1 "99/06/11"
+.TH STRACE 1 "2003-01-21"
.SH NAME
strace \- trace system calls and signals
.SH SYNOPSIS
.BI \-u username
]
[
+.BI \-E var=val
+]
+\&...
+[
+.BI \-E var
+]
+\&...
+[
.I command
[
.I arg
.LP
.B strace
is a useful diagnostic, instructional, and debugging tool.
-System adminstrators, diagnosticians and trouble-shooters will find
+System administrators, diagnosticians and trouble-shooters will find
it invaluable for solving problems with
programs for which the source is not readily available since
they do not need to be recompiled in order to trace them.
+++ killed by SIGINT +++
.CE
Arguments are printed in symbolic form with a passion.
-This example shows the shell peforming ``>>xyzzy'' output redirection:
+This example shows the shell performing ``>>xyzzy'' output redirection:
.CW
open("xyzzy", O_WRONLY|O_APPEND|O_CREAT, 0666) = 3
.CE
.TP 12
.TP
.B \-c
-Count time, calls, and errors for each system call and report a
-summary on program exit.
+Count time, calls, and errors for each system call and report a summary on
+program exit. On Linux, this attempts to show system time (CPU time spent
+running in the kernel) independent of wall clock time.
.TP
.B \-d
Show some debugging output of
Attempt to follow
.BR vfork s.
(On SunOS 4.x, this is accomplished with
-some dynamic linking trickery. On Linux, it requires some kernel
-functionality not yet in the standard kernel.) Otherwise,
+some dynamic linking trickery.)
+Otherwise,
.BR vfork s
will
not be followed even if
Print all strings in hexadecimal string format.
.TP
.BI "\-a " column
-Align return values in a secific column (default column 40).
+Align return values in a specific column (default column 40).
.TP
.BI "\-e " expr
A qualifying expression which modifies which events to trace
.BR verbose=all .
.TP
.BI "\-e raw=" set
-Print raw, undecoded arguments for the specifed set of system calls.
+Print raw, undecoded arguments for the specified set of system calls.
This option has the effect of causing all arguments to be printed
in hexadecimal. This is mostly useful if you don't trust the
decoding or you need to know the actual numeric value of an
how much time is spent in mere measuring when timing system calls using
the
.B \-c
-option. The acuracy of the heuristic can be gauged by timing a given
+option. The accuracy of the heuristic can be gauged by timing a given
program run without tracing (using
.BR time (1))
and comparing the accumulated
.BI "\-S " sortby
Sort the output of the histogram printed by the
.B \-c
-option by the specified critereon. Legal values are
+option by the specified criterion. Legal values are
.BR time ,
.BR calls ,
.BR name ,
correct execution of setuid and/or setgid binaries.
Unless this option is used setuid and setgid programs are executed
without effective privileges.
+.TP
+.BI "\-E " var=val
+Run command with
+.IR var=val
+in its list of environment variables.
+.TP
+.BI "\-E " var
+Remove
+.IR var
+from the inherited list of environment variables before passing it on to
+the command.
.SH "SETUID INSTALLATION"
If
.B strace
.SH PROBLEMS
Problems with
.B strace
-should be reported to the current
+should be reported via the Debian Bug Tracking System,
+or to the
.B strace
-maintainer, Wichert Akkerman, at <wakkerma@debian.org>.
+mailing list at <strace-devel@lists.sourceforge.net>.