Index for Section 8

Alphabetical listing for T

Bottom of page

trpt(8)
NAME
  trpt - Transliterates protocol trace

SYNOPSIS
  trpt [-afjst] [-p address]

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

  -f  Follows the trace as it occurs, waiting briefly for additional records
      each time the end of the log is reached.

  -j  Lists the protocol control block addresses for which trace records
      exist. See DESCRIPTION for more information.

  -p address
      Shows only trace records associated with the protocol control block
      specified in hexadecimal by the address variable.

      You must include a space between the -p option and the address variable
      when you specify this option.

  -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, in
      addition to the normal output.

DESCRIPTION
  The trpt command, used for debugging sockets, queries the buffer of
  Transmission Control Protocol (TCP) trace records. The TCP trace record
  buffer is created when a socket is marked for debugging with the
  setsockopt(2) subroutine. The trpt command queries the buffer and then
  prints a description of the trace records.

  When you specify no options, the trpt command prints all the trace records
  found in the system and groups them according to their TCP/IP connection
  Protocol Control Block (PCB).

  If you are debugging a system file other than the default, the system
  argument can be used to replace the default.

  Before you can use the trpt command, you must do the following:

   1.  Isolate the problem and mark for debugging the socket or sockets
       involved in the connection.

   2.  Find the address of the protocol control blocks associated with these
       sockets by using the netstat -aA command.

   3.  Then, you can run the trpt command, using the -p option to supply the
       associated protocol control block addresses. You can specify multiple
       -p address options with a single trpt command.

  The -f option can be used to follow the trace log once it is located. The
  -j option can be used to check for the presence of trace records for the
  socket in question.

  If the system image does not contain the proper symbols to find the trace
  buffer, the trpt command cannot succeed.

FILES
  /usr/sbin/trpt
      Specifies the command path.

SEE ALSO
  Commands: netstat(1)

  Functions: setsockopt(2)

Index for Section 8

Alphabetical listing for T

Top of page