version 1.4, 2013/09/12 09:27:27 |
version 1.5, 2014/04/04 21:34:47 |
|
|
.Nm ltrace |
.Nm ltrace |
.Op Fl ai |
.Op Fl ai |
.Op Fl f Ar trfile |
.Op Fl f Ar trfile |
|
.Op Fl t Ar trstr |
.Op Fl u Ar trspec |
.Op Fl u Ar trspec |
.Ar command |
.Ar command |
.Sh DESCRIPTION |
.Sh DESCRIPTION |
|
|
.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 Fl t Ar trstr |
|
The string argument represents the kernel trace points, one per letter. |
|
The default flags are |
|
.Cm c , |
|
.Cm e , |
|
.Cm i , |
|
.Cm n , |
|
.Cm s , |
|
.Cm t , |
|
and |
|
.Cm u . |
|
The following table equates the letters with the tracepoints: |
|
.Pp |
|
.Bl -tag -width flag -offset indent -compact |
|
.It Cm c |
|
trace system calls |
|
.It Cm e |
|
trace emulation changes |
|
.It Cm i |
|
trace I/O |
|
.It Cm n |
|
trace namei translations |
|
.It Cm s |
|
trace signal processing |
|
.It Cm t |
|
trace various structures |
|
.It Cm u |
|
trace user data coming from |
|
.Xr utrace 2 |
|
.It Cm w |
|
trace context switch points |
|
.It Cm + |
|
trace the default points |
|
.Pq everything but context switch points |
|
.El |
.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 |
|
|
Trace all the shared library function calls with names starting |
Trace all the shared library function calls with names starting |
.Qq fmt : |
.Qq fmt : |
.Dl $ ltrace -u \(dq:fmt*\(dq wc -lh /etc/motd |
.Dl $ ltrace -u \(dq:fmt*\(dq wc -lh /etc/motd |
|
.Pp |
|
Trace all shared library function calls, as well as all system calls: |
|
.Dl $ ltrace -t cu wc -lh /etc/motd |
.Sh SEE ALSO |
.Sh SEE ALSO |
.Xr kdump 1 , |
.Xr kdump 1 , |
.Xr ktrace 1 , |
.Xr ktrace 1 , |
.Xr ktrace 2 , |
.Xr ktrace 2 , |
.Xr utrace 2 |
.Xr utrace 2 |
|
.Sh HISTORY |
|
The |
|
.Nm ltrace |
|
command appeared in |
|
.Ox 5.4 . |