cuda_stream.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2020, 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 <functional>
20 #include <rmm/cuda_stream_view.hpp>
21 #include <rmm/detail/error.hpp>
22 #include <rmm/detail/logging_assert.hpp>
23 
24 #include <cuda_runtime_api.h>
25 
26 #include <memory>
27 
28 namespace rmm {
40 class cuda_stream {
41  public:
48  cuda_stream(cuda_stream&&) = default;
58  ~cuda_stream() = default;
59  cuda_stream(cuda_stream const&) = delete; // Copying disallowed: one stream one owner
60  cuda_stream& operator=(cuda_stream&) = delete;
61 
68  : stream_{[]() {
69  auto* stream = new cudaStream_t; // NOLINT(cppcoreguidelines-owning-memory)
70  RMM_CUDA_TRY(cudaStreamCreate(stream));
71  return stream;
72  }(),
73  [](cudaStream_t* stream) {
74  RMM_ASSERT_CUDA_SUCCESS(cudaStreamDestroy(*stream));
75  delete stream; // NOLINT(cppcoreguidelines-owning-memory)
76  }}
77  {
78  }
79 
86  [[nodiscard]] bool is_valid() const { return stream_ != nullptr; }
87 
93  [[nodiscard]] cudaStream_t value() const
94  {
95  RMM_LOGGING_ASSERT(is_valid());
96  return *stream_;
97  }
98 
102  explicit operator cudaStream_t() const noexcept { return value(); }
103 
109  [[nodiscard]] cuda_stream_view view() const { return cuda_stream_view{value()}; }
110 
116  operator cuda_stream_view() const { return view(); }
117 
125  void synchronize() const { RMM_CUDA_TRY(cudaStreamSynchronize(value())); }
126 
132  void synchronize_no_throw() const noexcept
133  {
134  RMM_ASSERT_CUDA_SUCCESS(cudaStreamSynchronize(value()));
135  }
136 
137  private:
138  std::unique_ptr<cudaStream_t, std::function<void(cudaStream_t*)>> stream_;
139 };
140  // end of group
142 } // namespace rmm
Strongly-typed non-owning wrapper for CUDA streams with default constructor.
Definition: cuda_stream_view.hpp:41
Owning wrapper for a CUDA stream.
Definition: cuda_stream.hpp:40
void synchronize_no_throw() const noexcept
Synchronize the owned CUDA stream. Does not throw if there is an error.
Definition: cuda_stream.hpp:132
bool is_valid() const
Returns true if the owned stream is non-null.
Definition: cuda_stream.hpp:86
void synchronize() const
Synchronize the owned CUDA stream.
Definition: cuda_stream.hpp:125
cuda_stream()
Construct a new cuda stream object.
Definition: cuda_stream.hpp:67
cuda_stream & operator=(cuda_stream &&)=default
Move copy assignment operator (default)
cudaStream_t value() const
Get the value of the wrapped CUDA stream.
Definition: cuda_stream.hpp:93
cuda_stream_view view() const
Creates an immutable, non-owning view of the wrapped CUDA stream.
Definition: cuda_stream.hpp:109
cuda_stream(cuda_stream &&)=default
Move constructor (default)