Numstore

Build and Link the C Library

Numstore is a C11 library with one public header, libs/numstore/include/numstore.h, and a set of static archives that you link together. There are no dependencies beyond libc, pthreads and libm.

Build

Build the library out of the repository:

git clone https://github.com/NumstoreDB/Numstore
cd Numstore
cmake -S . -B build/release -DCMAKE_BUILD_TYPE=Release
cmake --build build/release

That leaves you with nine archives in build/release/lib/ and the samples in build/release/bin/. libns_numstore.a is the public API; the rest are the layers under it. For a debug build, use -B build/debug -DCMAKE_BUILD_TYPE=Debug instead.

Install the library, then compile your program against it:

cmake --install build/release --prefix "$HOME/.local"
export PKG_CONFIG_PATH="$HOME/.local/lib/pkgconfig"
cc -std=c11 myprog.c $(pkg-config --cflags --libs numstore) -o myprog

The install puts the header, the nine archives and numstore.pc under the prefix. pkg-config hands back the include path and the archives in link order, plus -pthread -lm on Linux.

From CMake, point at the checkout and link the exported target. The include directory and the other archives come with it:

cmake_minimum_required(VERSION 3.20)
project(myapp C)

add_subdirectory(Numstore)

add_executable(myapp main.c)
target_link_libraries(myapp PRIVATE numstore::numstore)

cmake --install build/release --prefix /usr/local installs the archives, the header and a CMake package if you would rather link against a system path. A project that uses the installed copy calls find_package (numstore) and links the same numstore::numstore target.

Next steps