Struct Linker 

pub struct Linker { /* private fields */ }

RAII wrapper around the CUDA link state (CUlinkState).

The linker accumulates PTX, cubin, and fatbin inputs via the add_* methods and then produces a single linked binary via complete.

On macOS, a synthetic implementation stores the inputs in memory and produces a synthetic cubin on completion.

Drop behaviour

Dropping the linker calls cuLinkDestroy on platforms with a real CUDA driver. If complete() was already called, Drop is still safe because the cubin data has been copied into the LinkedModule.

Implementations

impl Linker

pub fn new(options: LinkerOptions) -> CudaResult<Self>

Creates a new linker with the given options.

On platforms with a real CUDA driver, this calls cuLinkCreate. On macOS, a synthetic linker is created for testing purposes.

Errors

Returns a CudaError if cuLinkCreate fails (e.g. no active CUDA context).

pub fn add_ptx(&mut self, ptx: &str, name: &str) -> CudaResult<()>

Adds PTX source code to the linker.

The PTX is compiled and linked when complete is called.

Arguments

• ptx — PTX source code (must not contain interior null bytes).
• name — A descriptive name for this input (used in error messages).

Errors

• CudaError::InvalidValue if ptx contains interior null bytes.
• Other CudaError variants if cuLinkAddData fails.

pub fn add_cubin(&mut self, data: &[u8], name: &str) -> CudaResult<()>

Adds compiled cubin data to the linker.

Arguments

• data — Raw cubin binary data.
• name — A descriptive name for this input.

Errors

• CudaError::InvalidValue if name contains interior null bytes or data is empty.
• Other CudaError variants if cuLinkAddData fails.

pub fn add_fatbin(&mut self, data: &[u8], name: &str) -> CudaResult<()>

Adds a fat binary to the linker.

Arguments

• data — Raw fatbin binary data.
• name — A descriptive name for this input.

Errors

• CudaError::InvalidValue if name contains interior null bytes or data is empty.
• Other CudaError variants if cuLinkAddData fails.

pub fn add_object(&mut self, data: &[u8], name: &str) -> CudaResult<()>

Adds a relocatable device object to the linker.

Arguments

• data — Raw object binary data.
• name — A descriptive name for this input.

Errors

• CudaError::InvalidValue if name contains interior null bytes or data is empty.

pub fn add_library(&mut self, data: &[u8], name: &str) -> CudaResult<()>

Adds a device code library to the linker.

Arguments

• data — Raw library binary data.
• name — A descriptive name for this input.

Errors

• CudaError::InvalidValue if name contains interior null bytes or data is empty.

pub fn input_count(&self) -> usize

Returns the number of inputs added to the linker.

pub fn input_names(&self) -> &[String]

Returns the names of all inputs added so far.

pub fn options(&self) -> &LinkerOptions

Returns a reference to the linker options.

pub fn complete(self) -> CudaResult<LinkedModule>

Completes the link, producing a LinkedModule.

This consumes the linker. The resulting cubin data is copied into the LinkedModule before the underlying CUlinkState is destroyed (by Drop).

Errors

• CudaError::InvalidValue if no inputs have been added.
• Other CudaError variants if cuLinkComplete fails.

Trait Implementations

impl Debug for Linker

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Drop for Linker

fn drop(&mut self)

Executes the destructor for this type.

impl Send for Linker