unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (SunOS-5.10)
Page:
Section:
Apropos / Subsearch:
optional field

sotruss(1)                       User Commands                      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 output-
                               file. 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)

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:


       tab()    allbox;    cw(2.750000i)|     cw(2.750000i)     lw(2.750000i)|
       lw(2.750000i).  ATTRIBUTE TYPEATTRIBUTE VALUE AvailabilitySUNWtoo


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

       Linker and Libraries Guide



SunOS 5.10                        12 May 1997                       sotruss(1)