README revision f1bfe203f5f1c0e11a614f9d593a68406f5cb47e
1                                ltrace
2
3                       A Dynamic Library Tracer
4
5         Copyright 1997-2002 Juan Cespedes <cespedes@debian.org>
6
7
8Contents
9--------
10 0. Authors
11 1. Introduction
12 2. Where can I find it
13 3. How does it work
14 4. Where does it work
15 5. Bugs
16 6. License
17
18
190. Authors
20----------
21ltrace has been developed mainly by Juan Cespedes <cespedes@debian.org>,
22but he has received many contributions from other people.  The following
23people have contributed significantly to this project:
24
25* Pat Beirne <pbeirne@home.com> (ARM port)
26* Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de> (m68k port)
27* Morten Eriksen <mortene@sim.no> (misc fixes)
28* Silvio Cesare <silvio@big.net.au> (ELF hacking)
29* Timothy Fesig <slate@us.ibm.com> (S390 port)
30* Anton Blanchard <anton@linuxcare.com.au> (Powerpc port)
31
321. Introduction
33---------------
34ltrace is a debugging tool, similar to strace, but it traces library
35calls instead of system calls.
36
372. Where can I find it
38----------------------
39At the moment, it's only available as a Debian package.  Please let
40me know if you distribute it any other way.
41
42You may find it at:
43 * ftp://ftp.debian.org/debian/pool/main/l/ltrace/
44
45Alternatively, you may find it in any Debian mirror.  For more info,
46see ftp://ftp.debian.org/debian/README.mirrors
47
483. How does it work
49-------------------
50Using software breakpoints, just like gdb.
51
524. Where does it work
53---------------------
54At the time of writting, it works only with ELF32 executables. It only
55works in Linux, and it only works on i386, m68k, S/390 and ARM processors.
56
57It is part of at least Debian GNU/Linux, RedHat, SuSE and Mandrake.
58
595. Bugs
60-------
61Too many to list here :).  If you like to submit a bug report, or a
62feature request, either do that against the Debian `ltrace' package,
63or mail ``Juan Cespedes <cespedes@debian.org>''.
64
65This file is very incomplete and out-of-date.
66
676. License
68----------
69    Copyright (C) 1997-2002 Juan Cespedes <cespedes@debian.org>
70
71    This program is free software; you can redistribute it and/or modify
72    it under the terms of the GNU General Public License as published by
73    the Free Software Foundation; either version 2 of the License, or
74    (at your option) any later version.
75
76    This program is distributed in the hope that it will be useful,
77    but WITHOUT ANY WARRANTY; without even the implied warranty of
78    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
79    GNU General Public License for more details.
80
81    You should have received a copy of the GNU General Public License
82    along with this program; if not, write to the Free Software
83    Foundation, Inc., 59 Temple Place - Suite 330, Boston,
84    MA 02111-1307, USA.
85
86