Copy head (r256279) to stable/10 as part of the 10.0-RELEASE cycle.

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

mdoc: move two sentences from synopsis to description (where they really
belong). With this change, mandoc now formats these manpages properly.

mdoc: make pages render with mandoc

It's a bit more pedantic regarding .Bl list elements. This has an added
benefit of unbreaking the ipfw(8) manpage, where groff was silently
skipping one list element.

Add a "-D" flag to restore which puts it into "degraded" mode. This
makes restore less efficient, but it makes a bigger effore to read
corrupted dumps. Specifiacally, when in degreded mode:

1) Restore shifts the input by 1 byte if it sees a problem,
rather than one tape block.
2) It doesn't assume the inodes are stored in ascending order.
3) It turns some panics into warning printfs.

We also verify some fields more carefully than before.

There's probably more a degreded mode could do, but this seems to
help a lot.

Approved by: imp, iedowse, mckusick
MFC after: 3 weeks

Mention the -L option of dump(8) that can neutralize negative
effects of restoring dumps of live file systems.

PR: docs/91297

Remove a diagnostic message that can't occur: we lost the ability to
handle the old filesystem format on 2002/06/21.

Sync usage and man page with reality. There's no '-c' command line
flag today. Maybe we should still retain it, but I'll let others fight
that windmill.

Expand *n't contractions.

Sort sections.

Mechanically kill hard sentence breaks.

Assorted markup, grammar, and spelling fixes.

Add -P arguments for dump(8) and restore(8) which allow the user to
use backup methods other than files and tapes. The -P argument is
a normal sh(1) pipeline with either $DUMP_VOLUME or $RESTORE_VOLUME
defined in the environment, respectively.

For example, I can back up my home to three DVD+R[W]s as so:
Filesystem 1K-blocks Used Avail Capacity Mounted on
/dev/ad0s2e 40028550 10093140 26733126 27% /home
green# dump -0 -L -C16 -B4589840 -P 'growisofs -Z /dev/cd0=/dev/fd/0' /home

Remove advertising clause from University of California Regent's license,
per letter dated July 22, 1999.

Approved by: core, imp

Add section number to .Xr

Removed all vestiges of KerberosIV.

De-Kerberise (KerberosIV). KerberosIV is no longer present, and
remote backups can still be done with Kerberos authentication using
SSH and Kerberos 5.

Add TAPE to the ENVIRONMENT section.

MFC after: 1 month

Add an ENVIRONMENT section so that the reader knows that the TMPDIR envar
is honoured.

Reported by: des
MFC after: 1 month

Fixed the abuses of .Ql visible on stderr in troff mode.

PR: docs/37176

s/filesystem/file system/g as discussed on -developers

The .Nm utility.

more file system > filesystem

restore(8) manual page does not explain rrestore.

PR: 34234
Submitted by: Gary W. Swearingen <swear@blarg.net>

Documentation fixes:

- The '-d' option was not documented on the manpage or in the
usage message.

- The '-N' option was not included in the usage.

Fix grammar.

Remove whitespace at EOL.

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

Document the interactive command `what'.

Reviewed by: ru
MFC after: 2 weeks

bye-bye documented raw device

mdoc(7) police: use the default ``file ...'' feature of the .Ar macro.

Prepare for mdoc(7)NG.

Prepare for mdoc(7)NG.

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

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

Add text from NetBSD's rev 1.12 which should have accompanied
the changes made to our own source on 1997-01-01.

PR: 20445
Submitted by: Jon Masami Kuroda <jkuroda@eecs.berkeley.edu>

Update references to disk and tape devices.

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.

Remove xrefs to obsolete ft driver.

PR: docs/17080
Submitted by: Udo Erdelhoff <ue@nathan.ruhr.de>

Committed changes to restore(8) for previously undocumented -N option.

PR: 15600
Reviewed by: jim

Add `.Nm rrestore' to NAME section.

$Id$ -> $FreeBSD$

Refer to "da" rather than "sd" device.

Change rst0 into rsa0.

Add rcsid. Remove unused #includes. Add missing prototypes and others -Wall
cleanings. Spelling.

Well, nobody objected, so here's my -u (unlink) flag to restore.

Document -k flag here, too.

Merge from Lite2
- cleanups,
- whiteout support
- bug fixes (chflags missing on a few file types etc)
The dump/restore folks would want to have a closer look at this, the
change is pretty big.

Revert $FreeBSD$ to $Id$

Remove suid bit from binary, and update manpage to reflect this.

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.

Correct some man page cross references and some file
locations.

Make the default tape device match dump(8).

Add a reference to ft(8).

Should that last sentence read "...thus a full dump must be done...",
or do I have it all wrong?

Submitted by: "Shawn M. Carey" <smcarey@mailbox.syr.edu>

This commit was generated by cvs2svn to compensate for changes in r1558,
which included commits to RCS files with non-trunk default branches.

BSD 4.4 Lite sbin Sources

Note: XNSrouted and routed NOT imported here, they shall be imported with
usr.sbin.