History log of /openbsd-current/sbin/dump/dump.8
Revision (<<< Hide revision tags) (Show revision tags >>>) Date Author Comments
# 1.56 13-Oct-2022 jmc

controm terminql -> controlling terminal;


Revision tags: OPENBSD_7_2_BASE
# 1.55 02-Jun-2022 millert

Don't treat the first arg as a 4.3BSD option string if it contains a '/'.
Also document that files-to-dump could be interpreted as a 4.3BSD option
if it doesn't contain a slash. OK deraadt@


Revision tags: OPENBSD_6_7_BASE OPENBSD_6_8_BASE OPENBSD_6_9_BASE OPENBSD_7_0_BASE OPENBSD_7_1_BASE
# 1.54 19-Dec-2019 bentley

Spell "mount point" as other man pages do, with a space.

ok jmc@


Revision tags: OPENBSD_6_6_BASE
# 1.53 02-Sep-2019 deraadt

More correction of section 3 layout. directory->opendir, fts->fts_open,
getcap->cgetent. pwcache->user_from_uid. And then repair references.
ok jmc


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.52 07-Jun-2018 jmc

add some EXIT STATUS sections; from matthew martin


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.55 02-Jun-2022 millert

Don't treat the first arg as a 4.3BSD option string if it contains a '/'.
Also document that files-to-dump could be interpreted as a 4.3BSD option
if it doesn't contain a slash. OK deraadt@


Revision tags: OPENBSD_6_7_BASE OPENBSD_6_8_BASE OPENBSD_6_9_BASE OPENBSD_7_0_BASE OPENBSD_7_1_BASE
# 1.54 19-Dec-2019 bentley

Spell "mount point" as other man pages do, with a space.

ok jmc@


Revision tags: OPENBSD_6_6_BASE
# 1.53 02-Sep-2019 deraadt

More correction of section 3 layout. directory->opendir, fts->fts_open,
getcap->cgetent. pwcache->user_from_uid. And then repair references.
ok jmc


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.52 07-Jun-2018 jmc

add some EXIT STATUS sections; from matthew martin


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.54 19-Dec-2019 bentley

Spell "mount point" as other man pages do, with a space.

ok jmc@


Revision tags: OPENBSD_6_6_BASE
# 1.53 02-Sep-2019 deraadt

More correction of section 3 layout. directory->opendir, fts->fts_open,
getcap->cgetent. pwcache->user_from_uid. And then repair references.
ok jmc


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.52 07-Jun-2018 jmc

add some EXIT STATUS sections; from matthew martin


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.53 02-Sep-2019 deraadt

More correction of section 3 layout. directory->opendir, fts->fts_open,
getcap->cgetent. pwcache->user_from_uid. And then repair references.
ok jmc


Revision tags: OPENBSD_6_4_BASE OPENBSD_6_5_BASE
# 1.52 07-Jun-2018 jmc

add some EXIT STATUS sections; from matthew martin


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


# 1.52 07-Jun-2018 jmc

add some EXIT STATUS sections; from matthew martin


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE OPENBSD_6_3_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision


Revision tags: OPENBSD_6_1_BASE OPENBSD_6_2_BASE
# 1.51 06-Oct-2016 schwarze

fix HISTORY;
patches from Sevan Janiyan <venture37 at geeklan dot co dot uk>;
verified using minnie.tuhs.org/cgi-bin/utree.pl


Revision tags: OPENBSD_5_9_BASE OPENBSD_6_0_BASE
# 1.50 21-Nov-2015 jmc

add missing NAME entries; ok schwarze


Revision tags: OPENBSD_5_8_BASE
# 1.49 03-May-2015 guenther

Eliminate the -U flag and make usage of DUID in /etc/dumpdates the default.
Correct old style entries so nothing has to be done for the admin.

diff from Manuel Giraud (manuel (at) ledu-giraud.fr) Thanks!


Revision tags: OPENBSD_5_6_BASE OPENBSD_5_7_BASE
# 1.48 17-Jul-2014 jmc

files-to-dump can be a duid;
From: Maximilian Fillinger


# 1.47 11-Jul-2014 halex

make dump support DUIDs for command line arguments and /etc/dumpdates (using
the new shiny -U switch)

dumpdates part originating from, and discussed with, Maximilian Fillinger

seems reasonable to krw@, "get it in" deraadt@


# 1.46 30-May-2014 stephan

Add option -S to have dump(8) only estimate backup size and number of tapes
required (from NetBSD).

ok beck@, krw@ and sthen@


Revision tags: OPENBSD_5_4_BASE OPENBSD_5_5_BASE
# 1.45 04-Apr-2013 zhuk

Make our dump(8) honour the "nodump" flag for directories, effectively
disabling dumping their contents.

input and ok otto@ millert@
man page bits input and ok jmc@


Revision tags: OPENBSD_4_3_BASE OPENBSD_4_4_BASE OPENBSD_4_5_BASE OPENBSD_4_6_BASE OPENBSD_4_7_BASE OPENBSD_4_8_BASE OPENBSD_4_9_BASE OPENBSD_5_0_BASE OPENBSD_5_1_BASE OPENBSD_5_2_BASE OPENBSD_5_3_BASE
# 1.44 26-Jan-2008 jmc

the kids want I/O;


# 1.43 19-Nov-2007 jmc

put the SIGINFO blurb in a saner place;


# 1.42 18-Nov-2007 otto

do not confuse the reader telling he should use a towers of hanoi
based scheme when it makes no sense: a weekly schedule does not
benefit from it. ok mbalmer@ jmc@ ray@


Revision tags: OPENBSD_4_2_BASE
# 1.41 31-May-2007 jmc

convert to new .Dd format;


Revision tags: OPENBSD_4_1_BASE
# 1.40 25-Feb-2007 jmc

shuffle the text slightly into a more logical order;


# 1.39 25-Feb-2007 jmc

the -W and -w flags do not need a separate synopsis;


# 1.38 25-Feb-2007 jmc

move the text describing 4.3 syntax compatibility to HISTORY, rather
than slap bang in SYNOPSIS;


# 1.37 25-Feb-2007 jmc

document the "opaque", "arch", and "nodump" flags more fully;
closes documentation/5384 from Andrew Hamilton-Wright

help from henning, otto, and weingart


# 1.36 22-Feb-2007 jmc

igor sobrado spotted that although we have mlinks for rdump and
rrestore, the pages they point to don;t actually mention them.
so make it clear that their functionality is now integral in dump and
restore, and sync the text a little between the two pages;

help/ok otto


Revision tags: OPENBSD_3_8_BASE OPENBSD_3_9_BASE OPENBSD_4_0_BASE
# 1.35 02-Aug-2005 jmc

$TAPE Ev may refer to a number of things, not just a physical tape device:
- for -f description, point people to TAPE
- for TAPE description, point people to -f
- use `file' to describe these differing forms, as that is consistent with
the rest of the page

this is based on -r1.71 from freebsd, from ceri davies,
which was in turn based on pr #84200 from gary w. swearingen;

ok otto@


Revision tags: OPENBSD_3_4_BASE OPENBSD_3_5_BASE OPENBSD_3_6_BASE OPENBSD_3_7_BASE
# 1.34 15-Jul-2003 jmc

.Ql Fl -> .Sq Fl where literal makes no sense;


# 1.33 04-Jun-2003 deraadt

fix some more UCB term 3


# 1.32 03-Jun-2003 jmc

- section reorder
- some mdoc fixes


# 1.31 09-Apr-2003 jmc

document that rewind/eject features of tape devices depend on name of
tape device; reference st(4) for an explanation.

diff from Olivier Cherrier;
ok millert@


# 1.30 08-Apr-2003 jmc

missing .Fl macro for -a option;


Revision tags: OPENBSD_3_3_BASE
# 1.29 01-Feb-2003 jmc

typos;
chat(8): removed reference to uucico(8)

ok deraadt@


Revision tags: OPENBSD_3_1_BASE OPENBSD_3_2_BASE
# 1.28 22-Feb-2002 deraadt

typo; jslag@prop.walkerart.org


# 1.27 11-Feb-2002 mpech

Initial patch.
When you give command examples in a manual page prefix them with
$ command
or
# command

deraadt@ ok


# 1.26 13-Dec-2001 mpech

o) start new sentence on a new line;
o) wrap long lines;
o) fix bogus .Xr usage;
o) we don't like blank lines;
o) always close .Bl tags;
o) OpenBSD -> .Ox;
o) don't like .Pp before .Ss;

millert@ ok;


Revision tags: OPENBSD_3_0_BASE
# 1.25 04-Oct-2001 ho

Mention that dump uses the TAPE variable.


Revision tags: OPENBSD_2_7_BASE OPENBSD_2_8_BASE OPENBSD_2_9_BASE
# 1.24 24-Mar-2000 aaron

Correct the HISTORY section to note that this command appeared in Version 5
of AT&T UNIX, not Version 6. Verified by strings(1)'ing a .dsk file (PDP-11
executable) containing the v5 sources, obtainable at gatekeeper.dec.com in the
directory /pub/DEC/sim/software. Idea from NetBSD PR/4790.


# 1.23 18-Mar-2000 aaron

Remove hard sentence breaks, and some other cleanup along the way.


# 1.22 05-Mar-2000 aaron

Finish standardizing options list introduction.


Revision tags: OPENBSD_2_6_BASE
# 1.21 17-Oct-1999 aaron

Use the AT&T UNIX macros.


# 1.20 04-Jul-1999 aaron

trash some old leftover macros and replace them with -mdoc macros


# 1.19 04-Jun-1999 aaron

start to remove non-escaped trailing whitespace, it can confuse troff; pjanzen@


# 1.18 26-May-1999 aaron

Xr st(4); from NetBSD


# 1.17 23-May-1999 aaron

remove argument from .Os macros so value in /usr/share/tmac/mdoc/doc-common
is used instead; kwesterback@home.com


Revision tags: OPENBSD_2_5_BASE
# 1.16 15-Dec-1998 aaron

always give .Nm macros an argument in SYNOPSIS sections; krw@tcn.net


# 1.15 28-Nov-1998 aaron

kill redundant .Nm macro arguments; other misc fixes


Revision tags: OPENBSD_2_4_BASE
# 1.14 23-Sep-1998 aaron

alphabetize SEE ALSO entries and order them numerically according to section


# 1.13 17-Sep-1998 aaron

sbin/ man page fixes


# 1.12 06-May-1998 deraadt

correct operational description; ksulliva@psc.edu


Revision tags: OPENBSD_2_3_BASE
# 1.11 03-Jan-1998 deraadt

default level is 0, not 9; hnokubi@yyy.or.jp


Revision tags: OPENBSD_2_2_BASE
# 1.10 27-Jul-1997 deraadt

Xr rcmd 3


# 1.9 05-Jul-1997 millert

Fix some incorrect strncpy usage.

From NetBSD (luke@netbsd.org)
* verbosity additions displaying total & per-volume transfer times and rates
* Add the ability to dump specific files & directories of a single
filesystem. This uses fts(3) to access the directory structure (and
not the raw device), so the standard access permissions are adhered
to (unlike dumping an entire filesystem, which just requires read
access to the raw disk device).
* Support SIGINFO status reporting.
* Remove now unused variables that previously stored the (e)uid.
* Be more informative in a couple of error messages.

From NetBSD (mrg)
* fix NetBSD PR#3710, reported by Tatoku Ogaito <tacha@trap.fukui-med.ac.jp>.
don't pass pw->pw_name into functions; make a copy.


# 1.8 02-Jun-1997 deraadt

dump(5) does not exist, markd@Grizzly.COM


Revision tags: OPENBSD_2_1_BASE
# 1.7 27-Apr-1997 downsj

Correct assumed editing mistakes.


# 1.6 16-Apr-1997 millert

_PATH_DEFTAPE is now defined in <paths.h>
Change man page to reflect new default tape drive (/dev/rst0)


# 1.5 10-Feb-1997 millert

Make dump(8) really honor -a. Fix up formatting in man page and remove
duplicate entry.


# 1.4 03-Feb-1997 deraadt

new -a option autosizes, meaning it runs till it hits EOM (no need for
pesky sizing options) -- from FreeBSD.
also make -b option aware of MAXPHYS issues (via a little hack)


Revision tags: OPENBSD_2_0_BASE
# 1.3 23-Jun-1996 deraadt

update rcsid


# 1.2 22-Feb-1996 niklas

From NetBSD:
support $TAPE. update manual to reflect reality (#1937 from Matthew Green).


# 1.1 18-Oct-1995 deraadt

branches: 1.1.1;
Initial revision