Archive::Tar::Streamed

Archive::Tar::StreameUser Contributed Perl DocumentaArchive::Tar::Streamed(3)



SYNOPSIS
	 use Archive::Tar::Streamed;

	 my $fh;
	 open $fh,’>’,’/home/myarch.tar’ or die "Couldn’t create archive";
	 binmode $fh;
	 my $tar = Archive::Tar::Streamed->new($fh);
	 $tar->add(’file1’);
	 $tar->add(@files);

	 my $fh2l
	 open $fh2,’<’,’prevarch.tar’ or die "Couldn’t open archive";
	 binmode $fh;
	 my $tar2 = Archive::Tar::Streamed->new($fh2);
	 my $fil = $tar2->next;

DESCRIPTION
       The Archive::Tar module is a powerfull tool for manipulating archives
       from perl. However, most of the time, this module needs the entire
       archive to be resident in memory. This renders the module per se, not
       to be directly usable for very large archive (of the order of giga-
       bytes).

       Archive::Tar::Streamed provides a wrapper, which allows working with
       tar archives on disk, with no need for the archive to be memory resi-
       dent.

       This module provides an alternative answer to the FAQ "Isn’t
       Archive::Tar heavier on memory than /bin/tar?". It also aims to be
       portable, and available on platforms without a native tar.

       add

       This is a method call to add one or more files to an archive. These
       are written to disk before the method returns.

       next

       This method is an iterator, which returns an Archive::Tar::File object
       for the next file, or undef. undef indicates the end of the archive;
       any unexpected conditions result in throwing an exception.

BUGS
       Please use http://rt.cpan.org to report any bugs in this module

AUTHOR
	       I. Williams
	       bitumen@xemaps.com

COPYRIGHT
       This program is free software; you can redistribute it and/or modify
       it under the same terms as Perl itself.

       The full text of the license can be found in the LICENSE file included
       with this module.

SEE ALSO
       Archive::Tar



perl v5.8.8			  2005-01-02	    Archive::Tar::Streamed(3)