| 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). |