README
1This directory contains sources of ltrace. See the file configure.ac
2to see what version this is.
3
4Ltrace is a debugging program which runs a specified command until the
5command exits. While the command is executing, ltrace intercepts and
6records both the dynamic library calls called by the executed process
7and the signals received by the executed process. Ltrace can also
8intercept and print system calls executed by the process.
9
10For general building and installation instructions, see the file INSTALL.
11
12For list of authors and contributors, see the file CREDITS.
13
14ltrace is free software. See the file COPYING for license.
15
16Some documentation on ltrace usage is given in the manual page, which
17is in the file ltrace.1.
18
19
20Supported Targets
21-----------------
22
23The following targets are currently (at least somewhat) supported.
24Some of them may be more or less broken in reality, it is not feasible
25to test each release comprehensively on each target.
26
27 aarch64-*-linux-gnu
28 armv6l-*-linux-gnueabi
29 armv7l-*-linux-gnueabihf
30 i[4567]86-*-linux-gnu
31 ia64-*-linux-gnu
32 m68k-*-linux-gnu
33 metag-*-linux-uclibc
34 mips-*-linux-gnu
35 powerpc-*-linux-gnu
36 powerpc64-*-linux-gnu
37 s390-*-linux-gnu
38 s390x-*-linux-gnu
39 x86_64-*-linux-gnu
40
41The following systems were supported at some point in past, but
42current status is unknown:
43
44 sparc*-*-linux-gnu
45 sparc64*-*-linux-gnu
46 alpha*-*-linux-gnu
47
48
49Bug Reports
50-----------
51
52You can send bug reports to <ltrace-devel@lists.alioth.debian.org>.
53User requests can also be directed to that address.
54
55If the ltrace package that you are using came with your operating
56system, please be sure to reproduce the problem in unmodified upstream
57version of ltrace before reporting a bug.
58
59
60Development
61-----------
62
63ltrace development is hosted by Alioth.Debian.org:
64
65 https://alioth.debian.org/projects/ltrace/
66
67Release tarballs can be downloaded here:
68
69 https://alioth.debian.org/frs/?group_id=30892
70
71Anonymous GIT access is available via:
72
73 git://git.debian.org/git/collab-maint/ltrace.git
74
75If you have anything to contribute, please send an e-mail to
76<ltrace-devel@lists.alioth.debian.org>, and attach your patches
77formatted with git format-patch. This makes them easy to apply after
78review, and such patches also preserve authorship.
79
80If you intend to work on a feature (essentially anything beyond a
81quick one-liner), it is advisable to send an e-mail beforehand.
82
83
84-------------------------------------------------------------------------------
85Copyright (C) 2012-2014 Petr Machata <pmachata@redhat.com>
86Copyright (C) 1997-2009 Juan Cespedes <cespedes@debian.org>
87This file is part of ltrace.
88
89ltrace is free software; you can redistribute it and/or modify it
90under the terms of the GNU General Public License as published by the
91Free Software Foundation; either version 2 of the License, or (at your
92option) any later version.
93
94ltrace is distributed in the hope that it will be useful, but WITHOUT
95ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
96FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
97for more details.
98
99You should have received a copy of the GNU General Public License
100along with this program. If not, see <http://www.gnu.org/licenses/>.
101
README.version