dump(8)'s manual page is confusing in its use of records, blocks,
blocksizes, etc does not give the default of -b only mentiones rdump in the NAME section uses both filesystem and file system in similar contexts PR: 34248 Submitted by: Gary W. Swearingen <swear@blarg.net> MFC after: 3 days
This commit is contained in:
parent
440ed3238b
commit
7ac806655e
Notes:
svn2git
2020-12-20 02:59:44 +00:00
svn path=/head/; revision=94911
@ -53,7 +53,11 @@
|
|||||||
.Op Fl T Ar date
|
.Op Fl T Ar date
|
||||||
.Ar filesystem
|
.Ar filesystem
|
||||||
.Nm
|
.Nm
|
||||||
.Op Fl W Li \&| Fl w
|
.Fl W | Fl w
|
||||||
|
.Pp
|
||||||
|
.Nm rdump
|
||||||
|
is an alternate name for
|
||||||
|
.Nm .
|
||||||
.Pp
|
.Pp
|
||||||
.in \" XXX
|
.in \" XXX
|
||||||
(The
|
(The
|
||||||
@ -83,17 +87,23 @@ On media that cannot reliably return an end-of-media indication
|
|||||||
(such as some cartridge tape drives)
|
(such as some cartridge tape drives)
|
||||||
each volume is of a fixed size;
|
each volume is of a fixed size;
|
||||||
the actual size is determined by the tape size and density and/or
|
the actual size is determined by the tape size and density and/or
|
||||||
block count options below.
|
.Fl B
|
||||||
|
options.
|
||||||
By default, the same output file name is used for each volume
|
By default, the same output file name is used for each volume
|
||||||
after prompting the operator to change media.
|
after prompting the operator to change media.
|
||||||
.Pp
|
.Pp
|
||||||
|
The filesystem to be dumped is specified by the argument
|
||||||
|
.Ar filesystem
|
||||||
|
as either its device-special file or its mount point
|
||||||
|
(if that is in a standard entry in /etc/fstab).
|
||||||
|
.Pp
|
||||||
The following options are supported by
|
The following options are supported by
|
||||||
.Nm :
|
.Nm :
|
||||||
.Bl -tag -width Ds
|
.Bl -tag -width Ds
|
||||||
.It Fl 0\-9
|
.It Fl 0\-9
|
||||||
Dump levels.
|
Dump levels.
|
||||||
A level 0, full backup,
|
A level 0, full backup,
|
||||||
guarantees the entire file system is copied
|
guarantees the entire filesystem is copied
|
||||||
(but see also the
|
(but see also the
|
||||||
.Fl h
|
.Fl h
|
||||||
option below).
|
option below).
|
||||||
@ -112,11 +122,15 @@ recommended when appending to an existing tape, or using a tape
|
|||||||
drive with hardware compression (where you can never be sure about
|
drive with hardware compression (where you can never be sure about
|
||||||
the compression ratio).
|
the compression ratio).
|
||||||
.It Fl B Ar records
|
.It Fl B Ar records
|
||||||
The number of 1 KB blocks per volume.
|
The number of kilobytes per output volume, except that if it is
|
||||||
|
not an integer multiple of the output block size,
|
||||||
|
the command uses the next smaller such multiple.
|
||||||
This option overrides the calculation of tape size
|
This option overrides the calculation of tape size
|
||||||
based on length and density.
|
based on length and density.
|
||||||
.It Fl b Ar blocksize
|
.It Fl b Ar blocksize
|
||||||
The number of kilobytes per dump record.
|
The number of kilobytes per output block, except that if it is
|
||||||
|
larger than 64, the command uses 64. (See the BUGS section.)
|
||||||
|
The default block size is 10.
|
||||||
.It Fl c
|
.It Fl c
|
||||||
Change the defaults for use with a cartridge tape drive, with a density
|
Change the defaults for use with a cartridge tape drive, with a density
|
||||||
of 8000 bpi, and a length of 1700 feet.
|
of 8000 bpi, and a length of 1700 feet.
|
||||||
@ -243,7 +257,7 @@ but the
|
|||||||
option may be used to change it.
|
option may be used to change it.
|
||||||
.It Fl W
|
.It Fl W
|
||||||
.Nm Dump
|
.Nm Dump
|
||||||
tells the operator what file systems need to be dumped.
|
tells the operator what filesystems need to be dumped.
|
||||||
This information is gleaned from the files
|
This information is gleaned from the files
|
||||||
.Pa dumpdates
|
.Pa dumpdates
|
||||||
and
|
and
|
||||||
@ -252,12 +266,12 @@ The
|
|||||||
.Fl W
|
.Fl W
|
||||||
option causes
|
option causes
|
||||||
.Nm
|
.Nm
|
||||||
to print out, for each file system in
|
to print out, for each filesystem in
|
||||||
the
|
the
|
||||||
.Pa dumpdates
|
.Pa dumpdates
|
||||||
file
|
file
|
||||||
the most recent dump date and level,
|
the most recent dump date and level,
|
||||||
and highlights those file systems that should be dumped.
|
and highlights those filesystems that should be dumped.
|
||||||
If the
|
If the
|
||||||
.Fl W
|
.Fl W
|
||||||
option is set, all other options are ignored, and
|
option is set, all other options are ignored, and
|
||||||
@ -343,8 +357,7 @@ Always start with a level 0 backup, for example:
|
|||||||
This should be done at set intervals, say once a month or once every two months,
|
This should be done at set intervals, say once a month or once every two months,
|
||||||
and on a set of fresh tapes that is saved forever.
|
and on a set of fresh tapes that is saved forever.
|
||||||
.It
|
.It
|
||||||
After a level 0, dumps of active file
|
After a level 0, dumps of active filesystems are taken on a daily basis,
|
||||||
systems are taken on a daily basis,
|
|
||||||
using a modified Tower of Hanoi algorithm,
|
using a modified Tower of Hanoi algorithm,
|
||||||
with this sequence of dump levels:
|
with this sequence of dump levels:
|
||||||
.Bd -literal -offset indent
|
.Bd -literal -offset indent
|
||||||
@ -355,7 +368,7 @@ For the daily dumps, it should be possible to use a fixed number of tapes
|
|||||||
for each day, used on a weekly basis.
|
for each day, used on a weekly basis.
|
||||||
Each week, a level 1 dump is taken, and
|
Each week, a level 1 dump is taken, and
|
||||||
the daily Hanoi sequence repeats beginning with 3.
|
the daily Hanoi sequence repeats beginning with 3.
|
||||||
For weekly dumps, another fixed set of tapes per dumped file system is
|
For weekly dumps, another fixed set of tapes per dumped filesystem is
|
||||||
used, also on a cyclical basis.
|
used, also on a cyclical basis.
|
||||||
.El
|
.El
|
||||||
.Pp
|
.Pp
|
||||||
@ -378,7 +391,7 @@ see the
|
|||||||
.Fl D
|
.Fl D
|
||||||
option)
|
option)
|
||||||
.It Pa /etc/fstab
|
.It Pa /etc/fstab
|
||||||
dump table: file systems and frequency
|
dump table: filesystems and frequency
|
||||||
.It Pa /etc/group
|
.It Pa /etc/group
|
||||||
to find group
|
to find group
|
||||||
.Em operator
|
.Em operator
|
||||||
@ -404,7 +417,7 @@ is written.
|
|||||||
Currently,
|
Currently,
|
||||||
.Xr physio 9
|
.Xr physio 9
|
||||||
slices all requests into chunks of 64 KB. Therefore, it is
|
slices all requests into chunks of 64 KB. Therefore, it is
|
||||||
impossible to use a larger tape blocksize, so
|
impossible to use a larger output block size, so
|
||||||
.Nm
|
.Nm
|
||||||
will prevent this from happening.
|
will prevent this from happening.
|
||||||
.Pp
|
.Pp
|
||||||
|
Loading…
Reference in New Issue
Block a user