README revision 948a5d077939939dc086c0d0d199ff2f22706eea 
1                                ltrace
2
3                       A Dynamic Library Tracer
4
5         Copyright 1997-2004 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@samba.org> (Powerpc port)
31* Jakub Jelinek <jakub@redhat.com> (SPARC port)
32* Jakub Bogusz <qboosh@pld-linux.org> (alpha port)
33* SuSE (amd64 port)
34
351. Introduction
36---------------
37ltrace is a debugging tool, similar to strace, but it traces library
38calls instead of system calls.
39
402. Where can I find it
41----------------------
42At the moment, it's only available as a Debian package.  Please let
43me know if you distribute it any other way.
44
45You may find it at:
46 * ftp://ftp.debian.org/debian/pool/main/l/ltrace/
47
48Alternatively, you may find it in any Debian mirror.  For more info,
49see ftp://ftp.debian.org/debian/README.mirrors
50
513. How does it work
52-------------------
53Using software breakpoints, just like gdb.
54
554. Where does it work
56---------------------
57At the time of writting, it works only with ELF32 executables. It only
58works in Linux, and it only works on some architectures (i386, m68k,
59S/390, ARM, PowerPC, amd64, SPARC and alpha processors).
60
61It is part of at least Debian GNU/Linux, RedHat, SuSE and Mandrake.
62
635. Bugs
64-------
65Too many to list here :).  If you like to submit a bug report, or a
66feature request, either do that against the Debian `ltrace' package,
67or mail ``Juan Cespedes <cespedes@debian.org>''.
68
69This file is very incomplete and out-of-date.
70
716. License
72----------
73    Copyright (C) 1997-2004 Juan Cespedes <cespedes@debian.org>
74
75    This program is free software; you can redistribute it and/or modify
76    it under the terms of the GNU General Public License as published by
77    the Free Software Foundation; either version 2 of the License, or
78    (at your option) any later version.
79
80    This program is distributed in the hope that it will be useful,
81    but WITHOUT ANY WARRANTY; without even the implied warranty of
82    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
83    GNU General Public License for more details.
84
85    You should have received a copy of the GNU General Public License
86    along with this program; if not, write to the Free Software
87    Foundation, Inc., 59 Temple Place - Suite 330, Boston,
88    MA 02111-1307, USA.
89
90