Repository for eudev development
Go to file
2005-09-14 14:28:13 +02:00
docs fic gcov use and move it into the Makefile 2005-09-12 15:26:33 +02:00
etc fix nbd error messages with a gentoo rule hack 2005-09-13 14:10:27 -07:00
extras EXTRAS/Makefile: fix install targets to match main Makefile 2005-09-14 14:27:28 +02:00
klibc klibc: update to version 1.1.1 2005-09-06 22:57:07 +02:00
libsysfs move and update libsysfs.txt 2005-09-06 20:33:59 +02:00
test add edd_id tool to match BIOS EDD disk information 2005-09-06 12:18:04 +02:00
ccdv.c [PATCH] tweak the ccdv program to handle files in subdirectories being built. 2005-04-26 22:02:44 -07:00
ChangeLog 069 release 2005-09-13 10:24:51 -07:00
COPYING [PATCH] added initial documentation and gpl license 2005-04-26 21:00:32 -07:00
FAQ FAQ: update things that have changed 2005-09-12 16:00:09 +02:00
HOWTO-udev_for_dev [PATCH] replace tdb database by simple lockless file database 2005-04-26 22:16:40 -07:00
list.h [PATCH] cleanup list.h 2005-04-26 23:51:00 -07:00
logging.h cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
Makefile EXTRAS/Makefile: fix install targets to match main Makefile 2005-09-14 14:27:28 +02:00
README add EXTRAS documentation to the README file. 2005-08-18 10:02:27 -07:00
RELEASE-NOTES update RELEASE-NOTES 2005-08-29 03:49:40 +02:00
TODO update TODO 2005-09-08 12:45:09 +02:00
udev_add.c cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udev_config.c rename ...trailing_char() to ...trailing_chars() 2005-08-28 23:15:51 +02:00
udev_db.c don't store devpath in udevdb, we don't need it 2005-08-27 23:27:43 +02:00
udev_db.h don't store devpath in udevdb, we don't need it 2005-08-27 23:27:43 +02:00
udev_device.c rename ...trailing_char() to ...trailing_chars() 2005-08-28 23:15:51 +02:00
udev_event.c store ENV{key}="value" exported keys in the database 2005-08-26 21:38:18 +02:00
udev_libc_wrapper.c switch some strlcpy's to memcpy 2005-08-08 02:21:55 +02:00
udev_libc_wrapper.h cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udev_remove.c cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udev_rules_parse.c cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udev_rules.c check the udevdb before assigning a new %e 2005-08-29 03:48:17 +02:00
udev_rules.h add flag for reading of precompiled rules 2005-08-08 17:43:42 +02:00
udev_selinux.c selinux merge fixups again... 2005-04-26 23:52:14 -07:00
udev_selinux.h selinux merge fixups again... 2005-04-26 23:52:14 -07:00
udev_sysfs.c add pci_express to bus list 2005-08-25 03:37:38 +02:00
udev_sysfs.h fix the fix and change the file to wait for to the "bus" link 2005-06-22 02:11:59 +02:00
udev_utils_file.c split udev_util in several files 2005-08-10 16:54:14 +02:00
udev_utils_run.c use WRITE_END/READ_END for the pipe index 2005-08-28 20:25:37 +02:00
udev_utils_string.c rename ...trailing_char() to ...trailing_chars() 2005-08-28 23:15:51 +02:00
udev_utils.c add uft8 validation for safe volume label exporting 2005-08-28 13:49:32 +02:00
udev_utils.h rename ...trailing_char() to ...trailing_chars() 2005-08-28 23:15:51 +02:00
udev.8 all man pages rewritten to use DocBook XML 2005-08-30 23:30:52 +02:00
udev.c bring std(in|out|err) fd's in a sane state 2005-08-18 13:07:15 +02:00
udev.h move code to its own files 2005-07-22 12:35:58 -04:00
udev.spec 069 release 2005-09-13 10:24:51 -07:00
udevcontrol.c add Usage: to udevmonitor and udevcontrol 2005-08-11 20:34:24 +02:00
udevd.8 all man pages rewritten to use DocBook XML 2005-08-30 23:30:52 +02:00
udevd.c udevd: fix udevd read() calls to leave room for null byte 2005-09-14 14:28:13 +02:00
udevd.h add udevmonitor, to debug netlink+udev events at the same time 2005-08-01 20:22:46 +02:00
udeveventrecorder.c cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udevinfo.8 test the automatic man page rebuild and checkin 2005-08-30 05:02:11 +02:00
udevinfo.c udevinfo: restore -d option 2005-08-31 02:35:35 +02:00
udevinitsend.c fix exit code of udevinitsend and udevmonitor 2005-08-22 12:01:55 +02:00
udevmonitor.8 also forgot udevmonitor.8 2005-08-31 00:03:20 +02:00
udevmonitor.c udevmonitor: cleanup on exit 2005-08-25 00:38:25 +02:00
udevrulescompile.c add flag for reading of precompiled rules 2005-08-08 17:43:42 +02:00
udevsend.8 add missing udevsend man page 2005-08-31 00:00:22 +02:00
udevsend.c allow RUN to send the environment to a local socket 2005-08-01 05:07:19 +02:00
udevstart.8 write man page masters in DocBook XML 2005-08-30 04:41:42 +02:00
udevstart.c cleanup some debug output and move to info level + unify select() loops 2005-08-15 11:57:04 +02:00
udevtest.8 write man page masters in DocBook XML 2005-08-30 04:41:42 +02:00
udevtest.c add flag for reading of precompiled rules 2005-08-08 17:43:42 +02:00

udev - a userspace device manager

For more information on the design, and structure of this project, see the
files in the docs/ directory.

To use:

- You must be running a 2.6 version of the Linux kernel.

- Your 2.6 kernel must have had CONFIG_HOTPLUG enabled when it was built.

- Make sure sysfs is mounted at /sys. No other location is supported.
  You can mount it by running:
  	mount -t sysfs none /sys

- Make sure you integrate udev with your hotplug setup. There is a copy of
  the rules files for all major distros in the etc/udev folder. You may look
  there how others are doing it.

- Make sure you integrate with the kernel hotplug events. Later versions of
  udev are able to listen directly to a netlink socket, older versions used
  udevsend to feed the udev daemon with the kernel event. The most basic
  setup to run udev is to let the kernel for the udev binary directly:
	echo "/sbin/udev" > /proc/sys/kernel/hotplug

  While this may work in some setups, it is not recommended to do. A recent
  kernel and udev version is able to operate with the event serializing daemon
  udevd, that makes sure, that no "remove" event will beat a "add" event for
  the same device.

- Build the project:
	make

  Note:
      There are a number of different flags that you can use when building
      udev.  They are as follows:
	prefix
		set this to the default root that you want udev to be
		installed into.  This works just like the 'configure --prefix'
		script does.  Default value is ''.  Only override this if you
		really know what you are doing.
	USE_KLIBC
		if set to 'true', udev is built and linked against the
		included version of klibc.  Default value is 'false'.
	USE_LOG
		if set to 'true', udev will emit messages to the syslog when
		it creates or removes device nodes.  This is helpful to see
		what udev is doing.  This is enabled by default.  Note, if you
		are building udev against klibc it is recommended that you
		disable this option (due to klibc's syslog implementation.)
	USE_SELINUX
		if set to 'true', udev will be built with SELinux support
		enabled.  This is disabled by default.
	DEBUG
		if set to 'true', debugging messages will be sent to the syslog
		as udev is run.  Default value is 'false'.
	KERNEL_DIR
		If this is not set it will default to /lib/modules/`uname -r`/build
		This is used if USE_KLIBC=true to find the kernel include
		directory that klibc needs to build against.  This must be set
		if you are not building udev while running a 2.6 kernel.
	EXTRAS
		if set, will build the "extra" helper programs as specified
		as listed (see below for an example.)

      So, if you want to build udev using klibc with debugging messages, you
      would do:
	make USE_KLIBC=true DEBUG=true

      If you want to build the udev helper program cdrom_id and scsi_id you
      would do:
	make EXTRAS="extras/cdrom_id extras/scsi_id"

      udev will follow the setting of the debug level in udev.conf. Adapt this
      value to see the debug in syslog.

- Install the project:
	make install

  This will put the udev binaries in /sbin, create the and /etc/udev
  directories, and place the udev configuration files in /etc/udev/.  You
  will probably want to edit the *.rules files to create custom naming
  rules.  More info on how the config files are set up are contained in
  comments in the files, and is located in the documentation.

- Add and remove devices from the system and marvel as nodes are created
  and removed in /dev based on the device types.

- If you later get sick of it, uninstall it:
	make uninstall

If nothing seems to happen, make sure your build worked properly by
running the udev-test.pl script as root in the test/ subdirectory of the
udev source tree. Running udevstart should populate an empty /dev
directory. You may test, if a node is recreated after running udevstart.

Development and documentation help is very much appreciated, see the TODO
file for a list of things left to be done.

Any comment/questions/concerns please let me and the other udev developers
know by sending a message to the linux-hotplug-devel mailing list at:
	linux-hotplug-devel@lists.sourceforge.net

greg k-h
greg@kroah.com