Release new version 0.6.1
[grml-udev-config.git] / debian / README.Debian
1 grml-udev-config for Debian
2 ---------------------------
3
4 Notes regarding installation
5 ============================
6
7 Please notice that this package does NOT activate its init script itself on
8 installation. The udev rules are enabled automatically but if you want to use
9 the bootoptions noudev and blacklist you have to enable the provided init script
10 manually (unless you are using just the Grml *live* system of course where the
11 according toolchains do that for you).
12
13 So if you want to enable the grml-udev initscript manually on your system
14 execute the following commands to replace the /etc/init.d/udev script with
15 /etc/init.d/grml-udev:
16
17  update-rc.d -f udev remove
18  update-rc.d grml-udev start 03 S .
19
20 Documentation of provided rules
21 ===============================
22
23 /lib/udev/rules.d/01-grml-forensic.rules
24 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
25
26 Mark new block devices as readonly when booting with bootoption
27 forensic/readonly.
28
29 /lib/udev/rules.d/60-grml-blockdevices.rules
30 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31
32 This script triggers the /usr/sbin/rebuildfstab script for updating /etc/fstab
33 and /media/* when block devices are added or removed from the system.
34
35 /lib/udev/rules.d/60-grml-external.rules
36 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
37
38 Udev rule to map USB pendrives/sticks to /dev/external* device nodes (or
39 symlinks respectively).
40
41 Note: This rule is deprecated in favour of the grml-usbdev rules file mentioned
42 below. Nevertheless this way of accessing devices is retained for backwards
43 compatibility reasons.
44
45 /lib/udev/rules.d/60-grml-usbdev.rules
46 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
47
48 This udev rule allows simple access to USB devices like pendrives upon plugging
49 them in.  You'll get according symlinks in /dev (prefixed with 'usb-'), entries
50 in /etc/fstab (via rebuildfstab) and directories in /media according to available
51 labeled filesystems for free. On removal of the USB device the symlinks and
52 usb*-directories in /media will automatically vanish.
53
54  -- Michael Prokop <mika@grml.org>  Fri, 13 Nov 2009 12:02:41 +0100
55