MFC r314542:

kern.cam.da.X.delete_method: add -width to .Bl macro call

Now the section width is set appropriately per the BIO_DELETE
parameter being described.

Copy head@r302406 to stable/11 as part of the 11.0-RELEASE cycle.
Prune svn:mergeinfo from the new branch, as nothing has been merged
here.

Additional commits post-branch will follow.

Approved by: re (implicit)
Sponsored by: The FreeBSD Foundation

Make delete method set via kern.cam.da.X.delete_method persistent.

This allows to set delete method via tunable, before device capabilities
are known. Also allow ZERO method for devices not reporting LBP, if user
explicitly requests it -- it may be useful if storage supports compression
and WRITE SAME, but does not support UNMAP.

MFC after: 2 weeks

It's 2015, and some people are still trying to use fdisk and then
go asking what debug flags to set for GEOM to make it work. Advice
them to use gpart(8) instead.

Something similar should probably done with disklabel,
but I need to rewrite the disklabel examples first.

Reviewed by: wblock@
MFC after: 1 month
Sponsored by: The FreeBSD Foundation
Differential Revision: https://reviews.freebsd.org/D3315

Document sort_io_queue sysctls/tunables.

MFC after: 1 week

Fix some Xr references:

- ada(4): ad(4) - removed, ada(4) would be a self-referencing entry
- cd(4): ad(4) -> ada(4)
- da(4): ad(4) -> ada(4)
- DEVICE_PROBE(9): ugen(5) -> ugen(4)
- ed(4): dhclinet(8) -> dhclient(8) (typo)
- lmc(4): Netgraph(4) -> netgraph(4)
- security(7): rc.conf(8) -> rc.conf(5)
- sfxge(4): cpuset(8) -> cpuset(1)
- sbp(4): sysctl(1) -> sysctl(8)
- portindex(5): build(1) -> build(7)
- u3g(4): usbconfig(5) -> usbconfig(8)
- usb_quirk(4): usbconfig(5) -> usbconfig(8)

Found with: textproc/igor
MFC after: 3 days

Add links to cam(4).

Markup fixes.

- Axe the PARTITIONING and IOCTLS section as this has been made obsolete
now that all that stuff has been abstracted out of the disk drivers with
GEOM.
- Reference bsdlabel(8) rather than disklabel(8).

Ok'd by: phk, scottl (1)
Submitted by: Björn König (2)

Expand *n't contractions.

Mechanically kill hard sentence breaks and double whitespaces.

Removed trailing whitespace.

mdoc(7): Use the new feature of the .In macro.

Move dynamic sysctl(8) variable creation for the cd(4) and da(4) drivers
out of cdregister() and daregister(), which are run from interrupt context.

The sysctl code does blocking mallocs (M_WAITOK), which causes problems
if malloc(9) actually needs to sleep.

The eventual fix for this issue will involve moving the CAM probe process
inside a kernel thread. For now, though, I have fixed the issue by moving
dynamic sysctl variable creation for these two drivers to a task queue
running in a kernel thread.

The existing task queues (taskqueue_swi and taskqueue_swi_giant) run in
software interrupt handlers, which wouldn't fix the problem at hand. So I
have created a new task queue, taskqueue_thread, that runs inside a kernel
thread. (It also runs outside of Giant -- clients must explicitly acquire
and release Giant in their taskqueue functions.)

scsi_cd.c: Remove sysctl variable creation code from cdregister(), and
move it to a new function, cdsysctlinit(). Queue
cdsysctlinit() to the taskqueue_thread taskqueue once we
have fully registered the cd(4) driver instance.

scsi_da.c: Remove sysctl variable creation code from daregister(), and
move it to move it to a new function, dasysctlinit().
Queue dasysctlinit() to the taskqueue_thread taskqueue once
we have fully registered the da(4) instance.

taskqueue.h: Declare the new taskqueue_thread taskqueue, update some
comments.

subr_taskqueue.c:
Create the new kernel thread taskqueue. This taskqueue
runs outside of Giant, so any functions queued to it would
need to explicitly acquire/release Giant if they need it.

cd.4: Update the cd(4) man page to talk about the minimum command
size sysctl/loader tunable. Also note that the changer
variables are available as loader tunables as well.

da.4: Update the da(4) man page to cover the retry_count,
default_timeout and minimum_cmd_size sysctl variables/loader
tunables. Remove references to /dev/r???, they aren't used
any longer.

cd.9: Update the cd(9) man page to describe the CD_Q_10_BYTE_ONLY
quirk.

taskqueue.9: Update the taskqueue(9) man page to describe the new thread
task queue, and the taskqueue_swi_giant queue.

MFC after: 3 days

Hiten's patchset for section four manpages, slightly edited by me.

Uniformly refer to a file system as "file system".

Approved by: re

More file system > filesystem

Ispell sweep of share/man/man4.

Update man pages in the section 4 to match the reality in -CURRENT.

- Change lines referring to kernel configuration file:
device foo0 at isa port xxx irq yyy...
to
device foo
Describe resource "hints" in /boot/device.hints.

- Try to describe resource allocation and probe/attach behavior in the
newbus framework.

Consistently use 'queueing' instead of 'queuing'. Both spellings are
correct, but the former seems to be preferred. This makes all of the
section-4 manual pages consistent in this respect.

mdoc(7) police: removed HISTORY info from the .Os call.

mdoc(7) police: normalize .Nd.

Eliminate mdocNG warnings caused by misplaced or extraneous macro calls.

mdoc(7) police: use the new features of the Nm macro.

Use Fx macro wherever possible.

Fixed typo: .ar -> .Ar

Update @freebsd.org email addresses to @FreeBSD.org as is the
precedent.

- link ata.4 to {acd,ad,afd,ast}.4
- add the reference to ad.4 in da.4.

MFC candidate.

Submitted by: sheldonh, mpp

Insert a reference to ata.4.

Discussed with: phk

Oops, there's no ad.4.

Replace a reference to wd(4) to ad(4).

Found by: phk

. insert forgotten by someone "Space Mode on" directive. It caused displaying
of all macros placed after FILES section w/o any space characters.
. slightly correct usage of .An macros.

Use .An macro for declare Authors Name in AUTHORS section

Remove single-space hard sentence breaks. These degrade the quality
of the typeset output, tend to make diffs harder to read and provide
bad examples for new-comers to mdoc.

First round of config related changes to the manpages.

device blah0 -> device blah for PCI devices and busses.

$Id$ -> $FreeBSD$

transparant -> transparent

PR: docs/8472
Submitted by: Craig Leres <leres@ee.lbl.gov>

Fix a few typos and misspellings, grabbed from PR#8472

Remove reference to nonexistant man page `da(9)'

Fixed previous fix (dad -> rda via rad).

Correct typos.

PR: docs/12068
Submitted by: Steve Coltrin <spcoltri@io.com>

Devices are hardwired with "unit 0", not "lun 0" as was in these man pages.

Also, update the pass(4) man page to indicate that some CCBs must be
sent through the xpt(4) device and cannot be sent through a pass device.

PR: 8826

Fix a bunch typos, one fix of which is from docs/10794

Update the da(4) man page for CAM. The da.4 man page was repository-copied
from the sd.4 man page.

This includes a discussion of write caching and its effects.

Reviewed by: ken
Submitted by: gibbs

Correct the name of a header file that is referenced.

Revert $FreeBSD$ back to $Id$

added man page for /dev/sysmouse. (and activate it)

plus add appropriate xrefs now that we have {cd,sd,st}.9

Make the long-awaited change from $Id$ to $FreeBSD$

This will make a number of things easier in the future, as well as (finally!)
avoiding the Id-smashing problem which has plagued developers for so long.

Boy, I'm glad we're not using sup anymore. This update would have been
insane otherwise.

Sort cross references.

After prodding, add a BSD style copyright to those man pages I think
I probably originally wrote. Also take my name OUT of the ddb
man page.. I did NOT port it from mach.

Use the .Fx macro to specify FreeBSD version where appropriate.

Fix a bunch of spelling errors in a bunch of man pages.

Use -mdoc properly.
Delete lots of out-of-date text.
Write new text to replace some of the old text. BDE will need to inspect
the results for accuracy.

Updated man pages to reflect new configuration options. These man pages
are getting pretty out of date and need to be visited some more.

Added more missing manual pages from 1.1.5.