Copy stable/10@r272459 to releng/10.1 as part of
the 10.1-RELEASE process.

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

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.

When using dump to generate level 0 dumps which are then rsync'ed
to a remote machine, the fact that the dump date is stored with
each header (inode) record makes rsync significantly less efficient
than necessary. This also applies to inode access times when they
are not important data to retain. When implementing an offsite
backup solution of this type, these dates in particular are not
important, especially if it prevents effective offsite backups.

PR: bin/91049
Submitted by: Forrest W Christian <fwc@mt.net>

Markup fixes.

Clarify documentation of '-L' command line switch: the snapshot is
unlinked as soon as the dump starts (and removed when the dump is
completed, and the dump process exits). Previous wording was confusing
because users might expect the snapshot to be visible in the .snap
subdirectory while dump is running.

MFC after: 1 week

Revert a minor glitch of revision 1.69

Submitted by: Andriy Tkachuk <andrit@ukr.net>
X-MFC after: RE approval

Add the example that green@ used in his commit log for the dump to a
pipe functionality. I've done a cvs log main.c about a dozen times
now. Maybe others will find this useful.

Correct the description of the TAPE environment variable.
Based on:

PR: docs/84200
Submitted by: Gary W. Swearingen <garys at opusnet dot com>
MFC after: 1 week

Forced commit to note:

MFC after: 2 weeks

Improved error checking for existence of a .snap directory to
generate snapshots in when -L is requested. If the .snap directory
does not exist, or is not a directory, issue a warning and revert
to the non- live behavior.

Obtained from: St. Bernard Software RAPID

Sort sections.

Added the EXIT STATUS section where appropriate.

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

Improve the warnings for dump -L and do not bother doing the snapshot if
it is specified for read-only filesystems.

Submitted by: Jason Young <jyoung8607@hotmail.com>
PR: 46672

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

Approved by: core, imp

Add RSH to the list of enviroment variables.

Document that the live dump command (`dump -L') creates its snapshot
in the .snap directory in the root of the filesystem being dumped.
Document that if the .snap directory is missing that it must be
created manually and that it should be owned by user root and
group operator and set to mode 770 before a live dump can be run.

- add explanation of what an active file system is
- explain the reason for permitting 32 read errors for a dump

PR: docs/35602 and docs/35607
Reviewed by: jhb
Approved by: blackend (mentor)

Remove reference to max block size. dump no longer limits the block size.

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.

Sort options.

Add a caching option to dump. Use -C. Note that NetBSD has a caching option
called -r but it takes 512 byte blocks instead of megabytes, and I felt a
megabytes specification would be far more useful so I did not use the same
option character.

This will *greatly* improve dump performance at the cost of possibly
missing filesystem changes that occur between passes, and does a fairly
good job making up for the loss of buffered block devices. Caching is disabled
by default to retain historical behavior.

In tests, dump performance improved by about 40% when dumping / or /usr.

Beware that dump forks and the cache may wind up being larger then you
specify, but a more complex shared memory implementation would not produce
results that are all that much better so I kept it simple for now.

MFC after: 3 days

Add TAPE to the ENVIRONMENT section and standardize the section, using a
list instead of prose.

MFC after: 1 month

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

PR: docs/37176

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

Approved by: re

Add the `L' option to dump to notify it that it is dumping a
live filesystem. To obtain a consistent dump image, dump takes
a snapshot of the filesystem and then does a dump of the snapshot.
The snapshot is removed when the dump is complete.

Also add an operator warning that the `L' option should be used
if dump is run on a live filesystem without the `L' option being
specified. The alternative would be to silently use a snapshot
any time that a live filesystem is dumped, but this change in
dump semantics seemed too drastic at this time.

Sponsored by: DARPA & NAI Labs.
Approved by: re

Fix some 'SYNOPSIS' and 'usage' messages.

Fix Synopsis

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

The .Nm utility

mdoc(7) police: nits.

dump(8)'s manual page is confusing in its use of records, blocks,
blocksizes, etc
does not give the default of -b
only mentiones rdump in the NAME section
uses both filesystem and file system in similar contexts

PR: 34248
Submitted by: Gary W. Swearingen <swear@blarg.net>
MFC after: 3 days

mdoc(7) police: tiny fixes.

Add a new "-S" flag to dump to allow it just print out dump estimate
size and then exit.

PR: bin/35450
Submitted by: Mark Hannon <markhannon@optushome.com.au>
Obtained from: NetBSD
MFC after: 1 week

On receipt of a SIGINFO, schedule an immediate printout of the
percentage complete and remaining time estimate.

PR: bin/32138
Submitted by: mi

Make it clear that dump(8)'s honoring of the UF_NODUMP flag is subject
to the -h option. While here, xref chflags(1).

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

Sort options in DESCRIPTION.

Bump date for addition of -D.

Remove whitespace at EOL.

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

mdoc(7) police:
Restored .Pa for ``dumpdates'' (it's still a file).
Also, removed duplicate ``file'' words.

Add manual page and usage for dump -D (supplied by Dima Dorfman) (will also
be MFC'd)

Submitted by: Dima Dorfman <dima@unixfreak.org>

bye-bye documented raw devices

Support inheritance of the "nodump" flag down a hierarchy.

Submitted by: Dima Dorfman <dima@unixfreak.org>
Obtained from: NetBSD

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.

Update device name.

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>

Fix various man pages to stop abusing the .Bx macro to generate
the strings "FreeBSD" and "NetBSD". Use the .Fx or .Nx macro
instead.

Add `.Nm rdump' to NAME section.

$Id$ -> $FreeBSD$

Change rst0 into rsa0.

Correct use of .Nm. Add rcsid. Remove unused #includes.

Fix minor typo.

PR: 6571
Submitted by: Stephen J. Roznowski <sjr@home.net>

The default dumplevel is 0.

PR: 5413
Submitted by: NOKUBI Hirotaka <hnokubi@yyy.or.jp>

Fix the man page description about what will go into an incremental
backup.

PR: docs/4785
Submitted by: Matthew Dillon

The unit for the B option is 1 KB, not `dump records'.

PR: docs/4223

Remove the reference to the nonexistant dump(5) manpage.

PR: docs/3704

Implement Kerberized rcmd for rdump/rrestore. This is lacking the
options one would normally expect to set the realm, enable encryption,
and whatnot, but this actually is able to contact the remote server,
so at least it's a start. (As a bonus, the stripped static binary is
unquestionably exportable.)

Document the -a option in .Fl form instead of .Cm form to be consistant
with the rest of the manpage. (Lite2 documents it in getopt form, Lite1
did it in old-style arg format)

Merge Lite2 changes (rather bigish, the dump/restore folks should check)

Revert $FreeBSD$ to $Id$

Removed default setuid and added a comment to the manpage explaining this.

Add the `a' option (``auto-size'') to bypass all tape length
considerations, and dump right to the end of medium.

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.

Backing out my change of /etc/rmt -> /usr/sbin/rmt.
Added comments in both files stateing why /etc/rmt is correct so someone
else wont do the same thing again.

Suggested by: Warner Losh & Ollivier

rmt is /usr/sbin/rmt, not /etc/rmt which is a link to /usr/sbin/rmt

Use the .At macro where appropriate.

Andreas Klemm's patch set for dump(8), with some minor (cosmetic)
changes and one addition by me.

. Use reasonable defaults for the tape drive (/dev/rst0) instead of
something we actually don't have.

. Add a summary line displaying the alapsed time and the total throughput.

. Replace "rmt" for the remote location of rmt(8) by "/etc/rmt", since this
is the historical protocol, and relying on the $PATH causes a big pain.
Make it adjustable via an environmental variable though.

Reviewed by: joerg (for Andreas' part)
Submitted by: andreas@knobel.gun.de (Andreas Klemm)

Man page was incorrectly pointing to /etc/dump, it should be /sbin/dump.

Submitted by: faried nawaz <fn@big-brother.csrv.uidaho.edu>

Add pointer to the `ft' command.

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.