rapids_cuda_enable_fatbin_compression

Added in version v25.10.00.

Set the needed compilation flags for FATBIN compression on a provided target and/or in a variable

rapids_cuda_enable_fatbin_compression( [TARGET <target>]
                                       [VARIABLE <variable>]
                                       [TUNE_FOR (balanced|size|rapids|runtime_perf)] )

Establishes the needed compilation flags for the requested compression level, by adding the required compilation flags for any CUDA sources in the target.

It is recommended for this function to be called without any TUNE_FOR option as the value selection that has been tuned by RAPIDS.

TARGET

If target doesn’t currently exist it will be created as a global interface target.

VARIABLE

A variable with the name specified in this option will be created with compilation flags needed to fulfull the compression level requested. If a variable already exists in the calling scope with this name it will be overwritten.

balanced

Specify compression flags that aim for good tradeoff of binary size and runtime decompression performance.

CUDA 12 Requires Driver Version: 550.54.14+ CUDA 13 Requires Driver Version: 580+

rapids

Specify compression flags that have been selected by RAPIDS. RAPIDS generally tunes towards minimal size but this is subject to change as the needs of RAPIDS evolves.

CUDA 12 Requires Driver Version: 525.60.13+ CUDA 13 Requires Driver Version: 580+

runtime_perf

Specify compression flags that will aim for fastest runtime at the cost of compile time, and larger binary sizes.

CUDA 12 Requires Driver Version: 525.60.13+ CUDA 13 Requires Driver Version: 580+

size

Specify compression flags that will aim for smallest binary size at the cost of compile time, and slower runtime decompression.

CUDA 12 Requires Driver Version: 550.54.14+ CUDA 13 Requires Driver Version: 580+