README revision e4c829f9fcd3bcb3bc46c7fc078b486dfce2905b 
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	i[4567]86-*-linux-gnu
28	ia64-*-linux-gnu
29	m68k-*-linux-gnu
30	mips-*-linux-gnu
31	powerpc-*-linux-gnu
32	powerpc64-*-linux-gnu
33	s390-*-linux-gnu
34	s390x-*-linux-gnu
35	x86_64-*-linux-gnu
36
37The following systems were supported at some point in past, but
38current status is unknown:
39
40	sparc*-*-linux-gnu
41	sparc64*-*-linux-gnu
42	alpha*-*-linux-gnu
43
44Support of the following systems is known to be broken and requires
45fixing:
46
47	arm-*-linux-gnueabi
48
49
50Bug Reports
51-----------
52
53You can send bug reports to <ltrace-devel@lists.alioth.debian.org>.
54User requests can also be directed to that address.
55
56If the ltrace package that you are using came with your operating
57system, please be sure to reproduce the problem in unmodified upstream
58version of ltrace before reporting a bug.
59
60
61Development
62-----------
63
64ltrace development is hosted by Alioth.Debian.org:
65
66  https://alioth.debian.org/projects/ltrace/
67
68Release tarballs can be downloaded here:
69
70  https://alioth.debian.org/frs/?group_id=30892
71
72Anonymous GIT access is available via:
73
74  git://git.debian.org/git/collab-maint/ltrace.git
75
76If you have anything to contribute, please send an e-mail to
77<ltrace-devel@lists.alioth.debian.org>, and attach your patches
78formatted with git format-patch.  This makes them easy to apply after
79review, and such patches also preserve authorship.
80
81If you intend to work on a feature (essentially anything beyond a
82quick one-liner), it is advisable to send an e-mail beforehand.
83
84
85-------------------------------------------------------------------------------
86Copyright (C) 2012 Petr Machata <pmachata@redhat.com>
87Copyright (C) 1997-2009 Juan Cespedes <cespedes@debian.org>
88This file is part of ltrace.
89
90ltrace is free software; you can redistribute it and/or modify it
91under the terms of the GNU General Public License as published by the
92Free Software Foundation; either version 2 of the License, or (at your
93option) any later version.
94
95ltrace is distributed in the hope that it will be useful, but WITHOUT
96ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
97FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
98for more details.
99
100You should have received a copy of the GNU General Public License
101along with this program.  If not, see <http://www.gnu.org/licenses/>.
102