X-Git-Url: https://git.distorted.org.uk/~mdw/rsync-backup/blobdiff_plain/2aea457319d4aadc52805c52255a5198d8039db4..1c9c923af8ab55f91a9875d135e7189395302334:/rsync-backup.8 diff --git a/rsync-backup.8 b/rsync-backup.8 index 1311403..714b63f 100644 --- a/rsync-backup.8 +++ b/rsync-backup.8 @@ -5,6 +5,8 @@ \h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c .. .TH rsync-backup 8 "7 October 2012" rsync-backup +.SH NAME +rsync-backup \- back up files using rsync .SH SYNOPSIS .B rsync-backup .RB [ \-nv ] @@ -253,11 +255,42 @@ counter. The following shell variables may be overridden by the configuration file. .TP +.B HASH +The hash function to use for verifying archive integrity. This is +passed to the +.B \-H +option of +.BR fshash , +so it must name one of the hash functions supported by your Python's +.B hashlib +module. +The default is +.BR sha256 . +.TP +.B INDEXDB +The name of a SQLite database initialized by +.BR update-bkp-index (8) +in which an index is maintained of which dumps are on which backup +volumes. If the file doesn't exist, then no index is maintained. The +default is +.IB localstatedir /lib/bkp/index.db +where +.I localstatedir +is the state directory configured at build time. +.TP .B MAXLOG The number of log files to be kept for each filesystem. Old logfiles are deleted to keep the total number below this bound. The default value is 14. .TP +.B METADIR +The metadata directory for the currently mounted backup volume. +The default is +.IB mntbkpdir /meta +where +.I mntbkpdir +is the backup mount directory configured at build time. +.TP .B RSYNCOPTS Command-line options to pass to .BR rsync (1) @@ -303,16 +336,11 @@ where .I mntbkpdir is the backup mount directory configured at build time. .TP -.B HASH -The hash function to use for verifying archive integrity. This is -passed to the -.B \-H -option of -.BR fshash , -so it must name one of the hash functions supported by your Python's -.B hashlib -module. The default is -.BR sha256 . +.B VOLUME +The name of the current volume. If this is left unset, the volume name +is read from the file +.IB METADIR /volume +once at the start of the backup run. .SS Hook functions The configuration file may define shell functions to perform custom actions at various points in the backup process. @@ -452,6 +480,7 @@ referring to the most recent backup of the filesystem. .BR lvm (8), .BR rfreezefs (8), .BR rsync (1), -.BR ssh (1). +.BR ssh (1), +.BR update-bkp-index (8). .SH AUTHOR Mark Wooding,