From nobody Sun Sep 13 09:09:33 2026 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4hjMtB5XLYz6s5LV for ; Sun, 13 Sep 2026 09:09:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange x25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "YR2" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4hjMtB4qXzz4L44 for ; Sun, 13 Sep 2026 09:09:38 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789290578; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=WveX/W1/KimjB+NgHCCDhZh1vmFV8U0MCkMNgEIfx7E=; b=d9pyiL0NSUvkh/KC1DiaG3+VgbeIzIHj58dEMBVbGJQy3oFoyZX73v0c25vTxnbNEIY5lO ufZrb8ZMNDl7uLXfZK+n5nNsk5+LmX26cm8F2mUdPbVwlgOLVLHLQo74A2xtCHVQr6kGAi ZMlSmSm4x4JYsJaIEbBri15ilvxR7jfexDH2ACx5DBTHh+dLuXlko8FttJzD/2ExnauHVz 48I1URJh1lvxnhIIvT3lPvDhgzhm4N4CzPZH/ynvxMtqVPRjlYG8DFHqxUR45vcf2XNH0l mLs61N4YUKRAM/ZjbHzb2Es5KYXd3Qjt1+lLTTQoytNoWcRQS7jpQEywu6nY0g== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789290578; b=iXAu2zxUosKlgqrLmvobQj+Zoizhj206OEYNbx9IrUcQ8oMlqfEQv48borZtfJXYX1/KA6 nwpUtHzpgFJ7WULGSQuDgxBxUMTs7Df41xb8En7KA2vztuw0TAhL0b1eyXbpBgnHvl46D2 TelUbHhCZWZwqsz7FXQHwKsKj7EJRvfFM1HvdOeaR9B5Z8CPSFO1So0uG3+gWedLBbqA6A 16hePJA/EC5perWLrUcqWBRH1d9Y/Dh0hRJENihOI0GJeLYH07UbY+FEQ8drXO4AC9J2Lg EwcA0Gry/pxd6pQmDTKE4FOirjBtQqoCATHYnLGwk0sH7YZ4JaMsgizHZZio2g== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789290578; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=WveX/W1/KimjB+NgHCCDhZh1vmFV8U0MCkMNgEIfx7E=; b=e7JcH9q5avISK3RXihsDQdqpYPsLNSub5tZg8sYcO5LXi5CSA0SnB4EG9Sfi8Oa6d9/nOq H58nScm6tfbN64AtSrfrd0RCLyQ/8j4Jbrn1wMpPOXMWQbgsce0MfJt+/9vz6rum5dM8ZW dvsXnNi3Sc//QoBKqBEeBJ23D41WJivHq2AJa6XarpHuQmjOJBV3U5OXUhZGj964elsRjT pQurJjZRgHD9AXt+G1qgrKXkc11lGNh11yHxc6UwMDbtRETo0izzGRCgdG6quEUsbccdxo LpTf3j9CtraBo6WBmBypt2/ZAWCGlqevi6XCSBIrXF5GHtJTmYiS5S6nFbpmHg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4hjMtB3pJPzd3k for ; Sun, 13 Sep 2026 09:09:38 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 24069 by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sun, 13 Sep 2026 09:09:33 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Benedict Reuschling Subject: git: 05a2d40ac240 - main - glabel.8: clarify volume labels, metadata identifiers, and generic GEOM labels List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-dev-commits-src-all@FreeBSD.org List-Id: List-Post: List-Help: List-Subscribe: List-Unsubscribe: List-Owner: Precedence: list MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bcr X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 05a2d40ac240a2f3c24b8efeb501fbd371d447b8 Auto-Submitted: auto-generated Date: Sun, 13 Sep 2026 09:09:33 +0000 Message-Id: <6aa6684d.24069.61e1eca2@gitrepo.freebsd.org> The branch main has been updated by bcr: URL: https://cgit.FreeBSD.org/src/commit/?id=05a2d40ac240a2f3c24b8efeb501fbd371d447b8 commit 05a2d40ac240a2f3c24b8efeb501fbd371d447b8 Author: Benedict Reuschling AuthorDate: 2026-06-28 18:45:17 +0000 Commit: Benedict Reuschling CommitDate: 2026-09-13 08:52:50 +0000 glabel.8: clarify volume labels, metadata identifiers, and generic GEOM labels Change description of manual page to add precision. Split out filesystem, GPT and GEOM labels. Give an example for each filesystem for the program to show how to set a label. Clarify examples and use ada device names consistently. PR: 262207 Differential Revision: https://reviews.freebsd.org/D51030 --- lib/geom/label/glabel.8 | 129 +++++++++++++++++++++++++++--------------------- 1 file changed, 73 insertions(+), 56 deletions(-) diff --git a/lib/geom/label/glabel.8 b/lib/geom/label/glabel.8 index da958b52befd..ab539d1856d2 100644 --- 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 @@ The 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/