diff options
author | Linus Torvalds <torvalds@linux-foundation.org> | 2009-09-23 12:25:16 -0400 |
---|---|---|
committer | Linus Torvalds <torvalds@linux-foundation.org> | 2009-09-23 12:25:16 -0400 |
commit | be90a49ca22a95f184d9f32d35b5247b44032849 (patch) | |
tree | d3c2edc18c003c384366f57901616ac29c80bc27 /Documentation | |
parent | 1f0918d03ff4b5c94540c71ce889672abdbc2f4a (diff) | |
parent | a87371b477774b290c27bc5cb7f4ccc5379574a9 (diff) |
Merge git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/usb-2.6
* git://git.kernel.org/pub/scm/linux/kernel/git/gregkh/usb-2.6: (142 commits)
USB: Fix sysfs paths in documentation
USB: skeleton: fix coding style issues.
USB: O_NONBLOCK in read path of skeleton
USB: make usb-skeleton honor O_NONBLOCK in write path
USB: skel_read really sucks royally
USB: Add hub descriptor update hook for xHCI
USB: xhci: Support USB hubs.
USB: xhci: Set multi-TT field for LS/FS devices under hubs.
USB: xhci: Set route string for all devices.
USB: xhci: Fix command wait list handling.
USB: xhci: Change how xHCI commands are handled.
USB: xhci: Refactor input device context setup.
USB: xhci: Endpoint representation refactoring.
USB: gadget: ether needs to select CRC32
USB: fix USBTMC get_capabilities success handling
USB: fix missing error check in probing
USB: usbfs: add USBDEVFS_URB_BULK_CONTINUATION flag
USB: support for autosuspend in sierra while online
USB: ehci-dbgp,ehci: Allow dbpg to work with suspend/resume
USB: ehci-dbgp,documentation: Documentation updates for ehci-dbgp
...
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/kernel-parameters.txt | 2 | ||||
-rw-r--r-- | Documentation/usb/authorization.txt | 10 | ||||
-rw-r--r-- | Documentation/usb/usbmon.txt | 8 | ||||
-rw-r--r-- | Documentation/x86/earlyprintk.txt | 39 |
4 files changed, 47 insertions, 12 deletions
diff --git a/Documentation/kernel-parameters.txt b/Documentation/kernel-parameters.txt index c363840cdcea..6fa7292947e5 100644 --- a/Documentation/kernel-parameters.txt +++ b/Documentation/kernel-parameters.txt | |||
@@ -671,7 +671,7 @@ and is between 256 and 4096 characters. It is defined in the file | |||
671 | earlyprintk= [X86,SH,BLACKFIN] | 671 | earlyprintk= [X86,SH,BLACKFIN] |
672 | earlyprintk=vga | 672 | earlyprintk=vga |
673 | earlyprintk=serial[,ttySn[,baudrate]] | 673 | earlyprintk=serial[,ttySn[,baudrate]] |
674 | earlyprintk=dbgp | 674 | earlyprintk=dbgp[debugController#] |
675 | 675 | ||
676 | Append ",keep" to not disable it when the real console | 676 | Append ",keep" to not disable it when the real console |
677 | takes over. | 677 | takes over. |
diff --git a/Documentation/usb/authorization.txt b/Documentation/usb/authorization.txt index 381b22ee7834..c069b6884c77 100644 --- a/Documentation/usb/authorization.txt +++ b/Documentation/usb/authorization.txt | |||
@@ -16,20 +16,20 @@ Usage: | |||
16 | 16 | ||
17 | Authorize a device to connect: | 17 | Authorize a device to connect: |
18 | 18 | ||
19 | $ echo 1 > /sys/usb/devices/DEVICE/authorized | 19 | $ echo 1 > /sys/bus/usb/devices/DEVICE/authorized |
20 | 20 | ||
21 | Deauthorize a device: | 21 | Deauthorize a device: |
22 | 22 | ||
23 | $ echo 0 > /sys/usb/devices/DEVICE/authorized | 23 | $ echo 0 > /sys/bus/usb/devices/DEVICE/authorized |
24 | 24 | ||
25 | Set new devices connected to hostX to be deauthorized by default (ie: | 25 | Set new devices connected to hostX to be deauthorized by default (ie: |
26 | lock down): | 26 | lock down): |
27 | 27 | ||
28 | $ echo 0 > /sys/bus/devices/usbX/authorized_default | 28 | $ echo 0 > /sys/bus/usb/devices/usbX/authorized_default |
29 | 29 | ||
30 | Remove the lock down: | 30 | Remove the lock down: |
31 | 31 | ||
32 | $ echo 1 > /sys/bus/devices/usbX/authorized_default | 32 | $ echo 1 > /sys/bus/usb/devices/usbX/authorized_default |
33 | 33 | ||
34 | By default, Wired USB devices are authorized by default to | 34 | By default, Wired USB devices are authorized by default to |
35 | connect. Wireless USB hosts deauthorize by default all new connected | 35 | connect. Wireless USB hosts deauthorize by default all new connected |
@@ -47,7 +47,7 @@ USB port): | |||
47 | boot up | 47 | boot up |
48 | rc.local -> | 48 | rc.local -> |
49 | 49 | ||
50 | for host in /sys/bus/devices/usb* | 50 | for host in /sys/bus/usb/devices/usb* |
51 | do | 51 | do |
52 | echo 0 > $host/authorized_default | 52 | echo 0 > $host/authorized_default |
53 | done | 53 | done |
diff --git a/Documentation/usb/usbmon.txt b/Documentation/usb/usbmon.txt index 6c3c625b7f30..66f92d1194c1 100644 --- a/Documentation/usb/usbmon.txt +++ b/Documentation/usb/usbmon.txt | |||
@@ -33,7 +33,7 @@ if usbmon is built into the kernel. | |||
33 | 33 | ||
34 | Verify that bus sockets are present. | 34 | Verify that bus sockets are present. |
35 | 35 | ||
36 | # ls /sys/kernel/debug/usbmon | 36 | # ls /sys/kernel/debug/usb/usbmon |
37 | 0s 0u 1s 1t 1u 2s 2t 2u 3s 3t 3u 4s 4t 4u | 37 | 0s 0u 1s 1t 1u 2s 2t 2u 3s 3t 3u 4s 4t 4u |
38 | # | 38 | # |
39 | 39 | ||
@@ -58,11 +58,11 @@ Bus=03 means it's bus 3. | |||
58 | 58 | ||
59 | 3. Start 'cat' | 59 | 3. Start 'cat' |
60 | 60 | ||
61 | # cat /sys/kernel/debug/usbmon/3u > /tmp/1.mon.out | 61 | # cat /sys/kernel/debug/usb/usbmon/3u > /tmp/1.mon.out |
62 | 62 | ||
63 | to listen on a single bus, otherwise, to listen on all buses, type: | 63 | to listen on a single bus, otherwise, to listen on all buses, type: |
64 | 64 | ||
65 | # cat /sys/kernel/debug/usbmon/0u > /tmp/1.mon.out | 65 | # cat /sys/kernel/debug/usb/usbmon/0u > /tmp/1.mon.out |
66 | 66 | ||
67 | This process will be reading until killed. Naturally, the output can be | 67 | This process will be reading until killed. Naturally, the output can be |
68 | redirected to a desirable location. This is preferred, because it is going | 68 | redirected to a desirable location. This is preferred, because it is going |
@@ -305,7 +305,7 @@ Before the call, hdr, data, and alloc should be filled. Upon return, the area | |||
305 | pointed by hdr contains the next event structure, and the data buffer contains | 305 | pointed by hdr contains the next event structure, and the data buffer contains |
306 | the data, if any. The event is removed from the kernel buffer. | 306 | the data, if any. The event is removed from the kernel buffer. |
307 | 307 | ||
308 | The MON_IOCX_GET copies 48 bytes, MON_IOCX_GETX copies 64 bytes. | 308 | The MON_IOCX_GET copies 48 bytes to hdr area, MON_IOCX_GETX copies 64 bytes. |
309 | 309 | ||
310 | MON_IOCX_MFETCH, defined as _IOWR(MON_IOC_MAGIC, 7, struct mon_mfetch_arg) | 310 | MON_IOCX_MFETCH, defined as _IOWR(MON_IOC_MAGIC, 7, struct mon_mfetch_arg) |
311 | 311 | ||
diff --git a/Documentation/x86/earlyprintk.txt b/Documentation/x86/earlyprintk.txt index 607b1a016064..f19802c0f485 100644 --- a/Documentation/x86/earlyprintk.txt +++ b/Documentation/x86/earlyprintk.txt | |||
@@ -7,7 +7,7 @@ and two USB cables, connected like this: | |||
7 | 7 | ||
8 | [host/target] <-------> [USB debug key] <-------> [client/console] | 8 | [host/target] <-------> [USB debug key] <-------> [client/console] |
9 | 9 | ||
10 | 1. There are three specific hardware requirements: | 10 | 1. There are a number of specific hardware requirements: |
11 | 11 | ||
12 | a.) Host/target system needs to have USB debug port capability. | 12 | a.) Host/target system needs to have USB debug port capability. |
13 | 13 | ||
@@ -42,7 +42,35 @@ and two USB cables, connected like this: | |||
42 | This is a small blue plastic connector with two USB connections, | 42 | This is a small blue plastic connector with two USB connections, |
43 | it draws power from its USB connections. | 43 | it draws power from its USB connections. |
44 | 44 | ||
45 | c.) Thirdly, you need a second client/console system with a regular USB port. | 45 | c.) You need a second client/console system with a high speed USB 2.0 |
46 | port. | ||
47 | |||
48 | d.) The Netchip device must be plugged directly into the physical | ||
49 | debug port on the "host/target" system. You cannot use a USB hub in | ||
50 | between the physical debug port and the "host/target" system. | ||
51 | |||
52 | The EHCI debug controller is bound to a specific physical USB | ||
53 | port and the Netchip device will only work as an early printk | ||
54 | device in this port. The EHCI host controllers are electrically | ||
55 | wired such that the EHCI debug controller is hooked up to the | ||
56 | first physical and there is no way to change this via software. | ||
57 | You can find the physical port through experimentation by trying | ||
58 | each physical port on the system and rebooting. Or you can try | ||
59 | and use lsusb or look at the kernel info messages emitted by the | ||
60 | usb stack when you plug a usb device into various ports on the | ||
61 | "host/target" system. | ||
62 | |||
63 | Some hardware vendors do not expose the usb debug port with a | ||
64 | physical connector and if you find such a device send a complaint | ||
65 | to the hardware vendor, because there is no reason not to wire | ||
66 | this port into one of the physically accessible ports. | ||
67 | |||
68 | e.) It is also important to note, that many versions of the Netchip | ||
69 | device require the "client/console" system to be plugged into the | ||
70 | right and side of the device (with the product logo facing up and | ||
71 | readable left to right). The reason being is that the 5 volt | ||
72 | power supply is taken from only one side of the device and it | ||
73 | must be the side that does not get rebooted. | ||
46 | 74 | ||
47 | 2. Software requirements: | 75 | 2. Software requirements: |
48 | 76 | ||
@@ -56,6 +84,13 @@ and two USB cables, connected like this: | |||
56 | (If you are using Grub, append it to the 'kernel' line in | 84 | (If you are using Grub, append it to the 'kernel' line in |
57 | /etc/grub.conf) | 85 | /etc/grub.conf) |
58 | 86 | ||
87 | On systems with more than one EHCI debug controller you must | ||
88 | specify the correct EHCI debug controller number. The ordering | ||
89 | comes from the PCI bus enumeration of the EHCI controllers. The | ||
90 | default with no number argument is "0" the first EHCI debug | ||
91 | controller. To use the second EHCI debug controller, you would | ||
92 | use the command line: "earlyprintk=dbgp1" | ||
93 | |||
59 | NOTE: normally earlyprintk console gets turned off once the | 94 | NOTE: normally earlyprintk console gets turned off once the |
60 | regular console is alive - use "earlyprintk=dbgp,keep" to keep | 95 | regular console is alive - use "earlyprintk=dbgp,keep" to keep |
61 | this channel open beyond early bootup. This can be useful for | 96 | this channel open beyond early bootup. This can be useful for |