commit	fffc22c7303b3c856f6054fbb06a3ebca6469ed4	[log] [tgz]
author	Android Build Coastguard Worker <[email protected]>	Fri Jul 07 04:42:14 2023 +0000
committer	Android Build Coastguard Worker <[email protected]>	Fri Jul 07 04:42:14 2023 +0000
tree	133c7c54d940a2d0a09df511d71608a9a6cf0391
parent	0eb4cfe6c8b478413ddfbe6020bdb8b63bc19cb1 [diff]
parent	99ba05775fae7b9f7c16d54ea8a2b24b75595cfe [diff]

tree: 133c7c54d940a2d0a09df511d71608a9a6cf0391

README.md

pthreadpool

pthreadpool is a portable and efficient thread pool implementation. It provides similar functionality to #pragma omp parallel for, but with additional features.

Features:

C interface (C++-compatible).
1D-6D loops with step parameters.
Run on user-specified or auto-detected number of threads.
Work-stealing scheduling for efficient work balancing.
Wait-free synchronization of work items.
Compatible with Linux (including Android), macOS, iOS, Windows, Emscripten environments.
100% unit tests coverage.
Throughput and latency microbenchmarks.

Example

The following example demonstates using the thread pool for parallel addition of two arrays:

static void add_arrays(struct array_addition_context* context, size_t i) {
  context->sum[i] = context->augend[i] + context->addend[i];
}

#define ARRAY_SIZE 4

int main() {
  double augend[ARRAY_SIZE] = { 1.0, 2.0, 4.0, -5.0 };
  double addend[ARRAY_SIZE] = { 0.25, -1.75, 0.0, 0.5 };
  double sum[ARRAY_SIZE];

  pthreadpool_t threadpool = pthreadpool_create(0);
  assert(threadpool != NULL);

  const size_t threads_count = pthreadpool_get_threads_count(threadpool);
  printf("Created thread pool with %zu threads\n", threads_count);

  struct array_addition_context context = { augend, addend, sum };
  pthreadpool_parallelize_1d(threadpool,
    (pthreadpool_task_1d_t) add_arrays,
    (void*) &context,
    ARRAY_SIZE,
    PTHREADPOOL_FLAG_DISABLE_DENORMALS /* flags */);

  pthreadpool_destroy(threadpool);
  threadpool = NULL;

  printf("%8s\t%.2lf\t%.2lf\t%.2lf\t%.2lf\n", "Augend",
    augend[0], augend[1], augend[2], augend[3]);
  printf("%8s\t%.2lf\t%.2lf\t%.2lf\t%.2lf\n", "Addend",
    addend[0], addend[1], addend[2], addend[3]);
  printf("%8s\t%.2lf\t%.2lf\t%.2lf\t%.2lf\n", "Sum",
    sum[0], sum[1], sum[2], sum[3]);

  return 0;
}