2008-12-09 Roland McGrath <roland@redhat.com>

	* strace.1 (DIAGNOSTICS): New section, describe exit behavior.

1 files changed, 20 insertions, 2 deletions

diff --git a/strace.1 b/strace.1
index c1c2538..d35a74e 100644
--- a/strace.1
+++ b/strace.1
@@ -113,8 +113,7 @@ by a process and the signals which are received by a process.
 The name of each system call, its arguments and its return value
 are printed on standard error or to the file specified with the
 .B \-o
-option. When straced program exits, strace makes exit status
-available to the parent process of strace.
+option.
 .LP
 .B strace
 is a useful diagnostic, instructional, and debugging tool.
@@ -554,6 +553,25 @@ Remove
 .IR var
 from the inherited list of environment variables before passing it on to
 the command.
+.SH DIAGNOSTICS
+When
+.I command
+exits,
+.B strace
+exits with the same exit status.
+If
+.I command
+is terminated by a signal,
+.B strace
+terminates itself with the same signal, so that
+.B strace
+can be used as a wrapper process transparent to the invoking parent process.
+.LP
+When using
+.BR -p ,
+the exit status of
+.B strace
+is zero unless there was an unexpected error in doing the tracing.
 .SH "SETUID INSTALLATION"
 If
 .B strace