$Id: README,v 1.6 2002/02/28 12:34:22 bubuchka Exp $


CDBKUP
------
The cdbkup suite includes five utilities - cdbkup, cdrstr, cdsplit,
cdcat and cdappend.  Use the --help option or man pages for help.


DEPENDENCIES
------------
For this package to work you must have installed at least perl,
cdrecord, mkisofs, and GNU tar.  To do remote backups, you'll also
need an ssh client.

For view compatibility table refer to the COMPLIANCE file.


INSTALLATION
------------
To install cdbkup, you must walk through two steps:

1. Configuring package.

   The GNU tar version 1.13 has a bug with --listed-incremental. This bug
   appears in Linux (Slackware 7, 8; other?).  See the COMPLIANCE file for
   more info.  You can work around the problem by applying the provided
   patch:

   $ patch < linuxtar_13.patch

   After this procedure you can configure whole package. In this step just
   type:

   $ ./configure

   for basic configuration.
   The configure script accepts the --with-snardir=DIR option. This DIR
   is a directory which will contain any *.snar and *.info files.  The
   user who makes backups must have write access to this directory.  For
   security reasons, this directory should not have read/write
   permissions for other.  You can define the user and group properties
   with the --with-dumper=USER and --with-dumpgrp=GROUP options. The
   default values are "root" and "operator" respectively.

   $ ./configure --with-snardir=/usr/home/iam/snarfiles \
       --with-dumper=iam --with-dumpgrp=mygroup


2. Installation.

   After configuration made just install package with root privileges:

   # make install

3. Enjoy!


GET CDBKUP
----------
You can get the cdbkup utility in three ways.

1. HTTP.
   http://cdbkup.sourceforge.net	- project main site 
   http://mishka.terabyte.com.ua	- mirror for releases (Ukraine, 10M/s)

2. FTP.
   ftp://batraq.anything3d.com		- ftp mirror (Ukraine, 56K/s)

3. CVS.
   cvs.cdbkup.sourceforge.net 		- Main CVS repository.

   Login as "anonymous" in "CVS pserver":
   $ cvs -d:pserver:anonymous@cvs.cdbkup.sourceforge.net:/cvsroot/cdbkup login 

   Next, do checkout with command:
   $ cvs -z3 [-r TAG] -d:pserver:anonymous@cvs.cdbkup.sourceforge.net:/cvsroot/cdbkup co cdbkup

   You can know available tags by browsing CVS repository at
   http://cvs.sourceforge.net/cgi-bin/viewcvs.cgi/cdbkup

   Updates can be made with following command:
   $ cvs -z3 [-r TAG] update -P -d

   Please refer to Cederqvist or CVS documentation page for learning more:
   http://www.cvshome.org/docs/


DEVELOPERS
----------
John-Paul Gignac <jp@gignac.org>
Mike M. Volokhov <mishka@terabyte.com.ua> 
