// Copyright (c) 2021 PaddlePaddle Authors. All Rights Reserved. // // Licensed under the Apache License, Version 2.0 (the "License"); // you may not use this file except in compliance with the License. // You may obtain a copy of the License at // // http://www.apache.org/licenses/LICENSE-2.0 // // Unless required by applicable law or agreed to in writing, software // distributed under the License is distributed on an "AS IS" BASIS, // WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. // See the License for the specific language governing permissions and // limitations under the License. #pragma once #include #include #include namespace paddle { namespace framework { struct WorkQueueOptions { size_t num_threads{0}; bool allow_spinning{true}; bool track_task{false}; }; class WorkQueue { public: explicit WorkQueue(const WorkQueueOptions& options) : options_(options) {} WorkQueue(const WorkQueue&) = delete; WorkQueue& operator=(const WorkQueue&) = delete; virtual ~WorkQueue() = default; virtual void AddTask(std::function fn) = 0; // set WorkQueueOptions.track_task = true before call this // interface, otherwise will abort() virtual void WaitQueueEmpty() = 0; virtual size_t NumThreads() const = 0; protected: WorkQueueOptions options_; }; class WorkQueueGroup { public: explicit WorkQueueGroup(const std::vector& queues_options) : queues_options_(queues_options) {} WorkQueueGroup(const WorkQueueGroup&) = delete; WorkQueueGroup& operator=(const WorkQueueGroup&) = delete; virtual ~WorkQueueGroup() = default; virtual void AddTask(size_t queue_idx, std::function fn) = 0; // set WorkQueueOptions.track_task = true for at least one of queues // before call this interface, otherwise will abort() virtual void WaitQueueGroupEmpty() = 0; virtual size_t QueueNumThreads(size_t queue_idx) const = 0; virtual size_t QueueGroupNumThreads() const = 0; protected: std::vector queues_options_; }; std::unique_ptr CreateSingleThreadedWorkQueue( const WorkQueueOptions& options); std::unique_ptr CreateMultiThreadedWorkQueue( const WorkQueueOptions& options); std::unique_ptr CreateWorkQueueGroup( const std::vector& queues_options); } // namespace framework } // namespace paddle