Annotation of 43BSDTahoe/man/man8/trpt.8, revision 1.1.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.

unix.superglobalmegacorp.com

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