Annotation of 43BSDTahoe/man/man8/trsp.8, revision 1.1

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

unix.superglobalmegacorp.com

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