warnings.now files should exist and be empty

[chiark-utils.git] / backup / iwjbackup.txt

diff --git a/backup/iwjbackup.txt b/backup/iwjbackup.txt
index 91c904c87ea69eb70aeb602feb4fcb245fc51285..5de4276dcb28d30b13ee6edb7646c9b1de5dac59 100644 (file)
--- a/backup/iwjbackup.txt
+++ b/backup/iwjbackup.txt
@@ -54,18 +54,27 @@ In the fsys.* files:
    run things on a remote machine:
      prefix <prefix-name> <command-part>
   Other lines should be of the form
-    <directory name>   <backup-type>
-  for local backups, or 
-    <directory name>   <backup-type>   <prefix-name>
+    [<device name>:]<directory name> <backup-type>[,<options>]
+  for local backups, or
+    [<device name>:]<directory name> <backup-type>[,<options>] <prefix-name>
   for remote backups.
 The file (including any included files) must end with the word 'end'
 on a line of its own.
 
 Valid values for <backup-type> are `cpio' (uses cpio to produce
 tar-format backups), `dump' (uses dump to dump entire filesystems;
-<directory name> should be a mount-point for this), and `zafio' (uses
-afio to compress each file as it is backed up).  Only `dump' type
-backups perform incremental backups.
+<directory name> should be a mount-point for this), `zafio' (uses afio
+to compress each file as it is backed up), and `ntfsimage' (for NTFS
+volumes, requires device name).  Only `dump' type backups perform
+incremental backups.
+
+<options> is a comma-separated list of <option> or <option>=<value>.
+The only currently support options are gz[i][=<compressionlevel>], to
+indicate that the whole stream should be compressed with gzip.  The
+compression level defaults to 1 if gz is specified by the level isn't.
+gzi appliies only to the incrementals; gz applies to both unless gzi
+is also specified.  compression level 0 means not to run gzip at all
+and is the default if gz[i] is not mentioned.
 
 expected-diffs is a config file to indicate which 
 filesystems should *not* be backed up. The scripts do a config
@@ -96,6 +105,10 @@ Useful scripts (all in /usr/bin):
 backup-checkallused: this only does a check of the configuration
 files.  It should give a cryptic summary of the configuration and
 print 'configuration ok'. If not, fix your config files :->
+You have to create the file /var/lib/chiark-backup/last-tape
+containing the id of a tape; this helps backup-checkallused know where
+to start iterating over tapes.  Any tapeid will do.  (But don't make
+it the same as the one you want to back up to first.)
 
 backup-loaded: this tells the scripts that a currently unlabelled tape
 should be treated as tape X: eg: