install

linux下的多线程调试工具

=============================================================================

                        PTT - Installation guide

=============================================================================

  1) downloading glibc source
  2) buildind the instrumented NPTL
  3) building PTT tools
  4) cross compilation

=============================================================================
  1) downloading glibc source
=============================================================================

Check the version of the current glibc installed on your system:
$ getconf GNU_LIBC_VERSION
We provide patches for glibc 2.3.4 to 2.3.6 and an experimental patch for
glibc 2.4. We strongly advice you to upgrade your glibc if it is an older
version and if you want to use PTT.

Get the corresponding glibc source at http://ftp.gnu.org/gnu/glibc. From now,
I assume you got glibc-2.3.6.tar.bz2 from this web site. Adapt the following
commands if you got an other glibc version.

Unpack this source and create the directory where you will build the glibc.
For example, assuming the current pwd is $GLIBC:
$ ls
glibc-2.3.6.tar.bz2
$ bunzpi2 glibc-2.3.6.tar.bz2
$ tar -xvf glibc-2.3.6.tar
$ mv glibc-2.3.6 src

=============================================================================
  2) buildind the instrumented NPTL
=============================================================================

The following step of the installation process consists in building 2 NPTL
dynamic libraries (libpthread.so.0) from glibc source:
* the original libpthread
* an instrumented libpthread for using with PTT (this is done by using the
  --with-ptt option of the patched glibc configure script)

Go to the patch_glibc directory of PTT source and run the install_glibc.sh
script with the following arguments:
* directory where you want to build the glibc
* glibc source directory
* patch to apply to the glibc (possible patches are in the patch_glibc
  directory. Choose the one which corresponds to your glibc version).
* you can optionally specify the arguments [-j jobs]:
  This is the number of jobs make will run simultaneously when building the
  glibc (useful for SMP hardware).
* following arguments will be directly passed to the glibc configure script
  (useful for cross-compilation - see section 4)

Assuming $PTT is the PTT source directory:
$ cd $PTT/patch_glibc
$ ./install_glibc.sh $GLIBC $GLIBC/src ptt_glibc-2.3.6.patch

install_glibc.sh will perform the following tasks:
* create $GLIBC/patched_src with patched glibc source
* create $GLIBC/build directory to build the glibc (as recommended in the
  glibc INSTALL guidelines)
* build the patched glibc (--with-ptt option), installing libraries in
  $GLIBC/libc_root/lib
* rename $GLIBC/libc_root/lib/libpthread* in
  $GLIBC/libc_root/lib/libpthread_ptt*
* build the original glibc, installing libraries in $GLIBC/libc_root/lib
* copy $GLIBC/libc_root/lib/libpthread.so.0 in $PTT/lib/libpthread.so
* copy $GLIBC/libc_root/lib/libpthread_ptt.so.0 in $PTT/lib/libpthread_ptt.so

This can take a long time because the glibc needs to be compiled twice !

=============================================================================
  3) building PTT tools
=============================================================================

PTT tools (PTT daemon and trace file decoder) installation is based on
autoconf/automake. Assuming you want to install these tools in the $INSTALL
directory, use the following commands:
$ cd $PTT
$ ./configure --prefix=$INSTALL
$ make
$ make install

This will install PTT binaries in $INSTALL/bin, PTT man pages in $INSTALL/man
and copy the 2 NPTL dynamic librairies ($PTT/lib/libpthread.so and
$PTT/lib/libpthread_ptt.so) in $INSTALL/lib. To keep a better control on the
installation directories, use the traditional configure options.

Note: You can run the PTT test suite with 'make check' just after 'make'.

=============================================================================
  4) cross compilation
=============================================================================

To cross compile PTT tools, select your build, host and target system in
the configure script. You also need to cross compile the glibc. This is done
by using optional parameters of install_glibc.sh; these parameters are
passed to the glibc configure script. For example:

$ cd $PTT/patch_glibc
$ ./install_glibc.sh $GLIBC $GLIBC/src ptt_glibc-2.3.6.patch \
--host=powerpc64-unknown-linux-gnu
$ cd $PTT
$ ./configure --prefix=$INSTALL --host=powerpc64-unknown-linux-gnu
$ make
$ make install