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