Index for Section 8

Alphabetical listing for T

Bottom of page

trpt(8)
NAME
  trpt - Transliterates protocol trace

SYNOPSIS
  trpt [-afjst] [-p address]

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

  -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 flag and the address
	    variable when you specify this flag.

  -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 flag to supply the
       associated protocol control block addresses. You can specify multiple
       -p address flags with a single trpt command.


  The -f flag can be used to follow the trace log once it is located.  The -j
  flag 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

RELATED INFORMATION
  Commands: netstat(1)

  Functions: setsockopt(2)

Index for Section 8

Alphabetical listing for T

Top of page