1*590b49d6Sbostic.\" Copyright (c) 1985, 1991, 1993 2*590b49d6Sbostic.\" The Regents of the University of California. All rights reserved. 3f8c3c608Ssklower.\" 4016a3535Strent.\" %sccs.include.redist.man% 5f8c3c608Ssklower.\" 6*590b49d6Sbostic.\" @(#)trsp.8 8.1 (Berkeley) 06/06/93 7d89a41a4Sbostic.\" 8abfc8893Scael.Dd 9abfc8893Scael.Dt TRSP 8 10abfc8893Scael.Os BSD 4.2 11abfc8893Scael.Sh NAME 12abfc8893Scael.Nm trsp 13abfc8893Scael.Nd transliterate sequenced packet protocol trace 14abfc8893Scael.Sh SYNOPSIS 15abfc8893Scael.Nm trsp 16abfc8893Scael.Op Fl a 17abfc8893Scael.Op Fl s 18abfc8893Scael.Op Fl t 19abfc8893Scael.Op Fl j 20abfc8893Scael.Op Fl p Ar hex-address 21abfc8893Scael.Oo 22abfc8893Scael.Ar system Op Ar core 23abfc8893Scael.Oc 24abfc8893Scael.Sh DESCRIPTION 25abfc8893Scael.Xr Trpt 26abfc8893Scaelinterrogates the buffer of 27abfc8893Scael.Tn SPP 28abfc8893Scaeltrace records created 29abfc8893Scaelwhen a socket is marked for 30abfc8893Scael.Dq debugging 31abfc8893Scael(see 32abfc8893Scael.Xr setsockopt 2 ) , 33f8c3c608Ssklowerand prints a readable description of these records. 34f8c3c608SsklowerWhen no options are supplied, 35abfc8893Scael.Nm trsp 36f8c3c608Ssklowerprints all the trace records found in the system 37abfc8893Scaelgrouped according to 38abfc8893Scael.Tn SPP 39abfc8893Scaelconnection protocol control 40abfc8893Scaelblock 41abfc8893Scael.Pq Tn PCB . 42abfc8893ScaelThe following options may be used to 43f8c3c608Sskloweralter this behavior. 44abfc8893Scael.Bl -tag -width Ds 45abfc8893Scael.It Fl a 46abfc8893ScaelIn addition to the normal output, 47abfc8893Scaelprint the values of the source and destination 48abfc8893Scaeladdresses for each packet recorded. 49abfc8893Scael.It Fl j 50abfc8893ScaelJust give a list of the protocol control block 51abfc8893Scaeladdresses for which there are trace records. 52abfc8893Scael.It Fl p 53abfc8893ScaelShow only trace records associated with the protocol 54abfc8893Scaelcontrol block at the given address, 55abfc8893Scael.Ar hex-address . 56abfc8893Scael.It Fl s 57f8c3c608Ssklowerin addition to the normal output, 58f8c3c608Ssklowerprint a detailed description of the packet 59abfc8893Scaelsequencing information. 60abfc8893Scael.It Fl t 61f8c3c608Ssklowerin addition to the normal output, 62f8c3c608Ssklowerprint the values for all timers at each 63f8c3c608Ssklowerpoint in the trace, 64abfc8893Scael.El 65abfc8893Scael.Pp 66f8c3c608SsklowerThe recommended use of 67abfc8893Scael.Nm trsp 68f8c3c608Sskloweris as follows. 69f8c3c608SsklowerIsolate the problem and enable debugging on the 70f8c3c608Ssklowersocket(s) involved in the connection. 71f8c3c608SsklowerFind the address of the protocol control blocks 72f8c3c608Ssklowerassociated with the sockets using the 73abfc8893Scael.Fl A 74f8c3c608Sskloweroption to 75abfc8893Scael.Xr netstat 1 . 76f8c3c608SsklowerThen run 77abfc8893Scael.Nm trsp 78f8c3c608Ssklowerwith the 79abfc8893Scael.Fl p 80f8c3c608Sskloweroption, supplying the associated 81f8c3c608Ssklowerprotocol control block addresses. If there are 82f8c3c608Ssklowermany sockets using the debugging option, the 83abfc8893Scael.Fl j 84f8c3c608Sskloweroption may be useful in checking to see if 85f8c3c608Ssklowerany trace records are present for the socket in 86f8c3c608Ssklowerquestion. 87abfc8893Scael.Pp 88f8c3c608SsklowerIf debugging is being performed on a system or 89f8c3c608Ssklowercore file other than the default, the last two 90f8c3c608Ssklowerarguments may be used to supplant the defaults. 91abfc8893Scael.Sh FILES 92abfc8893Scael.Bl -tag -width /dev/kmem -compact 93abfc8893Scael.It Pa /vmunix 94abfc8893Scael.It Pa /dev/kmem 95abfc8893Scael.El 96abfc8893Scael.Sh SEE ALSO 97abfc8893Scael.Xr netstat 1 , 98abfc8893Scael.Xr setsockopt 2 99abfc8893Scael.Sh DIAGNOSTICS 100abfc8893Scael.Bl -tag -width Ds 101abfc8893Scael.It Sy no namelist 102abfc8893ScaelWhen the system image doesn't 103f8c3c608Ssklowercontain the proper symbols to find the trace buffer; 104f8c3c608Ssklowerothers which should be self explanatory. 105abfc8893Scael.Sh BUGS 106f8c3c608SsklowerShould also print the data for each input or output, 107f8c3c608Ssklowerbut this is not saved in the race record. 108abfc8893Scael.Pp 109f8c3c608SsklowerThe output format is inscrutable and should be described 110f8c3c608Ssklowerhere. 111abfc8893Scael.Sh HISTORY 112abfc8893ScaelThe 113abfc8893Scael.Nm 114abfc8893Scaelcommand appeared in 115abfc8893Scael.Bx 4.3 . 116