'S' size estimation option to dump.

[dump.git] / dump / dump.8.in

diff --git a/dump/dump.8.in b/dump/dump.8.in
index 262685868d0891e2808cdd0a89c350cf81bb5e76..bb7503331c73581deeb636401223ed23c1352321 100644 (file)
--- a/dump/dump.8.in
+++ b/dump/dump.8.in
@@ -30,17 +30,17 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"

-.\"    $Id: dump.8.in,v 1.2 1999/10/11 13:31:10 stelian Exp $
+.\"    $Id: dump.8.in,v 1.5 1999/11/22 19:08:50 tiniou Exp $

 .\"
 .Dd __DATE__
 .Dt DUMP 8
 .\"
 .Dd __DATE__
 .Dt DUMP 8

-.Os "__VERSION__"
+.Os "dump __VERSION__"

 .Sh NAME
 .Nm dump
 .Nd ext2 filesystem backup
 .Sh SYNOPSIS
 .Nm dump
 .Sh NAME
 .Nm dump
 .Nd ext2 filesystem backup
 .Sh SYNOPSIS
 .Nm dump

-.Op Fl 0123456789acknu
+.Op Fl 0123456789acknSu

 .Op Fl B Ar records
 .Op Fl b Ar blocksize
 .Op Fl d Ar density
 .Op Fl B Ar records
 .Op Fl b Ar blocksize
 .Op Fl d Ar density


@@ -51,7 +51,7 @@
 .Op Fl T Ar date
 .Ar filesystem
 .Nm dump
 .Op Fl T Ar date
 .Ar filesystem
 .Nm dump

-.Op Fl 0123456789acknu
+.Op Fl 0123456789acknSu

 .Op Fl B Ar records
 .Op Fl b Ar blocksize
 .Op Fl d Ar density
 .Op Fl B Ar records
 .Op Fl b Ar blocksize
 .Op Fl d Ar density


@@ -218,6 +218,13 @@ prompts for a new tape.
 It is recommended to be a bit conservative on this option.
 The default tape length is 2300 feet.
 .ne 1i
 It is recommended to be a bit conservative on this option.
 The default tape length is 2300 feet.
 .ne 1i

+.It Fl S
+Size estimate. Determine the amount of space
+that is needed to perform the dump without
+actually doing it, and display the estimated
+number of blocks it will take. This is useful
+with incremental dumps to determine how many
+volumes of media will be needed.

 .It Fl T Ar date
 Use the specified date as the starting time for the dump
 instead of the time determined from looking in
 .It Fl T Ar date
 Use the specified date as the starting time for the dump
 instead of the time determined from looking in


@@ -380,6 +387,13 @@ The environment variable
 will be used to determine the pathname of the remote
 .Xr rmt 8
 program.
 will be used to determine the pathname of the remote
 .Xr rmt 8
 program.

+.It Ev RSH
+.Nm Dump
+uses the contents of this variable to determine the name of the
+remote shell command to use when doing remote backups (rsh, ssh etc.). 
+If this variable is not set, 
+.Xr rcmd 3
+will be used, but only root will be able to do remote backups.

 .Sh FILES
 .Bl -tag -width __DUMPDATES__ -compact
 .It Pa /dev/st0
 .Sh FILES
 .Bl -tag -width __DUMPDATES__ -compact
 .It Pa /dev/st0


@@ -437,10 +451,10 @@ for the operator running
 .Pp
 .Nm Dump
 cannot do remote backups without being run as root, due to its
 .Pp
 .Nm Dump
 cannot do remote backups without being run as root, due to its

-security history.  This will be fixed in a later version of
-.Bx Free .
+security history.

 Presently, it works if you set it setuid (like it used to be), but this
 Presently, it works if you set it setuid (like it used to be), but this

-might constitute a security risk.
+might constitute a security risk. Note that you can set RSH to use
+a remote shell program instead.

 .Sh AUTHOR
 The 
 .Nm dump/restore
 .Sh AUTHOR
 The 
 .Nm dump/restore