Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | menu "Generic Driver Options" |
| 2 | |
Kay Sievers | 6a8d8ab | 2007-08-15 15:38:28 +0200 | [diff] [blame] | 3 | config UEVENT_HELPER_PATH |
| 4 | string "path to uevent helper" |
| 5 | depends on HOTPLUG |
Kay Sievers | 7934779 | 2010-01-14 22:49:39 +0100 | [diff] [blame] | 6 | default "" |
Kay Sievers | 6a8d8ab | 2007-08-15 15:38:28 +0200 | [diff] [blame] | 7 | help |
| 8 | Path to uevent helper program forked by the kernel for |
| 9 | every uevent. |
Kay Sievers | 7934779 | 2010-01-14 22:49:39 +0100 | [diff] [blame] | 10 | Before the switch to the netlink-based uevent source, this was |
| 11 | used to hook hotplug scripts into kernel device events. It |
| 12 | usually pointed to a shell script at /sbin/hotplug. |
| 13 | This should not be used today, because usual systems create |
| 14 | many events at bootup or device discovery in a very short time |
| 15 | frame. One forked process per event can create so many processes |
| 16 | that it creates a high system load, or on smaller systems |
| 17 | it is known to create out-of-memory situations during bootup. |
Kay Sievers | 6a8d8ab | 2007-08-15 15:38:28 +0200 | [diff] [blame] | 18 | |
Márton Németh | 573c977 | 2011-06-19 22:30:16 +0200 | [diff] [blame^] | 19 | To disable user space helper program execution at early boot |
| 20 | time specify an empty string here. This setting can be altered |
| 21 | via /proc/sys/kernel/hotplug or via /sys/kernel/uevent_helper |
| 22 | later at runtime. |
| 23 | |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 24 | config DEVTMPFS |
Kay Sievers | 4237e5f | 2010-01-14 22:47:57 +0100 | [diff] [blame] | 25 | bool "Maintain a devtmpfs filesystem to mount at /dev" |
Peter Korsgaard | da5e4ef | 2010-03-16 21:55:21 +0100 | [diff] [blame] | 26 | depends on HOTPLUG |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 27 | help |
Peter Korsgaard | da5e4ef | 2010-03-16 21:55:21 +0100 | [diff] [blame] | 28 | This creates a tmpfs/ramfs filesystem instance early at bootup. |
Kay Sievers | 4237e5f | 2010-01-14 22:47:57 +0100 | [diff] [blame] | 29 | In this filesystem, the kernel driver core maintains device |
| 30 | nodes with their default names and permissions for all |
| 31 | registered devices with an assigned major/minor number. |
| 32 | Userspace can modify the filesystem content as needed, add |
| 33 | symlinks, and apply needed permissions. |
| 34 | It provides a fully functional /dev directory, where usually |
| 35 | udev runs on top, managing permissions and adding meaningful |
| 36 | symlinks. |
| 37 | In very limited environments, it may provide a sufficient |
| 38 | functional /dev without any further help. It also allows simple |
| 39 | rescue systems, and reliably handles dynamic major/minor numbers. |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 40 | |
Peter Korsgaard | da5e4ef | 2010-03-16 21:55:21 +0100 | [diff] [blame] | 41 | Notice: if CONFIG_TMPFS isn't enabled, the simpler ramfs |
| 42 | file system will be used instead. |
| 43 | |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 44 | config DEVTMPFS_MOUNT |
Kay Sievers | 4237e5f | 2010-01-14 22:47:57 +0100 | [diff] [blame] | 45 | bool "Automount devtmpfs at /dev, after the kernel mounted the rootfs" |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 46 | depends on DEVTMPFS |
| 47 | help |
Kay Sievers | 4237e5f | 2010-01-14 22:47:57 +0100 | [diff] [blame] | 48 | This will instruct the kernel to automatically mount the |
| 49 | devtmpfs filesystem at /dev, directly after the kernel has |
| 50 | mounted the root filesystem. The behavior can be overridden |
| 51 | with the commandline parameter: devtmpfs.mount=0|1. |
| 52 | This option does not affect initramfs based booting, here |
| 53 | the devtmpfs filesystem always needs to be mounted manually |
| 54 | after the roots is mounted. |
| 55 | With this option enabled, it allows to bring up a system in |
| 56 | rescue mode with init=/bin/sh, even when the /dev directory |
| 57 | on the rootfs is completely empty. |
Kay Sievers | 2b2af54 | 2009-04-30 15:23:42 +0200 | [diff] [blame] | 58 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 59 | config STANDALONE |
| 60 | bool "Select only drivers that don't need compile-time external firmware" if EXPERIMENTAL |
| 61 | default y |
| 62 | help |
| 63 | Select this option if you don't have magic firmware for drivers that |
| 64 | need it. |
| 65 | |
| 66 | If unsure, say Y. |
| 67 | |
| 68 | config PREVENT_FIRMWARE_BUILD |
| 69 | bool "Prevent firmware from being built" |
| 70 | default y |
| 71 | help |
| 72 | Say yes to avoid building firmware. Firmware is usually shipped |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 73 | with the driver and only when updating the firmware should a |
| 74 | rebuild be made. |
| 75 | If unsure, say Y here. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 76 | |
| 77 | config FW_LOADER |
David Rientjes | 6a108a1 | 2011-01-20 14:44:16 -0800 | [diff] [blame] | 78 | tristate "Userspace firmware loading support" if EXPERT |
Adrian Bunk | d9b1919 | 2008-06-10 19:04:08 +0300 | [diff] [blame] | 79 | default y |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 80 | ---help--- |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 81 | This option is provided for the case where none of the in-tree modules |
| 82 | require userspace firmware loading support, but a module built |
| 83 | out-of-tree does. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 84 | |
David Woodhouse | d172e7f | 2008-06-25 13:56:07 +0100 | [diff] [blame] | 85 | config FIRMWARE_IN_KERNEL |
| 86 | bool "Include in-kernel firmware blobs in kernel binary" |
| 87 | depends on FW_LOADER |
| 88 | default y |
| 89 | help |
| 90 | The kernel source tree includes a number of firmware 'blobs' |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 91 | that are used by various drivers. The recommended way to |
matt mooney | 156faf9 | 2011-06-12 11:17:31 -0700 | [diff] [blame] | 92 | use these is to run "make firmware_install", which, after |
| 93 | converting ihex files to binary, copies all of the needed |
| 94 | binary files in firmware/ to /lib/firmware/ on your system so |
| 95 | that they can be loaded by userspace helpers on request. |
David Woodhouse | d172e7f | 2008-06-25 13:56:07 +0100 | [diff] [blame] | 96 | |
| 97 | Enabling this option will build each required firmware blob |
| 98 | into the kernel directly, where request_firmware() will find |
| 99 | them without having to call out to userspace. This may be |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 100 | useful if your root file system requires a device that uses |
| 101 | such firmware and do not wish to use an initrd. |
David Woodhouse | d172e7f | 2008-06-25 13:56:07 +0100 | [diff] [blame] | 102 | |
| 103 | This single option controls the inclusion of firmware for |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 104 | every driver that uses request_firmware() and ships its |
| 105 | firmware in the kernel source tree, which avoids a |
| 106 | proliferation of 'Include firmware for xxx device' options. |
David Woodhouse | d172e7f | 2008-06-25 13:56:07 +0100 | [diff] [blame] | 107 | |
| 108 | Say 'N' and let firmware be loaded from userspace. |
| 109 | |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 110 | config EXTRA_FIRMWARE |
| 111 | string "External firmware blobs to build into the kernel binary" |
| 112 | depends on FW_LOADER |
| 113 | help |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 114 | This option allows firmware to be built into the kernel for the case |
| 115 | where the user either cannot or doesn't want to provide it from |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 116 | userspace at runtime (for example, when the firmware in question is |
| 117 | required for accessing the boot device, and the user doesn't want to |
| 118 | use an initrd). |
| 119 | |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 120 | This option is a string and takes the (space-separated) names of the |
| 121 | firmware files -- the same names that appear in MODULE_FIRMWARE() |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 122 | and request_firmware() in the source. These files should exist under |
| 123 | the directory specified by the EXTRA_FIRMWARE_DIR option, which is |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 124 | by default the firmware subdirectory of the kernel source tree. |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 125 | |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 126 | For example, you might set CONFIG_EXTRA_FIRMWARE="usb8388.bin", copy |
| 127 | the usb8388.bin file into the firmware directory, and build the kernel. |
| 128 | Then any request_firmware("usb8388.bin") will be satisfied internally |
| 129 | without needing to call out to userspace. |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 130 | |
| 131 | WARNING: If you include additional firmware files into your binary |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 132 | kernel image that are not available under the terms of the GPL, |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 133 | then it may be a violation of the GPL to distribute the resulting |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 134 | image since it combines both GPL and non-GPL work. You should |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 135 | consult a lawyer of your own before distributing such an image. |
| 136 | |
| 137 | config EXTRA_FIRMWARE_DIR |
| 138 | string "Firmware blobs root directory" |
| 139 | depends on EXTRA_FIRMWARE != "" |
| 140 | default "firmware" |
| 141 | help |
| 142 | This option controls the directory in which the kernel build system |
| 143 | looks for the firmware files listed in the EXTRA_FIRMWARE option. |
matt mooney | 113647a | 2011-06-12 11:17:30 -0700 | [diff] [blame] | 144 | The default is firmware/ in the kernel source tree, but by changing |
| 145 | this option you can point it elsewhere, such as /lib/firmware/ or |
| 146 | some other directory containing the firmware files. |
David Woodhouse | 4d2acfb | 2008-05-23 13:58:12 +0100 | [diff] [blame] | 147 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 148 | config DEBUG_DRIVER |
| 149 | bool "Driver Core verbose debug messages" |
| 150 | depends on DEBUG_KERNEL |
| 151 | help |
| 152 | Say Y here if you want the Driver core to produce a bunch of |
| 153 | debug messages to the system log. Select this if you are having a |
| 154 | problem with the driver core and want to see more of what is |
| 155 | going on. |
| 156 | |
| 157 | If you are unsure about this, say N here. |
| 158 | |
Tejun Heo | 9ac7849 | 2007-01-20 16:00:26 +0900 | [diff] [blame] | 159 | config DEBUG_DEVRES |
| 160 | bool "Managed device resources verbose debug messages" |
| 161 | depends on DEBUG_KERNEL |
| 162 | help |
| 163 | This option enables kernel parameter devres.log. If set to |
| 164 | non-zero, devres debug messages are printed. Select this if |
| 165 | you are having a problem with devres or want to debug |
| 166 | resource management for a managed device. devres.log can be |
| 167 | switched on and off from sysfs node. |
| 168 | |
| 169 | If you are unsure about this, Say N here. |
| 170 | |
Michael Holzheu | 4039483 | 2006-05-09 12:53:49 +0200 | [diff] [blame] | 171 | config SYS_HYPERVISOR |
| 172 | bool |
| 173 | default n |
Randy Dunlap | eba6cd6 | 2006-10-28 10:38:55 -0700 | [diff] [blame] | 174 | |
| 175 | endmenu |