Page MenuHomeFreeBSD
Files F152953939

D47178.id145322.diff
No OneTemporary
Actions

D47178.id145322.diff
View Options

diff --git a/usr.sbin/usbdump/usbdump.8 b/usr.sbin/usbdump/usbdump.8
--- a/usr.sbin/usbdump/usbdump.8
+++ b/usr.sbin/usbdump/usbdump.8
@@ -131,56 +131,80 @@
.Pp
.Dl "usbdump -r /tmp/dump_pkts -v"
.Sh OUTPUT FORMAT
-The output format of
+The default output format of
.Nm
is as follows:
.Pp
-.Dl "<time> <bus>.<addr> <ep> <xfertype> <S/D> (<frames>/<length>) <...>"
+.Bl -literal -offset indent -compact
+<time> <bus>.<addr> <type>-<xfertype>-EP-<endoint>,\e
+SPD=<speed>,NFR=<frames>,SLEN=<len>,IVAL=<interval> [,<ERR=errnum>]
.Pp
The meaning of the output format elements is as follows:
.Bl -tag -width "<xfertype>"
.It <time>
A timestamp preceding all output lines.
-The timestamp has the format "hh:mm:ss.frac" and is as accurate as
+The timestamp has the format
+.Dq hh:mm:ss.frac
+and is as accurate as
the kernel's clock.
.It <bus>
The USB host controller's bus unit number.
.It <addr>
The unique number of the USB device as allocated by the host controller driver.
-.It <ep>
-The USB endpoint address that indicates whether the address is
-.Dv OUT
-or
-.Dv IN .
+.It <type>
+.Sq SUBM
+indicates a USB submit.
+.Sq DONE
+indicates a USB transfer done.
.It <xfertype>
The USB transfer type.
Can be
.Dv CTRL ,
.Dv ISOC ,
-.Dv BULK
+.Dv BULK ,
or
.Dv INTR .
-.It <S/D>
-`S' indicates a USB submit.
-`D' indicates a USB transfer done.
+.It <endpoint>
+The USB endpoint number or stream ID.
+.It <speed>
+The USB transfer speed.
+Can be
+.Dv FULL ,
+.Dv HIGH ,
+.Dv LOW ,
+.Dv VARI ,
+.Dv SUPER ,
+or
+.Dv UNKNOWN .
.It <frames>
-Numbers of frames in this packets.
+Number of frames in this packet.
If this is a USB submit, its value is
.Li xfer->nframes
which means how many frames are acceptable or registered to transfer.
If this is a USB done,
.Li xfer->aframes
is the actual number of frames.
-.It <length>
+.It <len>
Total packet size.
If this is a USB submit, its value is
.Li xfer->sumlen .
If this is a USB done, its value is
.Li xfer->actlen .
-.It <...>
+.It <interval>
+Transfer interval for interrupt and isochronous use, in milliseconds.
+Its value is
+.Li up->up_interval .
+.It <,ERR=errnum>
Optional field used for printing an error string if the packet is from USB done.
+Error numbers and descriptions can be found in include file
+.In dev/usb/usbdi.h .
.El
.Sh SEE ALSO
.Xr usbconfig 8
+.Sh HISTORY
+The
+.Nm
+utility first appeared in
+.Fx 8.3 .
.Sh AUTHORS
.An Weongyo Jeong Aq Mt weongyo@FreeBSD.org

File Metadata

Mime Type
text/plain
Expires
Sun, Apr 19, 7:30 AM (10 h, 12 m)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
31753450
Default Alt Text
D47178.id145322.diff (2 KB)

Event Timeline