unixdev.net


Switch to SpeakEasy.net DSL

The Modular Manual Browser

Home Page
Manual: (OSF1-V5.1-alpha)
Page:
Section:
Apropos / Subsearch:
optional field



trpt(8)								      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 addi-
      tion 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 set-
  sockopt(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	argu-
  ment 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)