NAME
    Alien::Libarchive - Build and make available libarchive

VERSION
    version 0.04

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->new;
     WriteMakefile(
       ...
       CFLAGS => Alien::Libarchive->cflags,
       LIBS   => Alien::Libarchive->libs,
     );

    FFI

     use Alien::Libarchive;
     use FFI::Sweet qw( ffi_lib );
 
     ffi_lib(Alien::Libarchive->new->libs);

DESCRIPTION
    This distribution installs libarchive so that it can be used by other
    Perl distributions. If already installed for your operating system, and
    if it can find it, 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.

  Requirements
   operating system install
    The development headers and libraries for libarchive

    On Debian you can install these with this command:

     % sudo apt-get install libarchive-dev

    libarchive comes with FreeBSD as of version 5.3.

   from source install
    A C compiler and any prerequisites for building libarchive.

METHODS
  cflags
    Returns the C compiler flags necessary to build against libarchive.

  libs
    Returns the library flags necessary to build against libarchive.

CAVEATS
    Native windows support is completely missing at the moment. It should in
    theory be possible to install in a cygwin environment. However, I just
    tried it and it did not work. Debian Linux and FreeBSD (9.0) have been
    tested in development of this distribution.

    Patches to improve portability and platform support would be eagerly
    appreciated.

    If you reinstall this distribution, you may need to reinstall any
    distributions that depend on it as well.

SEE ALSO
    Archive::Libarchive::XS
    Archive::Libarchive::FFI

AUTHOR
    Graham Ollis <plicease@cpan.org>

COPYRIGHT AND LICENSE
    This software is copyright (c) 2013 by Graham Ollis.

    This is free software; you can redistribute it and/or modify it under
    the same terms as the Perl 5 programming language system itself.

