1*61893Sbostic.\" Copyright (c) 1983, 1991, 1993 2*61893Sbostic.\" The Regents of the University of California. All rights reserved. 319020Smckusick.\" 443851Strent.\" %sccs.include.redist.man% 519020Smckusick.\" 6*61893Sbostic.\" @(#)trpt.8 8.1 (Berkeley) 06/06/93 735587Sbostic.\" 847470Scael.Dd 947470Scael.Dt TRPT 8 1047470Scael.Os BSD 4.2 1147470Scael.Sh NAME 1247470Scael.Nm trpt 1347470Scael.Nd transliterate protocol trace 1447470Scael.Sh SYNOPSIS 1547470Scael.Nm trpt 1647470Scael.Op Fl a 1747470Scael.Op Fl f 1847470Scael.Op Fl j 1947470Scael.Op Fl p Ar hex-address 2047470Scael.Op Fl s 2147470Scael.Op Fl t 2247470Scael.Oo 2347470Scael.Ar system Op Ar core 2447470Scael.Oc 2547470Scael.Sh DESCRIPTION 2647470Scael.Nm Trpt 2747470Scaelinterrogates the buffer of 2847470Scael.Tn TCP 2947470Scaeltrace records created 3047470Scaelwhen a socket is marked for 3147470Scael.Dq debugging 3247470Scael(see 3347470Scael.Xr setsockopt 2 ) , 3419020Smckusickand prints a readable description of these records. 3519020SmckusickWhen no options are supplied, 3647470Scael.Nm trpt 3719020Smckusickprints all the trace records found in the system 3847470Scaelgrouped according to 3947470Scael.Tn TCP 4047470Scaelconnection protocol control 4147470Scaelblock 4247470Scael.Pq Tn PCB . 4347470ScaelThe following options may be used to 4419020Smckusickalter this behavior. 4547470Scael.Bl -tag -width Ds 4647470Scael.It Fl a 4747470ScaelIn addition to the normal output, 4828798Skarelsprint the values of the source and destination 4928798Skarelsaddresses for each packet recorded. 5047470Scael.It Fl f 5147470ScaelFollow the trace as it occurs, waiting a short time for additional records 5247470Scaeleach time the end of the log is reached. 5347470Scael.It Fl j 5447470ScaelJust give a list of the protocol control block 5547470Scaeladdresses for which there are trace records. 5647470Scael.It Fl p 5747470ScaelShow only trace records associated with the protocol 5847470Scaelcontrol block at the given address 5947470Scael.Ar hex-address . 6047470Scael.It Fl s 6147470ScaelIn addition to the normal output, 6219020Smckusickprint a detailed description of the packet 6328798Skarelssequencing information. 6447470Scael.It Fl t 6519020Smckusickin addition to the normal output, 6619020Smckusickprint the values for all timers at each 6728798Skarelspoint in the trace. 6847470Scael.El 6947470Scael.Pp 7019020SmckusickThe recommended use of 7147470Scael.Nm trpt 7219020Smckusickis as follows. 7319020SmckusickIsolate the problem and enable debugging on the 7419020Smckusicksocket(s) involved in the connection. 7519020SmckusickFind the address of the protocol control blocks 7619020Smckusickassociated with the sockets using the 7747470Scael.Fl A 7819020Smckusickoption to 7947470Scael.Xr netstat 1 . 8019020SmckusickThen run 8147470Scael.Nm trpt 8219020Smckusickwith the 8347470Scael.Fl p 8419020Smckusickoption, supplying the associated 8528798Skarelsprotocol control block addresses. 8628798SkarelsThe 8747470Scael.Fl f 8828798Skarelsoption can be used to follow the trace log once the trace is located. 8928798SkarelsIf there are 9019020Smckusickmany sockets using the debugging option, the 9147470Scael.Fl j 9219020Smckusickoption may be useful in checking to see if 9319020Smckusickany trace records are present for the socket in 9419020Smckusickquestion. 9528798SkarelsThe 9647470Scael.Pp 9719020SmckusickIf debugging is being performed on a system or 9819020Smckusickcore file other than the default, the last two 9919020Smckusickarguments may be used to supplant the defaults. 10047470Scael.Sh FILES 10147470Scael.Bl -tag -width /dev/kmem -compact 10247470Scael.It Pa /vmunix 10347470Scael.It Pa /dev/kmem 10447470Scael.El 10547470Scael.Sh SEE ALSO 10647470Scael.Xr netstat 1 , 10747470Scael.Xr setsockopt 2 , 10847470Scael.Xr trsp 8 10947470Scael.Sh DIAGNOSTICS 11047470Scael.Bl -tag -width Ds 11147470Scael.It Sy no namelist 11247470ScaelWhen the system image doesn't 11319020Smckusickcontain the proper symbols to find the trace buffer; 11419020Smckusickothers which should be self explanatory. 11547470Scael.El 11647470Scael.Sh BUGS 11719020SmckusickShould also print the data for each input or output, 11819020Smckusickbut this is not saved in the race record. 11947470Scael.Pp 12019020SmckusickThe output format is inscrutable and should be described 12119020Smckusickhere. 12247470Scael.Sh HISTORY 12347470ScaelThe 12447470Scael.Nm 12547470Scaelcommand appeared in 12647470Scael.Bx 4.2 . 127