AutoArchive ver. 0.2.0
=======================

Jednoduchý program pre vytváranie záloh.

Copyright (C) 2003 - 2010 by Róbert Čerňanský
Copyright (C) 2003 - 2010 HOME software



INFORMÁCIE O PROGRAME
=====================


AutoArchive je jednoduchý pythonovský skript pre uľahčenie zálohovania. Pre
vytváranie archívov používa tar. Myšlienka programu je združiť informácie
potrebné na vytvorenie zálohy do jedného súboru - špecifikácie archívu. Cesta
k tomuto súboru je potom predaná ako parameter príkazu 'aa', ktorý si z neho
prečíta informácie a vytvorí požadovanú zálohu.

Príkaz 'autoarchive' je alternatívne meno pre 'aa'; príkazy sú
ekvivalentné.



Použitie
--------

aa/autoarchive [voľby] AA_SPEC...

Voľby:

--version
       vypíše verziu programu a skončí

-h, --help
       vypíše tento manuál a skončí

-v, --verbose
       Zapne "ukecaný" mód.

-a ARCHIVER, --archiver=ARCHIVER
       Nastavenie typu archivačného programu. Podporované typy sú: ('tar',
       'targz', 'tarbz2', 'tarlzma', 'tarxz') (predvolený: tarbz2).

-i, --incremental
       Vytvor inkrementálnu zálohu.

-l LEVEL, --level=LEVEL
       Nastav, záloha akej úrovne má byť vytvorená. Informácie o vyšších
       úrovniach budú vymazané. Ak informácie pre požadovanú úroveň nie sú
       k dispozícii, bude vytvorená najbližšia možná úroveň.

-c NUM, --compression-level=NUM
       Úroveň kompresie. Ak nie je špecifikovaná, bude použitá úroveň vybratá
       použitým kompresným programom.

AA_SPEC je súbor špecifikácie archívu. Špecifikuje čo má byť archivované a meno
archívu. Jeho štandardná koncovka mena súboru je ".aa". Pozri kapitolu "Formát
súboru špecifikácie archívu" pre popis syntaxe. Je možné zadať viac ".aa"
súborov.



Formát súboru špecifikácie archívu
----------------------------------

AA_SPEC súbor pozostáva z jednej sekcie "[General]" v rámci ktorej sa
nachádzajú všetky premenné špecifikujúce informácie o archíve. Premenné sa píšu
v tvare "meno_premennej: hodnota", vždy jedna premenná na jeden riadok. Riadky
začínajúce znakom "#" alebo ";" sú ignorované a môžu byť použité na komentáre.

Možné premenné sú:

name

  Meno archívu. Vytvorený archív bude mať meno uvedené v tejto premennej plus
  príslušná koncovka.

path

  Cesta ku koreňovému adresáru archívu. Všetky cesty uvedené v tejto
  špecifikácii archívu budú brané ako relatívne k uvedenej ceste.

include_files

  Zoznam medzerou oddelených názvov súborov alebo adresárov určených
  k archivácii.

exclude_files

  Zoznam medzerou oddelených názvov súborov alebo adresárov vyradených
  z archivácie.

Hodnoty obsahujúce medzery musia byť uzatvorené do "". Vo všetkých menách
adresárov alebo súborov je možné použiť zástupné znaky shellu. Taktiež znak ~
bude nahradený cestou k používateľovmu domovskému adresáru.

Pri uvádzaní hodnoty je tiež možné sa odkázať na hodnotu inej premennej v tvare
%(meno_premennej)s.



Príklad
-------

Povedzme, že chceme spraviť zálohu konfiguračných súborov všetkých používateľov
okrem používateľa foo. Predpokladajme, že máme unixovský štýl domovských
adresárov (adresár /home obsahuje adresáre všetkých používateľov; konfiguračné
súbory sa začínajú bodkou). Názov archívu bude 'users-config'.

Najskôr si musíme vytvoriť súbor users-config.aa (môže mať akékoľvek meno).

----- obsah súboru users-config.aa -----
# AutoArchive súbor pre konfiguračné súbory užívateľov
[General]
name: users-config
path: /home
include_files: */.*
exclude_files: foo
--------- koniec user-config.aa ---------

Potom vytvoríme zálohu napísaním

  aa users-config.aa

a v aktuálnom adresári sa vytvorí archív users-config.tar.bz2.



Známe chyby
-----------

Pri vytváraní inkrementálnej zálohy, súbory uvedené v 'include_files' sú vždy
pridané do archívu a to aj v prípade, že neboli zmenené. Je to chyba/vlastnosť
tar-u.



Kontaktovanie autora
--------------------

Komentáre, hlásenia o chybách, priania týkajúce sa tohto programu sú vítané na
e-mailovej adrese openhs@users.sourceforge.net.

Domovská stránka: http://autoarchive.sourceforge.net/.