Commit | Line | Data |
---|---|---|
dbee94a9 KB |
1 | .\" Copyright (c) 1983 The Regents of the University of California. |
2 | .\" All rights reserved. | |
79be0566 | 3 | .\" |
24f519df | 4 | .\" %sccs.include.redist.man% |
79be0566 | 5 | .\" |
24f519df | 6 | .\" @(#)trpt.8 6.4 (Berkeley) %G% |
dbee94a9 KB |
7 | .\" |
8 | .TH TRPT 8 "" | |
79be0566 KM |
9 | .UC 5 |
10 | .SH NAME | |
11 | trpt \- transliterate protocol trace | |
12 | .SH SYNOPSIS | |
13 | .B trpt | |
14 | [ | |
15 | .B \-a | |
16 | ] [ | |
17 | .B \-s | |
18 | ] [ | |
19 | .B \-t | |
20 | ] [ | |
6e29ad7e MK |
21 | .B \-f |
22 | ] [ | |
79be0566 KM |
23 | .B \-j |
24 | ] [ | |
25 | .B \-p | |
26 | hex-address ] | |
27 | [ system [ core ] ] | |
28 | .SH DESCRIPTION | |
29 | .I Trpt | |
30 | interrogates the buffer of TCP trace records created | |
31 | when a socket is marked for \*(lqdebugging\*(rq (see | |
32 | .IR setsockopt (2)), | |
33 | and prints a readable description of these records. | |
34 | When no options are supplied, | |
35 | .I trpt | |
36 | prints all the trace records found in the system | |
37 | grouped according to TCP connection protocol control | |
38 | block (PCB). The following options may be used to | |
39 | alter this behavior. | |
40 | .TP | |
6e29ad7e MK |
41 | .B \-a |
42 | in addition to the normal output, | |
43 | print the values of the source and destination | |
44 | addresses for each packet recorded. | |
45 | .TP | |
79be0566 KM |
46 | .B \-s |
47 | in addition to the normal output, | |
48 | print a detailed description of the packet | |
6e29ad7e | 49 | sequencing information. |
79be0566 KM |
50 | .TP |
51 | .B \-t | |
52 | in addition to the normal output, | |
53 | print the values for all timers at each | |
6e29ad7e MK |
54 | point in the trace. |
55 | .TP | |
56 | .B \-f | |
57 | follow the trace as it occurs, waiting a short time for additional records | |
58 | each time the end of the log is reached. | |
79be0566 KM |
59 | .TP |
60 | .B \-j | |
61 | just give a list of the protocol control block | |
6e29ad7e | 62 | addresses for which there are trace records. |
79be0566 KM |
63 | .TP |
64 | .B \-p | |
65 | show only trace records associated with the protocol | |
6e29ad7e | 66 | control block, the address of which follows. |
79be0566 KM |
67 | .PP |
68 | The recommended use of | |
69 | .I trpt | |
70 | is as follows. | |
71 | Isolate the problem and enable debugging on the | |
72 | socket(s) involved in the connection. | |
73 | Find the address of the protocol control blocks | |
74 | associated with the sockets using the | |
75 | .B \-A | |
76 | option to | |
77 | .IR netstat (1). | |
78 | Then run | |
79 | .I trpt | |
80 | with the | |
81 | .B \-p | |
82 | option, supplying the associated | |
6e29ad7e MK |
83 | protocol control block addresses. |
84 | The | |
85 | .B \-f | |
86 | option can be used to follow the trace log once the trace is located. | |
87 | If there are | |
79be0566 KM |
88 | many sockets using the debugging option, the |
89 | .B \-j | |
90 | option may be useful in checking to see if | |
91 | any trace records are present for the socket in | |
92 | question. | |
6e29ad7e | 93 | The |
79be0566 KM |
94 | .PP |
95 | If debugging is being performed on a system or | |
96 | core file other than the default, the last two | |
97 | arguments may be used to supplant the defaults. | |
98 | .SH FILES | |
99 | /vmunix | |
100 | .br | |
101 | /dev/kmem | |
102 | .SH "SEE ALSO" | |
dbee94a9 | 103 | netstat(1), setsockopt(2), trsp(8) |
79be0566 KM |
104 | .SH DIAGNOSTICS |
105 | ``no namelist'' when the system image doesn't | |
106 | contain the proper symbols to find the trace buffer; | |
107 | others which should be self explanatory. | |
108 | .SH BUGS | |
109 | Should also print the data for each input or output, | |
110 | but this is not saved in the race record. | |
111 | .PP | |
112 | The output format is inscrutable and should be described | |
113 | here. |