From: Karel Zak <kzak@redhat.com>
Date: Mon, 13 Sep 2010 09:43:14 +0000 (+0200)
Subject: mount: better describe UUIDs usage in man pages
X-Git-Tag: v2.19-rc1~343
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=7c97f7402e77b2d42c4ddfd9516c848a8022f099;p=thirdparty%2Futil-linux.git

mount: better describe UUIDs usage in man pages

Addresses: http://bugzilla.redhat.com/show_bug.cgi?id=632373
Signed-off-by: Karel Zak <kzak@redhat.com>
---

diff --git a/mount/fstab.5 b/mount/fstab.5
index c10490a42b..99557194e8 100644
--- a/mount/fstab.5
+++ b/mount/fstab.5
@@ -87,6 +87,11 @@ writing LABEL=<label> or UUID=<uuid>,
 e.g., `LABEL=Boot' or `UUID=3e6be9de\%-8139\%-11d1\%-9106\%-a43f08d823a6'.
 This will make the system more robust: adding or removing a SCSI disk
 changes the disk device name but not the filesystem volume label.
+.LP
+Note that
+.BR mount (8)
+uses UUIDs as strings. The string representation of the UUID should be based on
+lower case characters.
 .RE
 
 .B The second field
diff --git a/mount/mount.8 b/mount/mount.8
index 0147e71db4..79a55f24a9 100644
--- a/mount/mount.8
+++ b/mount/mount.8
@@ -136,9 +136,19 @@ or
 The recommended setup is to use LABEL=<label> or UUID=<uuid> tags rather than
 .B /dev/disk/by-{label,uuid}
 udev symlinks in the /etc/fstab file. The tags are
-more readable, robust and portable. The mount(8) command internally uses udev
+more readable, robust and portable. The
+.BR mount (8)
+command internally uses udev
 symlinks, so use the symlinks in /etc/fstab is not advantage over LABEL=/UUID=.
-For more details see libblkid(3).
+For more details see
+.BR libblkid (3).
+
+Note that
+.BR mount (8)
+uses UUIDs as strings. The UUIDs from command line or
+.BR fstab (5)
+are not converted to internal binary representation. The string representation
+of the UUID should be based on lower case characters.
 
 The
 .I proc