This is the git repository for LibTomMath, a free open source portable number theoretic multiple-precision integer (MPI) library written entirely in C.
API/ABI changes: check here
develop branch contains the in-development version. Stable releases are tagged.
Documentation is built from the LaTeX file
bn.tex. There is also limited documentation in
There is also a document,
tommath.pdf, which describes the goals of the project and many of the algorithms used.
The project can be build by using
make. Along with the usual
make clean and
there are several other build targets, see the makefile for details.
There are also makefiles for certain specific platforms.
Tests are located in
demo/ and can be built in two flavors.
make testcreates a stand-alone test binary that executes several test routines.
make mtest_opponentcreates a test binary that is intended to be run against
mtestcan be built with
make mtestand test execution is done like
./mtest/mtest | ./mtest_opponent.
mtestis creating test vectors using an alternative MPI library and
testis consuming these vectors to verify correct behavior of ltm
Building is straightforward for GNU Linux only, the section "Building LibTomMath" in the documentation in
doc/bn.pdf has the details.
The project provides support for the CMake build system.
git clone https://github.com/libtom/libtommath.git mkdir -p libtommath/build cd libtommath/build cmake .. make -j$(nproc)
A shared library build can be done by setting
-DBUILD_SHARED_LIBS=On when invoking the