Copy stable/9 to releng/9.3 as part of the 9.3-RELEASE cycle.

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

Add a "kern.features.ata_cam" sysctl in the kernel when the ATA_CAM kernel
option is defined. This sysctl can be queried by feature_present(3).

Query for this feature in /sbin/atacontrol and /usr/sbin/burncd.
If these utilities detect that ATA_CAM is enabled, then these utilities
will error out. These utilities are compatible with the old ATA
driver, but are incomptible with the new ATA_CAM driver. By erroring out,
we give end-users an idea as to what remedies to use, and reduce the need for them
to file PR's. For atacontrol, camcontrol must be used instead,
and for burncd, alternative utilties from the ports collection must be used
such as sysutils/cdrtools.

In future, maybe someone can re-write burncd to work with ATA_CAM,
but at least for now, we give a somewhat useful error message to end users.

PR: 160979
Reviewed by: jh, Arnaud Lacombe <lacombar at gmail dot com>
Approved by: re (kib)
Reported by: Joe Barbish <fbsd8 at a1poweruser dot com>

Copy head to stable/9 as part of 9.0-RELEASE release cycle.

Approved by: re (implicit)

mdoc: drop redundant .Pp and .LP calls

They have no effect when coming in pairs, or before .Bl/.Bd

mdoc: order prologue macros consistently by Dd/Dt/Os

Although groff_mdoc(7) gives another impression, this is the ordering
most widely used and also required by mdocml/mandoc.

Reviewed by: ru
Approved by: philip, ed (mentors)

Add support of using environment variable BURNCD_SPEED to specify
recodring speed.

PR: bin/140530
Submitted by: Alexander Best <alexbestms wwu.de>
MFC after: 1 month

- Remove MLINKS to nonexistant manpages
- Change some section numbers to match reality
- For MLINKS to manpages from ports, mention which port installs them

MFC after: 3 days

Document the device burncd uses by default.

Submitted by: Christoph Mallon <christoph.mallon@gmx.de>
MFC after: 3 days

Sort sections.

The "fixate" command no longer terminates command processing,
so that "eject" following it can happen.

Document -F in usage() and SYNOPSIS.

My fingers keep typing 'burncd data foo fixate eject' instead of 'burncd -e
data foo fixate'. Humor them.

MFC after: 4 weeks

Refer to the sysutils/cdrtools port now that the sysutils/mkisofs port
has been merged into the former.

PR: docs/69087
Submitted by: Janos Mohacsi <janos.mohacsi@bsd.hu>
MFC after: 3 days

Catch up with the latest in device naming.

Assorted mdoc(7) fixes.

Approved by: re (blanket)

Fixed troff(1) and mdoc(7) warnings.

Approved by: re (blanket)

Add support for using the CDROM env var for device to use;

PR: 38178

Default speed is 4 not 1.
PR: 50474

mdoc(7) police: Scheduled sweep.

burncd format accepts either 'dvd+rw' or 'dvd-rw' not 'dwd+rw'.

Approved by: sos

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

Approved by: re

mdoc(7) police: markup fixes.

Approved by: re

* Add CDRIOC{READ,WRITE}SPEED ioctls to cd(4). Units are in KB/sec.
* Change atapi-cd ioctls to use the same units.
* Change burncd, cdcontrol to convert CDROM speed to KB/sec before
calling the ioctl. Add a "max" speed option for their command lines.

This change does not break ABI but does change the units passed through
the ioctl so 3rd party software that uses cdrio.h will have to convert
(most likely by multiplying CDROM speed by 177 to get KB/s).

PR: kern/36845
Submitted by: Philipp Mergenthaler <p@i609a.hadiko.de> (CAM ioctls)
Reviewed by: sos, ken
MFC after: 1 month

Add DVD+RW support to the ATA driver and burncd. This also closes
PR40430 by "Peter Haight <peterh@sapros.com>" that has semilar patches
included and which I merged with my own work.

HW sponsored by: FreeBSD Foundation & FreeBSD Mall Inc

Enjoy!

The .Nm utility

Mention the fact that you must burn an ISO image to your CDR (created
by mkisofs(8) or similar), if you actually intend to mount the data CD
created by burncd.

PR: bin/35524
Approved by: sos
MFC after: 3 days

Update headers

mdoc(7) police:

- bump document date
- add -n to SYNOPSIS
- remove whitespace at EOL
- remove hard sentence break
- be a bit verbose about "vcd" operation

Add the ability to write VCD/SVCD disc's.
It is still nessesary to supply the tracks as individual files, burncd
can't read .cue files yet, but now the infrastructure to do it is
present we just need a .cue file parser (hint hint)...

Fixes from Ruslan Ermilov:

1. FreeBSD should be spelled with "F" and "BSD" in capitals,
even in comments.

2. Please don't use hard sentence breaks. Always start a
new sentence from the new line.

3. Don't use `#' or `$' in EXAMPLES; this has been fixed
recently in share/examples/mdoc/ templates.

4. Nuke the prog_name variable burncd.c, use getprogname(3).

Add DAO mode (Disk At Once).
See burncd.8 for how to use it.

mdoc(7) police:

Avoid using parenthesis enclosure macros (.Pq and .Po/.Pc) with plain text.
Not only this slows down the mdoc(7) processing significantly, but it also
has an undesired (in this case) effect of disabling hyphenation within the
entire enclosed block.

mkisofs is in section 8, not section 1.

mdoc(7) police: formatting fixes.

New option -m to select multisession mode.
WARNING: until now all disks was closed as multisession disks, this is
no longer the case, if the -m option isn't used disks are closed as
singlesession. The reason is that some drives wont close a disk
with one large image on in multisession mode, probably because it
"knows" that a new session wont fit on the media resonably.

Also update burncd with new stuff from various places that I've collected
and modified to my taste, its actually amasing how many thinks up the
same enhancements (none mentioned none forgotten):

Allow '-' to be used as filename for using stdin.

Add 'l' option to take a list of image files from 'filename'

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

Avoid use of direct troff requests in mdoc(7) manual pages.

Fix some spelling errors.

mkisofs has the -C option for this, doh.

Add msinfo command, used for multisession CD generation with
mkisofs. Gives the last track start LBA, and the next writable LBA.

Inspired by: peter

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.

Add mode2 and XAmode1 type CD tracks.

Enable the 't' option, and document it in the manpage.

Submitted by: green@freebsd.org <Brian Fundakowski Feldman>

New ATAPI burner utility. Replaces wormcontrol.