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

kernelzilla · Nov 18, 2010 · 61ede15 · 61ede15
1 parent 03761ed
commit 61ede15
Show file tree

Hide file tree

Showing 2 changed files with 23 additions and 0 deletions.
diff --git a/ChangeLog b/ChangeLog
@@ -1,3 +1,7 @@
+2008-12-09  Roland McGrath  <roland@redhat.com>
+
+	* strace.1 (DIAGNOSTICS): New section, describe exit behavior.
+
 2008-11-09  Dmitry V. Levin  <ldv@altlinux.org>
 
 	* process.c (prctl_options): Update constants from linux 2.6.27.

diff --git a/strace.1 b/strace.1
@@ -530,6 +530,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