Return to trpt.8c CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man8

Annotation of cci/usr/src/man/man8/trpt.8c, revision 1.1.1.1

1.1       root        1: .TH TRPT 8C "2 March 1983"
                      2: .UC 4
                      3: .SH NAME
                      4: trpt \- transliterate protocol trace
                      5: .SH SYNOPSIS
                      6: .B trpt
                      7: [
                      8: .B \-a
                      9: ] [
                     10: .B \-s
                     11: ]  [
                     12: .B \-t
                     13: ] [
                     14: .B \-j
                     15: ] [
                     16: .B \-p
                     17: hex-address ]
                     18: [ system [ core ] ]
                     19: .SH DESCRIPTION
                     20: .I Trpt
                     21: interrogates the buffer of TCP trace records created
                     22: when a socket is marked for \*(lqdebugging\*(rq (see
                     23: .IR setsockopt (2)),
                     24: and prints a readable description of these records.
                     25: When no options are supplied, 
                     26: .I trpt
                     27: prints all the trace records found in the system
                     28: grouped according to TCP connection protocol control
                     29: block (PCB).  The following options may be used to
                     30: alter this behavior.
                     31: .TP
                     32: .B \-s
                     33: in addition to the normal output,
                     34: print a detailed description of the packet
                     35: sequencing information,
                     36: .TP
                     37: .B \-t
                     38: in addition to the normal output,
                     39: print the values for all timers at each
                     40: point in the trace,
                     41: .TP
                     42: .B \-j
                     43: just give a list of the protocol control block
                     44: addresses for which there are trace records,
                     45: .TP
                     46: .B \-p
                     47: show only trace records associated with the protocol
                     48: control block who's address follows,
                     49: .TP
                     50: .B \-a
                     51: in addition to the normal output,
                     52: print the values of the source and destination
                     53: addresses for each packet recorded.
                     54: .PP
                     55: The recommended use of
                     56: .I trpt
                     57: is as follows.
                     58: Isolate the problem and enable debugging on the
                     59: socket(s) involved in the connection.
                     60: Find the address of the protocol control blocks
                     61: associated with the sockets using the 
                     62: .B \-A
                     63: option to 
                     64: .IR netstat (1).
                     65: Then run
                     66: .I trpt
                     67: with the
                     68: .B \-p
                     69: option, supplying the associated
                     70: protocol control block addresses.  If there are
                     71: many sockets using the debugging option, the
                     72: .B \-j
                     73: option may be useful in checking to see if
                     74: any trace records are present for the socket in
                     75: question.
                     76: .PP
                     77: If debugging is being performed on a system or
                     78: core file other than the default, the last two
                     79: arguments may be used to supplant the defaults.
                     80: .SH FILES
                     81: /vmunix
                     82: .br
                     83: /dev/kmem
                     84: .SH "SEE ALSO"
                     85: setsockopt(2), netstat(1)
                     86: .SH DIAGNOSTICS
                     87: ``no namelist'' when the system image doesn't
                     88: contain the proper symbols to find the trace buffer;
                     89: others which should be self explanatory.
                     90: .SH BUGS
                     91: Should also print the data for each input or output,
                     92: but this is not saved in the race record.
                     93: .PP
                     94: The output format is inscrutable and should be described
                     95: here.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.