The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

Archive::Par - use & manipulate par files

SYNOPSIS

  use Archive::Par qw( $PACKAGE $VERSION );

DESCRIPTION

CLASS CONSTANTS

CLASS COMPONENTS

CLASS HIGHER-LEVEL FUNCTIONS

CLASS HIGHER-LEVEL PROCEDURES

INSTANCE CONSTRUCTION

new

Create & return a new thing.

INSTANCE COMPONENTS

INSTANCE HIGHER-LEVEL FUNCTIONS

files

PRECONDITION
  $self->checked
ARGUMENTS

None

RETURNS
files

List of files known by par, by their names as par believes they should be.

files

PRECONDITION
  $self->checked
ARGUMENTS

None

RETURNS
files

List of files known by par, by their names as found on the filesystem. Files not found are not included in the list. File names are prefixed by the directory portion of the par filename, so -e should work.

file_known

PRECONDITION
  $self->checked
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
known

Whether this file name is known by par.

file_found

PRECONDITION
  $self->file_known($fn)
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
found

Whether this file name is found by par.

file_restorable

PRECONDITION
  $self->file_known($fn)
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
found

Whether this file name is thought by par to be restorable.

file_moved

PRECONDITION
  $self->file_known($fn)
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
found

The name this file has apparently moved to as per par; undef if the file has not moved.

file_ok

PRECONDITION
  $self->file_known($fn)
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
found

Whether this file name is thought by par to be in tip-top condition.

file_corrupt

PRECONDITION
  $self->file_known($fn)
ARGUMENTS
fn

Name of file to look up. This is the name as expected by par, not any suitable substitute found by par.

RETURNS
found

Whether this file name is thought by par to be corrupt

file_recoverable

PRECONDITION
  ! $self->file_ok($fn)
ARGUMENTS
fn
RETURNS

Whether the file may be regenerated somehow

recoverable

PRECONDITIONS
  $self->checked

  ! $self->ok
ARGUMENTS

None

RETURNS
recoverable

true if the files can be recovered, false if not

dump_file_status

Convenience method for returning status of files in par.

checked

ARGUMENTS

None

RETURNS
checked

Whether the status flags for this instance are meaningful.

ok

PRECONDITIONS
  $self->checked
ARGUMENTS

None

RETURNS
ok

True if there are no fixes for par to make.

INSTANCE HIGHER-LEVEL PROCEDURES

restore

PRECONDITIONS
  $self->recoverable
ARGUMENTS
remove_old_files

Optional If true, remove (corrupt) old files created by the restore.

EXAMPLES

BUGS

REPORTING BUGS

Email the author.

AUTHOR

Martyn J. Pearce fluffy@cpan.org

COPYRIGHT

Copyright (c) 2002 Martyn J. Pearce. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

SEE ALSO