Ninjatrappeur's systemd working tree
Go to file
greg@kroah.com 3c54f73e84 [PATCH] some cleanups due to the need for LABEL rules to use "SYSFS_" now. 2005-04-26 21:13:08 -07:00
docs [PATCH] updated the documentation. 2005-04-26 21:01:38 -07:00
etc/init.d [PATCH] Add restart target to the etc/init.d/udev script 2005-04-26 21:13:07 -07:00
extras [PATCH] more extras/multipath changes 2005-04-26 21:13:08 -07:00
klibc [PATCH] sync up with the 0.84 version of klibc 2005-04-26 21:13:02 -07:00
libsysfs [PATCH] pre-libsysfs-0.4.0 patch 2005-04-26 21:13:07 -07:00
tdb [PATCH] fix some compiler warnings in the tdb code. 2005-04-26 21:13:05 -07:00
test [PATCH] don't rely on field order in namedev_parse 2005-04-26 21:13:08 -07:00
COPYING [PATCH] added initial documentation and gpl license 2005-04-26 21:00:32 -07:00
ChangeLog [PATCH] update ChangeLog for v008 2005-04-26 21:13:06 -07:00
FAQ [PATCH] update the FAQ due to the latest devfs mess on lkml and also due to symlinks now working. 2005-04-26 21:13:07 -07:00
Makefile [PATCH] install initscript in udev rpm 2005-04-26 21:13:08 -07:00
README [PATCH] document the different Makefile config options that we have. 2005-04-26 21:13:06 -07:00
TODO [PATCH] man-page mention multiple symlinks 2005-04-26 21:13:07 -07:00
klibc_fixups.c [PATCH] get rid of functions in klibc_fixups that are now in klibc 2005-04-26 21:13:02 -07:00
klibc_fixups.h [PATCH] get rid of functions in klibc_fixups that are now in klibc 2005-04-26 21:13:02 -07:00
list.h [PATCH] Initial namedev parsing of config files 2005-04-26 21:01:38 -07:00
logging.c [PATCH] overall whitespace + debug text conditioning 2005-04-26 21:13:03 -07:00
namedev.c [PATCH] get part of callout return string 2005-04-26 21:13:07 -07:00
namedev.h [PATCH] don't rely on field order in namedev_parse 2005-04-26 21:13:08 -07:00
namedev_parse.c [PATCH] don't rely on field order in namedev_parse 2005-04-26 21:13:08 -07:00
udev-add.c [PATCH] pre-libsysfs-0.4.0 patch 2005-04-26 21:13:07 -07:00
udev-remove.c [PATCH] allow multiple symlinks 2005-04-26 21:13:07 -07:00
udev.8 [PATCH] some cleanups due to the need for LABEL rules to use "SYSFS_" now. 2005-04-26 21:13:08 -07:00
udev.c [PATCH] move all of the DBUS logic into one file and remove all of the #ifdef crud from the main code. 2005-04-26 21:13:06 -07:00
udev.conf.in [PATCH] use udevdir in udev.conf 2005-04-26 21:13:07 -07:00
udev.h [PATCH] move all of the DBUS logic into one file and remove all of the #ifdef crud from the main code. 2005-04-26 21:13:06 -07:00
udev.permissions [PATCH] added debian's version of udev.permissions. 2005-04-26 21:06:25 -07:00
udev.permissions.debian [PATCH] added debian's version of udev.permissions. 2005-04-26 21:06:25 -07:00
udev.rules [PATCH] some cleanups due to the need for LABEL rules to use "SYSFS_" now. 2005-04-26 21:13:08 -07:00
udev.rules.demo [PATCH] don't rely on field order in namedev_parse 2005-04-26 21:13:08 -07:00
udev.rules.devfs [PATCH] change devfs disk name rule from 'disk' to 'disc' 2005-04-26 21:13:07 -07:00
udev.spec [PATCH] remove udev from runlevels on uninstall 2005-04-26 21:13:08 -07:00
udev_config.c [PATCH] get rid of the majority of the debug environment variables. 2005-04-26 21:13:05 -07:00
udev_dbus.c [PATCH] fix formatting of udev_dbus.c to use tabs. Also get it to build properly now. 2005-04-26 21:13:06 -07:00
udev_dbus.h [PATCH] move all of the DBUS logic into one file and remove all of the #ifdef crud from the main code. 2005-04-26 21:13:06 -07:00
udev_sysbus_policy.conf [PATCH] D-BUS patch for udev-008 2005-04-26 21:13:06 -07:00
udevdb.c [PATCH] overall whitespace + debug text conditioning 2005-04-26 21:13:03 -07:00
udevdb.h [PATCH] overall whitespace + debug text conditioning 2005-04-26 21:13:03 -07:00

README

udev - a userspace implementation of devfs

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.

- Make sure sysfs is mounted.  udev will figure out where sysfs is mounted, but
  the traditional place for it is at /sys.  You can mount it by hand by running:
  	mount -t sysfs none /sys

- Make sure you have the latest version of the linux-hotplug scripts.  They are
  available at linux-hotplug.sf.net or from your local kernel.org mirror at:
	kernel.org/pub/linux/utils/kernel/hotplug/
  They are required in order for udev to work properly.

  If for some reason you do not install the hotplug scripts, you must tell the
  kernel to point the hotplug binary at wherever you install udev at.  This can
  be done by:
	echo "/sbin/udev" > /proc/sys/kernel/hotplug

- 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.
	KLIBC - if set to 'true', udev is built and linked against the included
		version of klibc.  Default value is 'false'.
	DEBUG - if set to 'true', debugging messages will be sent to the syslog
		as udev is run.  Default value is 'false'.
	DBUS -  if set to 'true', DBUS messages will be sent everytime udev
		creates or removes a device node.  This requires that DBUS
		development headers and libraries be present on your system to
		build properly.  Default value is 'false'.

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


- Install the project:
	make install

  This will put the udev binary in /sbin, create the /udev and /etc/udev
  directories, and place the udev configuration files in /etc/udev.  You
  will probably want to edit the namedev.* 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 /udev/ based on the device types.

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


Things are still quite rough, and it's a bit beyond proof of concept
code.  Help is very much appreciated, see the TODO file for a list of
things left to be done.

If you want to build using klibc, use the Makefile.klibc file:
	- read the klibc/klibc/README file for how to set up the linux
	  symlink properly.
	- make clean
	- make -f Makefile.klibc
and marvel at the tiny binary you just created :)

Any comment/questions/concerns please let me know.

greg k-h
greg@kroah.com