Bug 218610

Summary:	md(4) manpage misses geom_md.ko
Product:	Documentation	Reporter:	Harald Schmalzbauer <bugzilla.freebsd>
Component:	Books & Articles	Assignee:	freebsd-doc (Nobody) <doc>
Status:	Closed FIXED
Severity:	Affects Some People	CC:	bcr
Priority:	---
Version:	Latest
Hardware:	Any
OS:	Any

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

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

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

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

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

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!