view release on metacpan or  search on metacpan

README  view on Meta::CPAN

NAME

    Alien::Libarchive - Build and make available libarchive

VERSION

    version 0.28

SYNOPSIS

    Build.PL

     use Alien::Libarchive;
     use Module::Build;
     
     my $alien = Alien::Libarchive->new;
     my $build = Module::Build->new(
       ...
       extra_compiler_flags => [$alien->cflags],
       extra_linker_flags   => [$alien->libs],
       ...
     );
     
     $build->create_build_script;

    Makefile.PL

     use Alien::Libarchive;
     use ExtUtils::MakeMaker;
     
     my $alien = Alien::Libarchive;
     WriteMakefile(
       ...
       CCFLAGS => scalar $alien->cflags,
       LIBS    => [$alien->libs],
     );

    FFI::Platypus

     use Alien::Libarchive;
     use FFI::Platypus;
     
     my $ffi = FFI::Platypus->new(lib => [Alien::Libarchive->new->dlls]);
     $ffi->attach( archive_read_new => [] => 'opaque' );

DESCRIPTION

    This distribution installs libarchive so that it can be used by other
    Perl distributions. If already installed for your operating system, and
    it can be found, this distribution will use the libarchive that comes
    with your operating system, otherwise it will download it from the
    Internet, build and install it.

    If you set the environment variable ALIEN_LIBARCHIVE to 'share', this
    distribution will ignore any system libarchive found, and build from
    source instead. This may be desirable if your operating system comes
    with a very old version of libarchive and an upgrade path for the
    system libarchive is not possible.

    For partial compatibility with Alien::Base, this distribution will also
    honor the ALIEN_FORCE environment variable. Setting ALIEN_BASE to a
    true value is the same as setting ALIEN_LIBARCHIVE to 'share'.

 Requirements

  operating system install

    The development headers and libraries for libarchive

    Debian

      On Debian you can install these with this command:

       % sudo apt-get install libarchive-dev

    Cygwin

      On Cygwin, make sure that this package is installed

       libarchive-devel

    FreeBSD

      libarchive comes with FreeBSD as of version 5.3.

  from source install

    A C compiler and any prerequisites for building libarchive.

    Debian

      On Debian build-essential should be good enough:

       % sudo apt-get install build-essential

    Cygwin

      On Cygwin, I couldn't get libarchive to build without making a minor
      tweak to one of the include files. On Cygwin this module will patch
      libarchive before it attempts to build if it is version 3.1.2.

METHODS

 cflags