f78cae31d01d247db0c6f0cad302b52f86a3f4f8
[grml-udev-config.git] / debian / README.Debian
1 grml-udev-config for Debian
2 ---------------------------
3
4 grml.rules
5 ==========
6 A custom rule file /etc/udev/z30_grml.rules is installed by the grml udev
7 package.  This file contains a udev rule to map USB-Pendrives (or USB-Sticks) to
8 the /dev/external* device nodes (or symlinks respectively). This allows us to
9 easily mount USB-Sticks on a grml System and you don't risk to accidentialy
10 overwrite your SCSI/S-ATA disk.
11 Note: These rules are deprecated in favour of the grml_usbdev rules mentioned
12 below. Nevertheless this way of accessing USB-Pendrives is retained for
13 backwards compatibility reasons.
14
15 grml_usbdev.rules
16 =================
17 The rule file /etc/udev/z31_grml_usbdev.rules is installed. The rules contained
18 in there allow simple access to USB devices like pendrives upon plugging them
19 in.  You'll get according symlinks in /dev (prefixed with 'usb-'), entries in
20 /etc/fstab (via rebuildfstab) and directories in /mnt according to available
21 labeled filesystems for free. On removal of the usb device the symlinks and
22 usb*-directories in /mnt will automatically vanish.
23
24 To prevent udev from automatically creating the directories and fstab entries
25 please rename the rules file by executing:
26
27         mv z31_grml_usbdev.rules \#z31_grml_usbdev.rules
28
29 inside the directory /etc/udev/rules.d
30
31 Persistent network interfaces
32 =============================
33 Don't run write_net_rules on any occasion, it's evil on a Live-CD. The script is
34 still shipped and can be enabled manually to get persistent network interfaces
35 across reboots (e.g. after a hd-install). Just execute
36
37         mv \#75_persistent-net-generator.rules 75_persistent-net-generator.rules
38
39 in /etc/udev/rules.d and reload the udev rules with 'udevcontrol reload_rules'
40 (as root)
41
42 Or better just see 'grml-tips udev' for other ways to get persistent network
43 interfaces.
44
45 SELinux support
46 ===============
47 The udev version on grml is built without support for SELinux.
48
49 Various
50 =======
51 The generation of the udeb package has been disabled in debian/rules (by
52 removing BUILD_UDEB := 1) as this is not needed on grml. Some grml specific
53 functions have been added to the init script and to the maintainer scripts.
54
55 hg repository
56 ==============
57 Since version 0.103-0grml1 this package is maintained in the grml hg repository
58 at http://hg.grml.org/udev. The version in the git repository at
59 http://git.distanz.ch is not maintained anymore.
60
61  -- Michael Prokop <mika@grml.org>  Fri, 13 Nov 2009 12:02:41 +0100
62