xref: /openbmc/linux/drivers/base/Kconfig (revision 113647a2)
11da177e4SLinus Torvaldsmenu "Generic Driver Options"
21da177e4SLinus Torvalds
36a8d8abbSKay Sieversconfig UEVENT_HELPER_PATH
46a8d8abbSKay Sievers	string "path to uevent helper"
56a8d8abbSKay Sievers	depends on HOTPLUG
67934779aSKay Sievers	default ""
76a8d8abbSKay Sievers	help
86a8d8abbSKay Sievers	  Path to uevent helper program forked by the kernel for
96a8d8abbSKay Sievers	  every uevent.
107934779aSKay Sievers	  Before the switch to the netlink-based uevent source, this was
117934779aSKay Sievers	  used to hook hotplug scripts into kernel device events. It
127934779aSKay Sievers	  usually pointed to a shell script at /sbin/hotplug.
137934779aSKay Sievers	  This should not be used today, because usual systems create
147934779aSKay Sievers	  many events at bootup or device discovery in a very short time
157934779aSKay Sievers	  frame. One forked process per event can create so many processes
167934779aSKay Sievers	  that it creates a high system load, or on smaller systems
177934779aSKay Sievers	  it is known to create out-of-memory situations during bootup.
186a8d8abbSKay Sievers
192b2af54aSKay Sieversconfig DEVTMPFS
204237e5fdSKay Sievers	bool "Maintain a devtmpfs filesystem to mount at /dev"
21da5e4ef7SPeter Korsgaard	depends on HOTPLUG
222b2af54aSKay Sievers	help
23da5e4ef7SPeter Korsgaard	  This creates a tmpfs/ramfs filesystem instance early at bootup.
244237e5fdSKay Sievers	  In this filesystem, the kernel driver core maintains device
254237e5fdSKay Sievers	  nodes with their default names and permissions for all
264237e5fdSKay Sievers	  registered devices with an assigned major/minor number.
274237e5fdSKay Sievers	  Userspace can modify the filesystem content as needed, add
284237e5fdSKay Sievers	  symlinks, and apply needed permissions.
294237e5fdSKay Sievers	  It provides a fully functional /dev directory, where usually
304237e5fdSKay Sievers	  udev runs on top, managing permissions and adding meaningful
314237e5fdSKay Sievers	  symlinks.
324237e5fdSKay Sievers	  In very limited environments, it may provide a sufficient
334237e5fdSKay Sievers	  functional /dev without any further help. It also allows simple
344237e5fdSKay Sievers	  rescue systems, and reliably handles dynamic major/minor numbers.
352b2af54aSKay Sievers
36da5e4ef7SPeter Korsgaard	  Notice: if CONFIG_TMPFS isn't enabled, the simpler ramfs
37da5e4ef7SPeter Korsgaard	  file system will be used instead.
38da5e4ef7SPeter Korsgaard
392b2af54aSKay Sieversconfig DEVTMPFS_MOUNT
404237e5fdSKay Sievers	bool "Automount devtmpfs at /dev, after the kernel mounted the rootfs"
412b2af54aSKay Sievers	depends on DEVTMPFS
422b2af54aSKay Sievers	help
434237e5fdSKay Sievers	  This will instruct the kernel to automatically mount the
444237e5fdSKay Sievers	  devtmpfs filesystem at /dev, directly after the kernel has
454237e5fdSKay Sievers	  mounted the root filesystem. The behavior can be overridden
464237e5fdSKay Sievers	  with the commandline parameter: devtmpfs.mount=0|1.
474237e5fdSKay Sievers	  This option does not affect initramfs based booting, here
484237e5fdSKay Sievers	  the devtmpfs filesystem always needs to be mounted manually
494237e5fdSKay Sievers	  after the roots is mounted.
504237e5fdSKay Sievers	  With this option enabled, it allows to bring up a system in
514237e5fdSKay Sievers	  rescue mode with init=/bin/sh, even when the /dev directory
524237e5fdSKay Sievers	  on the rootfs is completely empty.
532b2af54aSKay Sievers
541da177e4SLinus Torvaldsconfig STANDALONE
551da177e4SLinus Torvalds	bool "Select only drivers that don't need compile-time external firmware" if EXPERIMENTAL
561da177e4SLinus Torvalds	default y
571da177e4SLinus Torvalds	help
581da177e4SLinus Torvalds	  Select this option if you don't have magic firmware for drivers that
591da177e4SLinus Torvalds	  need it.
601da177e4SLinus Torvalds
611da177e4SLinus Torvalds	  If unsure, say Y.
621da177e4SLinus Torvalds
631da177e4SLinus Torvaldsconfig PREVENT_FIRMWARE_BUILD
641da177e4SLinus Torvalds	bool "Prevent firmware from being built"
651da177e4SLinus Torvalds	default y
661da177e4SLinus Torvalds	help
671da177e4SLinus Torvalds	  Say yes to avoid building firmware. Firmware is usually shipped
68*113647a2Smatt mooney	  with the driver and only when updating the firmware should a
69*113647a2Smatt mooney	  rebuild be made.
70*113647a2Smatt mooney	  If unsure, say Y here.
711da177e4SLinus Torvalds
721da177e4SLinus Torvaldsconfig FW_LOADER
736a108a14SDavid Rientjes	tristate "Userspace firmware loading support" if EXPERT
74d9b19199SAdrian Bunk	default y
751da177e4SLinus Torvalds	---help---
76*113647a2Smatt mooney	  This option is provided for the case where none of the in-tree modules
77*113647a2Smatt mooney	  require userspace firmware loading support, but a module built
78*113647a2Smatt mooney	  out-of-tree does.
791da177e4SLinus Torvalds
80d172e7f5SDavid Woodhouseconfig FIRMWARE_IN_KERNEL
81d172e7f5SDavid Woodhouse	bool "Include in-kernel firmware blobs in kernel binary"
82d172e7f5SDavid Woodhouse	depends on FW_LOADER
83d172e7f5SDavid Woodhouse	default y
84d172e7f5SDavid Woodhouse	help
85d172e7f5SDavid Woodhouse	  The kernel source tree includes a number of firmware 'blobs'
86*113647a2Smatt mooney	  that are used by various drivers. The recommended way to
87d172e7f5SDavid Woodhouse	  use these is to run "make firmware_install" and to copy the
88*113647a2Smatt mooney	  resulting binary files created in usr/lib/firmware/ of the
89*113647a2Smatt mooney	  kernel tree to /lib/firmware/ on your system so that they can
90*113647a2Smatt mooney	  be loaded by userspace helpers on request.
91d172e7f5SDavid Woodhouse
92d172e7f5SDavid Woodhouse	  Enabling this option will build each required firmware blob
93d172e7f5SDavid Woodhouse	  into the kernel directly, where request_firmware() will find
94d172e7f5SDavid Woodhouse	  them without having to call out to userspace. This may be
95*113647a2Smatt mooney	  useful if your root file system requires a device that uses
96*113647a2Smatt mooney	  such firmware and do not wish to use an initrd.
97d172e7f5SDavid Woodhouse
98d172e7f5SDavid Woodhouse	  This single option controls the inclusion of firmware for
99*113647a2Smatt mooney	  every driver that uses request_firmware() and ships its
100*113647a2Smatt mooney	  firmware in the kernel source tree, which avoids a
101*113647a2Smatt mooney	  proliferation of 'Include firmware for xxx device' options.
102d172e7f5SDavid Woodhouse
103d172e7f5SDavid Woodhouse	  Say 'N' and let firmware be loaded from userspace.
104d172e7f5SDavid Woodhouse
1054d2acfbfSDavid Woodhouseconfig EXTRA_FIRMWARE
1064d2acfbfSDavid Woodhouse	string "External firmware blobs to build into the kernel binary"
1074d2acfbfSDavid Woodhouse	depends on FW_LOADER
1084d2acfbfSDavid Woodhouse	help
109*113647a2Smatt mooney	  This option allows firmware to be built into the kernel for the case
110*113647a2Smatt mooney	  where the user either cannot or doesn't want to provide it from
1114d2acfbfSDavid Woodhouse	  userspace at runtime (for example, when the firmware in question is
1124d2acfbfSDavid Woodhouse	  required for accessing the boot device, and the user doesn't want to
1134d2acfbfSDavid Woodhouse	  use an initrd).
1144d2acfbfSDavid Woodhouse
115*113647a2Smatt mooney	  This option is a string and takes the (space-separated) names of the
116*113647a2Smatt mooney	  firmware files -- the same names that appear in MODULE_FIRMWARE()
1174d2acfbfSDavid Woodhouse	  and request_firmware() in the source. These files should exist under
1184d2acfbfSDavid Woodhouse	  the directory specified by the EXTRA_FIRMWARE_DIR option, which is
119*113647a2Smatt mooney	  by default the firmware subdirectory of the kernel source tree.
1204d2acfbfSDavid Woodhouse
121*113647a2Smatt mooney	  For example, you might set CONFIG_EXTRA_FIRMWARE="usb8388.bin", copy
122*113647a2Smatt mooney	  the usb8388.bin file into the firmware directory, and build the kernel.
123*113647a2Smatt mooney	  Then any request_firmware("usb8388.bin") will be satisfied internally
124*113647a2Smatt mooney	  without needing to call out to userspace.
1254d2acfbfSDavid Woodhouse
1264d2acfbfSDavid Woodhouse	  WARNING: If you include additional firmware files into your binary
127*113647a2Smatt mooney	  kernel image that are not available under the terms of the GPL,
1284d2acfbfSDavid Woodhouse	  then it may be a violation of the GPL to distribute the resulting
129*113647a2Smatt mooney	  image since it combines both GPL and non-GPL work. You should
1304d2acfbfSDavid Woodhouse	  consult a lawyer of your own before distributing such an image.
1314d2acfbfSDavid Woodhouse
1324d2acfbfSDavid Woodhouseconfig EXTRA_FIRMWARE_DIR
1334d2acfbfSDavid Woodhouse	string "Firmware blobs root directory"
1344d2acfbfSDavid Woodhouse	depends on EXTRA_FIRMWARE != ""
1354d2acfbfSDavid Woodhouse	default "firmware"
1364d2acfbfSDavid Woodhouse	help
1374d2acfbfSDavid Woodhouse	  This option controls the directory in which the kernel build system
1384d2acfbfSDavid Woodhouse	  looks for the firmware files listed in the EXTRA_FIRMWARE option.
139*113647a2Smatt mooney	  The default is firmware/ in the kernel source tree, but by changing
140*113647a2Smatt mooney	  this option you can point it elsewhere, such as /lib/firmware/ or
141*113647a2Smatt mooney	  some other directory containing the firmware files.
1424d2acfbfSDavid Woodhouse
1431da177e4SLinus Torvaldsconfig DEBUG_DRIVER
1441da177e4SLinus Torvalds	bool "Driver Core verbose debug messages"
1451da177e4SLinus Torvalds	depends on DEBUG_KERNEL
1461da177e4SLinus Torvalds	help
1471da177e4SLinus Torvalds	  Say Y here if you want the Driver core to produce a bunch of
1481da177e4SLinus Torvalds	  debug messages to the system log. Select this if you are having a
1491da177e4SLinus Torvalds	  problem with the driver core and want to see more of what is
1501da177e4SLinus Torvalds	  going on.
1511da177e4SLinus Torvalds
1521da177e4SLinus Torvalds	  If you are unsure about this, say N here.
1531da177e4SLinus Torvalds
1549ac7849eSTejun Heoconfig DEBUG_DEVRES
1559ac7849eSTejun Heo	bool "Managed device resources verbose debug messages"
1569ac7849eSTejun Heo	depends on DEBUG_KERNEL
1579ac7849eSTejun Heo	help
1589ac7849eSTejun Heo	  This option enables kernel parameter devres.log. If set to
1599ac7849eSTejun Heo	  non-zero, devres debug messages are printed. Select this if
1609ac7849eSTejun Heo	  you are having a problem with devres or want to debug
1619ac7849eSTejun Heo	  resource management for a managed device. devres.log can be
1629ac7849eSTejun Heo	  switched on and off from sysfs node.
1639ac7849eSTejun Heo
1649ac7849eSTejun Heo	  If you are unsure about this, Say N here.
1659ac7849eSTejun Heo
1664039483fSMichael Holzheuconfig SYS_HYPERVISOR
1674039483fSMichael Holzheu	bool
1684039483fSMichael Holzheu	default n
169eba6cd67SRandy Dunlap
170eba6cd67SRandy Dunlapendmenu
171