--- a/debian/rebuildfstab.8 Fri Nov 24 20:45:30 2006 +0100
+++ b/debian/rebuildfstab.8 Fri Nov 24 21:11:42 2006 +0100
@@ -20,8 +20,7 @@ located in /dev and listed in /proc/part
\fBgrml-rebuildfstab\fP is a shell alias defined for the zsh in
/etc/zsh/zshrc. It is meant for easy use and rebuild of /etc/fstab without
having to remember the options of rebuildfstab. grml-rebuildfstab executes
-\'"rebuildfstab -v -r -u $fstabuser -g $fstabuser\'" where $fstabuser is
-the user with the UID 1000.
+\'"rebuildfstab -v -r -config\'".
.SH DETAILS ABOUT GENERATION OF /etc/fstab
@@ -36,55 +35,57 @@ a file named /etc/fstab.local which will
a file named /etc/fstab.local which will be appended to /etc/fstab on each
invocation of rebuildfstab.
-If a partition contains a filesystem with a filesystem label on it, an
-entry with LABEL= is generated so you can run \'mount /mnt/$LABEL\'. If
-multiple filesystems have the same filesystem label entries with UUID= are
-genereated instead so uniqueness for mounting filesystems can be
-guaranteed. For present filesystem labels see /dev/disk/by-label/* for the
-label<->partition mapping. If you want to get details about a filesystem
-(and if a label is defined) run \'"/lib/udev/vol_id /dev/ice\'". If you want
-to disable the LABEL feature take a look at the FAQ below.
+If a partition contains a filesystem with a filesystem label on it, an entry
+with LABEL= is generated so you can run \'mount /mnt/$LABEL\'. If multiple
+filesystems have the same filesystem, label entries with UUID= are generated
+instead so uniqueness for mounting filesystems can be guaranteed. If duplicate
+labels are present but UUIDs are not set it is falling back to normal
+/dev/ice-schema. For present filesystem labels see /dev/disk/by-label/* for the
+label<->partition mapping. If you want to get details about a filesystem (and
+if a label is defined) run \'"/lib/udev/vol_id /dev/ice\'". If you want to
+disable the LABEL feature take a look at the FAQ below.
-The /dev/usb-sd* entries are used for external usb devices. If you plug in
-an external usb device grml's udev will generate /dev/usb-sd* devices
-(which are symlinks to the real devices) and run rebuildfstab so you can
+The /dev/usb-sd* entries are used for external usb devices. If you plug in an
+external usb device grml's udev will generate /dev/usb-sd* devices (which are
+symlinks to the real devices). Afterwards rebuildfstab is executed so you can
easily mount the device without taking care of entries in /etc/fstab. See
-/usr/share/doc/udev/README.grml for more details. To disable the feature
-just remove the symlink to the udev rules file named
-/etc/udev/rules.d/z31_grml_usbdev.rules.
+/usr/share/doc/udev/README.grml for more details. To disable the /dev/usb-sd*
+feature just remove the symlink to the udev rules file named
+/etc/udev/rules.d/z31_grml_usbdev.rules. To disable [grml-]rebuildfstab
+when adding/removing block devices remove the symlink to the udev rules file
+named /etc/udev/rules.d/z32_grml_blockdevices.rules.
Notice: If you do not want to rebuild /etc/fstab on your harddisk
installation of grml either run \'"grml-autoconfig\'" and deselect the
-fstab entry or manually set CONFIG_FSTAB='no' in /etc/grml/autoconfig.
+fstab entry, manually set CONFIG_FSTAB='no' in /etc/grml/autoconfig.
.SH FAQ
.TP
.B What's the /mnt/external* stuff?
-If you plug in an external usb device udev of grml
-(/etc/udev/rules.d/z30_grml.rules) will generate symlinks /dev/external and
+If you plug in an external usb device udev of grml (more precise:
+/etc/udev/rules.d/z30_grml.rules) will generate symlinks /dev/external and
/dev/external1 pointing to the real usb device. Running \'"mount
-/mnt/external1\'" then mounts the first usb device. While /mnt/external1
+/mnt/external1\'" then will mount the first usb device. While /mnt/external1
would be something like /dev/sda1 (the first partition on the device),
/mnt/external would correspond to something like /dev/sda (no partition).
-Starting with udev >= 0.098-2grml3 grml provides improved handling of
-external usb devices. See the next item on the FAQ.
+Starting with udev >= 0.098-2grml3 grml provides improved handling of external
+usb devices. See the next item on the FAQ.
.TP
.B What's the /mnt/usb-sd* stuff?
-Handling of external usb devices (like usb pens) sucks if you do not have
-the corresponding entries in /etc/fstab. An approach of grml is to rebuild
-the fstab (using grml-rebuildfstab) on demand. Handling of labels works
-with grml-rebuildfstab >= 0.3 but not all devices have labels on their
-filesystems. Therefore grml's udev creates /dev/usb-sd* symlinks to the
-real usb devices and creates corresponding directories (that's the
-/mnt/usb-sd* stuff). Now you can mount external usb devices on request via
-running something like 'mount /mnt/usb-sda1', it also works for the main
-user on your grml system (with uid 1000, by default that's the user named
-grml). If you do not like the feature just remove the symlink
-/etc/udev/rules.d/z31_grml_usbdev.rules pointing to the real udev rules
-file and restart the udev daemon running \'"/etc/init.d/udev restart\'".
+Handling of external usb devices (like usb pens) sucks if you do not have the
+corresponding entries in /etc/fstab. An approach of grml is to rebuild
+/etc/fstab (using grml-rebuildfstab) for each new and/or removed block device on
+demand. Handling of labels works with grml-rebuildfstab >= 0.3 but not all
+devices have labels on their filesystems. Therefore grml's udev creates symlinks
+/dev/usb-sd* pointing to the real usb devices and afterwards creates the
+corresponding directories (that's the /mnt/usb-sd* stuff). Now you can mount
+external usb devices on request via running something like 'mount
+/mnt/usb-sda1'. If you do not like the feature just remove the symlink
+/etc/udev/rules.d/z31_grml_usbdev.rules pointing to the real udev rules file and
+restart the udev daemon running \'"/etc/init.d/udev restart\'".
.TP
.B How to disable the LABEL-feature?
@@ -93,6 +94,14 @@ grml-rebuildfstab'. If you booted using
grml-rebuildfstab'. If you booted using the bootoption nolabel
but want to force usage of labels later on again, rebuild fstab manually
via running 'LABEL=1 grml-rebuildfstab'.
+
+.TP
+.B How do I set uid/gid for the user(s) who should be allowed to access the device?
+
+You can either manually run 'rebuildfstab -u <userid> -g <groupid> [...]' or if
+you want to make your changes persistent adjust CONFIG_FSTAB_USER and
+CONFIG_FSTAB_GROUP in /etc/grml/autoconfig and make sure you use the '-config'
+option of rebuildfstab (automatically done in grml's udev rule).
.SH OPTIONS
The following options are supported by rebuildfstab:
@@ -111,13 +120,18 @@ Set uid in /etc/fstab to specified value
.TP
.B \-g, \-\-group [ groupname ]
Set gid in /etc/fstab to specified value.
+.TP
+.B \-c, \-\-config
+Source configuration file /etc/grml/autoconfig and use variables
+CONFIG_FSTAB_USER and CONFIG_FSTAB_GROUP (if set) for uid/gid in
+/etc/fstab.
+
.SH BUGS
-Please report any problems you notice. See http://grml.org/bugs/ for
-details.
+Please report any problems you notice. See http://grml.org/bugs/ for details.
.SH SEE ALSO
.BR scanpartitions (8)
.SH AUTHOR
rebuildfstab was written by Klaus Knopper and Michael Prokop.
.PP
-This manual page was written by Michael Prokop <mika@grml.org>,
-for the Debian project (but may be used by others).
+This manual page was written by Michael Prokop <mika@grml.org>
+for the grml project (but may be used by others).