r751 - in lvm2/trunk/debian: . tree/dmsetup/lib/udev/rules.d tree/dmsetup/usr/share/doc/dmsetup tree/lvm2/lib/udev/rules.d tree/lvm2/usr/share/doc tree/lvm2/usr/share/doc/lvm2

Bastian Blank waldi at alioth.debian.org
Mon Oct 12 03:23:38 UTC 2009 

Author: waldi
Date: Mon Oct 12 03:23:36 2009
New Revision: 751

Log:
* debian/changelog: Update.
* debian/tree/dmsetup/lib/udev/rules.d/55-dm.rules,
  debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules,
  debian/tree/lvm2/lib/udev/rules.d/56-lvm.rules,
  debian/tree/lvm2/lib/udev/rules.d/60-persistent-storage-lvm.rules:
  Refer to real documentation file.
* debian/tree/dmsetup/usr/share/doc/dmsetup/README.udev,
  debian/tree/lvm2/usr/share/doc/lvm2/README.udev: Add.

Added:
   lvm2/trunk/debian/tree/dmsetup/usr/share/doc/dmsetup/README.udev
   lvm2/trunk/debian/tree/lvm2/usr/share/doc/
   lvm2/trunk/debian/tree/lvm2/usr/share/doc/lvm2/
   lvm2/trunk/debian/tree/lvm2/usr/share/doc/lvm2/README.udev
Modified:
   lvm2/trunk/debian/changelog
   lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/55-dm.rules
   lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules
   lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/56-lvm.rules
   lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/60-persistent-storage-lvm.rules

Modified: lvm2/trunk/debian/changelog
==============================================================================
--- lvm2/trunk/debian/changelog	Mon Oct 12 02:39:36 2009	(r750)
+++ lvm2/trunk/debian/changelog	Mon Oct 12 03:23:36 2009	(r751)
@@ -1,6 +1,7 @@
 lvm2 (2.02.53-3) UNRELEASED; urgency=low
 
   * Remove notify rules, unused for now.
+  * Add better documentation about the udev rules.
 
  -- Bastian Blank <waldi at debian.org>  Mon, 12 Oct 2009 04:38:12 +0200
 

Modified: lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/55-dm.rules
==============================================================================
--- lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/55-dm.rules	Mon Oct 12 02:39:36 2009	(r750)
+++ lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/55-dm.rules	Mon Oct 12 03:23:36 2009	(r751)
@@ -1,13 +1,5 @@
 # Udev rules for device-mapper devices.
-#
-# These rules create a DM control node in /dev/(DM_DIR) directory.
-# The rules also create nodes named dm-x (x is a number) in /dev
-# directory and symlinks to these nodes with names given by
-# the actual DM names. Some udev environment variables are set
-# for use in later rules:
-#   DM_NAME - actual DM device's name
-#   DM_UUID - UUID set for DM device (blank if not specified)
-#   DM_SUSPENDED - suspended state of DM device (0 or 1)
+# See /usr/share/doc/dmsetup/README.udev for further information.
 
 KERNEL=="device-mapper", NAME="mapper/control"
 

Modified: lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules
==============================================================================
--- lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules	Mon Oct 12 02:39:36 2009	(r750)
+++ lvm2/trunk/debian/tree/dmsetup/lib/udev/rules.d/60-persistent-storage-dm.rules	Mon Oct 12 03:23:36 2009	(r751)
@@ -1,9 +1,5 @@
 # Udev rules for device-mapper devices.
-#
-# These rules create symlinks in /dev/disk directory.
-# Symlinks that depend on probing filesystem type,
-# label and uuid are created only if the device is not
-# suspended.
+# See /usr/share/doc/dmsetup/README.udev for further information.
 
 SUBSYSTEM!="block", GOTO="persistent_storage_dm_end"
 KERNEL!="dm-[0-9]*", GOTO="persistent_storage_dm_end"

Added: lvm2/trunk/debian/tree/dmsetup/usr/share/doc/dmsetup/README.udev
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ lvm2/trunk/debian/tree/dmsetup/usr/share/doc/dmsetup/README.udev	Mon Oct 12 03:23:36 2009	(r751)
@@ -0,0 +1,19 @@
+The udev rules included into dmsetup are responsible for setting up the devices
+in /dev/mapper and also provides some environment variables for use by later
+rules:
+
+* DM_NAME
+  Actual DM device's name
+* DM_UUID
+  UUID set for DM device (blank if not specified)
+* DM_SUSPENDED
+  Suspended state of DM device (0 or 1)
+
+Some other variables can be set to change the behaviour:
+
+* DM_HIDE
+  Set to 1 to not even try to extract filesystem information and set links in
+  /dev/disk according to that information.
+
+Other device mapper using packages may define there own rules. For example lvm2,
+see /usr/share/doc/lvm2/README.udev for further informations.

Modified: lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/56-lvm.rules
==============================================================================
--- lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/56-lvm.rules	Mon Oct 12 02:39:36 2009	(r750)
+++ lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/56-lvm.rules	Mon Oct 12 03:23:36 2009	(r751)
@@ -1,4 +1,5 @@
 # Udev rules for LVM.
+# See /usr/share/doc/lvm2/README.udev for further information.
 
 ENV{DM_UUID}!="LVM-?*", GOTO="lvm_end"
 

Modified: lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/60-persistent-storage-lvm.rules
==============================================================================
--- lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/60-persistent-storage-lvm.rules	Mon Oct 12 02:39:36 2009	(r750)
+++ lvm2/trunk/debian/tree/lvm2/lib/udev/rules.d/60-persistent-storage-lvm.rules	Mon Oct 12 03:23:36 2009	(r751)
@@ -1,12 +1,5 @@
 # Udev rules for LVM.
-#
-# These rules create symlinks for LVM logical volumes in
-# /dev/VG directory (VG is an actual VG name). Some udev
-# environment variables are set (they can be used in later
-# rules as well):
-#   DM_LV_NAME - logical volume name
-#   DM_VG_NAME - volume group name
-#   DM_LV_LAYER - logical volume layer (blank if not set)
+# See /usr/share/doc/lvm2/README.udev for further information.
 
 ENV{DM_UUID}!="LVM-?*", GOTO="persistent_storage_lvm_end"
 ENV{DM_HIDE}!="", GOTO="persistent_storage_lvm_end"

Added: lvm2/trunk/debian/tree/lvm2/usr/share/doc/lvm2/README.udev
==============================================================================
--- /dev/null	00:00:00 1970	(empty, because file is newly added)
+++ lvm2/trunk/debian/tree/lvm2/usr/share/doc/lvm2/README.udev	Mon Oct 12 03:23:36 2009	(r751)
@@ -0,0 +1,13 @@
+The udev rules included in lvm2 are responsible for setting up the devices
+in /dev/$VG and also provides some environment variables for use by later
+rules:
+
+* DM_VG_NAME
+  Volume group name
+* DM_LV_NAME
+  Logical volume name
+* DM_LV_LAYER
+  Logical volume layer (blank if not set)
+
+The rules included in dmsetup are responsible for the core device mapper
+support, see /usr/share/doc/dmsetup/README.udev for further information.

More information about the pkg-lvm-commits mailing list