Merge branch 'topic/echoaudio' into for-linus
[linux-2.6] / drivers / usb / core / Kconfig
1 #
2 # USB Core configuration
3 #
4 config USB_DEBUG
5         bool "USB verbose debug messages"
6         depends on USB
7         help
8           Say Y here if you want the USB core & hub drivers to produce a bunch
9           of debug messages to the system log. Select this if you are having a
10           problem with USB support and want to see more of what is going on.
11
12 config USB_ANNOUNCE_NEW_DEVICES
13         bool "USB announce new devices"
14         depends on USB
15         default N
16         help
17           Say Y here if you want the USB core to always announce the
18           idVendor, idProduct, Manufacturer, Product, and SerialNumber
19           strings for every new USB device to the syslog.  This option is
20           usually used by distro vendors to help with debugging and to
21           let users know what specific device was added to the machine
22           in what location.
23
24           If you do not want this kind of information sent to the system
25           log, or have any doubts about this, say N here.
26
27 comment "Miscellaneous USB options"
28         depends on USB
29
30 config USB_DEVICEFS
31         bool "USB device filesystem"
32         depends on USB
33         ---help---
34           If you say Y here (and to "/proc file system support" in the "File
35           systems" section, above), you will get a file /proc/bus/usb/devices
36           which lists the devices currently connected to your USB bus or
37           busses, and for every connected device a file named
38           "/proc/bus/usb/xxx/yyy", where xxx is the bus number and yyy the
39           device number; the latter files can be used by user space programs
40           to talk directly to the device. These files are "virtual", meaning
41           they are generated on the fly and not stored on the hard drive.
42
43           You may need to mount the usbfs file system to see the files, use
44           mount -t usbfs none /proc/bus/usb
45
46           For the format of the various /proc/bus/usb/ files, please read
47           <file:Documentation/usb/proc_usb_info.txt>.
48
49           Usbfs files can't handle Access Control Lists (ACL), which are the
50           default way to grant access to USB devices for untrusted users of a
51           desktop system. The usbfs functionality is replaced by real
52           device-nodes managed by udev. These nodes live in /dev/bus/usb and
53           are used by libusb.
54
55 config USB_DEVICE_CLASS
56         bool "USB device class-devices (DEPRECATED)"
57         depends on USB
58         default y
59         ---help---
60           Userspace access to USB devices is granted by device-nodes exported
61           directly from the usbdev in sysfs. Old versions of the driver
62           core and udev needed additional class devices to export device nodes.
63
64           These additional devices are difficult to handle in userspace, if
65           information about USB interfaces must be available. One device
66           contains the device node, the other device contains the interface
67           data. Both devices are at the same level in sysfs (siblings) and one
68           can't access the other. The device node created directly by the
69           usb device is the parent device of the interface and therefore
70           easily accessible from the interface event.
71
72           This option provides backward compatibility for libusb device
73           nodes (lsusb) when usbfs is not used, and the following udev rule
74           doesn't exist:
75             SUBSYSTEM=="usb", ACTION=="add", ENV{DEVTYPE}=="usb_device", \
76             NAME="bus/usb/$env{BUSNUM}/$env{DEVNUM}", MODE="0644"
77
78 config USB_DYNAMIC_MINORS
79         bool "Dynamic USB minor allocation"
80         depends on USB
81         help
82           If you say Y here, the USB subsystem will use dynamic minor
83           allocation for any device that uses the USB major number.
84           This means that you can have more than 16 of a single type
85           of device (like USB printers).
86
87           If you are unsure about this, say N here.
88
89 config USB_SUSPEND
90         bool "USB selective suspend/resume and wakeup"
91         depends on USB && PM
92         help
93           If you say Y here, you can use driver calls or the sysfs
94           "power/level" file to suspend or resume individual USB
95           peripherals and to enable or disable autosuspend (see
96           Documentation/usb/power-management.txt for more details).
97
98           Also, USB "remote wakeup" signaling is supported, whereby some
99           USB devices (like keyboards and network adapters) can wake up
100           their parent hub.  That wakeup cascades up the USB tree, and
101           could wake the system from states like suspend-to-RAM.
102
103           If you are unsure about this, say N here.
104
105 config USB_OTG
106         bool
107         depends on USB && EXPERIMENTAL
108         select USB_SUSPEND
109         default n
110
111
112 config USB_OTG_WHITELIST
113         bool "Rely on OTG Targeted Peripherals List"
114         depends on USB_OTG || EMBEDDED
115         default y if USB_OTG
116         default n if EMBEDDED
117         help
118           If you say Y here, the "otg_whitelist.h" file will be used as a
119           product whitelist, so USB peripherals not listed there will be
120           rejected during enumeration.  This behavior is required by the
121           USB OTG specification for all devices not on your product's
122           "Targeted Peripherals List".  "Embedded Hosts" are likewise
123           allowed to support only a limited number of peripherals.
124
125           Otherwise, peripherals not listed there will only generate a
126           warning and enumeration will continue.  That's more like what
127           normal Linux-USB hosts do (other than the warning), and is
128           convenient for many stages of product development.
129
130 config USB_OTG_BLACKLIST_HUB
131         bool "Disable external hubs"
132         depends on USB_OTG || EMBEDDED
133         help
134           If you say Y here, then Linux will refuse to enumerate
135           external hubs.  OTG hosts are allowed to reduce hardware
136           and software costs by not supporting external hubs.  So
137           are "Embedded Hosts" that don't offer OTG support.
138