aboutsummaryrefslogtreecommitdiffstats
path: root/README
diff options
context:
space:
mode:
authorMattias Andrée <maandree@kth.se>2020-06-01 15:47:54 +0200
committerMattias Andrée <maandree@kth.se>2020-06-01 15:47:54 +0200
commit222bccafd8548194be47fbae578b3df3c636fd38 (patch)
treefdade6519429c9566022755072d830298c95b9b7 /README
parentAdd tests for manually testing (diff)
downloadsctrace-222bccafd8548194be47fbae578b3df3c636fd38.tar.gz
sctrace-222bccafd8548194be47fbae578b3df3c636fd38.tar.bz2
sctrace-222bccafd8548194be47fbae578b3df3c636fd38.tar.xz
Add man page and README0.1
Signed-off-by: Mattias Andrée <maandree@kth.se>
Diffstat (limited to '')
-rw-r--r--README32
1 files changed, 32 insertions, 0 deletions
diff --git a/README b/README
new file mode 100644
index 0000000..3eb38b8
--- /dev/null
+++ b/README
@@ -0,0 +1,32 @@
+NAME
+ sctrace - Trace system calls
+
+SYNOPSIS
+ sctrace [-o trace-output-file] [-ft] (command | -0 command argv0) [argument] ...
+
+DESCRIPTION
+ sctrace starts the command specified in the command argument, with the
+ additional arguments specified in the argument arguments, and prints
+ information about all system calls it mades, to standard error (or the
+ file specified in the trace-output-file argument if the -o option is used).
+
+ sctrace will also print information about process termination, received signals,
+ and process suspension and continuation.
+
+OPTIONS
+ -0 This options specifies that the argv0 argument shall be inserted
+ immediately after the command argument. If this option is used, the
+ very first argument (typically called argv[0] in C programs) for the
+ trace process shall the string specified in the argv0 argument rather
+ than the command argument.
+
+ -f Recursively trace all new children and threads. This option implies -t.
+
+ -o trace-output-file
+ Write trace outputs to the file specified in the trace-output-file
+ argument.
+
+ -t Trace threads.
+
+SEE ALSO
+ ptrace(2), strace(1), ltrace(1)