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