Archive::Tar::Streamed - Tar archives, non memory resident


Archive-Tar-Streamed documentation  | view source Contained in the Archive-Tar-Streamed distribution.

Index


SYNOPSIS

Top

  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

Top

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 gigabytes).

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

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

Top

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

AUTHOR

Top

	I. Williams
	bitumen@xemaps.com

COPYRIGHT

Top

SEE ALSO

Top

Archive::Tar


Archive-Tar-Streamed documentation  | view source Contained in the Archive-Tar-Streamed distribution.