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