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