This is strace 4.0, a system call tracer for SunOS 4.x, Linux, System
V release 4, Solaris 2.x and Irix 5.x.  strace is released under a
Berkeley-style license at the request of Paul Kranenburg; see the file
COPYRIGHT for details.

Read the INSTALL file for generic instructions on how to install
strace.  If configure cannot guess your system configuration, you can
specify it on the command line after the other options like this:

	./configure --prefix=/usr i486-linux

A single sunos4.1 binary should work on all the sun4, sun4c and sun4m
kernel architectures.  Let me know if sun4d doesn't work.  Other
i486-*-sysv4 systems may work with little or no tweaking.

See the file NEWS for information on what has changed in recent
versions.

See the file PORTING if you like strace but it doesn't work on an
operating system you use frequently.

See the file CREDITS to see who has contributed to strace.

See the file TODO if you feel like helping out.

You can get the latest version of strace from its homepage at
http://sourceforge.net/projects/strace/ .

Please send bug reports and enhancements to the strace
mailinglist at strace-devel@lists.sourceforge.net, or directly to
Wichert Akkerman <wakkerma@debian.org>

Strace on Android

The Android port of Strace does not use the configure scripts or Makefiles
from the original source distribution.

Build Strace on Android using the Android build system, like the rest
of the system.

Android-specific customizations are immortalized in Android.patch to
ease future upgrades.

This file can be regenerated using:

diff -r -u -d path-to-original-unmodified-strace . | grep -v "Only in" > Android.patch

Strace has been ported by Branko Lankester <branko@hacktic.nl>
to run on Linux systems.  Since then it has been greatly modified
by various other people.

If you want to compile strace on a Linux system please make sure that
you use recent kernel headers. Strace needs those to get the proper data
structures and constatns used by the kernel, since these can be
different from the structures that the C library uses. Currently you
will need at least a 2.2.7 or newer kernel.

To complicate things a bit further strace might not compile if you are
using development kernels. These tend to have headers that conflict with
the headers from libc which makes it impossible to use them.

There are three ways to compile strace with other kernel headers:
* Specify the location in CFLAGS when running configure

     CFLAGS=-I/usr/src/linux/include ./configure

* you can tell make where your kernel sources are. For example if you
  have your kernelsource in /usr/src/linux, you can invoke make like
  this:

     make CFLAGS="\$CFLAGS -I/usr/src/linux/include"

  (the extra \$CFLAGS is there to make sure we don't override any CFLAGS
  settings that configure has found).

* you can link /usr/include/linux and /usr/include/asm to the
  corresponding directories in your kernel source-tree.