Repository for eudev development
Go to file
kay.sievers@vrfy.org aef6bb132e [PATCH] udev default config layout changes
Here we catch up, after the default config changes.

o the man page is updated to reflect the new default config

o /etc/udev/rules.d/ + permissions.d/ dirs are created now

o udev.rules is installed in /etc/udev/rules.d/50-udev.rules
  so the user can easily order the files by prepending a number.
  (RedHat has the same name in the last rpm.)

o defined directory names in the Makefile are all without slashes now,
  not the first half with and the remaining without.

o all binaries are uninstalled now

o leading slashes in config values are now removed or prepended while the
  config is parsed, so we are more robust if the usere changes something.

o replaced the macros from udev_config.c with real code, cause we can
  skip if the value matches and not useless iterate over the remaining
  fields.

o config parsing errors are logged with info() now, fixes the bug where
  we report a error with debug_parse(), even when there isn't one
2005-04-26 21:35:17 -07:00
docs [PATCH] add hints for red hat users from Leann Ogasawara <ogasawara@osdl.org> 2005-04-26 21:35:15 -07:00
etc [PATCH] add more permissions based on SuSE's recommendations. 2005-04-26 21:35:16 -07:00
extras [PATCH] udev_selinux changes 2005-04-26 21:35:15 -07:00
klibc [PATCH] fix offsetof() define in klibc. 2005-04-26 21:32:27 -07:00
libsysfs [PATCH] udevd race conditions and performance, assorted cleanups - take 2 2005-04-26 21:35:13 -07:00
tdb [PATCH] make spotless 2005-04-26 21:35:10 -07:00
test [PATCH] add devd_test script. 2005-04-26 21:35:16 -07:00
ChangeLog [PATCH] v025 release 2005-04-26 21:35:17 -07:00
COPYING [PATCH] added initial documentation and gpl license 2005-04-26 21:00:32 -07:00
dev_d.c [PATCH] make dev.d call each directory in the directory chain of the device name, instead of just the whole name. 2005-04-26 21:35:16 -07:00
FAQ [PATCH] add a question/answer about automounting usb devices to the FAQ. 2005-04-26 21:35:10 -07:00
HOWTO-udev_for_dev [PATCH] fix HOWTO-udev_for_dev for udevdir 2005-04-26 21:35:10 -07:00
klibc_fixups.c [PATCH] udevd race conditions and performance, assorted cleanups - take 2 2005-04-26 21:35:13 -07:00
klibc_fixups.h [PATCH] udevd race conditions and performance, assorted cleanups - take 2 2005-04-26 21:35:13 -07:00
list.h [PATCH] Initial namedev parsing of config files 2005-04-26 21:01:38 -07:00
logging.h [PATCH] overall trivial trivial cleanup 2005-04-26 21:35:08 -07:00
make_gcov.sh [PATCH] add scripts to run gcov for udev from Leann Ogasawara <ogasawara@osdl.org> 2005-04-26 21:35:15 -07:00
Makefile [PATCH] udev default config layout changes 2005-04-26 21:35:17 -07:00
namedev_parse.c [PATCH] dev_d.c file sorting and cleanup 2005-04-26 21:35:12 -07:00
namedev.c [PATCH] fix test regressions 2005-04-26 21:35:16 -07:00
namedev.h [PATCH] dev_d.c file sorting and cleanup 2005-04-26 21:35:12 -07:00
README [PATCH] remove USE_DBUS and USE_SELINUX flags from the README as they are no longer present. 2005-04-26 21:35:11 -07:00
README-gcov_for_udev [PATCH] gcov for udev 2005-04-26 21:35:16 -07:00
run_gcov.sh [PATCH] add scripts to run gcov for udev from Leann Ogasawara <ogasawara@osdl.org> 2005-04-26 21:35:15 -07:00
TODO [PATCH] update the TODO list as we already have a devfs config file. 2005-04-26 21:35:07 -07:00
udev_config.c [PATCH] udev default config layout changes 2005-04-26 21:35:17 -07:00
udev_lib.c [PATCH] udev default config layout changes 2005-04-26 21:35:17 -07:00
udev_lib.h [PATCH] udev default config layout changes 2005-04-26 21:35:17 -07:00
udev-add.c [PATCH] fix devpath for netdev 2005-04-26 21:35:15 -07:00
udev-remove.c [PATCH] DEVPATH for netdev 2005-04-26 21:35:13 -07:00
udev.8.in [PATCH] udev default config layout changes 2005-04-26 21:35:17 -07:00
udev.c [PATCH] hmm, handle net devices with udev? 2005-04-26 21:35:12 -07:00
udev.h [PATCH] DEVPATH for netdev 2005-04-26 21:35:13 -07:00
udev.spec [PATCH] v025 release 2005-04-26 21:35:17 -07:00
udevd.8 [PATCH] increase udevd event timeout 2005-04-26 21:35:14 -07:00
udevd.c [PATCH] udevd test script 2005-04-26 21:35:15 -07:00
udevd.h [PATCH] increase udevd event timeout 2005-04-26 21:35:14 -07:00
udevdb.c [PATCH] netdev - udevdb+dev.d changes 2005-04-26 21:35:13 -07:00
udevdb.h [PATCH] udev - reverse user query options 2005-04-26 21:13:17 -07:00
udevinfo.8 [PATCH] update bk ignore list some more. 2005-04-26 21:35:14 -07:00
udevinfo.c [PATCH] netdev - udevdb+dev.d changes 2005-04-26 21:35:13 -07:00
udevruler.c [PATCH] handle netdev in udevruler 2005-04-26 21:35:14 -07:00
udevsend.c [PATCH] udevd race conditions and performance, assorted cleanups - take 2 2005-04-26 21:35:13 -07:00
udevstart.8 [PATCH] update bk ignore list some more. 2005-04-26 21:35:14 -07:00
udevstart.c [PATCH] udevstart fix 2005-04-26 21:35:14 -07:00
udevtest.8 [PATCH] update bk ignore list some more. 2005-04-26 21:35:14 -07:00
udevtest.c [PATCH] handle the subsytem if provided in udevtest. 2005-04-26 21:35:14 -07:00

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.

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

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

      So, if you want to build udev using klibc with debugging messages, you
      would do:
	make USE_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, but it should work properly.  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.

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