CCCL (CUDA C++ Core Libraries) provides: - CUB: device/block/warp-level GPU primitives (reduce, scan, sort, topk) - Thrust: high-level parallel algorithms (transform_reduce, sort, scan) - libcudacxx: CUDA C++ standard library (atomics, barriers, memory) - cudax: experimental features (memory resources, allocators) - Tuning policies: per-SM hardware-specific algorithm parameters Competition optimization vectors mapped to CCCL: - Output TPS (83% weight): warp_reduce, block_reduce, device_topk - Input TPS (14% weight): device_scan, block_load, prefetch - Cache TPS (3% weight): prefix caching strategy patterns - Memory (0.9 util): pooled/cached/buddy allocators Source: https://github.com/NVIDIA/cccl (shallow clone, HEAD only) License: Apache-2.0
284 lines
9.4 KiB
Plaintext
284 lines
9.4 KiB
Plaintext
//===----------------------------------------------------------------------===//
|
|
//
|
|
// Part of CUDA Experimental in CUDA Core Compute Libraries,
|
|
// 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) 2026 NVIDIA CORPORATION.
|
|
//
|
|
//===----------------------------------------------------------------------===//
|
|
|
|
#include <cuda/std/version>
|
|
|
|
#include <cstdio>
|
|
#include <cstring>
|
|
#include <memory>
|
|
|
|
#include <cccl/c/transform.h>
|
|
#include <hostjit/codegen/cub_call.hpp>
|
|
#include <util/build_utils.h>
|
|
#include <util/first_call_gate.h>
|
|
|
|
using namespace hostjit::codegen;
|
|
|
|
// (d_in, d_out, num_items, op_state, stream)
|
|
using unary_transform_fn_t = int (*)(void*, void*, unsigned long long, void*, void*);
|
|
// (d_in1, d_in2, d_out, num_items, op_state, stream)
|
|
using binary_transform_fn_t = int (*)(void*, void*, void*, unsigned long long, void*, void*);
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Build
|
|
// ---------------------------------------------------------------------------
|
|
|
|
CUresult cccl_device_unary_transform_build_ex(
|
|
cccl_device_transform_build_result_t* build_ptr,
|
|
cccl_iterator_t d_in,
|
|
cccl_iterator_t d_out,
|
|
cccl_op_t op,
|
|
int cc_major,
|
|
int cc_minor,
|
|
const char* cub_path,
|
|
const char* thrust_path,
|
|
const char* libcudacxx_path,
|
|
const char* ctk_path,
|
|
cccl_build_config* config)
|
|
try
|
|
{
|
|
if (build_ptr == nullptr)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
#if CCCL_OS(WINDOWS)
|
|
build_ptr->first_call_state = nullptr;
|
|
#endif
|
|
const std::string cccl_include_str = cccl::detail::parse_cccl_include_path(libcudacxx_path);
|
|
const std::string ctk_root_str = cccl::detail::parse_ctk_root(ctk_path);
|
|
const char* const cccl_include_path = cccl_include_str.empty() ? nullptr : cccl_include_str.c_str();
|
|
const char* const ctk_root = ctk_root_str.empty() ? nullptr : ctk_root_str.c_str();
|
|
cccl::detail::MergedBuildConfig merged(config, cub_path, thrust_path);
|
|
#if CCCL_OS(WINDOWS)
|
|
auto first_call_state = std::make_unique<cccl::detail::first_call_gate>();
|
|
#endif
|
|
|
|
auto result =
|
|
CubCall::from("cub/device/device_transform.cuh")
|
|
.run("cub::DeviceTransform::Transform")
|
|
.name("cccl_jit_unary_transform")
|
|
.with(in(d_in), out(d_out), num_items, unary_op(op, d_in.value_type, d_out.value_type), stream)
|
|
.compile(cc_major, cc_minor, merged.get(), ctk_root, cccl_include_path);
|
|
|
|
build_ptr->cc = cc_major * 10 + cc_minor;
|
|
cccl::detail::copy_cubin(result.cubin, build_ptr->payload, build_ptr->payload_size);
|
|
build_ptr->jit_compiler = result.compiler;
|
|
#if CCCL_OS(WINDOWS)
|
|
build_ptr->first_call_state = first_call_state.release();
|
|
#endif
|
|
build_ptr->transform_fn = result.fn_ptr;
|
|
|
|
return CUDA_SUCCESS;
|
|
}
|
|
catch (const std::exception& exc)
|
|
{
|
|
fprintf(stderr, "\nEXCEPTION in cccl_device_unary_transform_build_ex(): %s\n", exc.what());
|
|
return CUDA_ERROR_UNKNOWN;
|
|
}
|
|
|
|
CUresult cccl_device_binary_transform_build_ex(
|
|
cccl_device_transform_build_result_t* build_ptr,
|
|
cccl_iterator_t d_in1,
|
|
cccl_iterator_t d_in2,
|
|
cccl_iterator_t d_out,
|
|
cccl_op_t op,
|
|
int cc_major,
|
|
int cc_minor,
|
|
const char* cub_path,
|
|
const char* thrust_path,
|
|
const char* libcudacxx_path,
|
|
const char* ctk_path,
|
|
cccl_build_config* config)
|
|
try
|
|
{
|
|
if (build_ptr == nullptr)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
#if CCCL_OS(WINDOWS)
|
|
build_ptr->first_call_state = nullptr;
|
|
#endif
|
|
const std::string cccl_include_str = cccl::detail::parse_cccl_include_path(libcudacxx_path);
|
|
const std::string ctk_root_str = cccl::detail::parse_ctk_root(ctk_path);
|
|
const char* const cccl_include_path = cccl_include_str.empty() ? nullptr : cccl_include_str.c_str();
|
|
const char* const ctk_root = ctk_root_str.empty() ? nullptr : ctk_root_str.c_str();
|
|
cccl::detail::MergedBuildConfig merged(config, cub_path, thrust_path);
|
|
#if CCCL_OS(WINDOWS)
|
|
auto first_call_state = std::make_unique<cccl::detail::first_call_gate>();
|
|
#endif
|
|
|
|
// Use the output type as the accumulator type (same as the previous raw JIT
|
|
// implementation) so the binary op functor uses the correct result type.
|
|
auto result =
|
|
CubCall::from("cub/device/device_transform.cuh")
|
|
.run("cub::DeviceTransform::Transform")
|
|
.name("cccl_jit_binary_transform")
|
|
.use_tuple_inputs()
|
|
.with(force_accum_type(d_out.value_type), in(d_in1), in(d_in2), out(d_out), num_items, op, stream)
|
|
.compile(cc_major, cc_minor, merged.get(), ctk_root, cccl_include_path);
|
|
|
|
build_ptr->cc = cc_major * 10 + cc_minor;
|
|
cccl::detail::copy_cubin(result.cubin, build_ptr->payload, build_ptr->payload_size);
|
|
build_ptr->jit_compiler = result.compiler;
|
|
#if CCCL_OS(WINDOWS)
|
|
build_ptr->first_call_state = first_call_state.release();
|
|
#endif
|
|
build_ptr->transform_fn = result.fn_ptr;
|
|
|
|
return CUDA_SUCCESS;
|
|
}
|
|
catch (const std::exception& exc)
|
|
{
|
|
fprintf(stderr, "\nEXCEPTION in cccl_device_binary_transform_build_ex(): %s\n", exc.what());
|
|
return CUDA_ERROR_UNKNOWN;
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Non-ex wrappers (call _ex with nullptr config)
|
|
// ---------------------------------------------------------------------------
|
|
|
|
CUresult cccl_device_unary_transform_build(
|
|
cccl_device_transform_build_result_t* build_ptr,
|
|
cccl_iterator_t d_in,
|
|
cccl_iterator_t d_out,
|
|
cccl_op_t op,
|
|
int cc_major,
|
|
int cc_minor,
|
|
const char* cub_path,
|
|
const char* thrust_path,
|
|
const char* libcudacxx_path,
|
|
const char* ctk_path)
|
|
{
|
|
return cccl_device_unary_transform_build_ex(
|
|
build_ptr, d_in, d_out, op, cc_major, cc_minor, cub_path, thrust_path, libcudacxx_path, ctk_path, nullptr);
|
|
}
|
|
|
|
CUresult cccl_device_binary_transform_build(
|
|
cccl_device_transform_build_result_t* build_ptr,
|
|
cccl_iterator_t d_in1,
|
|
cccl_iterator_t d_in2,
|
|
cccl_iterator_t d_out,
|
|
cccl_op_t op,
|
|
int cc_major,
|
|
int cc_minor,
|
|
const char* cub_path,
|
|
const char* thrust_path,
|
|
const char* libcudacxx_path,
|
|
const char* ctk_path)
|
|
{
|
|
return cccl_device_binary_transform_build_ex(
|
|
build_ptr, d_in1, d_in2, d_out, op, cc_major, cc_minor, cub_path, thrust_path, libcudacxx_path, ctk_path, nullptr);
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Runtime functions
|
|
// ---------------------------------------------------------------------------
|
|
|
|
CUresult cccl_device_unary_transform(
|
|
cccl_device_transform_build_result_t build,
|
|
cccl_iterator_t d_in,
|
|
cccl_iterator_t d_out,
|
|
uint64_t num_items,
|
|
cccl_op_t op,
|
|
CUstream stream)
|
|
try
|
|
{
|
|
if (!build.transform_fn)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
const auto fn = reinterpret_cast<unary_transform_fn_t>(build.transform_fn);
|
|
#if CCCL_OS(WINDOWS)
|
|
if (!build.first_call_state)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
const auto invoke = [&] {
|
|
return fn(d_in.state, d_out.state, num_items, op.state, reinterpret_cast<void*>(stream));
|
|
};
|
|
// Empty calls return before CUB initializes its static launch configuration,
|
|
// so they must not complete the first-call gate.
|
|
const int status =
|
|
num_items == 0 ? invoke() : static_cast<cccl::detail::first_call_gate*>(build.first_call_state)->invoke(invoke);
|
|
#else
|
|
const int status = fn(d_in.state, d_out.state, num_items, op.state, reinterpret_cast<void*>(stream));
|
|
#endif
|
|
return (status == 0) ? CUDA_SUCCESS : CUDA_ERROR_UNKNOWN;
|
|
}
|
|
catch (const std::exception& exc)
|
|
{
|
|
fprintf(stderr, "\nEXCEPTION in cccl_device_unary_transform(): %s\n", exc.what());
|
|
return CUDA_ERROR_UNKNOWN;
|
|
}
|
|
|
|
CUresult cccl_device_binary_transform(
|
|
cccl_device_transform_build_result_t build,
|
|
cccl_iterator_t d_in1,
|
|
cccl_iterator_t d_in2,
|
|
cccl_iterator_t d_out,
|
|
uint64_t num_items,
|
|
cccl_op_t op,
|
|
CUstream stream)
|
|
try
|
|
{
|
|
if (!build.transform_fn)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
const auto fn = reinterpret_cast<binary_transform_fn_t>(build.transform_fn);
|
|
#if CCCL_OS(WINDOWS)
|
|
if (!build.first_call_state)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
const auto invoke = [&] {
|
|
return fn(d_in1.state, d_in2.state, d_out.state, num_items, op.state, reinterpret_cast<void*>(stream));
|
|
};
|
|
// Empty calls return before CUB initializes its static launch configuration,
|
|
// so they must not complete the first-call gate.
|
|
const int status =
|
|
num_items == 0 ? invoke() : static_cast<cccl::detail::first_call_gate*>(build.first_call_state)->invoke(invoke);
|
|
#else
|
|
const int status = fn(d_in1.state, d_in2.state, d_out.state, num_items, op.state, reinterpret_cast<void*>(stream));
|
|
#endif
|
|
return (status == 0) ? CUDA_SUCCESS : CUDA_ERROR_UNKNOWN;
|
|
}
|
|
catch (const std::exception& exc)
|
|
{
|
|
fprintf(stderr, "\nEXCEPTION in cccl_device_binary_transform(): %s\n", exc.what());
|
|
return CUDA_ERROR_UNKNOWN;
|
|
}
|
|
|
|
// ---------------------------------------------------------------------------
|
|
// Cleanup
|
|
// ---------------------------------------------------------------------------
|
|
|
|
CUresult cccl_device_transform_cleanup(cccl_device_transform_build_result_t* build_ptr)
|
|
try
|
|
{
|
|
if (build_ptr == nullptr)
|
|
{
|
|
return CUDA_ERROR_INVALID_VALUE;
|
|
}
|
|
#if CCCL_OS(WINDOWS)
|
|
delete static_cast<cccl::detail::first_call_gate*>(build_ptr->first_call_state);
|
|
build_ptr->first_call_state = nullptr;
|
|
#endif
|
|
cccl::detail::release_jit_artifacts(build_ptr);
|
|
build_ptr->transform_fn = nullptr;
|
|
|
|
return CUDA_SUCCESS;
|
|
}
|
|
catch (const std::exception& exc)
|
|
{
|
|
fprintf(stderr, "\nEXCEPTION in cccl_device_transform_cleanup(): %s\n", exc.what());
|
|
return CUDA_ERROR_UNKNOWN;
|
|
}
|