Annotation of 43BSDReno/usr.sbin/trsp/trsp.8, revision 1.1.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.

unix.superglobalmegacorp.com

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