From a2ddee73920673aae645ab7fde322251a249024f Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 15:54:04 +0000 Subject: [PATCH 01/12] Docs: README: `to replace' -> `replacing' Signed-off-by: Michael Witten --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README b/README index 78787469c..92a23724c 100644 --- a/README +++ b/README @@ -3,7 +3,7 @@ udev - Linux userspace device management Integrating udev in the system has complex dependencies and may differ from distribution to distribution. A system may not be able to boot up or work reliably without a properly installed udev version. The upstream udev project -does not recommend to replace a distro's udev installation with the upstream +does not recommend replacing a distro's udev installation with the upstream version. The upstream udev project's set of default rules may require a most recent From 9698e70c1feae3d4807e4b5c6b53cbc459313f12 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 15:55:18 +0000 Subject: [PATCH 02/12] Docs: README: `,' -> `;' Signed-off-by: Michael Witten --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README b/README index 92a23724c..b4c65468c 100644 --- a/README +++ b/README @@ -10,7 +10,7 @@ The upstream udev project's set of default rules may require a most recent kernel release to work properly. This is currently version 2.6.31. Tools and rules shipped by udev are not public API and may change at any time. -Never call any private tool in /lib/udev from any external application, it might +Never call any private tool in /lib/udev from any external application; it might just go away in the next release. Access to udev information is only offered by udevadm and libudev. Tools and rules in /lib/udev, and the entire content of the /dev/.udev directory is private to udev and does change whenever needed. @@ -70,7 +70,7 @@ Setup: - Restarting the daemon does never apply any rules to existing devices. - - New/changed rule files are picked up automatically, there is no daemon + - New/changed rule files are picked up automatically; there is no daemon restart or signal needed. Operation: @@ -80,7 +80,7 @@ Operation: - All kernel events are matched against a set of specified rules, which possibly hook into the event processing and load required kernel modules to setup devices. For all devices the kernel exports a major/minor - number, if needed, udev will create a device node with the default kernel + number; if needed, udev will create a device node with the default kernel name. If specified, udev applies permissions/ownership to the device node, creates additional symlinks pointing to the node, and executes programs to handle the device. From 600b2584566a44b8a57f546f5ce27f5b1cce21d6 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 15:56:16 +0000 Subject: [PATCH 03/12] Docs: README: Clean up a sentence Signed-off-by: Michael Witten --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README b/README index b4c65468c..1eecf9d84 100644 --- a/README +++ b/README @@ -12,8 +12,8 @@ kernel release to work properly. This is currently version 2.6.31. Tools and rules shipped by udev are not public API and may change at any time. Never call any private tool in /lib/udev from any external application; it might just go away in the next release. Access to udev information is only offered -by udevadm and libudev. Tools and rules in /lib/udev, and the entire content of -the /dev/.udev directory is private to udev and does change whenever needed. +by udevadm and libudev. Tools and rules in /lib/udev and the entire contents of +the /dev/.udev directory are private to udev and do change whenever needed. Requirements: - Version 2.6.27 of the Linux kernel with sysfs, procfs, signalfd, inotify, From 3fe44a296abbac8a3df667861a7c111e95b54ca4 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 15:59:01 +0000 Subject: [PATCH 04/12] Docs: README: Use present tense Signed-off-by: Michael Witten --- README | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/README b/README index 1eecf9d84..04e722f3d 100644 --- a/README +++ b/README @@ -31,7 +31,7 @@ Requirements: CONFIG_TMPFS_POSIX_ACL=y (user ACLs for device nodes) CONFIG_BLK_DEV_BSG=y (SCSI devices) - - Udev will not work with the CONFIG_SYSFS_DEPRECATED* option. + - Udev does not work with the CONFIG_SYSFS_DEPRECATED* option. - Unix domain sockets (CONFIG_UNIX) as a loadable kernel module may work, but it is not supported. @@ -57,8 +57,8 @@ Requirements: Setup: - At bootup, the /dev directory should get the 'devtmpfs' filesystem - mounted. Udev will manage permissions and ownership of the kernel-created - device nodes, and possibly create additional symlinks. If needed, udev also + mounted. Udev manages the permissions and ownership of the kernel-created + device nodes, and udev possibly creates additional symlinks. If needed, udev also works on an empty 'tmpfs' filesystem, but some static device nodes like /dev/null, /dev/console, /dev/kmsg are needed to be able to start udev itself. @@ -80,7 +80,7 @@ Operation: - All kernel events are matched against a set of specified rules, which possibly hook into the event processing and load required kernel modules to setup devices. For all devices the kernel exports a major/minor - number; if needed, udev will create a device node with the default kernel + number; if needed, udev creates a device node with the default kernel name. If specified, udev applies permissions/ownership to the device node, creates additional symlinks pointing to the node, and executes programs to handle the device. From bde1af68b61f0f36127de09eee5a5051ae5c9167 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:00:01 +0000 Subject: [PATCH 05/12] Docs: README: Add missing `and' Signed-off-by: Michael Witten --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README b/README index 04e722f3d..5cac0213a 100644 --- a/README +++ b/README @@ -41,18 +41,18 @@ Requirements: unusable because the kernel may create too many processes in parallel so that the system runs out-of-memory. - - The proc filesystem must be mounted on /proc, the sysfs filesystem must + - The proc filesystem must be mounted on /proc, and the sysfs filesystem must be mounted at /sys. No other locations are supported by a standard udev installation. - The system must have the following group names resolvable at udev startup: - disk, cdrom, floppy, tape, audio, video, lp, tty, dialout, kmem. + disk, cdrom, floppy, tape, audio, video, lp, tty, dialout, and kmem. Especially in LDAP setups, it is required, that getgrnam() is able to resolve these group names with only the rootfs mounted, and while no network is available. - To build all 'udev extras', libacl, libglib2, libusb, usbutils, pciutils, - gperf are needed. These dependencies can be disabled with the + and gperf are needed. These dependencies can be disabled with the --disable-extras configure option. Setup: From 47d9121c9a6a6d4d3415e6a012ebbb3256440a65 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:01:18 +0000 Subject: [PATCH 06/12] Docs: README: Remove commas and use subjective mood Signed-off-by: Michael Witten --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README b/README index 5cac0213a..6aabf69f8 100644 --- a/README +++ b/README @@ -47,8 +47,8 @@ Requirements: - The system must have the following group names resolvable at udev startup: disk, cdrom, floppy, tape, audio, video, lp, tty, dialout, and kmem. - Especially in LDAP setups, it is required, that getgrnam() is able to resolve - these group names with only the rootfs mounted, and while no network is + Especially in LDAP setups, it is required that getgrnam() be able to resolve + these group names with only the rootfs mounted and while no network is available. - To build all 'udev extras', libacl, libglib2, libusb, usbutils, pciutils, From 1224944f61d88d7e09010c808b117ce102c61ef9 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:04:38 +0000 Subject: [PATCH 07/12] Docs: README: Clean up `udev extras' requirements Signed-off-by: Michael Witten --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README b/README index 6aabf69f8..10a937a76 100644 --- a/README +++ b/README @@ -51,9 +51,9 @@ Requirements: these group names with only the rootfs mounted and while no network is available. - - To build all 'udev extras', libacl, libglib2, libusb, usbutils, pciutils, - and gperf are needed. These dependencies can be disabled with the - --disable-extras configure option. + - The 'udev extras' has the following dependencies: + libacl, libglib2, libusb, usbutils, pciutils, and gperf. + These dependencies can be disabled with the --disable-extras configure option. Setup: - At bootup, the /dev directory should get the 'devtmpfs' filesystem From e62c9c72cdb4ff920c71679f230cde9736570ee7 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:14:48 +0000 Subject: [PATCH 08/12] Docs: README: Clarify configuration of existing devices Signed-off-by: Michael Witten --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README b/README index 10a937a76..8d4ecbd5c 100644 --- a/README +++ b/README @@ -64,7 +64,7 @@ Setup: - The udev daemon should be started to handle device events sent by the kernel. During bootup, the kernel can be asked to send events for all already existing - devices, to apply the configuration to these devices. This is usually done by: + devices so that they too can be configured by udev. This is usually done by: /sbin/udevadm trigger --type=subsystems /sbin/udevadm trigger --type=devices From cb936a3961f37ccb8eef0c505b8fffa6711c57be Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:15:39 +0000 Subject: [PATCH 09/12] Docs: README: `does never apply' -> `never applies' Signed-off-by: Michael Witten --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README b/README index 8d4ecbd5c..7f0399e71 100644 --- a/README +++ b/README @@ -68,7 +68,7 @@ Setup: /sbin/udevadm trigger --type=subsystems /sbin/udevadm trigger --type=devices - - Restarting the daemon does never apply any rules to existing devices. + - Restarting the daemon never applies any rules to existing devices. - New/changed rule files are picked up automatically; there is no daemon restart or signal needed. From fd752623faf6a3a4f2ac17e1a9d24f589119084d Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:18:32 +0000 Subject: [PATCH 10/12] Docs: README: Flip sentence structure to improve wording Signed-off-by: Michael Witten --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README b/README index 7f0399e71..350a22b45 100644 --- a/README +++ b/README @@ -74,8 +74,8 @@ Setup: restart or signal needed. Operation: - - Udev creates/removes device nodes in /dev, based on events the kernel - sends out on device creation/removal. + - Based on events the kernel sends out on device creation/removal, udev + creates/removes device nodes in the /dev directory. - All kernel events are matched against a set of specified rules, which possibly hook into the event processing and load required kernel From 00ecb6745b4021a9cae6056132dc5be3cfcc26b5 Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:19:46 +0000 Subject: [PATCH 11/12] Docs: README: `set up' is the verb; `setup' is a noun Signed-off-by: Michael Witten --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README b/README index 350a22b45..476ee2ec6 100644 --- a/README +++ b/README @@ -79,7 +79,7 @@ Operation: - All kernel events are matched against a set of specified rules, which possibly hook into the event processing and load required kernel - modules to setup devices. For all devices the kernel exports a major/minor + modules to set up devices. For all devices the kernel exports a major/minor number; if needed, udev creates a device node with the default kernel name. If specified, udev applies permissions/ownership to the device node, creates additional symlinks pointing to the node, and executes From 49500e9b0db05a630e2baa37443c5f2facf359ad Mon Sep 17 00:00:00 2001 From: Michael Witten Date: Fri, 8 Apr 2011 16:20:18 +0000 Subject: [PATCH 12/12] Docs: README: Add a comma to offset the modifier Signed-off-by: Michael Witten --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README b/README index 476ee2ec6..4520f3dbe 100644 --- a/README +++ b/README @@ -79,7 +79,7 @@ Operation: - All kernel events are matched against a set of specified rules, which possibly hook into the event processing and load required kernel - modules to set up devices. For all devices the kernel exports a major/minor + modules to set up devices. For all devices, the kernel exports a major/minor number; if needed, udev creates a device node with the default kernel name. If specified, udev applies permissions/ownership to the device node, creates additional symlinks pointing to the node, and executes @@ -90,7 +90,7 @@ Operation: http://www.kernel.org/pub/linux/utils/kernel/hotplug/libudev/ http://www.kernel.org/pub/linux/utils/kernel/hotplug/gudev/ -For more details about udev and udev rules see the udev(7) man page. +For more details about udev and udev rules, see the udev(7) man page. Please direct any comment/question to the linux-hotplug mailing list at: linux-hotplug@vger.kernel.org