[src/netbsd-3]: src/sbin/dump Pull up revision 1.54 (requested by hannken in ...

[tron <tron%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/2cb3576a7a2b
branches:  netbsd-3
changeset: 575526:2cb3576a7a2b
user:      tron <tron%NetBSD.org@localhost>
date:      Thu Apr 21 19:04:27 2005 +0000

description:
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@localhost>

diffstat:

 sbin/dump/dump.8 |  28 +++++++++++++++++++++++++---
 1 files changed, 25 insertions(+), 3 deletions(-)

diffs (74 lines):

diff -r 68d4d60d53ef -r 2cb3576a7a2b sbin/dump/dump.8
--- a/sbin/dump/dump.8  Thu Apr 21 19:04:20 2005 +0000
+++ b/sbin/dump/dump.8  Thu Apr 21 19:04:27 2005 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: dump.8,v 1.53 2003/08/07 10:04:13 agc Exp $
+.\"    $NetBSD: dump.8,v 1.53.6.1 2005/04/21 19:04:27 tron Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"     Regents of the University of California.
@@ -30,7 +30,7 @@
 .\"
 .\"     @(#)dump.8     8.3 (Berkeley) 5/1/95
 .\"
-.Dd May 26, 2003
+.Dd April 19, 2005
 .Dt DUMP 8
 .Os
 .Sh NAME
@@ -39,7 +39,7 @@
 .Nd file system backup
 .Sh SYNOPSIS
 .Nm
-.Op Fl 0123456789aceFnStu
+.Op Fl 0123456789aceFnStuX
 .Bk -words
 .Op Fl B Ar records
 .Ek
@@ -73,6 +73,9 @@
 .Bk -words
 .Op Fl T Ar date
 .Ek
+.Bk -words
+.Op Fl x Ar snap-backup
+.Ek
 .Ar files-to-dump
 .Nm
 .Op Fl W Li \&| Fl w
@@ -304,6 +307,20 @@
 (as opposed to an entire file system), then
 .Fl u
 is ignored.
+.It Fl x Ar snap-backup
+Use a snapshot with
+.Ar snap-backup
+as backup for this dump.
+See
+.Xr fss 4
+for more details.
+Snapshot support is
+.Em experimental .
+Be sure you have a backup before you use it.
+.It Fl X
+Similar to
+.Fl x
+but uses a file system internal snapshot on the file system to be dumped.
 .It Fl W
 .Nm
 tells the operator what file systems need to be dumped.
@@ -513,6 +530,7 @@
 .Xr stty 1 ,
 .Xr wall 1 ,
 .Xr fts 3 ,
+.Xr fss 4 ,
 .Xr rcmd 3 ,
 .Xr st 4 ,
 .Xr fstab 5 ,
@@ -555,3 +573,7 @@
 and provided more assistance
 for the operator running
 .Xr restore 8 .
+.Pp
+Snapshot support is
+.Em experimental .
+Be sure you have a backup before you use it.