README
1This is strace 4.0, a system call tracer for SunOS 4.x, Linux, System
2V release 4, Solaris 2.x and Irix 5.x. strace is released under a
3Berkeley-style license at the request of Paul Kranenburg; see the file
4COPYRIGHT for details.
5
6Read the INSTALL file for generic instructions on how to install
7strace. If configure cannot guess your system configuration, you can
8specify it on the command line after the other options like this:
9
10 ./configure --prefix=/usr i486-linux
11
12A single sunos4.1 binary should work on all the sun4, sun4c and sun4m
13kernel architectures. Let me know if sun4d doesn't work. Other
14i486-*-sysv4 systems may work with little or no tweaking.
15
16See the file NEWS for information on what has changed in recent
17versions.
18
19See the file PORTING if you like strace but it doesn't work on an
20operating system you use frequently.
21
22See the file CREDITS to see who has contributed to strace.
23
24See the file TODO if you feel like helping out.
25
26You can get the latest version of strace from its homepage at
27http://sourceforge.net/projects/strace/ .
28
29Please send bug reports and enhancements to the strace
30mailinglist at strace-devel@lists.sourceforge.net, or directly to
31Wichert Akkerman <wakkerma@debian.org>
32
README-Android
1Strace on Android
2
3The Android port of Strace does not use the configure scripts or Makefiles
4from the original source distribution.
5
6Build Strace on Android using the Android build system, like the rest
7of the system.
8
9Android-specific customizations are immortalized in Android.patch to
10ease future upgrades.
11
12This file can be regenerated using:
13
14diff -r -u -d path-to-original-unmodified-strace . | grep -v "Only in" > Android.patch
15
README-linux
1
2Strace has been ported by Branko Lankester <branko@hacktic.nl>
3to run on Linux systems. Since then it has been greatly modified
4by various other people.
5
6If you want to compile strace on a Linux system please make sure that
7you use recent kernel headers. Strace needs those to get the proper data
8structures and constatns used by the kernel, since these can be
9different from the structures that the C library uses. Currently you
10will need at least a 2.2.7 or newer kernel.
11
12To complicate things a bit further strace might not compile if you are
13using development kernels. These tend to have headers that conflict with
14the headers from libc which makes it impossible to use them.
15
16There are three ways to compile strace with other kernel headers:
17* Specify the location in CFLAGS when running configure
18
19 CFLAGS=-I/usr/src/linux/include ./configure
20
21* you can tell make where your kernel sources are. For example if you
22 have your kernelsource in /usr/src/linux, you can invoke make like
23 this:
24
25 make CFLAGS="\$CFLAGS -I/usr/src/linux/include"
26
27 (the extra \$CFLAGS is there to make sure we don't override any CFLAGS
28 settings that configure has found).
29
30* you can link /usr/include/linux and /usr/include/asm to the
31 corresponding directories in your kernel source-tree.
32