README 3.2 KB
Newer Older
Petr Machata's avatar
Petr Machata committed
1 2
This directory contains sources of ltrace.  See the file configure.ac
to see what version this is.
Juan Céspedes's avatar
Juan Céspedes committed
3

Petr Machata's avatar
Petr Machata committed
4 5 6 7 8
Ltrace is a debugging program which runs a specified command until the
command exits.  While the command is executing, ltrace intercepts and
records both the dynamic library calls called by the executed process
and the signals received by the executed process.  Ltrace can also
intercept and print system calls executed by the process.
Juan Céspedes's avatar
Juan Céspedes committed
9

Petr Machata's avatar
Petr Machata committed
10
For general building and installation instructions, see the file INSTALL.
Juan Céspedes's avatar
Juan Céspedes committed
11

Petr Machata's avatar
Petr Machata committed
12
For list of authors and contributors, see the file CREDITS.
Juan Céspedes's avatar
Juan Céspedes committed
13

Petr Machata's avatar
Petr Machata committed
14
ltrace is free software.  See the file COPYING for license.
Juan Céspedes's avatar
Juan Céspedes committed
15

Petr Machata's avatar
Petr Machata committed
16 17
Some documentation on ltrace usage is given in the manual page, which
is in the file ltrace.1.
Juan Céspedes's avatar
Juan Céspedes committed
18

19

Petr Machata's avatar
Petr Machata committed
20 21
Supported Targets
-----------------
Juan Cespedes's avatar
Juan Cespedes committed
22

Petr Machata's avatar
Petr Machata committed
23 24 25
The following targets are currently (at least somewhat) supported.
Some of them may be more or less broken in reality, it is not feasible
to test each release comprehensively on each target.
26

Petr Machata's avatar
Petr Machata committed
27
	aarch64-*-linux-gnu
28 29
	armv6l-*-linux-gnueabi
	armv7l-*-linux-gnueabihf
Petr Machata's avatar
Petr Machata committed
30 31 32
	i[4567]86-*-linux-gnu
	ia64-*-linux-gnu
	m68k-*-linux-gnu
33
	metag-*-linux-uclibc
Petr Machata's avatar
Petr Machata committed
34 35 36
	mips-*-linux-gnu
	powerpc-*-linux-gnu
	powerpc64-*-linux-gnu
37
	powerpc64le-*-linux-gnu
Petr Machata's avatar
Petr Machata committed
38 39 40
	s390-*-linux-gnu
	s390x-*-linux-gnu
	x86_64-*-linux-gnu
Max Filippov's avatar
Max Filippov committed
41
	xtensa-*-linux-gnu
Juan Céspedes's avatar
Juan Céspedes committed
42

Petr Machata's avatar
Petr Machata committed
43 44
The following systems were supported at some point in past, but
current status is unknown:
Juan Cespedes's avatar
Juan Cespedes committed
45

Petr Machata's avatar
Petr Machata committed
46 47 48
	sparc*-*-linux-gnu
	sparc64*-*-linux-gnu
	alpha*-*-linux-gnu
Juan Céspedes's avatar
Juan Céspedes committed
49

Ian Wienand's avatar
Ian Wienand committed
50

Petr Machata's avatar
Petr Machata committed
51 52
Bug Reports
-----------
Juan Cespedes's avatar
Juan Cespedes committed
53

Petr Machata's avatar
Petr Machata committed
54 55
You can send bug reports to <ltrace-devel@lists.alioth.debian.org>.
User requests can also be directed to that address.
Juan Céspedes's avatar
Juan Céspedes committed
56

Petr Machata's avatar
Petr Machata committed
57 58 59
If the ltrace package that you are using came with your operating
system, please be sure to reproduce the problem in unmodified upstream
version of ltrace before reporting a bug.
60

Juan Céspedes's avatar
Juan Céspedes committed
61

Petr Machata's avatar
Petr Machata committed
62 63
Development
-----------
Juan Cespedes's avatar
Juan Cespedes committed
64

Petr Machata's avatar
Petr Machata committed
65
ltrace development is hosted by Alioth.Debian.org:
66

Petr Machata's avatar
Petr Machata committed
67
  https://alioth.debian.org/projects/ltrace/
Juan Céspedes's avatar
Juan Céspedes committed
68

Petr Machata's avatar
Petr Machata committed
69
Release tarballs can be downloaded here:
Juan Céspedes's avatar
Juan Céspedes committed
70

Petr Machata's avatar
Petr Machata committed
71
  https://alioth.debian.org/frs/?group_id=30892
Juan Céspedes's avatar
Juan Céspedes committed
72

Petr Machata's avatar
Petr Machata committed
73
Anonymous GIT access is available via:
Juan Céspedes's avatar
Juan Céspedes committed
74

Petr Machata's avatar
Petr Machata committed
75 76 77 78 79 80 81 82 83 84 85 86
  git://git.debian.org/git/collab-maint/ltrace.git

If you have anything to contribute, please send an e-mail to
<ltrace-devel@lists.alioth.debian.org>, and attach your patches
formatted with git format-patch.  This makes them easy to apply after
review, and such patches also preserve authorship.

If you intend to work on a feature (essentially anything beyond a
quick one-liner), it is advisable to send an e-mail beforehand.


-------------------------------------------------------------------------------
Petr Machata's avatar
Petr Machata committed
87
Copyright (C) 2012-2014 Petr Machata <pmachata@redhat.com>
Petr Machata's avatar
Petr Machata committed
88 89 90 91 92 93 94 95 96 97 98 99 100 101 102
Copyright (C) 1997-2009 Juan Cespedes <cespedes@debian.org>
This file is part of ltrace.

ltrace is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.

ltrace is distributed in the hope that it will be useful, but WITHOUT
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.