X-Git-Url: https://git.wh0rd.org/?a=blobdiff_plain;f=dump%2Fdump.8.in;h=5d16fc77d53182fc3d6152c1b85cea63ecf0ecce;hb=871ede100ce41d967ebbb4e2d67c6b7587e16f76;hp=38ba0846747dad975eda10313fa4a78e0c23c5b1;hpb=4f4eee3d2e237c2f0becd9c5ce41524f8f5bc1c1;p=dump.git diff --git a/dump/dump.8.in b/dump/dump.8.in index 38ba084..5d16fc7 100644 --- a/dump/dump.8.in +++ b/dump/dump.8.in @@ -30,7 +30,7 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: dump.8.in,v 1.18 2000/11/10 13:22:10 stelian Exp $ +.\" $Id: dump.8.in,v 1.26 2001/04/10 13:42:22 stelian Exp $ .\" .Dd __DATE__ .Dt DUMP 8 @@ -49,9 +49,11 @@ .Op Fl F Ar script .Op Fl h Ar level .Op Fl L Ar label +.Op Fl Q Ar file .Op Fl s Ar feet .Op Fl T Ar date -.Ar file-to-dump +.Op Fl z Ar compression level +.Ar files-to-dump .Nm dump .Op Fl W Li \&| Fl w .Pp @@ -82,15 +84,17 @@ tape size, density and/or block count options below. By default, the same output file name is used for each volume after prompting the operator to change media. .Pp -.Ar file-to-dump +.Ar files-to-dump is either a mountpoint of a filesystem -or a directory to be backed up as a subset of a filesystem. +or a list of files and directories to be backed up as a subset of a +filesystem. In the former case, either the path to a mounted filesystem or the device of an unmounted filesystem can be used. In the latter case, certain restrictions are placed on the backup: .Fl u -is not allowed and the only dump level that is supported is -.Fl 0 . +is not allowed, the only dump level that is supported is +.Fl 0 +and all the files and directories must reside on the same filesystem. .Pp The following options are supported by .Nm Ns : @@ -111,7 +115,7 @@ copy all files new or modified since the last dump of a lower level. The default level is 9. .It Fl B Ar records -The number of 1 KB blocks per volume. +The number of 1 kB blocks per volume. This option overrides the end-of-media detection, and calculation of tape size based on length and density. .It Fl a @@ -125,7 +129,7 @@ existing tape, or using a tape drive with hardware compression .It Fl b Ar blocksize The number of kilobytes per dump record. Since the IO system slices all requests into chunks of MAXBSIZE -(typically 64KB), it is not possible to use a larger blocksize +(typically 64kB), it is not possible to use a larger blocksize without having problems later with .Xr restore 8 . Therefore @@ -238,6 +242,14 @@ notify all operators in the group .Dq operator by means similar to a .Xr wall 1 . +.It Fl Q Ar file +Enable the Quick File Access support. Tape positions for each +inode are stored into the file +.Ar file +which is used by restore (if called with parameter Q and the filename) +to directly position the tape at the file restore is currently working +on. This saves hours when restoring single files from large backups, +saves the tapes and the drive's head. .It Fl s Ar feet Attempt to calculate the amount of tape needed at a particular density. If this amount is exceeded, @@ -315,6 +327,15 @@ Is like but prints only recognized filesystems in .Pa /etc/fstab which need to be dumped. +.It Fl z Ar compression level +Compress every block to be written on the tape using zlib library. This +option will work only when dumping to a file or pipe or, when dumping +to a tape drive, if the tape drive is capable of writing variable +length blocks. You will need at least the 0.4b22 version of restore in +order to extract compressed tapes. Tapes written using compression will +not be compatible with the BSD tape format. The (optional) parameter +specifies the compression level zlib will use. The default compression +level is 2. .El .Pp .Nm Dump @@ -480,17 +501,17 @@ a remote shell program instead. .Sh AUTHOR The .Nm dump/restore -backup suit was ported to Linux's Second Extended File System +backup suite was ported to Linux's Second Extended File System by Remy Card . He maintained the initial versions of dump (up and including 0.4b4, released in january 1997). .Pp Starting with 0.4b5, the new maintainer is Stelian Pop .br -. +. .Sh AVAILABILITY The .Nm dump/restore -backup suit is available from +backup suite is available from .br http://dump.sourceforge.net .Sh HISTORY