linD026 / mthpc

Multiple Threads, Parallelism and Concurrency Library (MTHPC)

mthpc

mthpc is parallelism and concurrency library for C language. It targets to improve the parallel and concurrent part of userspace C. mthpc provides the thread framework, asynchronous worker (deferred work), synchronous mechanisms, and some concurrent data structures. mthpc is based on C11 Atomics and POSIX Threads.

Build

To build the mthpc library, use the following commands.

make build          # Build the library and headers in mthpc directory
make lib            # Build the library only
make clean          # Delete generated files

The default building will generate the dynamic library. If you want to generate the static library, add the paramter static=1.

---

Features

The mthpc library provides the synchronous mechanisms, concurrncy data structures, and more. See all the features in api.md.

---

Development

For the development, the mthpc library provides the Makefile paramter, debug=1, to verify the action in runtime.

All the featues have the test program(s) in their own directory, for example, rcu feature has new_test.c and test.c in src/rcu/. And, we can run the test program(s) with the command, bash script.sh.

Compare with urcu

Before running the benchmark, we need the userspace-rcu lib.

We run 100 readers and single writer. And, the hardware is i7-8750H with 6 cores.

# Source: tests/urcu-benchmark/logs/log-test-urcu-timing-2023-04-19

## urcu

Time per read : 596.663 cycles
Time per write : 6.25778e+07 cycles

## mthpc

Time per read : 569.977 cycles
Time per write : 6.91447e+07 cycles