path: root/sctrace.1

.TH SCTRACE 1 SCTRACE
.SH NAME
sctrace - Trace system calls
.SH SYNOPSIS
.B sctrace
.RB [ -a
.IR byte-count ]
.RB [ -o
.IR trace-output-file ]
.RB [ -ft ]
.RI ( command " |"
.B -0
.I command
.IR argv0 )
.RI [ argument "] ..."
.SH DESCRIPTION
.B sctrace
starts the command specified in the
.I command
argument, with the additional arguments
specified in the
.I argument
arguments, and prints information about
all system calls it mades, to standard
error (or the file specified in the
.I trace-output-file
argument if the
.B -o
option is used).
.PP
.B sctrace
will also print information about process
termination, received signals, and process
suspension and continuation.
.SH OPTIONS
.TP
.B -0
This options specifies that the
.I argv0
argument shall be inserted immediately
after the
.I command
argument. If this option is used, the
very first argument (typically called
.I argv[0]
in C programs) for the trace process shall
the string specified in the
.I argv0
argument rather than the
.I command
argument.
.TP
.BR -a " "\fIbyte-count\fP
Limit the displayed number of bytes in any region
of uninterpreted memory (this excludes strings
and structures but includes file I/O) to
.I byte-count
bytes. The string
.B inf
is interpreted to remove previously applied limit.
.TP
.B -f
Recursively trace all new children and threads.
This option implies
.BR -t .
.TP
.BR -o " "\fItrace-output-file\fP
Write trace outputs to the file specified in the
.I trace-output-file
argument.
.TP
.B -t
Trace threads.
.SH "SEE ALSO"
.BR ptrace (2),
.BR strace (1),
.BR ltrace (1)