Permalink
..
Failed to load latest commit information.
debian Move from svn folder structure to git Jun 5, 2015
doc Include szdd_kwaj_format.html Nov 26, 2017
examples Move some programs from test/ into examples/ and src/ Aug 13, 2017
mspack Clarify that mspack_system.free() should accept and ignore NULL Aug 13, 2018
src Consistently use #if over #ifdef for the things config.h will always … Jul 28, 2018
test Work around ClamAV detecting cve-2015-4467-reset-interval-zero.chm as… Aug 9, 2018
.gitignore Move svn:ignore properties into .gitignore files Jun 5, 2015
AUTHORS It's Exchange Offline Address Book (OAB), not Outlook Address Book Aug 13, 2017
COPYING.LIB Move from svn folder structure to git Jun 5, 2015
ChangeLog Clarify that mspack_system.free() should accept and ignore NULL Aug 13, 2018
Makefile.am Work around ClamAV detecting cve-2015-4467-reset-interval-zero.chm as… Aug 9, 2018
NEWS Move from svn folder structure to git Jun 5, 2015
README Update README: repo is not Subversion any more Aug 13, 2018
TODO Move from svn folder structure to git Jun 5, 2015
acinclude.m4 Support MinGW32 one-arg mkdir() Aug 13, 2017
autogen.sh Add autogen.sh for people who want to autoreconf but not rebuild Aug 13, 2017
cleanup.sh Add autogen.sh for people who want to autoreconf but not rebuild Aug 13, 2017
configure.ac Bump version to v0.7.1alpha Aug 9, 2018
libmspack.pc.in Move from svn folder structure to git Jun 5, 2015
rebuild.sh Add autogen.sh for people who want to autoreconf but not rebuild Aug 13, 2017
winbuild.sh Move from svn folder structure to git Jun 5, 2015

README

libmspack 0.7.1alpha

The purpose of libmspack is to provide compressors and decompressors,
archivers and dearchivers for Microsoft compression formats: CAB, CHM, WIM,
LIT, HLP, KWAJ and SZDD. It is also designed to be easily embeddable,
stable, robust and resource-efficient.

The library is not intended as a generalised "any archiver" interface.
Users of the library must explicitly choose the format they intend to work
with.

All special features of the above formats will be covered as fully as
possible -- for example, CAB's multi-part cabinet sets, or CHM's fast
lookup indices. All compression methods used by the formats will be
implemented as completely as possible.

However, other than what is required for access to these formats and their
features, no other functionality is intended. There is no file metadata
translation functionality. All file I/O is abstracted, although a default
implementation using the standard C library is provided.


DOCUMENTATION

The API documentation is stored in the doc/ directory. It is generated
automatically from mspack.h with doxygen. It is also available online at
https://www.cabextract.org.uk/libmspack/doc/


BUILDING / INSTALLING

./configure
make
make install

This will install the main libmspack library and mspack.h header file.
Some other libraries and executables are built, but not installed.

If building from the Git repository, running rebuild.sh will create all the
auto-generated files, then run ./configure && make. Running cleanup.sh will
perform a thorough clean, deleting all auto-generated files.

In addition to gcc, you also need the following for building from repository:

- at least autoconf 2.57
- at least automake 1.7
- libtool

This is an alpha release. Unless you are in a position to package the
libmspack library for the environment you intend to run your application,
it is recommended that you do not rely on users of your software having
the binary library installed and instead you should include the libmspack
source files directly in your application's build environment.


LEGAL ISSUES

To the best of my knowledge, libmspack does not infringe on any
compression or decompression patents. However, this is not legal
advice, and it is recommended that you perform your own patent search.

libmspack is licensed under the LGPL - see COPYING.LIB in this directory.

The LGPL requires you to build libmspack as a stand alone library then link
your code to it using a linker. I personally grant you some extra rights:
you can incorporate libmspack's source code wholly or partially in your own
code, without having to build and link libmspack as an independent library,
provided you meet ALL of the following conditions:

1. ANY modifications to the existing libmspack source code are published and
   distributed under the LGPL license.
2. You MUST NOT use libmspack function calls, structures or definitions unless
   they are defined in the public library interface "mspack.h".
3. When distributing your code, you MUST make clear your code uses libmspack,
   and either include the full libmspack distribution with your code, or
   provide access to it as per clause 4 of the LGPL.

EXAMPLE CODE

libmspack is bundled with programs which demonstrate the library's features.

examples/cabd_memory.c - an mspack_system that can read and write to memory
examples/multifh.c     - an mspack_system that can simultaneously work on
                         in-memory images, raw file descriptors, open file
                         handles and regular disk files

src/cabrip.c           - extracts any CAB files embedded in another file
src/chmextract.c       - extracts all files in a CHM file to disk
src/msexpand.c         - expands an SZDD or KWAJ file
src/oabextract.c       - extracts an Exchange Offline Address Book (.LZX) file

test/cabd_c10          - tests the CAB decompressor on the C10 collection
test/cabd_compare      - compares libmspack with Microsoft's EXTRACT.EXE
test/cabd_md5          - shows MD5 checksums of all files in a CAB file/set
test/cabd_test.c       - regression tests for libmspack's CAB decompression
test/chmd_compare      - compares libmspack with Microsoft's HH.EXE
test/chmd_find.c       - fast-finds a file within a CHM file.
test/chmd_md5.c        - shows MD5 checksums of all files within a CHM file
test/chmd_order.c      - extracts files in a CHM file in four different ways
test/chmd_test.c       - regression tests for libmspack's CHM decompression
test/kwajd_test.c      - regression tests for libmspack's KWAJ decompression
test/chminfo.c         - prints verbose information about CHM file structures
test/msdecompile_md5   - runs Microsoft's HH.EXE -DECOMPILE via WINE
test/msextract_md5     - runs Microsoft's EXTRACT.EXE via WINE

Here is a simple example of usage, which will create a CAB decompressor,
then use that to open an existing Microsoft CAB file called "example.cab",
and list the names of all the files contained in that cab.

#include <stdio.h>
#include <unistd.h>
#include <mspack.h>

int main() {
  struct mscab_decompressor *cabd;
  struct mscabd_cabinet *cab;
  struct mscabd_file *file;
  int test;

  MSPACK_SYS_SELFTEST(test);
  if (test != MSPACK_ERR_OK) exit(0);

  if ((cabd = mspack_create_cab_decompressor(NULL))) {
    if ((cab = cabd->open(cabd, "example.cab"))) {
      for (file = cab->files; file; file = file->next) {
        printf("%s\n", file->filename);
      }
      cabd->close(cabd, cab);
    }
    mspack_destroy_cab_decompressor(cabd);
  }
  return 0;
}