Decompress SAPCAR archives https://github.com/VirtualForgeGmbH/hascar
|Latest on Hackage:||0.2.2.1|
This package is not currently in any snapshots. If you're interested in using it, we recommend adding it to Stackage Nightly. Doing so will make builds more reliable, and allow stackage.org to host generated Haddocks.
What is hascar?
HASCAR is a free unzip utility for SAP’s SAPCAR format. You can use it to decompress sap car files on the command line. The command line utility also supports unwrapping of transport files that are contained inside patch files. (Option -p, –depat) You can also use it as a library in your own haskell programs. So far, only the latest version of sapcar files are is supported, which is 2.01.
It is implemented 100% in haskell, including the lzh decompression routine.
This is not yet in a stable state. It should successfully unpack lzh compressed files and uncompressed files.
The SAPCAR container format decoder is based on research done by Martin Gallo with further investigation by Hans-Christian Esperer email@example.com, who also did the LZH decompressor reimplementation.
What is supported:
- Reading SAPCAR archives version 2.01 only
- Unpacking files that are LZH compressed
- Unpacking files that are not compressed
- Unpacking transport files are wrapped inside a PAT file
- Implement LZC
- Implement packing functionality
- Maybe implement signature checking
- Make the LZH algorithm more efficient (the author just about started to learn haskell when he embarked on implementing that algorithm :-) => Some work on this has been done; more is required.
- Implement CRC checking
Users of nixos can simply install hascar by issuing “nix-env -iaP haskellPackages.hascar”. Or if you only need it temporarily, open a nix-shell like this: “nix-shell -p haskellPackages.hascar”
To compile and install, first get stack, then issue:
stack build && stack install
hascar will be installed to ~/.local/bin . You should set your PATH variable to point to this directory.
Verifying signatures and encrypted archives
Since both use a proprietary crypto API, this is currently not supported.
Run hascar with the -h flag to get help. The basic usage should be the same as with SAP(R)’s sapcar tool. It should be noted that the used command line parser is a bit more strict than what you might be used to.
Extracting transport files from PAT files
SAR files can contain transport files that are wrapped inside PAT (patch) files. Since hascar 0.2.2.0 the option -p is offered, that will try to automatically detect PAT files. If such a file is detected, the contained transport file is extracted.
- When unwrapping transport files from PAT files, name the transport files properly
- Add an option to specify the extraction directory (default: CWD)
- Add an option to extract transport files from PAT files automatically
- Remove version constraints, rely on stack/nixos instead for dependency management
- Make it compile with ghc-8.0.2
- Make “SapCar” a real type instead of a type synonym
- Use the type system to prevent “CarEntry”s to escape the monad
- Use ST unboxed arrays instead of Data.Sequence and avoid usage of “temporary lists” during conversion to ByteStrings
- Add a parameter “size” to the decompressBlock function for more efficiency
- Rename the decompressBlock function to decompressBlocks for clarity
- Limit the maximum SAPCAR block size to make memory exhaustion attacks a bit less easy
- Compile the application single threadedly for more efficiency (yes, it does help in this case!)
- Expose the decompressBlock function directly