1
0
mirror of https://github.com/systemd/systemd.git synced 2024-12-23 21:35:11 +03:00
The systemd System and Service Manager
Go to file
Kay Sievers e0dc4f00ba move some helpers from extras to /lib/udev
Signed-off-by: Kay Sievers <kay.sievers@suse.de>
2005-11-22 17:31:38 +01:00
docs remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
etc/udev update README and RELEASE-NOTES 2005-11-16 05:22:31 +01:00
extras move some helpers from extras to /lib/udev 2005-11-22 17:31:38 +01:00
libsysfs libsysfs: remove brute-force "bus", "driver" searching for old kernels 2005-11-02 04:58:59 +01:00
test remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
.gitignore replace udeveventrecorder by a shell script 2005-11-10 02:06:43 +01:00
ccdv.c [PATCH] tweak the ccdv program to handle files in subdirectories being built. 2005-04-26 22:02:44 -07:00
ChangeLog 075 release 2005-11-10 02:20:25 +01:00
COPYING [PATCH] added initial documentation and gpl license 2005-04-26 21:00:32 -07:00
FAQ FAQ: remove confusing statement about module loading 2005-10-27 13:13:25 +02:00
list.h [PATCH] cleanup list.h 2005-04-26 23:51:00 -07:00
logging.h log to console if syslog is not available 2005-11-05 16:22:14 +01:00
Makefile Makefile: fail, if submake fails 2005-11-22 16:33:25 +01:00
README update README 2005-11-17 18:05:29 +01:00
RELEASE-NOTES move some helpers from extras to /lib/udev 2005-11-22 17:31:38 +01:00
TODO update README 2005-11-17 18:05:29 +01:00
udev_add.c remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udev_config.c remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udev_db.c remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udev_device.c remove all built-in wait_for_sysfs logic 2005-11-12 04:17:48 +01:00
udev_event.c remove all built-in wait_for_sysfs logic 2005-11-12 04:17:48 +01:00
udev_libc_wrapper.c move some logging from dbg() to info() 2005-11-07 18:52:03 +01:00
udev_libc_wrapper.h add dummy inotify syscalls on unsupported architecture 2005-10-28 02:29:38 +02:00
udev_remove.c move delete_path() to utils 2005-11-22 15:44:02 +01:00
udev_rules_parse.c move some logging from dbg() to info() 2005-11-07 18:52:03 +01:00
udev_rules.c remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udev_rules.h remove precompiled rules option 2005-11-05 20:00:31 +01:00
udev_selinux.c move some logging from dbg() to info() 2005-11-07 18:52:03 +01:00
udev_selinux.h selinux merge fixups again... 2005-04-26 23:52:14 -07:00
udev_utils_file.c move delete_path() to utils 2005-11-22 15:44:02 +01:00
udev_utils_run.c add strerror() to error logs 2005-11-07 18:44:18 +01:00
udev_utils_string.c rename ...trailing_char() to ...trailing_chars() 2005-08-28 23:15:51 +02:00
udev_utils.c move some logging from dbg() to info() 2005-11-07 18:52:03 +01:00
udev_utils.h move delete_path() to utils 2005-11-22 15:44:02 +01:00
udev.8 remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udev.c remove all built-in wait_for_sysfs logic 2005-11-12 04:17:48 +01:00
udev.h remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udevcontrol.c add strerror() to error logs 2005-11-07 18:44:18 +01:00
udevd.8 all man pages rewritten to use DocBook XML 2005-08-30 23:30:52 +02:00
udevd.c clean-up empty queue directories 2005-11-22 15:49:49 +01:00
udevd.h remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udevinfo.8 test the automatic man page rebuild and checkin 2005-08-30 05:02:11 +02:00
udevinfo.c remove "udev_db" option from config file 2005-11-16 04:14:15 +01:00
udevmonitor.8 also forgot udevmonitor.8 2005-08-31 00:03:20 +02:00
udevmonitor.c add linux/types.h back, old glibc-kernel-headers want it 2005-11-12 05:09:34 +01:00
udevsend.8 add missing udevsend man page 2005-08-31 00:00:22 +02:00
udevsend.c don't start udevd from udevsend 2005-11-17 18:50:47 +01:00
udevstart.8 write man page masters in DocBook XML 2005-08-30 04:41:42 +02:00
udevstart.c remove all built-in wait_for_sysfs logic 2005-11-12 04:17:48 +01:00
udevtest.8 write man page masters in DocBook XML 2005-08-30 04:41:42 +02:00
udevtest.c remove all built-in wait_for_sysfs logic 2005-11-12 04:17:48 +01: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
  and differs a lot from distro to distro. All reasonable distros depend on udev
  these days and the system will not work without it.

  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.

Requirements:
  - 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.

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

  - The proc filesystem must be mounted on /proc.

  - The sysfs filesystem must be mounted at /sys. No other location
    will be supported by udev.


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

  - Directly after mouting the real root filesystem, wherever that
    happens, in initramfs or with a directly mounted root, /dev should get
    a tmpfs filesystem mounted, which is populated from scratch by udev.
    Created nodes or changed permissions don't survive a reboot.

  - The content of /lib/udev/devices directory should be copied over to the
    tmpfs mounted /dev, to provide the required nodes to initialize udev.

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

  - From kernel version 2.6.15 on, the hotplug helper /sbin/hotplug should
    be disabled with an init script before the boot scripts are run and
    kernel modules are loaded.

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


Compile Options:
  prefix
  	Set this to the default root that you want to use. Only override
  	this if you really know what you are doing, even then, you probably
  	don't do the right thing.
  DESTDIR
  	Prefix for 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.
  STRIPCMD
  	If udev is compiled for packaging an empty string can be passed
  	to disable the stripping of the binaries.
  USE_SELINUX
  	If set to 'true', udev will be built with SELinux support
  	enabled.  This is disabled by default.
  USE_KLIBC
  	If set to 'true', udev is built and linked against klibc.
  	Default value is 'false'. KLCC specifies the klibc compiler
  	wrapper, usually located at /usr/bin/klcc.
  EXTRAS
  	If set, will build the "extra" helper programs as specified
  	as listed (see below for an example).

If you want to build the udev helper programs:
  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 /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 diretory 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 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.

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