cuda_stream_pool.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020-2021, NVIDIA CORPORATION.
3  *
4  * Licensed under the Apache License, Version 2.0 (the "License");
5  * you may not use this file except in compliance with the License.
6  * You may obtain a copy of the License at
7  *
8  * http://www.apache.org/licenses/LICENSE-2.0
9  *
10  * Unless required by applicable law or agreed to in writing, software
11  * distributed under the License is distributed on an "AS IS" BASIS,
12  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13  * See the License for the specific language governing permissions and
14  * limitations under the License.
15  */
16 
17 #pragma once
18 
19 #include <rmm/cuda_stream.hpp>
20 #include <rmm/cuda_stream_view.hpp>
21 #include <rmm/detail/error.hpp>
22 
23 #include <atomic>
24 #include <cstddef>
25 #include <vector>
26 
27 namespace rmm {
43  public:
44  static constexpr std::size_t default_size{16};
45 
52  explicit cuda_stream_pool(std::size_t pool_size = default_size) : streams_(pool_size)
53  {
54  RMM_EXPECTS(pool_size > 0, "Stream pool size must be greater than zero");
55  }
56  ~cuda_stream_pool() = default;
57 
59  cuda_stream_pool(cuda_stream_pool const&) = delete;
60  cuda_stream_pool& operator=(cuda_stream_pool&&) = delete;
61  cuda_stream_pool& operator=(cuda_stream_pool const&) = delete;
62 
71  {
72  return streams_[(next_stream++) % streams_.size()].view();
73  }
74 
85  rmm::cuda_stream_view get_stream(std::size_t stream_id) const
86  {
87  return streams_[stream_id % streams_.size()].view();
88  }
89 
97  std::size_t get_pool_size() const noexcept { return streams_.size(); }
98 
99  private:
100  std::vector<rmm::cuda_stream> streams_;
101  mutable std::atomic_size_t next_stream{};
102 };
103  // end of group
105 } // namespace rmm
A pool of CUDA streams.
Definition: cuda_stream_pool.hpp:42
static constexpr std::size_t default_size
Default stream pool size.
Definition: cuda_stream_pool.hpp:44
cuda_stream_pool(std::size_t pool_size=default_size)
Construct a new cuda stream pool object of the given non-zero size.
Definition: cuda_stream_pool.hpp:52
std::size_t get_pool_size() const noexcept
Get the number of streams in the pool.
Definition: cuda_stream_pool.hpp:97
rmm::cuda_stream_view get_stream() const noexcept
Get a cuda_stream_view of a stream in the pool.
Definition: cuda_stream_pool.hpp:70
rmm::cuda_stream_view get_stream(std::size_t stream_id) const
Get a cuda_stream_view of the stream associated with stream_id. Equivalent values of stream_id return...
Definition: cuda_stream_pool.hpp:85
Strongly-typed non-owning wrapper for CUDA streams with default constructor.
Definition: cuda_stream_view.hpp:41