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