chiark / gitweb /
add a bunch of private device properties to udev_device
[elogind.git] / README
1 udev - userspace device management
2
3 For more information see the files in the docs/ directory.
4
5 Important Note:
6   Integrating udev in the system has complex dependencies and differs from distro
7   to distro. All major distros depend on udev these days and the system may not
8   work without a properly installed version. The upstream udev project does not
9   recommend to replace a distro's udev installation with the upstream version.
10
11 Requirements:
12   - Version 2.6.18 of the Linux kernel for reliable operation of this release of
13     udev. The kernel may have a requirement on udev too, see Documentation/Changes
14     in the kernel source tree for the actual dependency.
15
16   - The kernel must have sysfs, unix domain sockets and networking enabled.
17     (unix domain sockets (CONFIG_UNIX) as a loadable kernel module may work,
18     but it does not make any sense - don't complain if anything goes wrong.)
19
20   - The proc filesystem must be mounted on /proc/, the sysfs filesystem must
21     be mounted at /sys/. No other locations are supported by udev.
22
23
24 Operation:
25   Udev creates and removes device nodes in /dev/, based on events the kernel
26   sends out on device discovery or removal.
27
28   - Very early in the boot process, the /dev/ directory should get a 'tmpfs'
29     filesystem mounted, which is populated from scratch by udev. Created nodes
30     or changed permissions will not survive a reboot, which is intentional.
31
32   - The content of /lib/udev/devices/ directory which contains the nodes,
33     symlinks and directories, which are always expected to be in /dev, should
34     be copied over to the tmpfs mounted /dev, to provide the required nodes
35     to initialize udev and continue booting.
36
37   - The old hotplug helper /sbin/hotplug should be disabled on bootup, before
38     actions like loading kernel modules are taken, which may cause a lot of
39     events.
40
41   - The udevd daemon must be started on bootup to receive netlink uevents
42     from the kernel driver core.
43
44   - All kernel events are matched against a set of specified rules in
45     /lib/udev/rules.d/ which make it possible to hook into the event
46     processing to load required kernel modules and setup devices. For all
47     devices the kernel exports a major/minor number, udev will create a
48     device node with the default kernel name, or the one specified by a
49     matching udev rule.
50
51 Please direct any comment/question/concern to the linux-hotplug mailing list at:
52   linux-hotplug@vger.kernel.org
53