Bug 218610 - md(4) manpage misses geom_md.ko
Summary: md(4) manpage misses geom_md.ko
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: --- Affects Some People
Assignee: freebsd-doc (Nobody)
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2017-04-12 18:43 UTC by Harald Schmalzbauer
Modified: 2017-11-19 11:27 UTC (History)
1 user (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 Harald Schmalzbauer 2017-04-12 18:43:40 UTC 
Since MINIMAL kernel configuration lacks "device md", I was curious if there's a way to boot my memory based systems without recompiling a new kernel.
There's geom_md.ko, which is nowhere documented.

md(4) was apporpriate for that I think.

In SYNOPSIS, under »device md«, the same mentioning of kernel modules like other pages do would fit:
Alternatively, to load the driver as a module at boot time, place the
following line in loader.conf(5):

   geom_md_load="YES"

Unfortunately I don't know anything of man page formatting nor do I know any tools to get started.
So this is just a report without patch.

-Harry
Comment 1 Benedict Reuschling freebsd_committer freebsd_triage 2017-09-07 19:25:24 UTC 
I added a review for this, waiting for comments/approval: https://reviews.freebsd.org/D12271
Comment 2 commit-hook freebsd_committer freebsd_triage 2017-11-05 18:46:33 UTC 
A commit references this bug:

Author: bcr
Date: Sun Nov  5 18:45:43 UTC 2017
New revision: 325441
URL: https://svnweb.freebsd.org/changeset/base/325441

Log:
  Extend the synopsis section of md(4) to look more like other manpages
  of this kind.  Describe how to compile the driver into the kernel
  and how to load it as a module.
  This is useful for people using the MINIMAL kernel configuration file.

  PR:			218610
  Submitted by:		Harald Schmalzbauer (bugzilla.freebsd@omnilan.de)
  Reviewed by:		noone (1 month inactivity)
  MFC after:		2 weeks
  Differential Revision:	https://reviews.freebsd.org/D12271

Changes:
  head/share/man/man4/md.4
Comment 3 Benedict Reuschling freebsd_committer freebsd_triage 2017-11-05 18:48:06 UTC 
A fix was committed to HEAD, waiting for the MFC period to pass before closing it.
Comment 4 commit-hook freebsd_committer freebsd_triage 2017-11-19 11:25:14 UTC 
A commit references this bug:

Author: bcr
Date: Sun Nov 19 11:24:24 UTC 2017
New revision: 325996
URL: https://svnweb.freebsd.org/changeset/base/325996

Log:
  MFC r325441:

  Extend the synopsis section of md(4) to look more like other manpages
  of this kind.  Describe how to compile the driver into the kernel
  and how to load it as a module.
  This is useful for people using the MINIMAL kernel configuration file.

  PR:			218610
  Submitted by:		Harald Schmalzbauer (bugzilla.freebsd@omnilan.de)
  Reviewed by:		noone (1 month inactivity)
  MFC after:		2 weeks
  Differential Revision:	https://reviews.freebsd.org/D12271

Changes:
_U  stable/11/
  stable/11/share/man/man4/md.4
Comment 5 Benedict Reuschling freebsd_committer freebsd_triage 2017-11-19 11:27:05 UTC 
The MFC is done, no need to keep this PR open any longer. Thanks for submitting the bug. PR closed!