patch: strace.1, explication of "unfinished"

Tomas Pospisek tpo at
Thu Aug 7 07:47:07 UTC 2008


here's a short patch to strace's manpage that documents 

I'm not subscribed to the mailing list, thus if there's critique/comments 
about the suggested text then please Cc: me.


$ diff -u strace.1.orig strace.1
--- strace.1.orig       2008-08-06 19:45:03.000000000 +0200
+++ strace.1    2008-08-06 20:29:30.000000000 +0200
@@ -147,6 +147,13 @@
  --- SIGINT (Interrupt) ---
  +++ killed by SIGINT +++
+If a system call is being executed and meanwhile another one is being called - or a signal arrives in the meantime then strace will try to preserve the order of those events and mark the ongoing call as being \fIunfinished\fP.
+When the call returns it will be marked as \fIresumed\fP:
+[pid 28772] select(4, [3], NULL, NULL, NULL <unfinished ...>
+[pid 28779] clock_gettime(CLOCK_REALTIME, {1130322148, 939977000}) = 0
+[pid 28772] <... select resumed> )      = 1 (in [3])
  Arguments are printed in symbolic form with a passion.
  This example shows the shell performing ``>>xyzzy'' output redirection:

More information about the Strace-devel mailing list