Return to trpt.8 CVS log

Up to [CSRG BSD Unix] / 43BSDTahoe / man / man8

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

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

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