Return to trsp.8 CVS log

Up to [CSRG BSD Unix] / 43BSDReno / usr.sbin / trsp

Annotation of 43BSDReno/usr.sbin/trsp/trsp.8, revision 1.1

1.1     ! root        1: .\" Copyright (c) 1985 The Regents of the University of California.
        !             2: .\" All rights reserved.
        !             3: .\"
        !             4: .\" Redistribution and use in source and binary forms are permitted provided
        !             5: .\" that: (1) source distributions retain this entire copyright notice and
        !             6: .\" comment, and (2) distributions including binaries display the following
        !             7: .\" acknowledgement:  ``This product includes software developed by the
        !             8: .\" University of California, Berkeley and its contributors'' in the
        !             9: .\" documentation or other materials provided with the distribution and in
        !            10: .\" all advertising materials mentioning features or use of this software.
        !            11: .\" Neither the name of the University nor the names of its contributors may
        !            12: .\" be used to endorse or promote products derived from this software without
        !            13: .\" specific prior written permission.
        !            14: .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED
        !            15: .\" WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF
        !            16: .\" MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
        !            17: .\"
        !            18: .\"    @(#)trsp.8      6.3 (Berkeley) 6/24/90
        !            19: .\"
        !            20: .TH TRSP 8 "June 24, 1990"
        !            21: .UC 5
        !            22: .SH NAME
        !            23: trsp \- transliterate sequenced packet protocol trace
        !            24: .SH SYNOPSIS
        !            25: .B trsp
        !            26: [
        !            27: .B \-a
        !            28: ] [
        !            29: .B \-s
        !            30: ]  [
        !            31: .B \-t
        !            32: ] [
        !            33: .B \-j
        !            34: ] [
        !            35: .B \-p
        !            36: hex-address ]
        !            37: [ system [ core ] ]
        !            38: .SH DESCRIPTION
        !            39: .I Trpt
        !            40: interrogates the buffer of SPP trace records created
        !            41: when a socket is marked for \*(lqdebugging\*(rq (see
        !            42: .IR setsockopt (2)),
        !            43: and prints a readable description of these records.
        !            44: When no options are supplied, 
        !            45: .I trsp
        !            46: prints all the trace records found in the system
        !            47: grouped according to SPP connection protocol control
        !            48: block (PCB).  The following options may be used to
        !            49: alter this behavior.
        !            50: .TP
        !            51: .B \-s
        !            52: in addition to the normal output,
        !            53: print a detailed description of the packet
        !            54: sequencing information,
        !            55: .TP
        !            56: .B \-t
        !            57: in addition to the normal output,
        !            58: print the values for all timers at each
        !            59: point in the trace,
        !            60: .TP
        !            61: .B \-j
        !            62: just give a list of the protocol control block
        !            63: addresses for which there are trace records,
        !            64: .TP
        !            65: .B \-p
        !            66: show only trace records associated with the protocol
        !            67: control block who's address follows,
        !            68: .TP
        !            69: .B \-a
        !            70: in addition to the normal output,
        !            71: print the values of the source and destination
        !            72: addresses for each packet recorded.
        !            73: .PP
        !            74: The recommended use of
        !            75: .I trsp
        !            76: is as follows.
        !            77: Isolate the problem and enable debugging on the
        !            78: socket(s) involved in the connection.
        !            79: Find the address of the protocol control blocks
        !            80: associated with the sockets using the 
        !            81: .B \-A
        !            82: option to 
        !            83: .IR netstat (1).
        !            84: Then run
        !            85: .I trsp
        !            86: with the
        !            87: .B \-p
        !            88: option, supplying the associated
        !            89: protocol control block addresses.  If there are
        !            90: many sockets using the debugging option, the
        !            91: .B \-j
        !            92: option may be useful in checking to see if
        !            93: any trace records are present for the socket in
        !            94: question.
        !            95: .PP
        !            96: If debugging is being performed on a system or
        !            97: core file other than the default, the last two
        !            98: arguments may be used to supplant the defaults.
        !            99: .SH FILES
        !           100: /vmunix
        !           101: .br
        !           102: /dev/kmem
        !           103: .SH "SEE ALSO"
        !           104: netstat(1), setsockopt(2)
        !           105: .SH DIAGNOSTICS
        !           106: ``no namelist'' when the system image doesn't
        !           107: contain the proper symbols to find the trace buffer;
        !           108: others which should be self explanatory.
        !           109: .SH BUGS
        !           110: Should also print the data for each input or output,
        !           111: but this is not saved in the race record.
        !           112: .PP
        !           113: The output format is inscrutable and should be described
        !           114: here.

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