CVS log for src/sbin/dump/dump.8

Up to [cvs.NetBSD.org] / src / sbin / dump

Request diff between arbitrary revisions

Keyword substitution: kv
Default branch: MAIN

Mostly merge changes from HEAD upto 20200411

Add -D flag to allow the user to specify an alternate dumpdates file.
Closes PR #54469.

Sync with HEAD

Pull up following revision(s) (requested by manu in ticket #1221):

	sbin/dump/tape.c: revision 1.55
	sbin/dump_lfs/dump_lfs.8: revision 1.18
	sbin/dump/dump.h: revision 1.56
	sbin/dump/dump.8: revision 1.69
	sbin/dump/dump.h: revision 1.57
	sbin/dump/ffs_inode.c: revision 1.23
	sbin/dump/optr.c: revision 1.43
	sbin/dump/itime.c: revision 1.21
	sbin/dump/main.c: revision 1.74
	sbin/dump/itime.c: revision 1.22
	sbin/dump/main.c: revision 1.75
	sbin/dump/dump.8: revision 1.70
	sbin/dump/traverse.c: revision 1.52
	sbin/dump/dump.8: revision 1.71

Document what rdump is (was once) for. PR 53442.

Use getfsspecname() to fill the filesystem argument in dumpdates.
While here, make sure that the error strings terminate with newline
consistently, and add a function that adds the system error string.

Add -U flag to dump(8) and dump_lfs(8) to specify dumpdates entry
This address situations where dump(8) cannot figure out the device being
dumped. It also allows tracking of subvolume dumps by using virtual
device as dumpdates entry.

Bump date for previous.

Bump date for previous.

Add -U flag to dump(8) and dump_lfs(8) to specify dumpdates entry

This address situations where dump(8) cannot figure out the device being
dumped. It also allows tracking of subvolume dumps by using virtual
device as dumpdates entry.

Sync with HEAD

Document what rdump is (was once) for. PR 53442.

dump was there from v4.
Confirmed from the TUHS hosted copies of man pages.
Bump date.

Pull up following revision(s) (requested by bouyer in ticket #1331):
	sbin/dump/dump.8: revision 1.67 via patch
	sbin/dump/main.c: revision 1.72
	sbin/dump/rcache.c: revision 1.25
Default the read block size (-k default value) to kern.maxphys (usually
64k these days). This gives a noticable performance boost on large filesystems.

Pull up following revision(s) (requested by bouyer in ticket #990):
	sbin/dump/rcache.c: revision 1.25
	sbin/dump/dump.8: revision 1.67
	sbin/dump/main.c: revision 1.72
Default the read block size (-k default value) to kern.maxphys (usually
64k these days). This gives a noticable performance boost on large filesystems.

Default the read block size (-k default value) to kern.maxphys (usually
64k these days). This gives a noticable performance boost on large filesystems.

Fix typos

sync with head

Use more markup, fix English usage.

sync with head

Sort option descriptions a bit more.

PR/45735: Bug Hunting: The dump(8) manpage, as well as the program's `usage'-line,
needs improvement

File system snapshots are no longer experimental.

Use a list for the list of bugs.

-i does not take an argument. Remove unnecessary Bk/Ek. New sentence, new line.

PR/42883: Greywolf: Add -i flag which brings "true incremental" capability.

Use indent-synopsis instead of iS register.  The latter is a register
used in BSD derived .Nm implementation.

Sync with HEAD.

Sync with wrstuden-revivesa-base-2.

We don't need to dump WAPBL log files - don't dump files with SF_LOG
flag set, and document this.

Argument is read-blocksize, not "read blocksize". From YOMURA Masanori in private mail.

Pull up revision 1.55 (requested by hannken in ticket #184):
Sort SEE ALSO.

Pull up revision 1.54 (requested by hannken in ticket #184):
Snapshot support for dump(8):
- New option `-x backup' takes the dump from a snapshot backed up by `backup'.
  The snapshot will be deleted on exit.
- New option `-X' as a synonym for `-x mountpoint' where `mountpoint' is the
  file system to be dumped.
Reviewed and Approved by: Manuel Bouyer <bouyer@netbsd.org>

Sort SEE ALSO.

Snapshot support for dump(8):

- New option `-x backup' takes the dump from a snapshot backed up by `backup'.
  The snapshot will be deleted on exit.

- New option `-X' as a synonym for `-x mountpoint' where `mountpoint' is the
  file system to be dumped.

Reviewed and Approved by: Manuel Bouyer <bouyer@netbsd.org>

Move UCB-licensed code from 4-clause to 3-clause licence.

Patches provided by Joel Baker in PR 22308, verified by myself.

* Document $RCMD_CMD in environ(7).
* Cross-reference rcmd(1), rcmd(3), and environ(7) as appropriate.

Should fix [bin/21670] from Geoff Wing.

Use "wall -g operator" (instead of private code) to broadcast() messages to
members of the operator group.
Don't install "setgid tty", and remove now unnecessary gid/egid swapping.
Remove utmp trawling code pulled in from usr.bin/who.
The Code is now simpler, and more portable (without the utmp cruft) too.

This is derived from similar work in OpenBSD.

.Nm does not need a dummy argument ("") before punctuation or
for correct formatting of the SYNOPSIS any longer.

"Utilize" has exactly the same meaning as "use," but it is more
difficult to read and understand. Most manuals of English style
therefore say that you should use "use".

New sentence, new line. By Robert Elz with minimal fixes.

Typo fix, from jslag@prop.walkerart.org via OpenBSD.

Fix typo in macro.

Pull up revision 1.44 (via patch, requested by bouyer):
  Add an ``-a'' option to ``auto-size'' the tape, rather than
  relying upon other options to define the tape size.

Pull up revisions 1.43,1.45 (via patch, requested by bouyer):
  Implement ``-l <timeout>'' option for use with e.g. autochangers.

For -l: specify the timeout on the command line (in seconds) instead of
hardwiring it to 2s, as suggested on tech-userlevel.

Add -a to "auto-size" the tape, rather than relying upon other options
to define the tape size.  Requires the tape driver to either return ENOSPC
at end of media, or 0 when a write is attempted (such as the "early warning"
support in st(4) enabled with "mt eew 1").   From FreeBSD.

Add a -l (autoload) flag. For multivolume dumps, this makes dump eject the
tape when a volume is full, and try to reopen the tape drive for 2 mn.
To be used with tape changers which load the next tape when the current one is
ejected.
While I'm there fix eject handling for remote tape.

One '\' too many.

relax the restriction on -F that the file system image argument must be a
regular file

Whitespace fixes, sort SEE ALSO, sort sections.

Add the capability for dump to print timestamps on all informational
messages.

- implement -F, which indicates that files-to-dump is a regular file
  containing a file system image (instead of being a single file as
  part of a subtree dump)
- use "file system" instead of "filesystem" or "file-system"

Drop arguments of .Os.

* improve parsing of file-systems-to-dump when a path is given:
      - if it's a path to an unmounted file-system listed in /etc/fstab, use
	that instead of assuming the user wanted a subtree dump of the parent
	directory. this restores the behaviour of dump before the subtree
	dumping code went in.
      - if it's a path to a mounted file-system which is not in /etc/fstab,
	use the info from getmntinfo(3). previously, dump would choke.
* implement error checked malloc(), calloc(), strdup(), and use
  appropriately (some of the calloc()s weren't being checked)
* use 'file-system' instead of 'filesystem' in the man page

Pull up revision 1.35 (requested by tron):
  Add a new option ``e'' to dump which directs it to eject tapes
  automatically if a tape change is required.

Add a new option "e" to "dump" which allows to eject tapes automatically
if a tape change is required.

pullup 1.32->1.33 (abs): Correct default device from /dev/rst0 to /dev/nrst0

Note the default tape device is taken from _PATH_DEFTAPE in /usr/include/paths.h

Default device is nrst0 not rst0

Implement a read cache, as announced on tech-userlevel. Default is 32k
read buffer size, 512 buffer or 15% of the user memory. Can be changed
with the -k and -s options.

Handle "nodump" flag on directories, by not dumping any files or directories
under it. Based on some parts of PR 6705 by Brian Grayson.
In the Makefile, add (commented out) debug options that can be turned on.

Clean up SYNOPSIS formatting.

s/1998/1999/

add support for '-L label', which file(1) and restore(1) can extract
from the header.
mostly based on [bin/6715] from Brian Grayson <bgrayson@ece.utexas.edu>

Add reference to "st(4)" as suggested by Brian Grayson in PR bin/6713.

A dump level above 0 saves new or modified files since the last dump of
a lower level, not the same level. Fixes pr 5402 by Kevin Sullivan.

PR#5697 + nroff cleanup

fix bad .Xr references

Change occurrences of "UNIX" to .Ux or .At as appropriate.

pull up from trunk:  add missing .Nm sections.

add missing .Nm sections.

Fix .Nm usage.

Various changes from Brian Grayson <bgrayson@ece.utexas.edu> in [bin/4103]
* exit after providing an estimate if -S was given. the PR used -e,
  but checking around indicated prior art in Solaris usin -S.
* remove superfluous 'DUMP:' prefix in two messages
* initialise blocksperfile explicitly (not necessary, but everything
  else in that section gets initialised, so be consistant :)
* display the ``pretty'' name of the dumped directory, so the user
  knows if it's a subset or not

resolve conflicts from lite-2 import

imported from lite-2

* cleanup for WARNS=1
* fix use of .Nm
* comment out some unused(?) functions

cleanup xrefs

* 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.

use _PATH_DEFTAPE from <paths.h>
change doco references/examples from /dev/rmt* to /dev/rst*

support $TAPE.  update manual to reflect reality (#1937).

Add /dev/rst* to FILES section. (pr 601)  (Matches mt man page.)

convert to new RCS Id conventions; reduce my headache

Fix an old formatting glitch.

Use getopt(3), with obsolete() from restore(8) for backward compatibility.

Import 4.4-Lite version.

Update from 4.4-Lite, with local changes.

More spelling errors.

new version from CSRG, via BSDI, with fixes

Use ".At v6" macro instead of spelling out "Version 6 AT&T UNIX".

Dump is now in /sbin.

Add RCS indentifiers.

changed "Id" to "Header" for rcsids

added rcs ids to all files

initial import of 386bsd-0.1 sources

Initial revision