From nobody Sun Sep 13 09:09:33 2026 X-Original-To: dev-commits-src-main@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 4hjMt54j7Kz6s5YL for ; Sun, 13 Sep 2026 09:09:33 +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 4hjMt54Cnmz4Kvt for ; Sun, 13 Sep 2026 09:09:33 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789290573; 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=yba1TioheoRYlVwp8ptDYpBMtvpYcSNnyMgZY3amlzdcfV1QIQjYzig/z80GAc1X5xYyDq s2ytwdcfQrAZEp3AK8g8T4X3q3ZD6CwRsLnek7sipO1hBIZcAMXy/2Q46P0wxfkp3Q93jD S4WlvzPXNC89zQWzoFwha87ySrAoShh0mprvVdnzaRQBzAVbDGyFdZNFJOvSjo29XWA5Vi U1nPOaU8S7UckQMMsjAaJmzsn7eK9VH4j1/Z94GEhQCzpJU+u8wEw5bDqI6HP99vp9gItN 7RDWx5DbyrFMHRhboeKSjsStHZa7/6gJegcAPFkmnnMLC4hivJ3XTyGY7yzu3A== ARC-Seal: i=1; a=rsa-sha256; d=freebsd.org; s=dkim; cv=none; t=1789290573; b=B5yC3qGNbSn6eZ8kdzhQHUrnJnAGJG+/YYDoElmrODu8sqryvtNkv9Ar3uJtNDolYUXdhA NPdWMEYl52/gfqwvMkTiikL091QzlZxd4v6PePhA9wS0xL7W3cRaic768TqdgFgmcXtjIT QfIltxzpu21/LI0CeZlwI9vy+wAQes8QbADIIpUwJ72i4ocfFF+/nIwJvy9BiA2C2E5ZJF UGXPXAoeQji3PwvlSN4U4idMwSa6coqATce74irmC1mts1+ugYXtso1DMB2rZBNy+2EGW4 Sj0qqjdKPgj7/vyKhhLGEJXkr4cfvpop7t+jjHduptPIhGwPYLEiWx7rJCDscg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1789290573; 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=RqRfBJtJz0y3McwWLI8N/22NqJN1vZhQ0kLLn7pLJoxgdTSPgC3/ISQt9vC8jXc5NUWmIL TSJ4Y4CNPMHfb9h6yTDzAslHmEvdn6xpa6T389ZJAh9qXQNk6k26evXFkVMYEqezWSiu5L WRNg9pCZ389UXjm+k1zzZxpK5KaCZb2EfRQI3bQ7J6LtW+y325zrw/+ek2ZC/lto4sPcsa ne9PX4mIoGlLQsG3VNeV9zfaOOydILLZOfuD3cvWBh/m0PeNn/6RnUOJD1XTwwhXqAqElD h3qLrmrmsMfHMyOVuoIIdPqs/rGVbocOpLAmyqyDz0Qe4YTr/rJyh2BUTOMWQg== 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 4hjMt530myzcmt for ; Sun, 13 Sep 2026 09:09:33 +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 the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@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/