blob: 281a2c5c8b754bf9381962a586bc754458b7a539 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
.\" Copyright (c) 1997 Juan Cespedes <cespedes@debian.org>
.\" This file is covered by the GNU GPL
.TH ltrace 1
.SH NAME
ltrace \- A library call tracer
.SH SYNOPSIS
.B ltrace
.I "[-difLS] [-a column] [-s strsize] [-o filename] [-u username] [-p pid] ... [command [arg ...]]"
.SH DESCRIPTION
.B ltrace
is a program that simply runs the specified
.I command
until it exits. It intercepts and records the dynamic library calls
which are called by the executed process and the signals which are
received by that process.
.PP
Its use is very similar to
.BR strace(1) .
.SH OPTIONS
.TP
.I \-d
Increase the debugging level.
.TP
.I \-i
Print the instruction pointer at the time of the library call.
.TP
.I \-f
Trace child processes as they are created by
currently traced processes as a result of the fork(2)
or clone(2) system calls.
The new process is attached as soon as its pid is known.
.TP
.I \-L
DON'T display library calls (use it with the
.I \-S
option).
.TP
.I \-S
Display system calls as well as library calls
.TP
.I \-a column
Align return values in a secific column (default column 50).
.TP
.I \-s
Specify the maximum string size to print (the default is 32).
.TP
.I \-o filename
Write the trace output to the file
.I filename
rather than to stderr.
.TP
.I \-u username
Run command with the userid, groupid and supplementary groups of
.IR username .
This option is only useful when running as root and enables the
correct execution of setuid and/or setgid binaries.
.TP
.I \-p pid
Attach to the process with the process ID
.I pid
and begin tracing.
.SH BUGS
At the moment, there are too many bugs to list here.
.PP
If you like to report a bug, send a notice to the author, or use the
.BR bug(1)
program if you are under Debian GNU/Linux.
.SH FILES
.TP
.I /etc/ltrace.conf
System configuration file
.TP
.I ~/.ltrace.conf
Personal config file, overrides
.I /etc/ltrace.conf
.SH AUTHOR
Juan Cespedes <cespedes@debian.org>
.SH "SEE ALSO"
.BR strace(1) ,
.BR ptrace(2)
|
