Bug 234997 - gmirror.8: geom_mirror_load="YES" is not documented
Summary: gmirror.8: geom_mirror_load="YES" is not documented
Status: In Progress
Alias: None
Product: Documentation
Classification: Unclassified
Component: Manual Pages (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Only Me
Assignee: Benedict Reuschling
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2019-01-16 13:29 UTC by Mateusz Piotrowski
Modified: 2024-01-10 04:58 UTC (History)
4 users (show)

See Also:

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Mateusz Piotrowski freebsd_committer freebsd_triage 2019-01-16 13:29:07 UTC 
In order to activate mirrors automatically on boot one has to add geom_mirror_load="YES" to loader.conf(5). It is not documented in gmirror.8, however.
Comment 1 Mateusz Piotrowski freebsd_committer freebsd_triage 2019-01-17 13:16:11 UTC 
Reported by: Michiel van Baak <michiel@vanbaak.eu>
Comment 2 Benedict Reuschling freebsd_committer freebsd_triage 2019-06-09 16:34:28 UTC 
The problem is actually bigger than anticipated. All the other files in the head/lib/geom/ subdirectories for the other GEOM modules also do not have this information in the SYNOPSIS section. I've opened a review for gmirror.8 here:

https://reviews.freebsd.org/D20577
Comment 3 commit-hook freebsd_committer freebsd_triage 2022-10-05 16:50:54 UTC 
A commit in branch main references this bug:

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

commit d63104d253e284964a2e7994553594b5b04422a3
Author:     Benedict Reuschling <bcr@FreeBSD.org>
AuthorDate: 2022-10-05 16:44:31 +0000
Commit:     Benedict Reuschling <bcr@FreeBSD.org>
CommitDate: 2022-10-05 16:44:31 +0000

    Add information on how to load gmirror on boot to auto activate mirrors

    PR:                     234997
    Reported by:            Michiel van Baak <michiel@vanbaak.eu>
    Event:                  Aberdeen Hackathon 2022
    Differential Revision:  https://reviews.freebsd.org/D20577

 lib/geom/mirror/gmirror.8 | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)
Comment 4 Benedict Reuschling freebsd_committer freebsd_triage 2022-10-05 16:53:05 UTC 
I've fixed it for gmirror, but as mentioned, the other geom man pages also need that. Not sure if that is necessary in the age of devmatch, but for consistencies sake, it would not hurt either. Opinions?
Comment 5 Mark Linimon freebsd_committer freebsd_triage 2024-01-10 04:58:42 UTC 
^Triage: assign to committer that resolved.

It still seems like there are similar issues to be discussed, however.