NAME
    Alien::Win32::LZMA - Install and make available lzma.exe

DESCRIPTION
    On Windows (unlike on Unix systems) the primary mechanism for accessing
    LZMA functionality is via the 7-Zip desktop application.

    Alien::Win32::LZMA is a simple Alien module which embeds a copy of the
    lzma.exe command line utility for use in situations where the
    memory-only compression and decompression provided by the current
    generation of modules is not sufficient.

    The version of lzma.exe provided by this module is taken from the LZMA
    SDK 4.65 at <http://downloads.sourceforge.net/sevenzip/lzma465.tar.bz2>.

FUNCTIONS
  lzma_exe
    The "lzma_exe" function returns the location of the installed lzma.exe
    command line application as a string.

  lzma_version
    The "lzma_version" function runs lzma.exe and finds the version of the
    application. It should match the version of this module.

  lzma_compress
      lzma_compress('file', 'file.lz') or die('Failed to compress');

    The "lzma_compress" function invokes lzma.exe to compress one file into
    another file.

    Any additional params to "lzma_compress" will be passed through to the
    underlying command line call as options.

    Returns true if the invocation returns without error.

  lzma_decompress
      lzma_decompress('file','file.lz') or die('Failed to decompress');

    The "lzma_decompress" function invokes lzma.exe to decompress an LZMA
    file into another file.

    Any additional params to "lzma_compress" will be passed through to the
    underlying command line call as options.

    Returns true if the invocation returns without error.

SUPPORT
    Bugs should be reported via the CPAN bug tracker at

    <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Alien-Win32-LZMA>

    For other issues, contact the author.

AUTHOR
    Adam Kennedy <adamk@cpan.org>

SEE ALSO
    Compress::umLZMA

COPYRIGHT
    Copyright 2009 Adam Kennedy.

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

    The full text of the license can be found in the LICENSE file included
    with this module.

    The LZMA SDK is written and placed in the public domain by Igor Pavlov.