PR#5697 + nroff cleanup

This commit is contained in:
fair 1998-07-03 11:17:46 +00:00
parent 8b671e53f4
commit 1de21af0c2
1 changed files with 46 additions and 9 deletions

View File

@ -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 .\" Copyright (c) 1980, 1991, 1993
.\" Regents of the University of California. .\" Regents of the University of California.
@ -59,7 +59,7 @@
(The (The
.Bx 4.3 .Bx 4.3
option syntax is implemented for backward compatibility, but option syntax is implemented for backward compatibility, but
is not documented here.) is not documented here).
.Sh DESCRIPTION .Sh DESCRIPTION
.Nm .Nm
examines files on a filesystem and determines which files need to 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 the last file name will used for all remaining volumes after prompting
for media changes. for media changes.
If the name of the file is of the form If the name of the file is of the form
.Dq host:file , .Qq host:file ,
or or
.Dq user@host:file , .Qq user@host:file ,
.Nm .Nm
writes to the named file on the remote host using writes to the named file on the remote host using
.Xr rmt 8 . .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 .It Fl h Ar level
Honor the user Honor the user
.Dq nodump .Qq nodump
flag flag
.Dp Dv UF_NODUMP .Dp Dv UF_NODUMP
only for dumps at or above the given only for dumps at or above the given
@ -163,7 +174,7 @@ Whenever
.Nm .Nm
requires operator attention, requires operator attention,
notify all operators in the group notify all operators in the group
.Dq operator .Qq operator
by means similar to a by means similar to a
.Xr wall 1 . .Xr wall 1 .
.It Fl s Ar feet .It Fl s Ar feet
@ -258,9 +269,9 @@ All questions
poses poses
.Em must .Em must
be answered by typing be answered by typing
.Dq yes .Qq yes
or or
.Dq no , .Qq no ,
appropriately. appropriately.
.Pp .Pp
Since making a dump involves a lot of time and effort for full dumps, Since making a dump involves a lot of time and effort for full dumps,
@ -326,12 +337,38 @@ receives a
.Dv SIGINFO .Dv SIGINFO
signal signal
(see the (see the
.Dq status .Qq status
argument of argument of
.Xr stty 1 ) .Xr stty 1 )
whilst a backup is in progress, statistics on the amount completed, whilst a backup is in progress, statistics on the amount completed,
current transfer rate, and estimated finished time, will be written current transfer rate, and estimated finished time, will be written
to the standard error output. 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 .Sh FILES
.Bl -tag -width /etc/dumpdates -compact .Bl -tag -width /etc/dumpdates -compact
.It Pa /dev/rst0 .It Pa /dev/rst0