aboutsummaryrefslogtreecommitdiff
path: root/README
blob: 02b1c91953e63a058f127a9349c2a3229d5b39df (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
                                ltrace

                       A Dynamic Library Tracer

         Copyright 1997-2006 Juan Cespedes <cespedes@debian.org>


Contents
--------
 0. Authors
 1. Introduction
 2. Where can I find it
 3. How does it work
 4. Where does it work
 5. Bugs
 6. License


0. Authors
----------
ltrace has been developed mainly by Juan Cespedes <cespedes@debian.org>,
but he has received many contributions from other people.  The following
people have contributed significantly to this project:

* Pat Beirne <pbeirne@home.com> (ARM port)
* Roman Hodek <Roman.Hodek@informatik.uni-erlangen.de> (m68k port)
* Morten Eriksen <mortene@sim.no> (misc fixes)
* Silvio Cesare <silvio@big.net.au> (ELF hacking)
* Timothy Fesig <slate@us.ibm.com> (S390 port)
* Anton Blanchard <anton@samba.org> (Powerpc port)
* Jakub Jelinek <jakub@redhat.com> (SPARC port, support for libelf, many fixes)
* Jakub Bogusz <qboosh@pld-linux.org> (alpha port)
* SuSE (amd64 port)
* Ian Wienand <ianw@gelato.unsw.edu.au> (ia64 port)

1. Introduction
---------------
ltrace is a debugging tool, similar to strace, but it traces library
calls instead of system calls.

2. Where can I find it
----------------------
At the moment, it's only available as a Debian package.  Please let
me know if you distribute it any other way.

You may find it at:
 * ftp://ftp.debian.org/debian/pool/main/l/ltrace/

Alternatively, you may find it in any Debian mirror.  For more info,
see ftp://ftp.debian.org/debian/README.mirrors

You can also retreive the source via CVS, see

http://ltrace.alioth.debian.org

3. How does it work
-------------------
Using software breakpoints, just like gdb.

4. Where does it work
---------------------
At the time of writting, it works only with ELF32 executables. It only
works in Linux, and it only works on some architectures (i386, m68k,
S/390, ARM, PowerPC, amd64, SPARC and alpha processors).

It is part of at least Debian GNU/Linux, RedHat, SuSE and Mandrake.

5. Bugs
-------
Too many to list here :).  If you like to submit a bug report, or a
feature request, plase do that against the Debian `ltrace' package

This file is very incomplete and out-of-date.

6. License
----------
    Copyright (C) 1997-2006 Juan Cespedes <cespedes@debian.org>

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 59 Temple Place - Suite 330, Boston,
    MA 02111-1307, USA.