unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (4.2BSD)
Page:
Section:
Apropos / Subsearch:
optional field

TRPT(8C)                                                              TRPT(8C)



NAME
       trpt - transliterate protocol trace

SYNOPSIS
       trpt  [ -a ] [ -s ]  [ -t ] [ -j ] [ -p hex-address ] [ system [ core ]
       ]

DESCRIPTION
       Trpt interrogates the buffer of TCP trace records created when a socket
       is  marked  for  "debugging" (see setsockopt(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.

       -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,

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

       -p     show only trace records associated  with  the  protocol  control
              block who's address follows,

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

       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(1).  Then run trpt with the -p option,
       supplying the associated protocol control block  addresses.   If  there
       are  many sockets using the debugging option, the -j option may be use-
       ful 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
       setsockopt(2), netstat(1)

DIAGNOSTICS
       ``no namelist'' when the system image doesn't 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 race record.

       The output format is inscrutable and should be described here.



4th Berkeley Distribution        2 March 1983                         TRPT(8C)