diff --git a/lib/geom/label/glabel.8 b/lib/geom/label/glabel.8 --- a/lib/geom/label/glabel.8 +++ b/lib/geom/label/glabel.8 @@ -27,7 +27,7 @@ .Os .Sh NAME .Nm glabel -.Nd "disk labelization control utility" +.Nd "GEOM provider label utility" .Sh SYNOPSIS .Nm .Cm create @@ -68,7 +68,14 @@ .Sh DESCRIPTION The .Nm -utility is used for GEOM provider labelization. +utility is used for GEOM provider label management. +.Pp +This manual page will discuss three types of labels. +Generic GEOM labels set with +.Nm Em label , +filesystem labels recognized by a specific GEOM provider, and +device metadata identifiers (like GPT IDs or Linux Swap UUIDs). +.Pp A label can be set up on a GEOM provider in two ways: .Dq manual or @@ -82,63 +89,49 @@ method uses on-disk metadata to store the label and detect it automatically in the future. .Pp -This GEOM class also provides volume label detection for file systems. -Those labels cannot be set with -.Nm , -but must be set with the appropriate file system utility, e.g.\& for UFS -the file system label is set with -.Xr tunefs 8 . -Currently supported file systems are: -.Pp -.Bl -bullet -offset indent -compact -.It -UFS1 volume names (directory -.Pa /dev/ufs/ ) . -.It -UFS2 volume names (directory -.Pa /dev/ufs/ ) . -.It -UFS1 file system IDs (directory -.Pa /dev/ufsid/ ) . -.It -UFS2 file system IDs (directory -.Pa /dev/ufsid/ ) . -.It -MSDOSFS (FAT12, FAT16, FAT32) (directory -.Pa /dev/msdosfs/ ) . -.It -CD ISO9660 (directory -.Pa /dev/iso9660/ ) . -.It -EXT2FS (directory -.Pa /dev/ext2fs/ ) . -.It -NTFS (directory -.Pa /dev/ntfs/ ) . -.It -Swap Linux (directory -.Pa /dev/swaplinux/ ) . -.El +Note that file system labels (such as those for UFS or FAT) +and GPT-based identifiers (such as GPT labels or GPT UUIDs) +are not created by +.Nm +but may appear alongside GEOM labels in +.Pa /dev . .Pp -Support for partition metadata is implemented for: +GEOM labels are set in the GEOM area of disk metadata. +Volume labels for file systems are set by the appropriate file system utility, +often within the filesystem data. +Device metadata identifiers are set during partitioning. +All types of labels can be used at the same time, +and will have appropriate entries under +.Pa /dev . .Pp -.Bl -bullet -offset indent -compact -.It -GPT labels (directory -.Pa /dev/gpt/ ) . -.It -GPT UUIDs (directory -.Pa /dev/gptid/ ) . +If a GEOM provider is able to read and understand the filesystem +label or device metadata identifier, a suitable entry will be created +as shown below. +.Bl -column "UFS1 or UFS2 volume names" "/dev/swaplinux/" "To set volume label" +.It Em "Filesystem Type" Ta Em "Mount path/