TRPT(8c,C)                  AIX TCP/IP User's Guide                  TRPT(8c,C)



-------------------------------------------------------------------------------
trpt



PURPOSE

Transliterates protocol trace.

SYNTAX


        +----------------------------------+   +----------+   +------- -
trpt ---| +--------+   +-----------------+ |---|          |---|      - - - |
        +-| +----+ |---|                 |-+   +- system -+   +- c o v .   -+
          +-| -a |-+   +- -p hexaddress -+
           ^| -s ||
           || -t ||
           || -f ||
           || -j ||
           |+----+|
           +------+


DESCRIPTION

The trpt interrogates the buffer of TCP trace records created when a socket is
marked for debugging (see setsockopt in the AIX Operating System Technical
Reference.) 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 (PCF).  The
following options may be used to alter this behavior.

FLAGS

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

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

-t     Prints the values for all timers at each point in the trace.

-f     Follows the trace as it occurs, waiting a short time for additiona l
       records each time the end of the log is reached.

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

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




Processed October 29, 1990        TRPT(8c,C)                                  1

TRPT(8c,C)                  AIX TCP/IP User's Guide                  TRPT(8c,C)



The recommended use of the trpt is as follows:

  o Isolates the problem and enables debugging on the socket(s) involved in the
    connection.

  o Finds the address of the protocol control blocks associated with the
    sockets using the netstat -a option.  For more information, see "netstat."

  o Run the trpt command 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 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.

MESSAGES

no namelist

Explanation:  When the system image doesn't contain the proper symbols to find
t trace buffer.

FILES

/unix
/dev/kmem

RELATED INFORMATION

In this book:  "netstat"
setsockopt, refer to the AIX Operating System Technical Reference.
trsp, refer to the AIX Operating System Commands Reference



















Processed October 29, 1990        TRPT(8c,C)                                  2