Ninjatrappeur's systemd working tree
Go to file
Martin Pitt 2417dc20f5 keymap: move from udev-extras 2009-06-17 11:56:52 +02:00
docs/writing_udev_rules doc: writing udev rules - refer to 'udevadm info' instead of 'udevinfo' 2009-01-24 15:24:01 +01:00
extras keymap: move from udev-extras 2009-06-17 11:56:52 +02:00
libudev cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
m4 libudev: add gtk-doc 2009-06-15 13:22:21 +02:00
rules rules: remove MMC rule, 2.6.30 has the modalias 2009-06-17 02:33:49 +02:00
test test: check string substitutions in OWNER and GROUP 2009-05-22 20:54:46 +02:00
udev cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
.gitignore libudev: add gtk-doc 2009-06-15 13:22:21 +02:00
COPYING update source file headers 2006-08-28 00:29:11 +02:00
ChangeLog release 142 2009-05-13 02:35:37 +02:00
INSTALL cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
Makefile.am gudev: move from udev-extras 2009-06-16 17:52:15 +02:00
Makefile.am.inc cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
NEWS cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
README configure: enable all extras by default, provide --disable-extras 2009-06-16 21:13:15 +02:00
TODO rules: remove MMC rule, 2.6.30 has the modalias 2009-06-17 02:33:49 +02:00
autogen.sh cleanup ./configure installation directory options 2009-06-17 02:25:07 +02:00
configure.ac keymap: move from udev-extras 2009-06-17 11:56:52 +02:00
udev.conf udevadm: control - use getopt_long() 2008-09-03 21:56:47 +02:00

README

udev - userspace device management

For more information see the files in the docs/ directory.

Important Note:
  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.

Requirements:
  - Version 2.6.25 of the Linux kernel with sysfs, procfs, signalfd, inotify,
    unix domain sockets, networking and hotplug enabled:
      CONFIG_HOTPLUG=y
      CONFIG_UEVENT_HELPER_PATH=""
      CONFIG_NET=y
      CONFIG_UNIX=y
      CONFIG_SYSFS=y
      CONFIG_SYSFS_DEPRECATED*=n
      CONFIG_PROC_FS=y
      CONFIG_TMPFS=y
      CONFIG_TMPFS_POSIX_ACL=y
      CONFIG_INOTIFY=y
      CONFIG_SIGNALFD=y

  - For reliable operation, the kernel must not use the CONFIG_SYSFS_DEPRECATED*
    option.

  - Unix domain sockets (CONFIG_UNIX) as a loadable kernel module is not
    supported.

  - The proc filesystem must be mounted on /proc/, the sysfs filesystem must
    be mounted at /sys/. No other locations are supported by udev.

  - The system must have the following group names resolvable at udev startup:
      disk, cdrom, floppy, tape, audio, video, lp, tty, dialout, kmem.
    Especially in LDAP setups, it is required, that getgrnam() is able to resolve
    these group names with only the rootfs mounted, and while no network is
    available.

  - To build all udev extras, libacl, libglib2, libusb, usbutils, pciutils are
    needed. These dependencies can be disabled with the --disable-extras option.

Operation:
  Udev creates and removes device nodes in /dev/, based on events the kernel
  sends out on device discovery or removal.

  - Early in the boot process, the /dev/ directory should get a 'tmpfs'
    filesystem mounted, which is maintained by udev. Created nodes or changed
    permissions will not survive a reboot, which is intentional.

  - The content of /lib/udev/devices/ directory which contains the nodes,
    symlinks and directories, which are always expected to be in /dev, should
    be copied over to the tmpfs mounted /dev, to provide the required nodes
    to initialize udev and continue booting.

  - The old hotplug helper /sbin/hotplug should be disabled in the kernel
    configuration, it is not needed, and may render the system unusable
    because of a fork-bombing behavior.

  - All kernel events are matched against a set of specified rules in
    /lib/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 exports a major/minor number, udev will create a
    device node with the default kernel name, or the one specified by a
    matching udev rule.

Please direct any comment/question/concern to the linux-hotplug mailing list at:
  linux-hotplug@vger.kernel.org