-
-
02 Jan 2005 11:51:47 UTC
- Distribution: Archive-Tar-Streamed
- Module version: 0.03
- Source (raw)
- Browse (raw)
- Changes
- How to Contribute
- Issues (4)
- Testers (1292 / 87 / 0)
- Kwalitee
Bus factor: 0- 94.44% Coverage
- License: unknown
- Activity
24 month- Tools
- Download (11.04KB)
- MetaCPAN Explorer
- Permissions
- Subscribe to distribution
- Permalinks
- This version
- Latest version
- Dependencies
- Archive::Tar
- Test::Simple
- and possibly others
- Reverse dependencies
- CPAN Testers List
- Dependency graph
NAME
Archive::Tar::Streamed - Tar archives, non memory resident
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 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
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
Module Install Instructions
To install Archive::Tar::Streamed, copy and paste the appropriate command in to your terminal.
cpanm Archive::Tar::Streamed
perl -MCPAN -e shell install Archive::Tar::Streamed
For more information on module installation, please visit the detailed CPAN module installation guide.