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