1
0
mirror of https://github.com/systemd/systemd.git synced 2024-12-25 01:34:28 +03:00
The systemd System and Service Manager
Go to file
Kay Sievers 963033472f usb_id: fail if vendor/product can not be retrieved
Thanks to Daniel Drake for identifying the bug.
2007-10-15 20:38:20 +02:00
docs remove outdated documentation 2006-12-08 10:10:56 +01:00
etc/udev rules: fix typos 2007-10-14 14:48:14 +02:00
extras usb_id: fail if vendor/product can not be retrieved 2007-10-15 20:38:20 +02:00
test accept relative path for TEST 2007-08-16 12:45:31 +02:00
.gitignore rename "udev.c" to "test-udev.c" - it is only for testing 2006-12-08 10:29:17 +01:00
ChangeLog release 116 2007-10-14 15:17:32 +02:00
COPYING update source file headers 2006-08-28 00:29:11 +02:00
FAQ remove broken %e enumeration 2006-07-04 12:27:00 +02:00
list.h [PATCH] cleanup list.h 2005-04-26 23:51:00 -07:00
logging.h update TODO 2006-09-02 14:26:44 +02:00
Makefile release 116 2007-10-14 15:17:32 +02:00
README update README 2007-09-21 10:33:36 +02:00
RELEASE-NOTES release 116 2007-10-14 15:17:32 +02:00
test-udev.c add udev_rules_run() to handle RUN list 2007-07-14 20:44:19 +02:00
TODO finally remove the directory event-multiplexer crap 2007-03-28 20:35:05 +02:00
udev_config.c check line length after comment check and whitespace strip 2007-09-11 17:17:29 +02:00
udev_db.c track "move" events to rename database and failed files 2007-08-26 05:22:35 +02:00
udev_device.c do not delete the device node with ignore_remove, but handle the event 2007-08-29 14:11:37 +02:00
udev_node.c prevent wrong symlink creation if database disagress with current rules 2007-09-20 19:38:58 +02:00
udev_rules_parse.c print warning for invalid TEST operations 2007-08-29 22:19:28 +02:00
udev_rules.c fix wrong variable used in logged string 2007-09-21 00:55:19 +02:00
udev_rules.h allow SYMLINK== match 2007-07-16 13:29:28 +02:00
udev_selinux.c correct includes in udev_selinux.c 2007-09-06 13:12:48 +02:00
udev_selinux.h update source file headers 2006-08-28 00:29:11 +02:00
udev_sysdeps.c update TODO 2006-09-02 14:26:44 +02:00
udev_sysdeps.h inotify syscall definitions for M32R 2006-12-06 15:01:30 +01:00
udev_sysfs.c fix debug output string 2007-09-25 13:45:49 +02:00
udev_utils_file.c handle dynamic rules created in /dev/.udev/rules.d/ 2007-07-15 19:10:06 +02:00
udev_utils_string.c replace_chars: replace spaces in node name 2007-05-17 20:01:54 +02:00
udev_utils.c name_list: rename loop_name -> name_loop 2007-07-15 19:01:01 +02:00
udev.7 do not delete the device node with ignore_remove, but handle the event 2007-08-29 14:11:37 +02:00
udev.h track "move" events to rename database and failed files 2007-08-26 05:22:35 +02:00
udev.xml do not delete the device node with ignore_remove, but handle the event 2007-08-29 14:11:37 +02:00
udevcontrol.c udevcontrol: allow to set global variables in udevd 2007-04-26 22:52:20 +02:00
udevd.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevd.c use SEQNUM in /dev/.udev/queue/ instead of devpath 2007-09-20 00:41:54 +02:00
udevd.h track "move" events to rename database and failed files 2007-08-26 05:22:35 +02:00
udevd.xml udevcontrol: allow to set global variables in udevd 2007-04-26 22:52:20 +02:00
udevinfo.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevinfo.c udevinfo: simplify symlink printing logic 2007-09-20 15:25:29 +02:00
udevinfo.xml man: add missing options to various man pages 2007-03-07 18:00:12 +01:00
udevmonitor.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevmonitor.c set buffer size if strlcpy/strlcat indicate truncation 2007-08-24 08:14:21 +02:00
udevmonitor.xml udevmonitor: add switch for kernel and udev events 2007-03-10 15:12:42 +01:00
udevsettle.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevsettle.c udevsettle: use long options 2007-05-17 02:17:13 +02:00
udevsettle.xml man pages: work around xmlto which tries to be smart 2006-07-29 02:08:58 +02:00
udevstart.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevstart.c add udev_rules_run() to handle RUN list 2007-07-14 20:44:19 +02:00
udevstart.xml man pages: work around xmlto which tries to be smart 2006-07-29 02:08:58 +02:00
udevtest.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevtest.c udevtrigger: allow to specify action string 2007-07-09 03:59:08 +02:00
udevtest.xml man pages: fix typos 2006-08-17 00:58:37 +02:00
udevtrigger.8 man: recreate man pages 2007-08-28 04:24:08 +02:00
udevtrigger.c set buffer size if strlcpy/strlcat indicate truncation 2007-08-24 08:14:21 +02:00
udevtrigger.xml udevtrigger: allow to specify action string 2007-07-09 03:59:08 +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.15 of the Linux kernel for reliable operation of this release of
    udev. The kernel may have a requirement on udev too, see Documentation/Changes
    in the kernel source tree for the actual dependency.

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

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


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
    /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 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.


Compile Options:
  DESTDIR
  	Prefix of install target, used for package building.
  USE_LOG
  	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.
  DEBUG
  	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.
  USE_SELINUX
  	If set to 'true', udev will be built with SELinux support
  	enabled.  This is disabled by default.
  EXTRAS
  	list of helper programs in extras/ to build.
        make EXTRAS="extras/cdrom_id extras/scsi_id extras/volume_id"


Installation:
  - The install target intalls the udev binaries in the default locations,
    All at boot time reqired binaries will be installed in /lib/udev or /sbin.

  - The default location for scripts and binaries that are called from
    rules is /lib/udev. Other packages who install udev rules, should use
    that directory too.

  - 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
    detected automatically by the kernel, will always be available.

  - Copies of the rules files for the major distros are provided as examples
    in the etc/udev directory.

  - The persistent device naming links in /dev/disk/ are required by other
    software that depends on the data udev has collected from the devices
    and should be installed by default with every udev installation.

Please direct any comment/question/concern to the linux-hotplug-devel mailing list at:
  linux-hotplug-devel@lists.sourceforge.net