2005-10-03 18:28:11 +04:00
udev - userspace device management
For more information see the files in the docs/ directory.
Important Note:
Integrating udev in the system is a whole lot of work, has complex dependencies
2005-11-16 07:22:31 +03:00
and differs a lot from distro to distro. All reasonable distros depend on udev
these days and the system will not work without it.
2005-10-03 18:28:11 +04:00
The upstream udev project does not support or recomend to replace a distro's udev
installation with the upstream version. The installation of a unmodified upstream
version may render your system unusable! There is no "default" setup or a set
of "default" rules provided by the upstream udev version.
2005-11-16 07:22:31 +03:00
Requirements:
2005-11-17 20:05:29 +03:00
- 2.6.x version of the Linux kernel. See the RELEASE-NOTES file in the
udev tree and the Documentation/Changes in the kernel source tree for
the actual dependency.
2005-10-03 18:28:11 +04:00
2005-11-17 20:05:29 +03:00
- The kernel must have sysfs and unix domain socket enabled.
(unix domain sockets (CONFIG_UNIX) as a loadable kernel module may work,
but it is completely silly, don't complain if anything goes wrong.)
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
- The proc filesystem must be mounted on /proc.
2005-10-03 18:28:11 +04:00
2005-11-16 07:22:31 +03:00
- The sysfs filesystem must be mounted at /sys. No other location
2005-11-17 20:05:29 +03:00
will be 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
2005-12-07 22:40:38 +03:00
- Early in the boot process, /dev should get a tmpfs 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
2005-11-25 20:50:42 +03:00
- The udevd daemon must be started by an init script to receive netlink
2005-12-07 22:40:38 +03:00
uevents from the kernel driver core.
2005-10-03 18:28:11 +04:00
2005-11-17 20:05:29 +03:00
- From kernel version 2.6.15 on, the hotplug helper /sbin/hotplug should
2005-12-07 22:40:38 +03:00
be disabled with an init script before actions like loading kernel
modules are taken, which may cause a lot of events.
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
devices the kernel requests a device node, udev will create one with
the default name or the one specified by a matching udev rules.
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.
STRIPCMD
If udev is compiled for packaging an empty string can be passed
to disable the stripping of the binaries.
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.
USE_KLIBC
2005-11-16 07:22:31 +03:00
If set to 'true', udev is built and linked against klibc.
2005-11-09 17:42:07 +03:00
Default value is 'false'. KLCC specifies the klibc compiler
2005-11-16 07:22:31 +03:00
wrapper, usually located at /usr/bin/klcc.
2005-10-03 18:28:11 +04:00
EXTRAS
2005-11-16 07:22:31 +03:00
If set, will build the "extra" helper programs as specified
as listed (see below for an example).
2005-10-03 18:28:11 +04:00
2005-11-17 20:05:29 +03:00
If you want to build the udev helper programs:
make EXTRAS="extras/cdrom_id extras/scsi_id extras/volume_id"
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,
All at boot time reqired binaries will be installed in /sbin.
2005-11-16 07:22:31 +03:00
- The default location for scripts and binaries that are called from
2005-11-17 20:05:29 +03:00
rules is /lib/udev. Other packages who install udev rules, should use
2005-12-07 22:40:38 +03:00
that directory too.
2005-11-16 07:22:31 +03:00
- It is recommended to use the /lib/udev/devices directory to place
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.
- Copies of the rules files for all major distros are in the etc/udev
directory (you may look there how others distros are doing it).
- The persistent disk links in /dev/disk are the de facto standard
on Linux and should be installed with every default udev installation.
The devfs naming scheme rules are not recommended and not supported.
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:
linux-hotplug-devel@lists.sourceforge.net
2004-10-06 10:51:24 +04:00