Find a file
2009-01-05 12:28:09 +01:00
docs/writing_udev_rules remove outdated docs/README-gcov_for_udev 2008-10-07 18:10:35 +02:00
extras usb_id: s/image/media/ 2009-01-05 03:44:28 +01:00
rules rules: Ubuntu merge - s/uucp/dialout/ 2009-01-04 17:01:47 +01:00
test string index - split nodes and childs to allow and unlimited number of childs 2008-11-12 05:50:05 +01:00
udev udevadm: s/udevinfo/udevadm info/ 2009-01-05 12:28:09 +01:00
.gitignore gitignore: move *.8 to subdirs 2008-09-29 05:03:43 +02:00
autogen.sh build: use autoreconf --symlink 2008-12-29 05:47:53 +01:00
ChangeLog release 135 2008-12-02 02:35:48 +01:00
configure.ac libudev: bump revision 2009-01-03 15:26:08 +01:00
COPYING update source file headers 2006-08-28 00:29:11 +02:00
INSTALL update INSTALL 2008-08-28 22:58:03 +02:00
Makefile.am make: do not delete autotools generated file with distclean 2008-12-06 04:03:08 +01:00
Makefile.am.inc libudev: get rid of selinux 2008-10-02 18:48:40 +02:00
NEWS update NEWS 2009-01-05 02:55:16 +01:00
README update NEWS 2009-01-04 17:38:33 +01:00
TODO rules: replace DVB shell script rule 2009-01-03 22:30:05 +01:00
udev.conf udevadm: control - use getopt_long() 2008-09-03 21:56:47 +02:00

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.22 of the Linux kernel for reliable operation of this release of
    udev. The kernel must not use the CONFIG_SYSFS_DEPRECATED* option.

  - The kernel must have sysfs, unix domain sockets and networking enabled.
    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.

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

  - Very early in the boot process, the /dev/ directory 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.

  - 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 on bootup, before
    actions like loading kernel modules are taken, which may cause a lot of
    events.

  - The udevd daemon must be started on bootup to receive netlink uevents
    from the kernel driver core.

  - 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