dump.8 (21673) | dump.8 (22192) |
---|---|
1.\" Copyright (c) 1980, 1991, 1993 2.\" Regents of the University of California. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 17 unchanged lines hidden (view full) --- 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.\" @(#)dump.8 8.1 (Berkeley) 6/16/93 | 1.\" Copyright (c) 1980, 1991, 1993 2.\" Regents of the University of California. 3.\" All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright --- 17 unchanged lines hidden (view full) --- 26.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 27.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 28.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 29.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 30.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 31.\" SUCH DAMAGE. 32.\" 33.\" @(#)dump.8 8.1 (Berkeley) 6/16/93 |
34.\" $FreeBSD: head/sbin/dump/dump.8 21673 1997-01-14 07:20:47Z jkh $ | 34.\" $FreeBSD: head/sbin/dump/dump.8 22192 1997-02-01 23:44:19Z joerg $ |
35.\" 36.Dd June 16, 1993 37.Dt DUMP 8 38.Os BSD 4 39.Sh NAME 40.Nm dump 41.Nd filesystem backup 42.Sh SYNOPSIS 43.Nm dump | 35.\" 36.Dd June 16, 1993 37.Dt DUMP 8 38.Os BSD 4 39.Sh NAME 40.Nm dump 41.Nd filesystem backup 42.Sh SYNOPSIS 43.Nm dump |
44.Op Cm 0123456789BbhfusTdWn Op Ar argument ... | 44.Op Cm 0123456789BTWabcdfhnsu Op Ar argument ... |
45.Op Ar filesystem 46.Sh DESCRIPTION 47.Nm Dump 48examines files 49on a filesystem 50and determines which files 51need to be backed up. These files 52are copied to the given disk, tape or other 53storage medium for safe keeping (see the 54.Cm f 55option below for doing remote backups). 56A dump that is larger than the output medium is broken into 57multiple volumes. 58On most media the size is determined by writing until an | 45.Op Ar filesystem 46.Sh DESCRIPTION 47.Nm Dump 48examines files 49on a filesystem 50and determines which files 51need to be backed up. These files 52are copied to the given disk, tape or other 53storage medium for safe keeping (see the 54.Cm f 55option below for doing remote backups). 56A dump that is larger than the output medium is broken into 57multiple volumes. 58On most media the size is determined by writing until an |
59end-of-media indication is returned. | 59end-of-media indication is returned. This can be enforced 60by using the 61.Cm a 62option. 63.Pp |
60On media that cannot reliably return an end-of-media indication 61(such as some cartridge tape drives) 62each volume is of a fixed size; 63the actual size is determined by the tape size and density and/or 64block count options below. 65By default, the same output file name is used for each volume 66after prompting the operator to change media. 67.Pp --- 12 unchanged lines hidden (view full) --- 80tells dump to 81copy all files new or modified since the 82last dump of the same or lower level. The default 83level is 9. 84.It Cm B Ar records 85The number of dump records per volume. 86This option overrides the calculation of tape size 87based on length and density. | 64On media that cannot reliably return an end-of-media indication 65(such as some cartridge tape drives) 66each volume is of a fixed size; 67the actual size is determined by the tape size and density and/or 68block count options below. 69By default, the same output file name is used for each volume 70after prompting the operator to change media. 71.Pp --- 12 unchanged lines hidden (view full) --- 84tells dump to 85copy all files new or modified since the 86last dump of the same or lower level. The default 87level is 9. 88.It Cm B Ar records 89The number of dump records per volume. 90This option overrides the calculation of tape size 91based on length and density. |
92.It Cm a 93.Dq auto-size . 94Bypass all tape length considerations, and enforce writing 95until an end-of-media indication is returned. This fits best 96for most modern tape drives. Use of this option is particularly 97recommended when appending to an existing tape, or using a tape 98drive with hardware compression (where you can never be sure about 99the compression ratio). |
|
88.It Cm b Ar blocksize 89The number of kilobytes per dump record. | 100.It Cm b Ar blocksize 101The number of kilobytes per dump record. |
102.It Cm c 103Change the defaults for use with a cartridge tape drive, with a density 104of 8000 bpi, and a length of 1700 feet. |
|
90.It Cm h Ar level 91Honor the user 92.Dq nodump 93flag 94.Dp Dv UF_NODUMP 95only for dumps at or above the given 96.Ar level . 97The default honor level is 1, --- 222 unchanged lines hidden (view full) --- 320abnormal termination is indicated with an exit code of 3. 321.Sh BUGS 322.Pp 323Fewer than 32 read errors on the filesystem are ignored. 324Each reel requires a new process, so parent processes for 325reels already written just hang around until the entire tape 326is written. 327.Pp | 105.It Cm h Ar level 106Honor the user 107.Dq nodump 108flag 109.Dp Dv UF_NODUMP 110only for dumps at or above the given 111.Ar level . 112The default honor level is 1, --- 222 unchanged lines hidden (view full) --- 335abnormal termination is indicated with an exit code of 3. 336.Sh BUGS 337.Pp 338Fewer than 32 read errors on the filesystem are ignored. 339Each reel requires a new process, so parent processes for 340reels already written just hang around until the entire tape 341is written. 342.Pp |
328restore(8) is currently unable to restore dumps that were created 329with a blocksize larger than 32 on some tape drives. This is likely 330a bug in the tape driver. Workaround for safety reasons: 331dump aborts with an error message when choosing a blocksize > 32. | 343Currently, 344.Xr physio 9 345slices all requests into chunks of 64 KB. Therefore, it is 346impossible to use a larger tape blocksize, so 347.Nm dump 348will prevent this from happening. |
332.Pp 333.Nm Dump 334with the 335.Cm W 336or 337.Cm w 338options does not report filesystems that have never been recorded 339in --- 17 unchanged lines hidden --- | 349.Pp 350.Nm Dump 351with the 352.Cm W 353or 354.Cm w 355options does not report filesystems that have never been recorded 356in --- 17 unchanged lines hidden --- |