NAME

CBAIS::Actions::Pkg - tar archive and graft based package versioning


SYNOPSIS


DESCRIPTION

The CBAIS::Actions::Pkg class impements a CBAIS Action which installs tar archive contents, and optionally supports the graft package versioning system.

The constructor supports the following keys

FILE
The name of the tar archive to unpack. May be compressed.

=item B<UNPACK_DIR>

The directory to unpack the tar archive in.

GRAFT (optional)
If defined and set to the value 'yes', specifies that the directory tree unpacked from this tar archive should be grafted. See graft.

GRAFT_OPTIONS (optional - implies GRAFT=yes)
Defines any special graft options. This option implies GRAFT=yes.


CONFIG FILE EXAMPLES

{ file => 'apache-1.3.14.tgz', unpack_dir => '/usr/local/pkgs', graft => 'yes', graft_options => '-t /usr/local/mail', },

{ file => 'mytar.tgz', unpack_dir => '/home/mydir', },


ASSUMPTIONS

The current version relies on the contents of a tarball being in a directory tree with a top level directory which is the same name as the tar file without the tar/gzip extension. This limitation will be rmeoved in future releases which will use the Archive::Tar library to do some intelligent parsing of the tar archive to provide a more robust implementation of the undo and verify methods.