Skip to content

Commit

Permalink
Implement cuda::mr::cuda_managed_memory_resource
Browse files Browse the repository at this point in the history
Fixes Implement a memory_resource using `cudaMallocManaged` and `cudaFree` NVIDIA#1515
  • Loading branch information
miscco committed Mar 11, 2024
1 parent aa400fb commit 8e45666
Show file tree
Hide file tree
Showing 6 changed files with 417 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -0,0 +1,216 @@
//===----------------------------------------------------------------------===//
//
// Part of libcu++, the C++ Standard Library for your entire system,
// under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
// SPDX-FileCopyrightText: Copyright (c) 2024 NVIDIA CORPORATION & AFFILIATES.
//
//===----------------------------------------------------------------------===//

#ifndef _CUDA__MEMORY_RESOURCE_CUDA_MANAGED_MEMORY_RESOURCE_H
#define _CUDA__MEMORY_RESOURCE_CUDA_MANAGED_MEMORY_RESOURCE_H

#include <cuda/__cccl_config>

#if defined(_CCCL_IMPLICIT_SYSTEM_HEADER_GCC)
# pragma GCC system_header
#elif defined(_CCCL_IMPLICIT_SYSTEM_HEADER_CLANG)
# pragma clang system_header
#elif defined(_CCCL_IMPLICIT_SYSTEM_HEADER_MSVC)
# pragma system_header
#endif // no system header

#if !defined(_CCCL_CUDA_COMPILER)
# include <cuda_runtime_api.h>
#endif // !_CCCL_CUDA_COMPILER

#include <cuda/__memory_resource/get_property.h>
#include <cuda/__memory_resource/properties.h>
#include <cuda/__memory_resource/resource_ref.h>
#include <cuda/__memory_resource/resource.h>

#if _CCCL_STD_VER >= 2014

_LIBCUDACXX_BEGIN_NAMESPACE_CUDA_MR

/**
* @brief `cuda_managed_memory_resource` uses cudaMallocManaged / cudaFree for allocation/deallocation.
*/
struct cuda_managed_memory_resource
{
/**
* @brief Allocate device memory of size at least \p __bytes.
* @param __bytes The size in bytes of the allocation.
* @param __alignment The requested alignment of the allocation. Is ignored!
* @return void* Pointer to the newly allocated memory
*/
void* allocate(const size_t __bytes, const size_t __alignment) const
{
_LIBCUDACXX_ASSERT(__alignment <= 256 && (256 % __alignment == 0),
"cuda_managed_memory_resource::allocate invalid alignment");
return allocate(__bytes);
}

/**
* @brief Allocate device memory of size at least \p __bytes.
* @param __bytes The size in bytes of the allocation.
* @return void* Pointer to the newly allocated memory
*/
void* allocate(const size_t __bytes) const
{
void* __ptr{nullptr};
const ::cudaError_t __status = ::cudaMallocManaged(&__ptr, __bytes);
_LIBCUDACXX_ASSERT(__status == cudaSuccess, "cuda_managed_memory_resource::allocate failed");
return __ptr;
}

/**
* @brief Deallocate memory pointed to by \p __ptr.
* @param __ptr Pointer to be deallocated
* @param __bytes The size in bytes of the allocation.
* @param __alignment The alignment that was passed to the `allocate` call that returned \p __ptr. Is ignored!
*/
void deallocate(void* __ptr, const size_t __bytes, const size_t __alignment) const
{
_LIBCUDACXX_ASSERT(__alignment <= 256 && (256 % __alignment == 0),
"cuda_managed_memory_resource::deallocate invalid alignment");
deallocate(__ptr, __bytes);
}

/**
* @brief Deallocate memory pointed to by \p __ptr.
* @param __ptr Pointer to be deallocated
* @param __bytes The size in bytes of the allocation.
*/
void deallocate(void* __ptr, size_t) const
{
const ::cudaError_t __status = ::cudaFree(__ptr);
_LIBCUDACXX_ASSERT(__status == cudaSuccess, "cuda_managed_memory_resource::deallocate failed");
}

/**
* @brief Equality comparison operator between two cuda_managed_memory_resource's
* @return true
*/
_LIBCUDACXX_NODISCARD_ATTRIBUTE constexpr bool operator==(cuda_managed_memory_resource const&) const noexcept
{
return true;
}
# if _CCCL_STD_VER <= 2017
/**
* @brief Inequality comparison operator between two cuda_managed_memory_resource's
* @return false
*/
_LIBCUDACXX_NODISCARD_ATTRIBUTE constexpr bool operator!=(cuda_managed_memory_resource const&) const noexcept
{
return false;
}
# endif // _CCCL_STD_VER <= 2017

/**
* @brief Equality comparison operator between a cuda_managed_memory_resource and a managed_memory resource
*
* @param __lhs The cuda_managed_memory_resource
* @param __rhs The resource to compare to
* @return false
*/
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>)
_LIBCUDACXX_AND resource<_Resource> _LIBCUDACXX_AND has_property<_Resource, managed_memory>)
_LIBCUDACXX_NODISCARD_FRIEND bool
operator==(cuda_managed_memory_resource const& __lhs, _Resource const& __rhs) noexcept
{
return resource_ref<managed_memory>{const_cast<cuda_managed_memory_resource&>(__lhs)}
== resource_ref<managed_memory>{const_cast<_Resource&>(__rhs)};
}
# if _CCCL_STD_VER <= 2017
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>)
_LIBCUDACXX_AND resource<_Resource> _LIBCUDACXX_AND has_property<_Resource, managed_memory>)
_LIBCUDACXX_NODISCARD_FRIEND bool
operator==(_Resource const& __rhs, cuda_managed_memory_resource const& __lhs) noexcept
{
return resource_ref<managed_memory>{const_cast<cuda_managed_memory_resource&>(__lhs)}
== resource_ref<managed_memory>{const_cast<_Resource&>(__rhs)};
}
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>)
_LIBCUDACXX_AND resource<_Resource> _LIBCUDACXX_AND has_property<_Resource, managed_memory>)
_LIBCUDACXX_NODISCARD_FRIEND bool
operator!=(cuda_managed_memory_resource const& __lhs, _Resource const& __rhs) noexcept
{
return resource_ref<managed_memory>{const_cast<cuda_managed_memory_resource&>(__lhs)}
!= resource_ref<managed_memory>{const_cast<_Resource&>(__rhs)};
}
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>)
_LIBCUDACXX_AND resource<_Resource> _LIBCUDACXX_AND has_property<_Resource, managed_memory>)
_LIBCUDACXX_NODISCARD_FRIEND bool
operator!=(_Resource const& __rhs, cuda_managed_memory_resource const& __lhs) noexcept
{
return resource_ref<managed_memory>{const_cast<cuda_managed_memory_resource&>(__lhs)}
!= resource_ref<managed_memory>{const_cast<_Resource&>(__rhs)};
}
# endif // _CCCL_STD_VER <= 2017

/**
* @brief Equality comparison operator between a cuda_managed_memory_resource and an arbitrary resource
*
* @param __lhs The cuda_managed_memory_resource
* @param __rhs The resource to compare to
* @return false
*/
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>) _LIBCUDACXX_AND
resource<_Resource> _LIBCUDACXX_AND(!has_property<_Resource, managed_memory>))
_LIBCUDACXX_NODISCARD_FRIEND bool operator==(cuda_managed_memory_resource const&, _Resource const&) noexcept
{
return false;
}
# if _CCCL_STD_VER <= 2017
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>) _LIBCUDACXX_AND
resource<_Resource> _LIBCUDACXX_AND(!has_property<_Resource, managed_memory>))
_LIBCUDACXX_NODISCARD_FRIEND bool operator==(_Resource const&, cuda_managed_memory_resource const&) noexcept
{
return false;
}
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>) _LIBCUDACXX_AND
resource<_Resource> _LIBCUDACXX_AND(!has_property<_Resource, managed_memory>))
_LIBCUDACXX_NODISCARD_FRIEND bool operator!=(cuda_managed_memory_resource const&, _Resource const&) noexcept
{
return true;
}
_LIBCUDACXX_TEMPLATE(class _Resource)
_LIBCUDACXX_REQUIRES((!_CUDA_VSTD::same_as<_Resource, cuda_managed_memory_resource>) _LIBCUDACXX_AND
resource<_Resource> _LIBCUDACXX_AND(!has_property<_Resource, managed_memory>))
_LIBCUDACXX_NODISCARD_FRIEND bool operator!=(_Resource const&, cuda_managed_memory_resource const&) noexcept
{
return true;
}
# endif // _CCCL_STD_VER <= 2017

/**
* @brief Enables the `managed_memory` property
*/
friend constexpr void get_property(cuda_managed_memory_resource const&, managed_memory) noexcept {}
/**
* @brief Enables the `device_accessible` property
*/
friend constexpr void get_property(cuda_managed_memory_resource const&, device_accessible) noexcept {}
/**
* @brief Enables the `host_accessible` property
*/
friend constexpr void get_property(cuda_managed_memory_resource const&, host_accessible) noexcept {}
};
static_assert(resource_with<cuda_managed_memory_resource, managed_memory>, "");
static_assert(resource_with<cuda_managed_memory_resource, device_accessible>, "");
static_assert(resource_with<cuda_managed_memory_resource, host_accessible>, "");

_LIBCUDACXX_END_NAMESPACE_CUDA_MR

#endif // _CCCL_STD_VER >= 2014

#endif //_CUDA__MEMORY_RESOURCE_CUDA_MANAGED_MEMORY_RESOURCE_H
5 changes: 5 additions & 0 deletions libcudacxx/include/cuda/__memory_resource/properties.h
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,11 @@ struct device_accessible
struct host_accessible
{};

/// \struct managed_memory
/// \brief The \c managed_memory property signals that the allocated memory is managed
struct managed_memory
{};

_LIBCUDACXX_END_NAMESPACE_CUDA_MR

#endif // _CCCL_STD_VER >= 2014
Expand Down
1 change: 1 addition & 0 deletions libcudacxx/include/cuda/memory_resource
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,7 @@ class resource_ref {
# endif // no system header

#include <cuda/__memory_resource/cuda_async_memory_resource.h>
#include <cuda/__memory_resource/cuda_managed_memory_resource.h>
#include <cuda/__memory_resource/cuda_memory_resource.h>
#include <cuda/__memory_resource/get_property.h>
#include <cuda/__memory_resource/properties.h>
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,49 @@
//===----------------------------------------------------------------------===//
//
// Part of libcu++, the C++ Standard Library for your entire system,
// under the Apache License v2.0 with LLVM Exceptions.
// See https://llvm.org/LICENSE.txt for license information.
// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
// SPDX-FileCopyrightText: Copyright (c) 2024 NVIDIA CORPORATION & AFFILIATES.
//
//===----------------------------------------------------------------------===//

// UNSUPPORTED: c++03, c++11
// UNSUPPORTED: nvrtc

#include <cuda/memory_resource>
#include <cuda/std/cassert>
#include <cuda/std/cstdint>
#include <cuda/stream_ref>

void ensure_device_ptr(void* ptr) {
assert(ptr != nullptr);
cudaPointerAttributes attributes;
cudaError_t status = cudaPointerGetAttributes (&attributes, ptr);
assert(status == cudaSuccess);
assert(attributes.type == cudaMemoryTypeManaged);
}

void test() {
cuda::mr::cuda_managed_memory_resource res{};

{ // allocate / deallocate
auto* ptr = res.allocate(42);
static_assert(cuda::std::is_same<decltype(ptr), void*>::value, "");
ensure_device_ptr(ptr);

res.deallocate(ptr, 42);
}

{ // allocate / deallocate with alignment
auto* ptr = res.allocate(42, 4);
static_assert(cuda::std::is_same<decltype(ptr), void*>::value, "");
ensure_device_ptr(ptr);

res.deallocate(ptr, 42, 4);
}
}

int main(int, char**) {
return 0;
}
Loading

0 comments on commit 8e45666

Please sign in to comment.