Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   16655 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

SOTRUSS(1)							    SOTRUSS(1)

NAME
       sotruss - trace shared library procedure calls

SYNOPSIS
       /usr/bin/sotruss [-f] [-F bindfromlist] [-T bindtolist]
	    [-o outputfile] executable [executable arguments...]

DESCRIPTION
       sotruss	executes  the  specified  command  and produces a trace of the
       library calls that it performs. Each line of the trace  output  reports
       what  bindings  are occurring between dynamic objects as each procedure
       call is executed. sotruss traces all of the procedure calls that	 occur
       between	dynamic objects via the Procedure Linkage Table, so only those
       procedure calls which are bound via the Procedure Linkage Table will be
       traced. See Linker and Libraries Guide

OPTIONS
       -F bindfromlist
			  A  colon-separated  list of libraries that are to be
			  traced.  Only calls from  these  libraries  will  be
			  traced.  The default is to trace calls from the main
			  executable only.

       -T bindtolist
			  A colon-separated list of libraries that are	to  be
			  traced.  Only	 calls	to  these  libraries  will  be
			  traced.  The default is to trace all calls.

       -o outputfile
			  sotruss output will be directed to  the  outputfile.
			  If  this option is combined with the	-f option then
			  the  pid of the executing program will be placed  at
			  the  end  of the filename. By default sotruss output
			  is placed on	stderr.

       -f
			  Follow all children created  by   fork()  and	 print
			  truss	 output	 on  each  child process.  This option
			  will also cause a  pid to be output  on  each	 truss
			  output line.

EXAMPLES
       Example 1 An example of sotruss.

       A simple example shows the tracing of a simple ls command:

	 % sotruss ls | more
	 ls	  ->	 libc.so.1:*atexit(0xef7d7d1c, 0x23c00, 0x0)
	 ls	  ->	 libc.so.1:*atexit(0x1392c, 0xef7d7d1c, 0xef621bb0)
	 ls	  ->	 libc.so.1:*setlocale(0x6, 0x1396c, 0xef621ba8)
	 ls	  ->	 libc.so.1:*textdomain(0x13970, 0x1396c, 0xef621ba8)
	 ls	  ->	 libc.so.1:*time(0x0, 0xef61f6fc, 0xef621ba8)
	 ls	  ->	 libc.so.1:*isatty(0x1, 0xef61f6fc, 0x0)
	 ls	  ->	 libc.so.1:*getopt(0x1, 0xeffff8fc, 0x13980)
	 ls	  ->	 libc.so.1:*malloc(0x100, 0x0, 0x0)
	 ls	  ->	 libc.so.1:*malloc(0x9000, 0x0, 0x0)
	 ls	  ->	 libc.so.1:*lstat64(0x23ee8, 0xeffff7a0, 0x0)
	 ...
	 ls	  ->	 libc.so.1:*printf(0x13a64, 0x26208, 0x23ef0)
	 ls	  ->	 libc.so.1:*printf(0x13a64, 0x26448, 0x23ef0)
	 ls	  ->	 libc.so.1:*exit(0x0, 0x24220, 0x2421c)

SEE ALSO
       ld.so.1(1), truss(1), whocalls(1), fork(2), attributes(5)

       Linker and Libraries Guide

				 May 12, 1997			    SOTRUSS(1)

Vote for polarhome