patch-2.3.99-pre4 linux/Documentation/usb/proc_usb_info.txt

Next file: linux/Documentation/usb/scanner-hp-sane.txt
Previous file: linux/Documentation/usb/ov511.txt
Back to the patch index
Back to the overall index

diff -u --recursive --new-file v2.3.99-pre3/linux/Documentation/usb/proc_usb_info.txt linux/Documentation/usb/proc_usb_info.txt
@@ -1,16 +1,17 @@
 /proc/bus/usb filesystem output
 ===============================
-(version 19991218)
+(version 2000.03.24)
 
 
 The /proc filesystem for USB devices generates
 /proc/bus/usb/drivers and /proc/bus/usb/devices.
 
-/proc/bus/usb/drivers just lists the registered drivers,
-one per line.  Not very interesting or pretty.
+/proc/bus/usb/drivers lists the registered drivers,
+one per line, with each driver's USB minor dev node
+number range if applicable.
 
 In /proc/bus/usb/devices, each device's output has multiple
-lines (except for a root hub) of ASCII output.
+lines of ASCII output.
 I made it ASCII instead of binary on purpose, so that someone
 can obtain some useful data from it without the use of an
 auxiliary program.  However, with an auxiliary program, the numbers
@@ -22,11 +23,12 @@
 Each line is tagged with a one-character ID for that line:
 
 T = Topology (etc.)
-B = Bandwidth
+B = Bandwidth (applies only to USB host controllers, which are
+    virtualized as root hubs)
 D = Device descriptor info.
 P = Product ID info. (from Device descriptor, but they won't fit
     together on one line)
-S = String info
+S = String descriptors.
 C = Configuration descriptor info. (* = active configuration)
 I = Interface descriptor info.
 E = Endpoint descriptor info.
@@ -93,7 +95,17 @@
 |__String info tag
 
 S:  Product=ssss
-|   |__Product description of this device as read from the device.
+|   |__Product description of this device as read from the device,
+|      except that it is a generated string for USB host controllers
+|      (virtual root hubs), in the form "USB *HCI Root Hub".
+|__String info tag
+
+S:  SerialNumber=ssss
+|   |__Serial Number of this device as read from the device,
+|      except that it is a generated string for USB host controllers
+|      (virtual root hubs), and represent's the host controller's
+|      unique identification in the system (currently I/O or
+|      memory-mapped base address).
 |__String info tag
 
 
@@ -142,7 +154,7 @@
 script, it can display any selected lines (for example, only T, D,
 and P lines) and change their output format.  (The "procusb"
 Perl script is the beginning of this idea.  It will list only
-selected lines [selected from TDPCIE] or "All" lines from
+selected lines [selected from TBDPSCIE] or "All" lines from
 /proc/bus/usb/devices.)
 
 The Topology lines can be used to generate a graphic/pictorial
@@ -163,6 +175,13 @@
 
 T:  Bus=00 Lev=00 Prnt=00 Port=00 Cnt=00 Dev#=  1 Spd=12  MxCh= 2
 B:  Alloc= 28/900 us ( 3%), #Int=  2, #Iso=  0
+D:  Ver= 1.00 Cls=09(hub  ) Sub=00 Prot=00 MxPS= 8 #Cfgs=  1
+P:  Vendor=0000 ProdID=0000 Rev= 0.00
+S:  Product=USB UHCI Root Hub
+S:  SerialNumber=dce0
+C:* #Ifs= 1 Cfg#= 1 Atr=40 MxPwr=  0mA
+I:  If#= 0 Alt= 0 #EPs= 1 Cls=09(hub  ) Sub=00 Prot=00 Driver=hub
+E:  Ad=81(I) Atr=03(Int.) MxPS=   8 Ivl=255ms
 T:  Bus=00 Lev=01 Prnt=01 Port=00 Cnt=01 Dev#=  2 Spd=12  MxCh= 4
 D:  Ver= 1.00 Cls=09(hub  ) Sub=00 Prot=00 MxPS= 8 #Cfgs=  1
 P:  Vendor=0451 ProdID=1446 Rev= 1.00

FUNET's LINUX-ADM group, linux-adm@nic.funet.fi
TCL-scripts by Sam Shen (who was at: slshen@lbl.gov)