mirror of
https://github.com/facebook/rocksdb.git
synced 2024-12-04 11:03:22 +00:00
0a4cdde50a
Summary: introduce new methods into a public threadpool interface, - allow submission of std::functions as they allow greater flexibility. - add Joining methods to the implementation to join scheduled and submitted jobs with an option to cancel jobs that did not start executing. - Remove ugly `#ifdefs` between pthread and std implementation, make it uniform. - introduce pimpl for a drop in replacement of the implementation - Introduce rocksdb::port::Thread typedef which is a replacement for std::thread. On Posix Thread defaults as before std::thread. - Implement WindowsThread that allocates memory in a more controllable manner than windows std::thread with a replaceable implementation. - should be no functionality changes. Closes https://github.com/facebook/rocksdb/pull/1823 Differential Revision: D4492902 Pulled By: siying fbshipit-source-id: c74cb11
57 lines
2 KiB
C++
57 lines
2 KiB
C++
// Copyright (c) 2011-present, Facebook, Inc. All rights reserved.
|
|
// This source code is licensed under the BSD-style license found in the
|
|
// LICENSE file in the root directory of this source tree. An additional grant
|
|
// of patent rights can be found in the PATENTS file in the same directory.
|
|
//
|
|
// Copyright (c) 2011 The LevelDB Authors. All rights reserved.
|
|
// Use of this source code is governed by a BSD-style license that can be
|
|
// found in the LICENSE file. See the AUTHORS file for names of contributors.
|
|
#pragma once
|
|
|
|
#include <functional>
|
|
|
|
namespace rocksdb {
|
|
|
|
/*
|
|
* ThreadPool is a component that will spawn N background threads that will
|
|
* be used to execute scheduled work, The number of background threads could
|
|
* be modified by calling SetBackgroundThreads().
|
|
* */
|
|
class ThreadPool {
|
|
public:
|
|
virtual ~ThreadPool() {}
|
|
|
|
// Wait for all threads to finish.
|
|
// Discard those threads that did not start
|
|
// executing
|
|
virtual void JoinAllThreads() = 0;
|
|
|
|
// Set the number of background threads that will be executing the
|
|
// scheduled jobs.
|
|
virtual void SetBackgroundThreads(int num) = 0;
|
|
|
|
// Get the number of jobs scheduled in the ThreadPool queue.
|
|
virtual unsigned int GetQueueLen() const = 0;
|
|
|
|
// Waits for all jobs to complete those
|
|
// that already started running and those that did not
|
|
// start yet. This ensures that everything that was thrown
|
|
// on the TP runs even though
|
|
// we may not have specified enough threads for the amount
|
|
// of jobs
|
|
virtual void WaitForJobsAndJoinAllThreads() = 0;
|
|
|
|
// Submit a fire and forget jobs
|
|
// This allows to submit the same job multiple times
|
|
virtual void SubmitJob(const std::function<void()>&) = 0;
|
|
// This moves the function in for efficiency
|
|
virtual void SubmitJob(std::function<void()>&&) = 0;
|
|
|
|
};
|
|
|
|
// NewThreadPool() is a function that could be used to create a ThreadPool
|
|
// with `num_threads` background threads.
|
|
extern ThreadPool* NewThreadPool(int num_threads);
|
|
|
|
} // namespace rocksdb
|