NAME

Dpkg::Archive::Ar - Unix ar archive support

DESCRIPTION

This module provides a class to handle Unix ar archives. It support the common format, with no GNU or BSD extensions.

Note: This is a private module, its API can change at any time.

METHODS

$ar = Dpkg::Archive::Ar->new(%opts)

Create a new object to handle Unix ar archives.

Supported options are:

filename

The filename for the archive to open or create.

create

A boolean denoting whether the archive should be created, otherwise if it does not exist the constructor will not open, create or scan it.

$ar->create_archive($filename)

Create the archive.

$ar->open_archive($filename)

Open the archive.

$ar->parse_magic()

Reads and parses the archive magic string, and validates it.

$ar->parse_member()

Reads and parses the archive member and tracks it for later handling.

$ar->skip_member($member)

Skip this member to the next one. Get the value of a given substitution.

$ar->scan_archive()

Scan the archive for all its member files and metadata.

$ar->get_members()

Get the list of members in the archive.

$ar->extract_member($member)

Extract the specified member to the current directory.

$ar->write_member($member)

Write the provided $member into the archive.

$ar->add_file($filename)

Append the specified $filename into the archive.

$ar->close_archive()

Close the archive and release any allocated resource.

CHANGES

Version 0.xx

This is a private module.