X-Git-Url: https://arthur.barton.de/gitweb/?a=blobdiff_plain;f=README.md;h=47ec27a91819dc27d1d52b6355126ed3deb3e16d;hb=8ec1b627babaaf626e983549b03ffd336cc471c2;hp=ef3ee97214444940694a55124aafd802282213b3;hpb=dbff329225555dc6ce284cac4a800188f2f5f408;p=backup-script.git diff --git a/README.md b/README.md index ef3ee97..47ec27a 100644 --- a/README.md +++ b/README.md @@ -1,15 +1,25 @@ # Backup Script -A script for cloning systems using rsync. +A script for backing up data using `ssh`(1), `rsync`(1), and `scp`(1). +Can handle backup generations on *btrfs* and *ZFS*. + Copyright (c)2008-2016 Alexander Barton () Homepage: https://github.com/alexbarton/backup-script +## Installation + +Call the scripts located in `./bin` directly from the source folder, or run +`make install` to install them to `/usr/local/sbin`. + +You can set `PREFIX` to use an other path prefix than `/usr/local` like this: +`make PREFIX=/opt/backup-script install`. + ## Usage ### backup-script -Backup all or individual systems. +Run all or individual backup jobs. Usage: `backup-script [] [ [ [...]]]` @@ -32,11 +42,19 @@ Usage: `backup-script-wrapper []` Show information about backups. -Usage: `backup-status [-q] [ [ [...]]]` +Usage: + +- `backup-status [--errors|--latest] [--quick] [ [ [...]]]` +- `backup-status --running` Options: -- `-q`: *quick mode*, don't calculate backup sizes. +- `-e`, `--errors`: only show current backups with errors (implies `--latest`). +- `-l`, `--latest`: only show latest backup generations. +- `-q`, `--quick`: *quick mode*, don't calculate backup sizes. +- `-r`, `--running`: check if an `backup-script` task is currently running. + +When no *job* is given, all defined jobs are listed. ### backup-audit @@ -46,8 +64,11 @@ Usage: `backup-audit [-q] [-v] [ [ [...]]]` Options: -- `-q`: *quiet mode*, don't show jobs without "relevant" changes. -- `-v`: *verbose mode*, show all checks that are run. +- `-d`, `--dirs`: compare two backup directories (not jobs). +- `-q`, `--quiet`: *quite mode*, only list jobs with changes or errors. +- `-v`, `--verbose`: *verbose mode*, show all checks that are run. + +When no *job* is given, all defined jobs are checked. ## Configuration @@ -229,14 +250,15 @@ The following job configurations variables used by the outdated backup-pull(1) script in job definition files are automatically mapped to the new backup-script variables: -* host -> system -* source -> source_root -* pre_exec -> job_pre_exec -* post_exec -> job_post_exec +* `host` -> `system` +* `source` -> `source_root` +* `pre_exec` -> `job_pre_exec` +* `post_exec` -> `job_post_exec` ## Exit codes +- 0: No error, success. - 1: Unspecific Error! - 2: Usage information has been shown. - 3: Can't read job definition