| Juan Cespedes | 07461b6 | 1997-08-22 15:29:10 +0200 | [diff] [blame] | 1 | .\" Copyright (c) 1997 Juan Cespedes <cespedes@etsit.upm.es> |
| 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 |
| 9 | .I "[-d] [-o filename] command [arg ...]" |
| 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 |
| 24 | .I \-d |
| Juan Cespedes | 1afec69 | 1997-08-23 21:31:46 +0200 | [diff] [blame] | 25 | Increase the debugging level. |
| Juan Cespedes | 07461b6 | 1997-08-22 15:29:10 +0200 | [diff] [blame] | 26 | .TP |
| Juan Cespedes | 5e4455b | 1997-08-24 01:48:26 +0200 | [diff] [blame] | 27 | .I \-i |
| 28 | Print the instruction pointer at the time of the library call. |
| 29 | .TP |
| 30 | .I \-S |
| 31 | Display system calls as well as library calls |
| 32 | .TP |
| Juan Cespedes | 07461b6 | 1997-08-22 15:29:10 +0200 | [diff] [blame] | 33 | .I \-o filename |
| 34 | Write the trace output to the file |
| 35 | .I filename |
| 36 | rather than to stderr. |
| 37 | |
| 38 | .SH BUGS |
| 39 | At the moment, there are too many bugs to list here. |
| 40 | .PP |
| Juan Cespedes | 3268a16 | 1997-08-25 16:45:22 +0200 | [diff] [blame^] | 41 | If you like to report a bug, send a notice to the author, or use the |
| 42 | .BR bug(1) |
| 43 | program if you are under Debian GNU/Linux. |
| Juan Cespedes | 07461b6 | 1997-08-22 15:29:10 +0200 | [diff] [blame] | 44 | |
| 45 | .SH AUTHOR |
| 46 | Juan Cespedes <cespedes@etsit.upm.es> |
| 47 | |
| 48 | .SH "SEE ALSO" |
| 49 | .BR strace(1) , |
| 50 | .BR ptrace(2) |
| 51 | |