View | Details | Raw Unified | Return to bug 34248
Collapse All | Expand All

(-)/tmp/dump.8 (-13 / +26 lines)
Lines 53-59 Link Here
53
.Op Fl T Ar date
53
.Op Fl T Ar date
54
.Ar filesystem
54
.Ar filesystem
55
.Nm
55
.Nm
56
.Op Fl W Li \&| Fl w
56
.Fl W | Fl w
57
.Pp
58
.Nm rdump
59
is an alternate name for
60
.Nm .
57
.Pp
61
.Pp
58
.in \" XXX
62
.in \" XXX
59
(The
63
(The
Lines 83-99 Link Here
83
(such as some cartridge tape drives)
87
(such as some cartridge tape drives)
84
each volume is of a fixed size;
88
each volume is of a fixed size;
85
the actual size is determined by the tape size and density and/or
89
the actual size is determined by the tape size and density and/or
86
block count options below.
90
.Fl B
91
options.
87
By default, the same output file name is used for each volume
92
By default, the same output file name is used for each volume
88
after prompting the operator to change media.
93
after prompting the operator to change media.
89
.Pp
94
.Pp
95
The filesystem to be dumped is specified by the argument
96
.Ar filesystem
97
as either its device-special file or its mount point
98
(if that is in a standard entry in /etc/fstab).
99
.Pp
90
The following options are supported by
100
The following options are supported by
91
.Nm :
101
.Nm :
92
.Bl -tag -width Ds
102
.Bl -tag -width Ds
93
.It Fl 0\-9
103
.It Fl 0\-9
94
Dump levels.
104
Dump levels.
95
A level 0, full backup,
105
A level 0, full backup,
96
guarantees the entire file system is copied
106
guarantees the entire filesystem is copied
97
(but see also the
107
(but see also the
98
.Fl h
108
.Fl h
99
option below).
109
option below).
Lines 112-122 Link Here
112
drive with hardware compression (where you can never be sure about
122
drive with hardware compression (where you can never be sure about
113
the compression ratio).
123
the compression ratio).
114
.It Fl B Ar records
124
.It Fl B Ar records
115
The number of 1 KB blocks per volume.
125
The number of kilobytes per output volume, except that if it is
126
not an integer multiple of the output block size,
127
the command uses the next smaller such multiple.
116
This option overrides the calculation of tape size
128
This option overrides the calculation of tape size
117
based on length and density.
129
based on length and density.
118
.It Fl b Ar blocksize
130
.It Fl b Ar blocksize
119
The number of kilobytes per dump record.
131
The number of kilobytes per output block, except that if it is
132
larger than 64, the command uses 64. (See the BUGS section.)
133
The default block size is 10.
120
.It Fl c
134
.It Fl c
121
Change the defaults for use with a cartridge tape drive, with a density
135
Change the defaults for use with a cartridge tape drive, with a density
122
of 8000 bpi, and a length of 1700 feet.
136
of 8000 bpi, and a length of 1700 feet.
Lines 240-246 Link Here
240
option may be used to change it.
254
option may be used to change it.
241
.It Fl W
255
.It Fl W
242
.Nm Dump
256
.Nm Dump
243
tells the operator what file systems need to be dumped.
257
tells the operator what filesystems need to be dumped.
244
This information is gleaned from the files
258
This information is gleaned from the files
245
.Pa dumpdates
259
.Pa dumpdates
246
and
260
and
Lines 249-260 Link Here
249
.Fl W
263
.Fl W
250
option causes
264
option causes
251
.Nm
265
.Nm
252
to print out, for each file system in
266
to print out, for each filesystem in
253
the
267
the
254
.Pa dumpdates
268
.Pa dumpdates
255
file
269
file
256
the most recent dump date and level,
270
the most recent dump date and level,
257
and highlights those file systems that should be dumped.
271
and highlights those filesystems that should be dumped.
258
If the
272
If the
259
.Fl W
273
.Fl W
260
option is set, all other options are ignored, and
274
option is set, all other options are ignored, and
Lines 345-352 Link Here
345
This should be done at set intervals, say once a month or once every two months,
359
This should be done at set intervals, say once a month or once every two months,
346
and on a set of fresh tapes that is saved forever.
360
and on a set of fresh tapes that is saved forever.
347
.It
361
.It
348
After a level 0, dumps of active file
362
After a level 0, dumps of active filesystems are taken on a daily basis,
349
systems are taken on a daily basis,
350
using a modified Tower of Hanoi algorithm,
363
using a modified Tower of Hanoi algorithm,
351
with this sequence of dump levels:
364
with this sequence of dump levels:
352
.Bd -literal -offset indent
365
.Bd -literal -offset indent
Lines 357-363 Link Here
357
for each day, used on a weekly basis.
370
for each day, used on a weekly basis.
358
Each week, a level 1 dump is taken, and
371
Each week, a level 1 dump is taken, and
359
the daily Hanoi sequence repeats beginning with 3.
372
the daily Hanoi sequence repeats beginning with 3.
360
For weekly dumps, another fixed set of tapes per dumped file system is
373
For weekly dumps, another fixed set of tapes per dumped filesystem is
361
used, also on a cyclical basis.
374
used, also on a cyclical basis.
362
.El
375
.El
363
.Pp
376
.Pp
Lines 380-386 Link Here
380
.Fl D
393
.Fl D
381
option)
394
option)
382
.It Pa /etc/fstab
395
.It Pa /etc/fstab
383
dump table: file systems and frequency
396
dump table: filesystems and frequency
384
.It Pa /etc/group
397
.It Pa /etc/group
385
to find group
398
to find group
386
.Em operator
399
.Em operator
Lines 405-411 Link Here
405
Currently,
418
Currently,
406
.Xr physio 9
419
.Xr physio 9
407
slices all requests into chunks of 64 KB.  Therefore, it is
420
slices all requests into chunks of 64 KB.  Therefore, it is
408
impossible to use a larger tape blocksize, so
421
impossible to use a larger output block size, so
409
.Nm
422
.Nm
410
will prevent this from happening.
423
will prevent this from happening.
411
.Pp
424
.Pp

Return to bug 34248