xref: /openbmc/linux/drivers/base/Kconfig (revision da5e4ef7)
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"
21*da5e4ef7SPeter Korsgaard	depends on HOTPLUG
222b2af54aSKay Sievers	help
23*da5e4ef7SPeter 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
36*da5e4ef7SPeter Korsgaard	  Notice: if CONFIG_TMPFS isn't enabled, the simpler ramfs
37*da5e4ef7SPeter Korsgaard	  file system will be used instead.
38*da5e4ef7SPeter 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
681da177e4SLinus Torvalds	  with the driver, and only when updating the firmware a rebuild
691da177e4SLinus Torvalds	  should be made.
701da177e4SLinus Torvalds	  If unsure say Y here.
711da177e4SLinus Torvalds
721da177e4SLinus Torvaldsconfig FW_LOADER
73d9b19199SAdrian Bunk	tristate "Userspace firmware loading support" if EMBEDDED
74135c294fSAndrew Morton	depends on HOTPLUG
75d9b19199SAdrian Bunk	default y
761da177e4SLinus Torvalds	---help---
771da177e4SLinus Torvalds	  This option is provided for the case where no in-kernel-tree modules
78312c004dSKay Sievers	  require userspace firmware loading support, but a module built outside
791da177e4SLinus Torvalds	  the kernel tree does.
801da177e4SLinus Torvalds
81d172e7f5SDavid Woodhouseconfig FIRMWARE_IN_KERNEL
82d172e7f5SDavid Woodhouse	bool "Include in-kernel firmware blobs in kernel binary"
83d172e7f5SDavid Woodhouse	depends on FW_LOADER
84d172e7f5SDavid Woodhouse	default y
85d172e7f5SDavid Woodhouse	help
86d172e7f5SDavid Woodhouse	  The kernel source tree includes a number of firmware 'blobs'
87d172e7f5SDavid Woodhouse	  which are used by various drivers. The recommended way to
88d172e7f5SDavid Woodhouse	  use these is to run "make firmware_install" and to copy the
89d172e7f5SDavid Woodhouse	  resulting binary files created in usr/lib/firmware directory
90d172e7f5SDavid Woodhouse	  of the kernel tree to the /lib/firmware on your system so
91d172e7f5SDavid Woodhouse	  that they can be loaded by userspace helpers on request.
92d172e7f5SDavid Woodhouse
93d172e7f5SDavid Woodhouse	  Enabling this option will build each required firmware blob
94d172e7f5SDavid Woodhouse	  into the kernel directly, where request_firmware() will find
95d172e7f5SDavid Woodhouse	  them without having to call out to userspace. This may be
96d172e7f5SDavid Woodhouse	  useful if your root file system requires a device which uses
97d172e7f5SDavid Woodhouse	  such firmware, and do not wish to use an initrd.
98d172e7f5SDavid Woodhouse
99d172e7f5SDavid Woodhouse	  This single option controls the inclusion of firmware for
10011f1fbcfSNick Andrew	  every driver which uses request_firmware() and ships its
101d172e7f5SDavid Woodhouse	  firmware in the kernel source tree, to avoid a proliferation
102d172e7f5SDavid Woodhouse	  of 'Include firmware for xxx device' options.
103d172e7f5SDavid Woodhouse
104d172e7f5SDavid Woodhouse	  Say 'N' and let firmware be loaded from userspace.
105d172e7f5SDavid Woodhouse
1064d2acfbfSDavid Woodhouseconfig EXTRA_FIRMWARE
1074d2acfbfSDavid Woodhouse	string "External firmware blobs to build into the kernel binary"
1084d2acfbfSDavid Woodhouse	depends on FW_LOADER
1094d2acfbfSDavid Woodhouse	help
1104d2acfbfSDavid Woodhouse	  This option allows firmware to be built into the kernel, for the
1114d2acfbfSDavid Woodhouse	  cases where the user either cannot or doesn't want to provide it from
1124d2acfbfSDavid Woodhouse	  userspace at runtime (for example, when the firmware in question is
1134d2acfbfSDavid Woodhouse	  required for accessing the boot device, and the user doesn't want to
1144d2acfbfSDavid Woodhouse	  use an initrd).
1154d2acfbfSDavid Woodhouse
1164d2acfbfSDavid Woodhouse	  This option is a string, and takes the (space-separated) names of the
1174d2acfbfSDavid Woodhouse	  firmware files -- the same names which appear in MODULE_FIRMWARE()
1184d2acfbfSDavid Woodhouse	  and request_firmware() in the source. These files should exist under
1194d2acfbfSDavid Woodhouse	  the directory specified by the EXTRA_FIRMWARE_DIR option, which is
1204d2acfbfSDavid Woodhouse	  by default the firmware/ subdirectory of the kernel source tree.
1214d2acfbfSDavid Woodhouse
1224d2acfbfSDavid Woodhouse	  So, for example, you might set CONFIG_EXTRA_FIRMWARE="usb8388.bin",
1234d2acfbfSDavid Woodhouse	  copy the usb8388.bin file into the firmware/ directory, and build the
1244d2acfbfSDavid Woodhouse	  kernel. Then any request_firmware("usb8388.bin") will be
1254d2acfbfSDavid Woodhouse	  satisfied internally without needing to call out to userspace.
1264d2acfbfSDavid Woodhouse
1274d2acfbfSDavid Woodhouse	  WARNING: If you include additional firmware files into your binary
1284d2acfbfSDavid Woodhouse	  kernel image which are not available under the terms of the GPL,
1294d2acfbfSDavid Woodhouse	  then it may be a violation of the GPL to distribute the resulting
1304d2acfbfSDavid Woodhouse	  image -- since it combines both GPL and non-GPL work. You should
1314d2acfbfSDavid Woodhouse	  consult a lawyer of your own before distributing such an image.
1324d2acfbfSDavid Woodhouse
1334d2acfbfSDavid Woodhouseconfig EXTRA_FIRMWARE_DIR
1344d2acfbfSDavid Woodhouse	string "Firmware blobs root directory"
1354d2acfbfSDavid Woodhouse	depends on EXTRA_FIRMWARE != ""
1364d2acfbfSDavid Woodhouse	default "firmware"
1374d2acfbfSDavid Woodhouse	help
1384d2acfbfSDavid Woodhouse	  This option controls the directory in which the kernel build system
1394d2acfbfSDavid Woodhouse	  looks for the firmware files listed in the EXTRA_FIRMWARE option.
1404d2acfbfSDavid Woodhouse	  The default is the firmware/ directory in the kernel source tree,
1414d2acfbfSDavid Woodhouse	  but by changing this option you can point it elsewhere, such as
1424d2acfbfSDavid Woodhouse	  the /lib/firmware/ directory or another separate directory
1434d2acfbfSDavid Woodhouse	  containing firmware files.
1444d2acfbfSDavid Woodhouse
1451da177e4SLinus Torvaldsconfig DEBUG_DRIVER
1461da177e4SLinus Torvalds	bool "Driver Core verbose debug messages"
1471da177e4SLinus Torvalds	depends on DEBUG_KERNEL
1481da177e4SLinus Torvalds	help
1491da177e4SLinus Torvalds	  Say Y here if you want the Driver core to produce a bunch of
1501da177e4SLinus Torvalds	  debug messages to the system log. Select this if you are having a
1511da177e4SLinus Torvalds	  problem with the driver core and want to see more of what is
1521da177e4SLinus Torvalds	  going on.
1531da177e4SLinus Torvalds
1541da177e4SLinus Torvalds	  If you are unsure about this, say N here.
1551da177e4SLinus Torvalds
1569ac7849eSTejun Heoconfig DEBUG_DEVRES
1579ac7849eSTejun Heo	bool "Managed device resources verbose debug messages"
1589ac7849eSTejun Heo	depends on DEBUG_KERNEL
1599ac7849eSTejun Heo	help
1609ac7849eSTejun Heo	  This option enables kernel parameter devres.log. If set to
1619ac7849eSTejun Heo	  non-zero, devres debug messages are printed. Select this if
1629ac7849eSTejun Heo	  you are having a problem with devres or want to debug
1639ac7849eSTejun Heo	  resource management for a managed device. devres.log can be
1649ac7849eSTejun Heo	  switched on and off from sysfs node.
1659ac7849eSTejun Heo
1669ac7849eSTejun Heo	  If you are unsure about this, Say N here.
1679ac7849eSTejun Heo
1684039483fSMichael Holzheuconfig SYS_HYPERVISOR
1694039483fSMichael Holzheu	bool
1704039483fSMichael Holzheu	default n
171eba6cd67SRandy Dunlap
172eba6cd67SRandy Dunlapendmenu
173