oracular (3) Dpkg::Archive::Ar.3perl.gz

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.