|
|
1.1 root 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: .\"
5: .\" @(#)trpt.8c 6.2 (Berkeley) 5/26/86
6: .\"
7: .TH TRPT 8C "May 26, 1986"
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: ] [
20: .B \-f
21: ] [
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
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
45: .B \-s
46: in addition to the normal output,
47: print a detailed description of the packet
48: sequencing information.
49: .TP
50: .B \-t
51: in addition to the normal output,
52: print the values for all timers at each
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.
58: .TP
59: .B \-j
60: just give a list of the protocol control block
61: addresses for which there are trace records.
62: .TP
63: .B \-p
64: show only trace records associated with the protocol
65: control block, the address of which follows.
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
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
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.
92: The
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"
102: setsockopt(2), netstat(1), trsp(8C)
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.