|
|
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.