Debian Codegraph @

upstream/debian-unstable/man1/sotruss.1

raw
1 .TH SOTRUSS "1" "May 2014" "sotruss" "User Commands"
2 .SH NAME
3 sotruss \- trace shared library calls through PLT
4 .SH SYNOPSIS
5 .B sotruss
6 [\fI\,OPTION\/\fR...] [\fI\,--\/\fR] \fI\,EXECUTABLE \/\fR[\fI\,EXECUTABLE-OPTION\/\fR...]
7 .SH DESCRIPTION
8 .B sotruss
9 is a small wrapper around
10 .B ld.so
11 that runs the specified
12 .I executable
13 until it exits. It intercepts and produce a trace of the dynamic library calls which
14 are called by the executed process via the Procedure Linkage Table (PLT). It
15 outputs the caller, the calle and the parameters as each call is executed.
16 .SH OPTIONS
17 .TP
18 \fB\-F\fR, \fB\-\-from\fR FROMLIST
19 Trace calls from objects on FROMLIST.
20 .TP
21 \fB\-T\fR, \fB\-\-to\fR TOLIST
22 Trace calls to objects on TOLIST.
23 .TP
24 \fB\-e\fR, \fB\-\-exit\fR
25 Also show exits from the function calls.
26 .TP
27 \fB\-f\fR, \fB\-\-follow\fR
28 Trace child processes as they are created by currently traced processes as a result of the
29 .BR fork(2)
30 system call.
31 .TP
32 \fB\-o\fR, \fB\-\-output\fR FILENAME
33 Write output to FILENAME (or FILENAME. in case
34 \fB\-f\fR is also used) instead of standard error.
35 .TP
36 \-?, \fB\-\-help\fR
37 Give this help list
38 .TP
39 \fB\-\-usage\fR
40 Give a short usage message
41 .TP
42 \fB\-\-version\fR
43 Print program version
44 .SH AUTHOR
45 Written by Ulrich Drepper.
46 .SH COPYRIGHT
47 Copyright \(co 2013 Free Software Foundation, Inc.
48 .br
49 This is free software; see the source for copying conditions. There is NO
50 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
51 .SH "SEE ALSO"
52 .BR ld.so(8).