xref: /csrg-svn/usr.sbin/trsp/trsp.8 (revision 61895)
1*61895Sbostic.\" Copyright (c) 1985, 1991, 1993
2*61895Sbostic.\"	The Regents of the University of California.  All rights reserved.
325116Ssklower.\"
443852Strent.\" %sccs.include.redist.man%
525116Ssklower.\"
6*61895Sbostic.\"     @(#)trsp.8	8.1 (Berkeley) 06/06/93
735589Sbostic.\"
847470Scael.Dd
947470Scael.Dt TRSP 8
1047470Scael.Os BSD 4.2
1147470Scael.Sh NAME
1247470Scael.Nm trsp
1347470Scael.Nd transliterate sequenced packet protocol trace
1447470Scael.Sh SYNOPSIS
1547470Scael.Nm trsp
1647470Scael.Op Fl a
1747470Scael.Op Fl s
1847470Scael.Op Fl t
1947470Scael.Op Fl j
2047470Scael.Op Fl p Ar hex-address
2147470Scael.Oo
2247470Scael.Ar system Op Ar core
2347470Scael.Oc
2447470Scael.Sh DESCRIPTION
2547470Scael.Xr Trpt
2647470Scaelinterrogates the buffer of
2747470Scael.Tn SPP
2847470Scaeltrace records created
2947470Scaelwhen a socket is marked for
3047470Scael.Dq debugging
3147470Scael(see
3247470Scael.Xr setsockopt 2 ) ,
3325116Ssklowerand prints a readable description of these records.
3425116SsklowerWhen no options are supplied,
3547470Scael.Nm trsp
3625116Ssklowerprints all the trace records found in the system
3747470Scaelgrouped according to
3847470Scael.Tn SPP
3947470Scaelconnection protocol control
4047470Scaelblock
4147470Scael.Pq Tn PCB .
4247470ScaelThe following options may be used to
4325116Sskloweralter this behavior.
4447470Scael.Bl -tag -width Ds
4547470Scael.It Fl a
4647470ScaelIn addition to the normal output,
4747470Scaelprint the values of the source and destination
4847470Scaeladdresses for each packet recorded.
4947470Scael.It Fl j
5047470ScaelJust give a list of the protocol control block
5147470Scaeladdresses for which there are trace records.
5247470Scael.It Fl p
5347470ScaelShow only trace records associated with the protocol
5447470Scaelcontrol block at the given address,
5547470Scael.Ar hex-address .
5647470Scael.It Fl s
5725116Ssklowerin addition to the normal output,
5825116Ssklowerprint a detailed description of the packet
5947470Scaelsequencing information.
6047470Scael.It Fl t
6125116Ssklowerin addition to the normal output,
6225116Ssklowerprint the values for all timers at each
6325116Ssklowerpoint in the trace,
6447470Scael.El
6547470Scael.Pp
6625116SsklowerThe recommended use of
6747470Scael.Nm trsp
6825116Sskloweris as follows.
6925116SsklowerIsolate the problem and enable debugging on the
7025116Ssklowersocket(s) involved in the connection.
7125116SsklowerFind the address of the protocol control blocks
7225116Ssklowerassociated with the sockets using the
7347470Scael.Fl A
7425116Sskloweroption to
7547470Scael.Xr netstat 1 .
7625116SsklowerThen run
7747470Scael.Nm trsp
7825116Ssklowerwith the
7947470Scael.Fl p
8025116Sskloweroption, supplying the associated
8125116Ssklowerprotocol control block addresses.  If there are
8225116Ssklowermany sockets using the debugging option, the
8347470Scael.Fl j
8425116Sskloweroption may be useful in checking to see if
8525116Ssklowerany trace records are present for the socket in
8625116Ssklowerquestion.
8747470Scael.Pp
8825116SsklowerIf debugging is being performed on a system or
8925116Ssklowercore file other than the default, the last two
9025116Ssklowerarguments may be used to supplant the defaults.
9147470Scael.Sh FILES
9247470Scael.Bl -tag -width /dev/kmem -compact
9347470Scael.It Pa /vmunix
9447470Scael.It Pa /dev/kmem
9547470Scael.El
9647470Scael.Sh SEE ALSO
9747470Scael.Xr netstat 1 ,
9847470Scael.Xr setsockopt 2
9947470Scael.Sh DIAGNOSTICS
10047470Scael.Bl -tag -width Ds
10147470Scael.It Sy no namelist
10247470ScaelWhen the system image doesn't
10325116Ssklowercontain the proper symbols to find the trace buffer;
10425116Ssklowerothers which should be self explanatory.
10547470Scael.Sh BUGS
10625116SsklowerShould also print the data for each input or output,
10725116Ssklowerbut this is not saved in the race record.
10847470Scael.Pp
10925116SsklowerThe output format is inscrutable and should be described
11025116Ssklowerhere.
11147470Scael.Sh HISTORY
11247470ScaelThe
11347470Scael.Nm
11447470Scaelcommand appeared in
11547470Scael.Bx 4.3 .
116