PR#5697 + nroff cleanup

sbin/dump/dump.8

@@ -1,4 +1,4 @@
-.\"	$NetBSD: dump.8,v 1.24 1998/04/29 09:49:11 fair Exp $
+.\"	$NetBSD: dump.8,v 1.25 1998/07/03 11:17:46 fair Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	 Regents of the University of California.
@@ -59,7 +59,7 @@
 (The
 .Bx 4.3
 option syntax is implemented for backward compatibility, but
-is not documented here.)
+is not documented here).
 .Sh DESCRIPTION
 .Nm
 examines files on a filesystem and determines which files need to
@@ -142,15 +142,26 @@ if the dump requires more volumes than the number of names given,
 the last file name will used for all remaining volumes after prompting
 for media changes.
 If the name of the file is of the form
-.Dq host:file ,
+.Qq host:file ,
 or
-.Dq user@host:file ,
+.Qq user@host:file ,
 .Nm
 writes to the named file on the remote host using
 .Xr rmt 8 .
+Note that methods more secure than
+.Xr rsh 1
+.Pq such as Xr ssh 1
+can be used to invoke
+.Xr rmt 8
+on the remote host, via the environment variable
+.Ev RCMD_CMD .
+See
+.Xr rcmd 3
+for more details.
+
 .It Fl h Ar level
 Honor the user
-.Dq nodump
+.Qq nodump
 flag
 .Dp Dv UF_NODUMP
 only for dumps at or above the given
@@ -163,7 +174,7 @@ Whenever
 .Nm
 requires operator attention,
 notify all operators in the group
-.Dq operator
+.Qq operator
 by means similar to a
 .Xr wall 1 .
 .It Fl s Ar feet
@@ -258,9 +269,9 @@ All questions
 poses
 .Em must
 be answered by typing
-.Dq yes
+.Qq yes
 or
-.Dq no ,
+.Qq no ,
 appropriately.
 .Pp
 Since making a dump involves a lot of time and effort for full dumps,
@@ -326,12 +337,38 @@ receives a
 .Dv SIGINFO
 signal
 (see the
-.Dq status
+.Qq status
 argument of
 .Xr stty 1 )
 whilst a backup is in progress, statistics on the amount completed,
 current transfer rate, and estimated finished time, will be written
 to the standard error output.
+.Sh ENVIRONMENT
+If the following environment variables exist, they are utilized by
+.Nm "" .
+.Bl -tag -width Fl
+.It Ev TAPE
+If no -f option was specified,
+.Nm
+will use the device specified via
+.Ev TAPE
+as the dump device.
+.Ev TAPE
+may be of the form
+.Qq tapename ,
+.Qq host:tapename ,
+or
+.Qq user@host:tapename .
+.It Ev RCMD_CMD
+.Nm
+will use
+.Ev RCMD_CMD
+rather than
+.Xr rsh 1
+to invoke
+.Xr rmt 8
+on the remote machine.
+.El
 .Sh FILES
 .Bl -tag -width /etc/dumpdates -compact
 .It Pa /dev/rst0