cuda_async_view_memory_resource.hpp
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2021-2025, 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 #pragma once
17 
18 #include <rmm/cuda_device.hpp>
19 #include <rmm/cuda_stream_view.hpp>
20 #include <rmm/detail/error.hpp>
21 #include <rmm/detail/export.hpp>
22 #include <rmm/detail/thrust_namespace.h>
24 
25 #include <cuda_runtime_api.h>
26 
27 #include <cstddef>
28 
29 namespace RMM_NAMESPACE {
30 namespace mr {
42  public:
53  cuda_async_view_memory_resource(cudaMemPool_t pool_handle)
54  : cuda_pool_handle_{[pool_handle]() {
55  RMM_EXPECTS(nullptr != pool_handle, "Unexpected null pool handle.");
56  return pool_handle;
57  }()}
58  {
59  // Check if cudaMallocAsync Memory pool supported
60  RMM_EXPECTS(rmm::detail::runtime_async_alloc::is_supported(),
61  "cudaMallocAsync not supported with this CUDA driver/runtime version");
62  }
63 
69  [[nodiscard]] cudaMemPool_t pool_handle() const noexcept { return cuda_pool_handle_; }
70 
74  default;
76  default;
78  default;
80  default;
81 
82  private:
83  cudaMemPool_t cuda_pool_handle_{};
84 
94  void* do_allocate(std::size_t bytes, rmm::cuda_stream_view stream) override
95  {
96  void* ptr{nullptr};
97  if (bytes > 0) {
98  RMM_CUDA_TRY_ALLOC(cudaMallocFromPoolAsync(&ptr, bytes, pool_handle(), stream.value()),
99  bytes);
100  }
101  return ptr;
102  }
103 
112  void do_deallocate(void* ptr,
113  [[maybe_unused]] std::size_t bytes,
114  rmm::cuda_stream_view stream) noexcept override
115  {
116  if (ptr != nullptr) { RMM_ASSERT_CUDA_SUCCESS(cudaFreeAsync(ptr, stream.value())); }
117  }
118 
126  [[nodiscard]] bool do_is_equal(device_memory_resource const& other) const noexcept override
127  {
128  return dynamic_cast<cuda_async_view_memory_resource const*>(&other) != nullptr;
129  }
130 };
131  // end of group
133 } // namespace mr
134 } // namespace RMM_NAMESPACE
Strongly-typed non-owning wrapper for CUDA streams with default constructor.
Definition: cuda_stream_view.hpp:39
cudaStream_t value() const noexcept
Get the wrapped stream.
device_memory_resource derived class that uses cudaMallocAsync/cudaFreeAsync for allocation/deallocat...
Definition: cuda_async_view_memory_resource.hpp:41
cuda_async_view_memory_resource & operator=(cuda_async_view_memory_resource &&)=default
Default move assignment operator.
cuda_async_view_memory_resource(cuda_async_view_memory_resource &&)=default
Default move constructor.
cudaMemPool_t pool_handle() const noexcept
Returns the underlying native handle to the CUDA pool.
Definition: cuda_async_view_memory_resource.hpp:69
cuda_async_view_memory_resource(cudaMemPool_t pool_handle)
Constructs a cuda_async_view_memory_resource which uses an existing CUDA memory pool....
Definition: cuda_async_view_memory_resource.hpp:53
cuda_async_view_memory_resource(cuda_async_view_memory_resource const &)=default
Default copy constructor.
cuda_async_view_memory_resource & operator=(cuda_async_view_memory_resource const &)=default
Default copy assignment operator.
Base class for all librmm device memory allocation.
Definition: device_memory_resource.hpp:94