Bug 292530 - geom.8: Add MD, VFS and DISK to classes
Summary: geom.8: Add MD, VFS and DISK to classes
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Many People
Assignee: Alexander Ziaee
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2026-01-17 00:12 UTC by Slawomir Wojciech Wojtczak
Modified: 2026-02-12 05:07 UTC (History)
3 users (show)

See Also:


Attachments
geom.8.diff (309 bytes, patch)
2026-01-17 00:12 UTC, Slawomir Wojciech Wojtczak
no flags Details | Diff
geom.8.diff (348 bytes, patch)
2026-01-17 12:27 UTC, Simon Wollwage
no flags Details | Diff

Note You need to log in before you can comment on or make changes to this bug.
Description Slawomir Wojciech Wojtczak 2026-01-17 00:12:02 UTC
Created attachment 267225 [details]
geom.8.diff

The geom(8) man page show these classes:

|     Currently, classes aware of geom are:
|
|           •   CACHE
|           •   CONCAT
|           •   ELI
|           •   JOURNAL
|           •   LABEL
|           •   MIRROR
|           •   MOUNTVER
|           •   MULTIPATH
|           •   NOP
|           •   PART
|           •   RAID
|           •   RAID3
|           •   SCHED
|           •   SHSEC
|           •   STRIPE
|           •   UNION
|           •   VINUM (deprecated)
|           •   VIRSTOR

This list is not complete as geom(8) also supports MD, VFS and DISK classes.

# geom md        
usage: geom md help
       geom md list [-a] [name ...]
       geom md status [-ags] [name ...]
       geom md load [-v]
       geom md unload [-v]

# geom vfs
usage: geom vfs help
       geom vfs list [-a] [name ...]
       geom vfs status [-ags] [name ...]
       geom vfs load [-v]
       geom vfs unload [-v]

# geom disk     
usage: geom disk help
       geom disk list [-a] [name ...]
       geom disk status [-ags] [name ...]
       geom disk load [-v]
       geom disk unload [-v]

I attach the patch to add MD, VFS and DISK to the geom(8) man page.

Regards,
vermaden
Comment 1 Simon Wollwage freebsd_triage 2026-01-17 12:27:14 UTC
Created attachment 267237 [details]
geom.8.diff

^Triage: rebased patch

Thank you for the submission.

Patches should be based at the src root. I went ahead and updated the diff for you. To base the patch at the root, just use "git diff -u", that is usually the easiest way.
Comment 2 Alexander Ziaee freebsd_committer freebsd_triage 2026-01-17 15:20:36 UTC
Thanks for the patch! Please both of you in the future use a git commit with a commit message and a properly set author and email, and then create the patch with `git format-patch @~1`.

Please let me know if any documentation anywhere is recommending anything else, it creates a lot of extra error-prone work for us.
Comment 3 commit-hook freebsd_committer freebsd_triage 2026-02-05 15:39:02 UTC
A commit in branch main references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=dc2ec1ccc17a0c43c736b16a537c01bb28d814a4

commit dc2ec1ccc17a0c43c736b16a537c01bb28d814a4
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-02-05 15:31:29 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-02-05 15:38:07 +0000

    geom.8: Improve classes list into a table

    Add missing entries MD, VFS, and DISK. Refactor list into a three
    column table, so the data is all visible at once, buying us ten lines
    at MANWIDTH 80, and still rendering nicely at MANWIDTH 59.

    PR:             292530
    MFC after:      3 days
    Reported by:    Slawomir Wojciech Wojtczak <vermaden@interia.pl>

 sbin/geom/core/geom.8 | 45 +++++++++------------------------------------
 1 file changed, 9 insertions(+), 36 deletions(-)
Comment 4 commit-hook freebsd_committer freebsd_triage 2026-02-12 05:07:58 UTC
A commit in branch stable/15 references this bug:

URL: https://cgit.FreeBSD.org/src/commit/?id=33326a7b91490fd0c826ac4928f6b2b8fc278374

commit 33326a7b91490fd0c826ac4928f6b2b8fc278374
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-02-05 15:31:29 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-02-12 05:04:43 +0000

    geom.8: Improve classes list into a table

    Add missing entries MD, VFS, and DISK. Refactor list into a three
    column table, so the data is all visible at once, buying us ten lines
    at MANWIDTH 80, and still rendering nicely at MANWIDTH 59.

    PR:             292530
    MFC after:      3 days
    Reported by:    Slawomir Wojciech Wojtczak <vermaden@interia.pl>

    (cherry picked from commit dc2ec1ccc17a0c43c736b16a537c01bb28d814a4)

 sbin/geom/core/geom.8 | 45 +++++++++------------------------------------
 1 file changed, 9 insertions(+), 36 deletions(-)