version 1.1, 2013/06/01 09:57:58 |
version 1.2, 2013/06/02 14:44:34 |
|
|
.It Fl i |
.It Fl i |
Inherit; pass the trace flags to all future children of the designated |
Inherit; pass the trace flags to all future children of the designated |
processes. |
processes. |
.It Ar command |
|
Execute |
|
.Ar command |
|
with the specified trace flags. |
|
.It Fl u Ar trspec |
.It Fl u Ar trspec |
Restrict the trace to a list of shared objects and/or function names, as |
Restrict the trace to a list of shared objects and/or function names, as |
specified by the |
specified by the |
|
|
argument. |
argument. |
The trace specification is a comma-separated list of library names, |
The trace specification is a comma-separated list of library names, |
followed by a colon |
followed by a colon |
.Pq : , and a comma-separated list of function names. |
.Pq :\& , |
|
and a comma-separated list of function names. |
Each list can be empty. |
Each list can be empty. |
Each list member may end up with a star |
Each list member may end with a star |
.Pq * |
.Pq * |
to only match the beginning of a name. |
to only match the beginning of a name. |
A leading bang at the beginning of a list turns it into a rejection list, |
A leading bang at the beginning of a list turns it into a rejection list, |
|
|
Library names are compared without their version number and |
Library names are compared without their version number and |
.Sq .so |
.Sq .so |
suffix. |
suffix. |
|
.It Ar command |
|
Execute |
|
.Ar command |
|
with the specified trace flags. |
.El |
.El |
.Sh FILES |
.Sh FILES |
.Bl -tag -width ktrace.out -compact |
.Bl -tag -width ktrace.outXXX -compact |
.It Pa ktrace.out |
.It Pa ktrace.out |
default ltrace dump file |
Default |
|
.Nm |
|
dump file. |
.El |
.El |
.Sh EXAMPLES |
.Sh EXAMPLES |
Trace all shared library function calls from |
Trace all shared library function calls from |
|
|
.Pa libc.so : |
.Pa libc.so : |
.Dl $ ltrace -u \(dq!libc\(dq wc -lh /etc/motd |
.Dl $ ltrace -u \(dq!libc\(dq wc -lh /etc/motd |
.Pp |
.Pp |
Trace all the shared library function calls which name start in |
Trace all the shared library function calls with names starting |
.Pq fmt : |
.Pq fmt : |
.Dl $ ltrace -u \(dq:fmt*\(dq wc -lh /etc/motd |
.Dl $ ltrace -u \(dq:fmt*\(dq wc -lh /etc/motd |
.Sh SEE ALSO |
.Sh SEE ALSO |