aa(1) - f14

1AA(1)                            User Commands                           AA(1)
2
3
4

NAME

6       aa, autoarchive - simple backup utility
7

SYNOPSIS

9       aa/autoarchive  [options] AA_SPEC...
10

DESCRIPTION

12       Simple backup utility.
13
14       AutoArchive  is  a simple python script for making backups more easily.
15       It uses tar(1) for creating archives. The idea of the program  is  that
16       every  information  needed for making a backup is in one file - the ar‐
17       chive spec file (AA_SPEC). Path to this file is passed as  a  parameter
18       to  'aa'  command  which reads informations from it and creates desired
19       backup.
20
21       Command 'autoarchive' is alias for 'aa'; commands are equivalent.
22

OPTIONS

24       --version
25              show program's version number and exit
26
27       -h, --help
28              show this help message and exit
29
30       -v, --verbose
31              Turns on verbose output.
32
33       -a ARCHIVER, --archiver=ARCHIVER
34              Specify archiver type. Supported  types  are:  ('tar',  'targz',
35              'tarbz2', 'tarlzma', 'tarxz') (default: tarbz2).
36
37       -i, --incremental
38              Perform incremental backup.
39
40       -l LEVEL, --level=LEVEL
41              Specify  backup  level  which  should  be created.  Informations
42              about higher levels will be erased.   If  not  present,  creates
43              next level in a row.
44
45       -c NUM, --compression-level=NUM
46              Compression level. If not specified, default behaviour of under‐
47              lying  compression program will be used.
48
49       AA_SPEC is an archive spec file. It specifies what should  be  archived
50       and  the  archive  name. Its standard file name extension is ".aa". For
51       syntax please see README file. It is possible to specify multiple ".aa"
52       files.
53

EXAMPLES

55       Let's  say  that  we  want  make a backup of configuration files of all
56       users except user foo. Assume that our system has  unix-like  style  of
57       home  directories  (directory  /home contains directories of all users;
58       configuration files begins with dot).  Name  of  this  backup  will  be
59       'users-config'.
60
61       First,  create  file users-config.aa (it doesn't need to have same name
62       as backup).
63
64        ----- content of file users-config.aa -----
65        # AutoArchive file for users configuration files
66        [General]
67        name: users-config
68        path: /home
69        include_files: */.*
70        exclude_files: foo
71        ---------- end of users-config.aa ----------
72
73       Then to create the backup just type
74
75         aa users-config.aa
76
77       and in current directory will be created archive users-config.tar.bz2.
78

FILES

80       ~/.config/aa/snapshots/*.snar
81              Files stores informations about  incremental  backup.  They  are
82              created by tar(1) archiver.
83

BUGS

85       When  creating  incremental  backup, files and directories specified in
86       'include_files' are always added to  archive,  even  if  they  did  not
87       changed. This is bug/feature of tar(1).
88

AUTHOR

90       Robert Cernansky <openhs@users.sourceforge.net>
91
92       Homepage: http://autoarchive.sourceforge.net/
93

COPYRIGHT

95       Copyright © 2003 - 2010 Robert Cernansky
96       Copyright © 2003 - 2010 HOME software
97
98       This program is free software: you can redistribute it and/or modify it
99       under the terms of the GNU General Public License  version  3  as  pub‐
100       lished by the Free Software Foundation.
101
102       This  program  is  distributed  in the hope that it will be useful, but
103       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
104       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
105       Public License for more details.
106
107       You should have received a copy of the GNU General Public License along
108       with this program.  If not, see <http://www.gnu.org/licenses/>.
109