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: freebsd-bugs (Nobody)
Keywords: easy, needs-patch
Depends on:
Reported: 2019-01-16 13:29 UTC by Mateusz Piotrowski
Modified: 2023-03-10 13:36 UTC (History)
4 users (show)

See Also:


Note You need to log in before you can comment on or make changes to this bug.
Description Mateusz Piotrowski freebsd_committer 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 2019-01-17 13:16:11 UTC
Reported by: Michiel van Baak <michiel@vanbaak.eu>
Comment 2 Benedict Reuschling freebsd_committer 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:

Comment 3 commit-hook freebsd_committer 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 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?