summaryrefslogtreecommitdiffstats
path: root/upstream/debian-bookworm/man1/sotruss.1
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-bookworm/man1/sotruss.1')
-rw-r--r--upstream/debian-bookworm/man1/sotruss.152
1 files changed, 52 insertions, 0 deletions
diff --git a/upstream/debian-bookworm/man1/sotruss.1 b/upstream/debian-bookworm/man1/sotruss.1
new file mode 100644
index 00000000..0705652a
--- /dev/null
+++ b/upstream/debian-bookworm/man1/sotruss.1
@@ -0,0 +1,52 @@
+.TH SOTRUSS "1" "May 2014" "sotruss" "User Commands"
+.SH NAME
+sotruss \- trace shared library calls through PLT
+.SH SYNOPSIS
+.B sotruss
+[\fI\,OPTION\/\fR...] [\fI\,--\/\fR] \fI\,EXECUTABLE \/\fR[\fI\,EXECUTABLE-OPTION\/\fR...]
+.SH DESCRIPTION
+.B sotruss
+is a small wrapper around
+.B ld.so
+that runs the specified
+.I executable
+until it exits. It intercepts and produce a trace of the dynamic library calls which
+are called by the executed process via the Procedure Linkage Table (PLT). It
+outputs the caller, the calle and the parameters as each call is executed.
+.SH OPTIONS
+.TP
+\fB\-F\fR, \fB\-\-from\fR FROMLIST
+Trace calls from objects on FROMLIST.
+.TP
+\fB\-T\fR, \fB\-\-to\fR TOLIST
+Trace calls to objects on TOLIST.
+.TP
+\fB\-e\fR, \fB\-\-exit\fR
+Also show exits from the function calls.
+.TP
+\fB\-f\fR, \fB\-\-follow\fR
+Trace child processes as they are created by currently traced processes as a result of the
+.BR fork(2)
+system call.
+.TP
+\fB\-o\fR, \fB\-\-output\fR FILENAME
+Write output to FILENAME (or FILENAME. in case
+\fB\-f\fR is also used) instead of standard error.
+.TP
+\-?, \fB\-\-help\fR
+Give this help list
+.TP
+\fB\-\-usage\fR
+Give a short usage message
+.TP
+\fB\-\-version\fR
+Print program version
+.SH AUTHOR
+Written by Ulrich Drepper.
+.SH COPYRIGHT
+Copyright \(co 2013 Free Software Foundation, Inc.
+.br
+This is free software; see the source for copying conditions. There is NO
+warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
+.SH "SEE ALSO"
+.BR ld.so(8).