trpt(1M)                                                    trpt(1M)


       NAME
             trpt - transliterate protocol trace

       SYNOPSIS
             trpt [-afjst] [-p pcb_addr] [system [core]]

       DESCRIPTION
             The trpt command interrogates the buffer of TCP trace records
             created when a socket is marked for debugging [see SO_DEBUG in
             getsockopt(3N)], and prints a readable description of these
             records.

          Files
             /stand/unix
             /dev/kmem

          Diagnostics
             no namelist    The system image does not contain the proper
                            symbols to find the trace buffer.

       USAGE
             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.

             -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 additional 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.




                           Copyright 1994 Novell, Inc.               Page 1

      trpt(1M)                                                    trpt(1M)


            -p pcb_addr    Show only trace records associated with the
                           protocol control block, with address: pcb_addr.
                           The pcb_addr address can be gotten from the PCB
                           field of netstat -A command output.  See below
                           for more information.

            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(1M).  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.

      REFERENCES
            getsockopt(3N), inetd(1M), netstat(1M)

























                          Copyright 1994 Novell, Inc.               Page 2