2004-09-03 Roland McGrath <roland@redhat.com>

[strace] / strace.1

diff --git a/strace.1 b/strace.1
index 281a5851a6bd6b4bbc1e3de858fd52825a01bce1..b8870a43932fbc88e344ef692eb68e654291cd15 100644 (file)
--- a/strace.1
+++ b/strace.1
@@ -37,7 +37,7 @@
 .fi
 .sp
 ..
-.TH STRACE 1 "96/02/13"
+.TH STRACE 1 "2003-01-21"
 .SH NAME
 strace \- trace system calls and signals
 .SH SYNOPSIS
@@ -66,6 +66,14 @@ strace \- trace system calls and signals
 .BI \-u username
 ]
 [
+.BI \-E var=val
+]
+\&...
+[
+.BI \-E var
+]
+\&...
+[
 .I command
 [
 .I arg
@@ -109,7 +117,7 @@ option.
 .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.
@@ -140,7 +148,7 @@ sigsuspend([] <unfinished ...>
 +++ 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
@@ -210,8 +218,9 @@ Here the second argument represents the full set of all signals.
 .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
@@ -250,8 +259,8 @@ where pid is the numeric process id of each process.
 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
@@ -306,7 +315,7 @@ Print all non-ASCII strings in hexadecimal string format.
 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
@@ -402,7 +411,7 @@ default is
 .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
@@ -459,7 +468,7 @@ This is useful for overriding the default heuristic for guessing
 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
@@ -493,7 +502,7 @@ full.
 .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 ,
@@ -510,6 +519,17 @@ This option is only useful when running as root and enables the
 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
@@ -634,6 +654,7 @@ and tired of writing about himself in the third person.
 .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>.