unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

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

TRPT(8C)                                                              TRPT(8C)



NAME
       trpt - transliterate protocol trace

SYNOPSIS
       /usr/etc/trpt [ -afjst ] [ -phex-address] [ system [ core ] ]

DESCRIPTION
       trpt interrogates the buffer of TCP trace records created when a socket
       is marked for "debugging" (see getsockopt(2)), and  prints  a  readable
       description  of  these  records.   When  no  options are supplied, trpt
       prints all the trace records found in the system grouped  according  to
       TCP connection protocol control block (PCB).  The following options may
       be used to alter this behavior.

OPTIONS
       -a     In addition to the normal output, print the values of the source
              and destination addresses for each packet recorded.

       -f     Follow  the  trace  as it occurs, waiting a short time for addi-
              tional records each time the end of the log is reached.

       -j     Just give a list of the protocol  control  block  addresses  for
              which there are trace records.

       -s     In  addition  to the normal output, print a detailed description
              of the packet sequencing information.

       -t     In addition to the normal  output,  print  the  values  for  all
              timers at each point in the trace.

       -p hex-address
              Show  only  trace  records  associated with the protocol control
              block, the address of which follows.

       The recommended use of trpt is as follows.   Isolate  the  problem  and
       enable debugging on the socket(s) involved in the connection.  Find the
       address of the protocol control  blocks  associated  with  the  sockets
       using  the -A option to netstat(8C).  Then run trpt with the -p option,
       supplying the associated protocol  control  block  addresses.   The  -f
       option  can  be used to follow the trace log once the trace is located.
       If there are many sockets using the debugging option, the -j option may
       be  useful  in checking to see if any trace records are present for the
       socket in question.

       If debugging is being performed on a system or core file other than the
       default, the last two arguments may be used to supplant the defaults.

FILES
       /vmunix
       /dev/kmem

SEE ALSO
       getsockopt(2), netstat(8C)

DIAGNOSTICS
       no namelist    When  the  system image does not contain the proper sym-
                      bols to find the trace buffer; others  which  should  be
                      self explanatory.

BUGS
       Should  also  print  the data for each input or output, but this is not
       saved in the trace record.

       The output format is inscrutable and should be described here.



4.2 Berkeley Distribution      9 September 1987                       TRPT(8C)