Added man pages

[matthijs/upstream/backupninja.git] / docs / man / backupninja.conf.5

diff --git a/docs/man/backupninja.conf.5 b/docs/man/backupninja.conf.5
new file mode 100644 (file)
index 0000000..ba7d421
--- /dev/null
+++ b/docs/man/backupninja.conf.5
@@ -0,0 +1,119 @@
+.\"                                      Hey, EMACS: -*- nroff -*-
+.\" 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"
+.SH NAME 
+BACKUPNINJA.CONF \- Configuration file(s) for \fBbackupninja (1)\fP.
+
+.\" Please adjust this date whenever revising the manpage.
+.\"
+.\" Some roff macros, for reference:
+.\" .nh        disable hyphenation
+.\" .hy        enable hyphenation
+.\" .ad l      left justify
+.\" .ad b      justify to both left and right margins
+.\" .nf        disable filling
+.\" .fi        enable filling
+.\" .br        insert line break
+.\" .sp <n>    insert n+1 empty lines
+.\" for manpage-specific macros, see man(7)
+.br
+.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
+
+.TP
+Support for additional configuration types can be added by dropping bash scripts with the name of the suffix into /usr/share/backupninja.
+
+.TP
+The configuration files are processed in alphabetical order. However, it is suggested that you name the config files in "sysvinit style."
+
+.TP
+For example:
+  00-disabled.ldap
+  10-runthisfirst.sh
+  20-runthisnext.mysql
+  90-runthislast.rdiff
+
+.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.
+
+.TP
+Unless otherwise specified, the config file format is "ini style."
+
+.TP
+For example:
+
+ # this is a comment
+
+ [fishes]
+ fish = red
+ fish = blue
+
+ [fruit]
+ apple = yes
+ pear = no thanks \
+ i will not have a pear.
+
+
+.PP
+
+.SH SCHEDULING
+.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
+.br
+
+.SH SEE ALSO
+.BR backupninja (1), 
+.br
+.SH AUTHOR
+BACKUPNINJA was written by <elijah@riseup.net>.
+.br
+BACKUPNINJA was packaged by <micah@riseup.net>.
+.br
+.PP
+This manual page was written by  <stefani@riseup.net>.