Commit | Line | Data |
---|---|---|
361f3820 KS |
1 | This manual page documents a tool used for debugging failures in |
2 | the Xerox NS Sequenced packet protocol layer. It is adapted from | |
3 | the Internet equivalent trpt(8c). | |
58bdc154 KB |
4 | .\" Copyright (c) 1985 The Regents of the University of California. |
5 | .\" All rights reserved. | |
361f3820 | 6 | .\" |
58bdc154 KB |
7 | .\" Redistribution and use in source and binary forms are permitted |
8 | .\" provided that the above copyright notice and this paragraph are | |
9 | .\" duplicated in all such forms and that any documentation, | |
10 | .\" advertising materials, and other materials related to such | |
11 | .\" distribution and use acknowledge that the software was developed | |
12 | .\" by the University of California, Berkeley. The name of the | |
13 | .\" University may not be used to endorse or promote products derived | |
14 | .\" from this software without specific prior written permission. | |
15 | .\" THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR | |
16 | .\" IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED | |
17 | .\" WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. | |
361f3820 | 18 | .\" |
58bdc154 KB |
19 | .\" @(#)trsp.8 6.2 (Berkeley) %G% |
20 | .\" | |
21 | .TH TRSP 8 "" | |
361f3820 KS |
22 | .UC 5 |
23 | .SH NAME | |
24 | trsp \- transliterate sequenced packet protocol trace | |
25 | .SH SYNOPSIS | |
26 | .B trsp | |
27 | [ | |
28 | .B \-a | |
29 | ] [ | |
30 | .B \-s | |
31 | ] [ | |
32 | .B \-t | |
33 | ] [ | |
34 | .B \-j | |
35 | ] [ | |
36 | .B \-p | |
37 | hex-address ] | |
38 | [ system [ core ] ] | |
39 | .SH DESCRIPTION | |
40 | .I Trpt | |
41 | interrogates the buffer of SPP trace records created | |
42 | when a socket is marked for \*(lqdebugging\*(rq (see | |
43 | .IR setsockopt (2)), | |
44 | and prints a readable description of these records. | |
45 | When no options are supplied, | |
46 | .I trsp | |
47 | prints all the trace records found in the system | |
48 | grouped according to SPP connection protocol control | |
49 | block (PCB). The following options may be used to | |
50 | alter this behavior. | |
51 | .TP | |
52 | .B \-s | |
53 | in addition to the normal output, | |
54 | print a detailed description of the packet | |
55 | sequencing information, | |
56 | .TP | |
57 | .B \-t | |
58 | in addition to the normal output, | |
59 | print the values for all timers at each | |
60 | point in the trace, | |
61 | .TP | |
62 | .B \-j | |
63 | just give a list of the protocol control block | |
64 | addresses for which there are trace records, | |
65 | .TP | |
66 | .B \-p | |
67 | show only trace records associated with the protocol | |
68 | control block who's address follows, | |
69 | .TP | |
70 | .B \-a | |
71 | in addition to the normal output, | |
72 | print the values of the source and destination | |
73 | addresses for each packet recorded. | |
74 | .PP | |
75 | The recommended use of | |
76 | .I trsp | |
77 | is as follows. | |
78 | Isolate the problem and enable debugging on the | |
79 | socket(s) involved in the connection. | |
80 | Find the address of the protocol control blocks | |
81 | associated with the sockets using the | |
82 | .B \-A | |
83 | option to | |
84 | .IR netstat (1). | |
85 | Then run | |
86 | .I trsp | |
87 | with the | |
88 | .B \-p | |
89 | option, supplying the associated | |
90 | protocol control block addresses. If there are | |
91 | many sockets using the debugging option, the | |
92 | .B \-j | |
93 | option may be useful in checking to see if | |
94 | any trace records are present for the socket in | |
95 | question. | |
96 | .PP | |
97 | If debugging is being performed on a system or | |
98 | core file other than the default, the last two | |
99 | arguments may be used to supplant the defaults. | |
100 | .SH FILES | |
101 | /vmunix | |
102 | .br | |
103 | /dev/kmem | |
104 | .SH "SEE ALSO" | |
58bdc154 | 105 | netstat(1), setsockopt(2) |
361f3820 KS |
106 | .SH DIAGNOSTICS |
107 | ``no namelist'' when the system image doesn't | |
108 | contain the proper symbols to find the trace buffer; | |
109 | others which should be self explanatory. | |
110 | .SH BUGS | |
111 | Should also print the data for each input or output, | |
112 | but this is not saved in the race record. | |
113 | .PP | |
114 | The output format is inscrutable and should be described | |
115 | here. |