Subject: bin/5697: dump(8) man page should mention RCMD_CMD and TAPE
To: None <gnats-bugs@gnats.netbsd.org>
From: None <bgrayson@ece.utexas.edu>
List: netbsd-bugs
Date: 07/02/1998 22:35:04
>Number: 5697
>Category: bin
>Synopsis: dump(8) man page should mention RCMD_CMD and TAPE
>Confidential: no
>Severity: non-critical
>Priority: low
>Responsible: bin-bug-people (Utility Bug People)
>State: open
>Class: doc-bug
>Submitter-Id: net
>Arrival-Date: Thu Jul 2 20:50:00 1998
>Last-Modified:
>Originator: Brian Grayson
>Organization:
Parallel and Distributed Systems
Electrical and Computer Engineering
The University of Texas at Austin
>Release: June 30, 1998
>Environment:
NetBSD marvin 1.3E NetBSD 1.3E (MARVIN) #40: Thu Jun 4 09:11:48 CDT 1998 bgrayson@marvin:/a/c3p0/home/c3p0/src/sys/arch/i386/compile/MARVIN i386
>Description:
The dump man page doesn't mention some environment
variables that are honored: TAPE and RCMD_CMD.
>How-To-Repeat:
>Fix:
--- dump.8.orig Thu Jul 2 21:26:36 1998
+++ dump.8 Thu Jul 2 22:33:05 1998
@@ -148,6 +148,12 @@
.Nm
writes to the named file on the remote host using
.Xr rmt 8 .
+Note that methods more secure than rsh (such as
+ssh) can be used to invoke rmt on the remote host, via the
+environment variable RCMD_CMD. See
+.Xr rcmd 3
+for more details.
+
.It Fl h Ar level
Honor the user
.Dq nodump
@@ -332,6 +338,28 @@
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
+.Dq tapename ,
+.Dq host:tapename ,
+or
+.Dq user@host:tapename .
+
+.It Ev RCMD_CMD
+.Nm
+will use RCMD_CMD rather than rsh to invoke rmt on a remote
+machine.
+
.Sh FILES
.Bl -tag -width /etc/dumpdates -compact
.It Pa /dev/rst0
>Audit-Trail:
>Unformatted: