Commit | Line | Data |
---|---|---|
b42074ab | 1 | .\" Copyright (c) 1983, 1991 The Regents of the University of California. |
dbee94a9 | 2 | .\" All rights reserved. |
79be0566 | 3 | .\" |
24f519df | 4 | .\" %sccs.include.redist.man% |
79be0566 | 5 | .\" |
b42074ab | 6 | .\" @(#)trpt.8 6.5 (Berkeley) %G% |
dbee94a9 | 7 | .\" |
b42074ab CL |
8 | .Dd |
9 | .Dt TRPT 8 | |
10 | .Os BSD 4.2 | |
11 | .Sh NAME | |
12 | .Nm trpt | |
13 | .Nd transliterate protocol trace | |
14 | .Sh SYNOPSIS | |
15 | .Nm trpt | |
16 | .Op Fl a | |
17 | .Op Fl f | |
18 | .Op Fl j | |
19 | .Op Fl p Ar hex-address | |
20 | .Op Fl s | |
21 | .Op Fl t | |
22 | .Oo | |
23 | .Ar system Op Ar core | |
24 | .Oc | |
25 | .Sh DESCRIPTION | |
26 | .Nm Trpt | |
27 | interrogates the buffer of | |
28 | .Tn TCP | |
29 | trace records created | |
30 | when a socket is marked for | |
31 | .Dq debugging | |
32 | (see | |
33 | .Xr setsockopt 2 ) , | |
79be0566 KM |
34 | and prints a readable description of these records. |
35 | When no options are supplied, | |
b42074ab | 36 | .Nm trpt |
79be0566 | 37 | prints all the trace records found in the system |
b42074ab CL |
38 | grouped according to |
39 | .Tn TCP | |
40 | connection protocol control | |
41 | block | |
42 | .Pq Tn PCB . | |
43 | The following options may be used to | |
79be0566 | 44 | alter this behavior. |
b42074ab CL |
45 | .Bl -tag -width Ds |
46 | .It Fl a | |
47 | In addition to the normal output, | |
6e29ad7e MK |
48 | print the values of the source and destination |
49 | addresses for each packet recorded. | |
b42074ab CL |
50 | .It Fl f |
51 | Follow the trace as it occurs, waiting a short time for additional records | |
52 | each time the end of the log is reached. | |
53 | .It Fl j | |
54 | Just give a list of the protocol control block | |
55 | addresses for which there are trace records. | |
56 | .It Fl p | |
57 | Show only trace records associated with the protocol | |
58 | control block at the given address | |
59 | .Ar hex-address . | |
60 | .It Fl s | |
61 | In addition to the normal output, | |
79be0566 | 62 | print a detailed description of the packet |
6e29ad7e | 63 | sequencing information. |
b42074ab | 64 | .It Fl t |
79be0566 KM |
65 | in addition to the normal output, |
66 | print the values for all timers at each | |
6e29ad7e | 67 | point in the trace. |
b42074ab CL |
68 | .El |
69 | .Pp | |
79be0566 | 70 | The recommended use of |
b42074ab | 71 | .Nm trpt |
79be0566 KM |
72 | is as follows. |
73 | Isolate the problem and enable debugging on the | |
74 | socket(s) involved in the connection. | |
75 | Find the address of the protocol control blocks | |
76 | associated with the sockets using the | |
b42074ab | 77 | .Fl A |
79be0566 | 78 | option to |
b42074ab | 79 | .Xr netstat 1 . |
79be0566 | 80 | Then run |
b42074ab | 81 | .Nm trpt |
79be0566 | 82 | with the |
b42074ab | 83 | .Fl p |
79be0566 | 84 | option, supplying the associated |
6e29ad7e MK |
85 | protocol control block addresses. |
86 | The | |
b42074ab | 87 | .Fl f |
6e29ad7e MK |
88 | option can be used to follow the trace log once the trace is located. |
89 | If there are | |
79be0566 | 90 | many sockets using the debugging option, the |
b42074ab | 91 | .Fl j |
79be0566 KM |
92 | option may be useful in checking to see if |
93 | any trace records are present for the socket in | |
94 | question. | |
6e29ad7e | 95 | The |
b42074ab | 96 | .Pp |
79be0566 KM |
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. | |
b42074ab CL |
100 | .Sh FILES |
101 | .Bl -tag -width /dev/kmem -compact | |
102 | .It Pa /vmunix | |
103 | .It Pa /dev/kmem | |
104 | .El | |
105 | .Sh SEE ALSO | |
106 | .Xr netstat 1 , | |
107 | .Xr setsockopt 2 , | |
108 | .Xr trsp 8 | |
109 | .Sh DIAGNOSTICS | |
110 | .Bl -tag -width Ds | |
111 | .It Sy no namelist | |
112 | When the system image doesn't | |
79be0566 KM |
113 | contain the proper symbols to find the trace buffer; |
114 | others which should be self explanatory. | |
b42074ab CL |
115 | .El |
116 | .Sh BUGS | |
79be0566 KM |
117 | Should also print the data for each input or output, |
118 | but this is not saved in the race record. | |
b42074ab | 119 | .Pp |
79be0566 KM |
120 | The output format is inscrutable and should be described |
121 | here. | |
b42074ab CL |
122 | .Sh HISTORY |
123 | The | |
124 | .Nm | |
125 | command appeared in | |
126 | .Bx 4.2 . |