Gitiles
Code Review Sign In
gerrit-public.fairphone.software / platform / external / pthreadpool / 1d0afb83a3f01b1aa0c9c0d618edc58032744d3c
commit1d0afb83a3f01b1aa0c9c0d618edc58032744d3c[log] [tgz]
authorXin Li <delphij@google.com>Thu Aug 27 18:30:06 2020 +0000
committerAutomerger Merge Worker <android-build-automerger-merge-worker@system.gserviceaccount.com>Thu Aug 27 18:30:06 2020 +0000
treebdff5f4a93033f04736f1ff8780f11f96c44e31f
parentaeabd9ff7536891d2a259bbea74b87af40a34867 [diff]
parent489a5572dc69e02dd689a71e8830be854a83f0cd [diff]
[automerger skipped] Mark Android R (rvc-dev-plus-aosp-without-vendor@6692709) as merged am: 489a5572dc -s ours

am skip reason: Change-Id Ibf95a97ebd77a6d52525f61ff5296a789fcdc011 with SHA-1 608343ca3e is in history

Original change: https://googleplex-android-review.googlesource.com/c/platform/external/pthreadpool/+/12469872

Change-Id: I0f7109050521e41d9b6ff8ee5eae92f76463db13
tree: bdff5f4a93033f04736f1ff8780f11f96c44e31f
  1. bench/
  2. cmake/
  3. examples/
  4. include/
  5. src/
  6. test/
  7. .gitignore
  8. .travis.yml
  9. Android.bp
  10. BUILD.bazel
  11. CMakeLists.txt
  12. configure.py
  13. confu.yaml
  14. LICENSE
  15. METADATA
  16. MODULE_LICENSE_BSD
  17. OWNERS
  18. README.md
  19. TEST_MAPPING
  20. WORKSPACE
README.md

pthreadpool

BSD (2 clause) License Build Status

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;
}