2005-10-03 18:28:11 +04:00
udev - userspace device management
For more information see the files in the docs/ directory.
Important Note:
2007-09-21 12:33:36 +04:00
Integrating udev in the system has complex dependencies and differs from distro
to distro. All major distros depend on udev these days and the system may not
work without a properly installed version. The upstream udev project does not
recommend to replace a distro's udev installation with the upstream version.
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
Requirements:
2008-03-15 02:05:02 +03:00
- Version 2.6.18 of the Linux kernel for reliable operation of this release of
2006-08-07 05:13:27 +04:00
udev. The kernel may have a requirement on udev too, see Documentation/Changes
in the kernel source tree for the actual dependency.
2005-10-03 18:28:11 +04:00
2006-08-07 05:13:27 +04:00
- The kernel must have sysfs, unix domain sockets and networking enabled.
2005-11-17 20:05:29 +03:00
(unix domain sockets (CONFIG_UNIX) as a loadable kernel module may work,
2008-03-15 02:05:02 +03:00
but it does not make any sense - don't complain if anything goes wrong.)
2005-10-03 18:28:11 +04:00
2006-08-07 05:13:27 +04:00
- The proc filesystem must be mounted on /proc, the sysfs filesystem must
2008-03-15 02:05:02 +03:00
be mounted at /sys. No other locations are supported by udev.
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
Operation:
2005-11-17 20:05:29 +03:00
Udev creates and removes device nodes in /dev, based on events the kernel
sends out on device discovery or removal.
2005-10-03 18:28:11 +04:00
2006-08-07 05:13:27 +04:00
- Very early in the boot process, the /dev directory should get a 'tmpfs'
2006-04-02 18:01:00 +04:00
filesystem mounted, which is populated from scratch by udev. Created nodes
or changed permissions will not survive a reboot, which is intentional.
2005-11-16 07:22:31 +03:00
2005-11-25 20:50:42 +03:00
- The content of /lib/udev/devices directory which contains the nodes,
2005-12-07 22:40:38 +03:00
symlinks and directories, which are always expected to be in /dev, should
2005-11-25 20:50:42 +03:00
be copied over to the tmpfs mounted /dev, to provide the required nodes
to initialize udev and continue booting.
2005-11-16 07:22:31 +03:00
2006-08-07 05:13:27 +04:00
- The old hotplug helper /sbin/hotplug should be disabled on bootup, before
actions like loading kernel modules are taken, which may cause a lot of
events.
2005-10-03 18:28:11 +04:00
2006-08-07 05:13:27 +04:00
- The udevd daemon must be started on bootup to receive netlink uevents
from the kernel driver core.
2005-10-03 18:28:11 +04:00
2005-11-17 20:05:29 +03:00
- All kernel events are matched against a set of specified rules in
/etc/udev/rules.d/ which make it possible to hook into the event
processing to load required kernel modules and setup devices. For all
2006-04-02 18:01:00 +04:00
devices the kernel exports a major/minor number, udev will create a
2008-03-15 02:05:02 +03:00
device node with the default kernel name, or the one specified by a
2006-04-02 18:01:00 +04:00
matching udev rule.
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
Compile Options:
2005-10-03 18:28:11 +04:00
DESTDIR
2005-12-07 22:40:38 +03:00
Prefix of install target, used for package building.
2005-10-03 18:28:11 +04:00
USE_LOG
2005-11-17 20:05:29 +03:00
If set to 'true', udev is able to pass errors or debug information
to syslog. This is very useful to see what udev is doing or not doing.
It is enabled by default, don't expect any useful answer, if you
need to hunt a bug, but you can't enable syslog.
2005-10-03 18:28:11 +04:00
DEBUG
2005-11-16 07:22:31 +03:00
If set to 'true', very verbose debugging messages will be compiled
into the udev binaries. The actual level of debugging is specified
in the udev config file.
2005-10-03 18:28:11 +04:00
USE_SELINUX
2005-11-16 07:22:31 +03:00
If set to 'true', udev will be built with SELinux support
2005-10-03 18:28:11 +04:00
enabled. This is disabled by default.
EXTRAS
2006-04-02 18:01:00 +04:00
list of helper programs in extras/ to build.
make EXTRAS="extras/cdrom_id extras/scsi_id extras/volume_id"
2005-11-17 20:05:29 +03:00
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
Installation:
2005-11-17 20:05:29 +03:00
- The install target intalls the udev binaries in the default locations,
2008-03-15 02:05:02 +03:00
All binaries will be installed in /lib/udev or /sbin.
2005-11-16 07:22:31 +03:00
- The default location for scripts and binaries that are called from
2008-03-15 02:05:02 +03:00
rules is /lib/udev. Other packages who install udev rules, may use
2005-12-07 22:40:38 +03:00
that directory too.
2005-11-16 07:22:31 +03:00
2008-03-15 02:05:02 +03:00
- It is recommended to use the /lib/udev/devices/ directory to place
2005-11-16 07:22:31 +03:00
device nodes and symlinks in, which are copied to /dev at every boot.
That way, nodes for broken subsystems or devices which can't be
2005-11-17 20:05:29 +03:00
detected automatically by the kernel, will always be available.
2008-03-15 02:05:02 +03:00
- Default udev rules and persistent device naming rules are required by other
software that depends on the data udev collects from the devices,
2006-04-02 18:01:00 +04:00
and should be installed by default with every udev installation.
2005-11-16 07:22:31 +03:00
2005-10-03 18:28:11 +04:00
Please direct any comment/question/concern to the linux-hotplug-devel mailing list at:
2007-12-27 06:17:46 +03:00
linux-hotplug@vger.kernel.org
2004-10-06 10:51:24 +04:00