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: