What is mchecksum?

MChecksum is a generic checksum library.

Please see the accompanying LICENSE.txt file for license details.

Supported platforms

Linux / MacOS

Documentation

Please see the documentation available on the mercury website
for a quick introduction to mchecksum.

Software requirements

CRC32 and Adler32 checksums require ZLIB.
CRC32C can be used with or without HW acceleration — SSE4.2 acceleration
requires the SSE4.2 instruction set to be supported by the CPU. Improved
performance can also be achieved using the Intel(R) ISA-L library but
requires the PCLMULQDQ instruction to be supported.

Building

If you install the full sources, put the tarball in a directory where you
have permissions (e.g., your home directory) and unpack it:

gzip -cd mchecksum-X.tar.gz | tar xvf -

bzip2 -dc mchecksum-X.tar.bz2 | tar xvf -

Replace 'X' with the version number of the package.

MChecksum makes use of the CMake build-system and requires that you do an
out-of-source build. In order to do that, you must create a new build
directory and run the ccmake command from it:

cd mchecksum-X
mkdir build
cd build
ccmake .. (where ".." is the relative path to the mchecksum-X directory)

Type 'c' multiple times and choose suitable options. Recommended options are:

BUILD_SHARED_LIBS                ON (or OFF if the library you link
                                 against requires static libraries)
BUILD_TESTING                    ON
CMAKE_INSTALL_PREFIX             /path/to/install/directory
MCHECKSUM_USE_ISAL               OFF (Optional)
MCHECKSUM_USE_SSE4_2             ON
MCHECKSUM_USE_ZLIB               OFF (Optional)

Setting include directory and library paths may require you to toggle to
the advanced mode by typing 't'. Once you are done and do not see any
errors, type 'g' to generate makefiles. Once you exit the CMake
configuration screen and are ready to build the targets, do:

make

(Optional) Verbose compile/build output:

This is done by inserting VERBOSE=1 in the make command. E.g.:

make VERBOSE=1

Installing

Assuming that the CMAKE_INSTALL_PREFIX has been set (see previous step)
and that you have write permissions to the destination directory, do
from the build directory:

make install

Testing

CTest is used to run the tests, simply run from the build directory:

ctest .

(Optional) Verbose testing:

This is done by inserting -V in the ctest command. E.g.:

ctest -V .

Extra verbose information can be displayed by inserting -VV. E.g.:

ctest -VV .