shared library function call
ltrace enables shared library function
calls issued by the specified processes to be traced using the
user tracing facility. By default, call trace data is logged to the file
ktrace.out, unless overridden by the
-f option. Each function call is traced as a pair of
KTRFAC_USER entries; the first entry contains the
shared library containing the symbol being called, and the second entry
contains the symbol name.
Once tracing is enabled on a process, trace data will be logged until either the process exits or the trace point is cleared with ktrace(1). A traced process can generate enormous amounts of log data quickly; it is strongly suggested that users memorize how to disable tracing before attempting to trace a process. The following command is sufficient to disable tracing on all user owned processes and, if executed by root, all processes:
$ ktrace -C
The trace file is not human-readable; use kdump(1) to decode it.
The options are as follows:
- Append to the trace file instead of recreating it.
- Log trace records to trfile instead of ktrace.out.
- Inherit; pass the trace flags to all future children of the designated processes.
- The string argument represents the kernel trace points, one per letter.
The default is just
u. The following table equates the letters with the trace points:
- Restrict the trace to a list of shared objects and/or function names, as specified by the trspec argument. The trace specification is a comma-separated list of library names, followed by a colon (:), and a comma-separated list of function names. Each list can be empty. Each list member may end with a star (*) to only match the beginning of a name. An exclamation mark at the beginning of a list turns it into a rejection list, causing all unmatched names to be traced. Library names are compared without their version number and ‘.so’ suffix.
- Execute command with the specified trace flags.
Trace all shared library function calls from wc(1) reading the message of the day:
$ ltrace wc -lh /etc/motd
Trace only the shared library function calls in libutil.so:
$ ltrace -u libutil wc -lh /etc/motd
Trace all the shared library function calls but those in libc.so:
$ ltrace -u "!libc" wc -lh /etc/motd
Trace all the shared library function calls with names starting "fmt":
$ ltrace -u ":fmt*" wc -lh /etc/motd
Trace all shared library function calls, as well as all system calls:
$ ltrace -t cu wc -lh /etc/motd
kdump(1), ktrace(1), ktrace(2), utrace(2)
ltrace command appeared in