Add man page for grml-udev-rebuildfstab
[grml-udev-config.git] / debian / grml-udev-rebuildfstab.8
1 .TH GRML-UDEV-REBUILDFSTAB 8
2 .SH NAME
3 grml-udev-rebuildfstab \- scan for new devices and add entries to /etc/fstab
4 .SH DESCRIPTION
5 .PP
6
7 \fBgrml-udev-rebuildfstab\fP updates /etc/fstab for available devices and
8 partitions.
9
10 .SH DETAILS ABOUT GENERATION OF /etc/fstab
11
12 If the file /etc/fstab is not present at all a default file will be
13 generated. As devices are added or removed to the system, new entries for
14 for these devices will be added to /etc/fstab. Please note that entries
15 are added to the end of /etc/fstab, so you should \fBnot\fP add your own
16 devices below any lines containing "Added by GRML" but instead \fBabove\fP
17 the line \'"Warning!  Please do....\'".
18
19 If a partition contains a filesystem with a filesystem label on it, an entry
20 with LABEL= is generated so you can run \'mount /mnt/$LABEL\'. If multiple
21 filesystems have the same filesystem, label entries with UUID= are generated
22 instead so uniqueness for mounting filesystems can be guaranteed. If duplicate
23 labels are present but UUIDs are not set it is falling back to normal
24 /dev/ice-schema. For present filesystem labels see /dev/disk/by-label/* for the
25 label<->partition mapping.  If you want to get details about a filesystem (and
26 if a label is defined) run \'"/lib/udev/vol_id /dev/ice\'". If you want to
27 disable the LABEL feature take a look at the FAQ below.
28
29 External USB Devices are named usb-sd*.
30
31 .SH FAQ
32 .TP
33 .B How to disable the LABEL-feature?
34
35 Set the boot option 'nolabel'.
36
37 .TP
38 .B How do I set uid/gid for the user(s) who should be allowed to access the device?
39
40 Adjust CONFIG_FSTAB_USER and CONFIG_FSTAB_GROUP in /etc/grml/autoconfig. Further
41 updates will then use these new values.
42
43 .SH BUGS
44 Please report any problems you notice. See http://grml.org/bugs/ for details.
45 .SH AUTHOR
46 grml-udev-rebuildfstab was written by Ulrich Dangel and Michael Prokop.
47 .PP
48 This manual page was written by Michael Prokop <mika@grml.org>
49 for the grml project (but may be used by others).