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