X-Git-Url: https://git.stderr.nl/gitweb?a=blobdiff_plain;f=docs%2Fman%2Fbackupninja.conf.5;h=f96c931e3cd8d2cbf45c919b4c26853b6f041ed5;hb=d943cfdaa9bb9e297319c63c2302995999ffe5c3;hp=ba7d4215043d6f9b1efdb95d1afa77412c620a7f;hpb=f8e59dc81f7eda58543eb6cfba244532d5e32b31;p=matthijs%2Fupstream%2Fbackupninja.git diff --git a/docs/man/backupninja.conf.5 b/docs/man/backupninja.conf.5 index ba7d421..f96c931 100644 --- a/docs/man/backupninja.conf.5 +++ b/docs/man/backupninja.conf.5 @@ -2,7 +2,7 @@ .\" First parameter, NAME, should be all caps .\" Second parameter, SECTION, should be 1-8, maybe w/ subsection .\" other parameters are allowed: see man(7), man(1) -.TH BACKUPNINJA.CONF 5 "January 2, 2005" "riseup" "backupninja package" +.TH BACKUPNINJA.CONF 5 "October 10, 2005" "riseup" "backupninja package" .SH NAME BACKUPNINJA.CONF \- Configuration file(s) for \fBbackupninja (1)\fP. @@ -22,98 +22,76 @@ BACKUPNINJA.CONF \- Configuration file(s) for \fBbackupninja (1)\fP. .SH SYNOPSIS .B "/etc/backupninja.conf " .br -.B "/etc/backup.d/* " -.br .SH DESCRIPTION .B backupninja.conf is the general configuration file. In this file you can set the log level and change the default directory locations. You can force a different general configuration file with "backupninja -f /path/to/conf". -.TP -To perform the actual backup, backupninja processes each configuration file in /etc/backup.d according to the file's suffix: -.br - .sh -- run this file as a shell script. - .rdiff -- this is a configuration for rdiff-backup - .maildir -- this is a configuration to backup maildirs - .mysql -- mysql backup configuration - .ldap -- ldap backup configuration - .sys -- general system reports +.SH OPTIONS .TP -Support for additional configuration types can be added by dropping bash scripts with the name of the suffix into /usr/share/backupninja. +.B loglevel +How verbose to make the logs. +.br +5 = Debugging messages +.br +4 = Informational messages +.br +3 = Warnings +.br +2 = Errors +.br +1 = Fatal errors .TP -The configuration files are processed in alphabetical order. However, it is suggested that you name the config files in "sysvinit style." +.B reportemail +Send a summary of the backup status to this email address .TP -For example: - 00-disabled.ldap - 10-runthisfirst.sh - 20-runthisnext.mysql - 90-runthislast.rdiff +.B reportsuccess +If set to 'yes', a report email will be generated even if all modules reported success. .TP -Typically, you will put a '.rdiff' config file last, so that any database dumps you make are included in the filesystem backup. Configurations files which begin with 0 (zero) are skipped. +.B reportwarning +If set to 'yes', a report email will be generated even if there was no error. .TP -Unless otherwise specified, the config file format is "ini style." +.B logfile +The path of the logfile. .TP -For example: - - # this is a comment +.B configdirectory +The directory where all the backup action configuration files live. - [fishes] - fish = red - fish = blue - - [fruit] - apple = yes - pear = no thanks \ - i will not have a pear. +.TP +.B scriptdirectory +Where backupninja handler scripts are found +.TP +.B usecolors +If set to 'yes', use colors in the log file and debug output. -.PP +.SH DEFAULTS -.SH SCHEDULING +loglevel = 4 .br -By default, each configuration file is processed everyday at 01:00 (1 -AM). This can be changed by specifying the 'when' in a config file. - -For example: - - when = sundays at 02:00 - when = 30th at 22 - when = 30 at 22:00 - when = everyday at 01 <-- the default - when = Tuesday at 05:00 - -A configuration file will be processed at the time(s) specified by the -"when" option. If multiple "when" options are present, then they all -apply. If two configurations files are scheduled to run in the same -hour, then we fall back on the alphabetical ordering specified above. -If two configurations files are scheduled close to one another in -time, it is possible to have multiple copies of backupninja running if -the first instance is not finished before the next one starts. - -These values for 'when' are equivalent: - - when = tuesday at 05:30 - when = TUESDAYS at 05 - -These values for 'when' are invalid: - - when = tuesday at 2am - when = tuesday at 2 - when = tues at 02 +reportemail = root +.br +reportsuccess = yes .br +reportwarning = yes +.br +logfile = /var/log/backupninja.log +.br +configdirectory = /etc/backup.d +.br +scriptdirectory = /usr/share/backupninja +.br +usecolors = yes .SH SEE ALSO .BR backupninja (1), +.BR ninjahelper (1), +.BR backup.d (5), .br .SH AUTHOR -BACKUPNINJA was written by . -.br -BACKUPNINJA was packaged by . -.br -.PP -This manual page was written by . +BACKUPNINJA was written by the riseup.net collective.