Return to trsp.8 CVS log

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

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

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