X-Git-Url: https://git.wh0rd.org/?p=dump.git;a=blobdiff_plain;f=dump%2Fdump.8.in;h=fa0578b9bf209c19375e0b7dd9f386f546ae959f;hp=206356b7658e6c10ceccb8e6ed4536049298b94c;hb=b82d31dc01e8474d503a86fbf52ddf6d74c245e6;hpb=e084ba00f03da98a6d260b0b3856aee2dfbb4c58 diff --git a/dump/dump.8.in b/dump/dump.8.in index 206356b..fa0578b 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.31 2001/08/16 09:37:59 stelian Exp $ +.\" $Id: dump.8.in,v 1.34 2001/11/11 00:06:39 stelian Exp $ .\" .Dd __DATE__ .Dt DUMP 8 @@ -49,6 +49,8 @@ .Op Fl f Ar file .Op Fl F Ar script .Op Fl h Ar level +.Op Fl I Ar nr errors +.Op Fl j Ar compression level .Op Fl L Ar label .Op Fl Q Ar file .Op Fl s Ar feet @@ -220,6 +222,24 @@ For security reasons, .Nm reverts back to the real user ID and the real group ID before running the script. +.It Fl I Ar nr errors +By default, +.Nm +will ignore the first 32 read errors on the file +system before asking for operator intervention. You can change this +using this flag to any value. This is useful when running +.Nm +on an active filesystem where read errors simply indicate an +inconsistency between the mapping and dumping passes. +.It Fl j Ar compression level +Compress every block to be written on the tape using bzlib 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.4b24 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 bzlib will use. The default compression +level is 2. .It Fl k Use Kerberos authentication to talk to remote tape servers. (Only available if this option was enabled when @@ -372,7 +392,7 @@ end of tape, end of dump, tape write error, tape open error or -disk read error (if there is more than a threshold of 32). +disk read error (if there is more than a threshold of nr errors). In addition to alerting all operators implied by the .Fl n key, @@ -476,6 +496,7 @@ remote shell command to use when doing remote backups (rsh, ssh etc.). If this variable is not set, .Xr rcmd 3 will be used, but only root will be able to do remote backups. +.El .Sh FILES .Bl -tag -width __DUMPDATES__ -compact .It Pa /dev/st0 @@ -503,7 +524,8 @@ abnormal termination is indicated with an exit code of 3. It might be considered a bug that this version of dump can only handle ext2 filesystems. Specifically, it does not work with FAT filesystems. .Pp -Fewer than 32 read errors on the filesystem are ignored. If noticing +Fewer than 32 read errors (change this with -I) +on the filesystem are ignored. If noticing read errors is important, the output from dump can be parsed to look for lines that contain the text 'read error'. .Pp