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