X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=README;h=a04b767ec51555d330ab0d52877969ee3216fcc8;hb=3c02f3967d49caad8d605484f8fbe5a6c1585eaa;hp=ab1a2e53ef1f7d764f6b8681b62d77d45f3eb69d;hpb=59749d048d9e452f049f9151735b5256756919c3;p=platform%2Fupstream%2Fltrace.git diff --git a/README b/README index ab1a2e5..a04b767 100644 --- a/README +++ b/README @@ -1,92 +1,100 @@ - ltrace +This directory contains sources of ltrace. See the file configure.ac +to see what version this is. - A Dynamic Library Tracer +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. - Copyright 1997-2009 Juan Cespedes +For general building and installation instructions, see the file INSTALL. +For list of authors and contributors, see the file CREDITS. -Contents --------- - 0. Authors - 1. Introduction - 2. Where can I find it - 3. How does it work - 4. Where does it work - 5. Bugs - 6. License +ltrace is free software. See the file COPYING for license. +Some documentation on ltrace usage is given in the manual page, which +is in the file ltrace.1. -0. Authors ----------- -ltrace has been developed mainly by Juan Cespedes , -but he has received many contributions from other people. The following -people have contributed significantly to this project: +Supported Targets +----------------- -* César Sánchez -* Santiago Romero -* Pat Beirne (ARM port) -* Roman Hodek (m68k port) -* Morten Eriksen (misc fixes) -* Silvio Cesare (ELF hacking) -* Timothy Fesig (S390 port) -* Anton Blanchard (Powerpc port) -* Jakub Jelinek (SPARC port, support for libelf, many fixes) -* Jakub Bogusz (alpha port) -* SuSE (amd64 port) -* Ian Wienand (IA64 port) -* Eric Vaitl (mipsel port) -* Petr Machata (misc fixes) +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. -1. Introduction ---------------- + aarch64-*-linux-gnu + armv6l-*-linux-gnueabi + armv7l-*-linux-gnueabihf + i[4567]86-*-linux-gnu + ia64-*-linux-gnu + m68k-*-linux-gnu + metag-*-linux-uclibc + mips-*-linux-gnu + powerpc-*-linux-gnu + powerpc64-*-linux-gnu + s390-*-linux-gnu + s390x-*-linux-gnu + x86_64-*-linux-gnu -ltrace is a debugging tool, similar to strace, but it traces library -calls instead of system calls. +The following systems were supported at some point in past, but +current status is unknown: -2. Where can I find it ----------------------- + sparc*-*-linux-gnu + sparc64*-*-linux-gnu + alpha*-*-linux-gnu -http://www.ltrace.org -3. How does it work -------------------- +Bug Reports +----------- -Using software breakpoints, just like gdb. +You can send bug reports to . +User requests can also be directed to that address. -4. Where does it work ---------------------- +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. -It works with ELF based Linux systems running on i386, m68k, S/390, -ARM, PowerPC, PowerPC64, IA64, AMD64, SPARC and Alpha processors. -It is part of at least Debian GNU/Linux, RedHat, SuSE, Mandrake... +Development +----------- -5. Bugs -------- +ltrace development is hosted by Alioth.Debian.org: -Too many to list here :). If you like to submit a bug report, or a -feature request, either do that against the Debian `ltrace' package, -or mail ltrace-devel@lists.alioth.debian.org. + https://alioth.debian.org/projects/ltrace/ -This file is very incomplete and out-of-date. +Release tarballs can be downloaded here: -6. License ----------- + https://alioth.debian.org/frs/?group_id=30892 - Copyright (C) 1997-2009 Juan Cespedes +Anonymous GIT access is available via: - This program 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. + git://git.debian.org/git/collab-maint/ltrace.git - This program 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. +If you have anything to contribute, please send an e-mail to +, and attach your patches +formatted with git format-patch. This makes them easy to apply after +review, and such patches also preserve authorship. - You should have received a copy of the GNU General Public License along - with this program; if not, write to the Free Software Foundation, Inc., - 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. +If you intend to work on a feature (essentially anything beyond a +quick one-liner), it is advisable to send an e-mail beforehand. + +------------------------------------------------------------------------------- +Copyright (C) 2012-2014 Petr Machata +Copyright (C) 1997-2009 Juan Cespedes +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 .