Dpkg::Archive::Ar(3perl)

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.