cuda.bindings._v2.driver.link_create_v2#

cuda.bindings._v2.driver.link_create_v2( unsigned int num_options, intptr_t options, intptr_t option_values, ) → intptr_t#

Creates a pending JIT linker invocation.

If the call is successful, the caller owns the returned CUlinkState, which should eventually be destroyed with cuLinkDestroy. The device code machine size (32 or 64 bit) will match the calling application. Both linker and compiler options may be specified. Compiler options will be applied to inputs to this linker action which must be compiled from PTX. The options CU_JIT_WALL_TIME, CU_JIT_INFO_LOG_BUFFER_SIZE_BYTES, and CU_JIT_ERROR_LOG_BUFFER_SIZE_BYTES will accumulate data until the CUlinkState is destroyed. The data passed in via cuLinkAddData and cuLinkAddFile will be treated as relocatable (-rdc=true to nvcc) when linking the final cubin during cuLinkComplete and will have similar consequences as offline relocatable device code linking. option_values must remain valid for the life of the CUlinkState if output options are used. No other references to inputs are maintained after this call returns.

Parameters:

num_options (unsigned int) – Size of options arrays.
options (intptr_t) – Array of linker and compiler options.
option_values (intptr_t) – Array of option values, each cast to void *.

Returns:

On success, this will contain a CUlinkState to: specify and complete this action.

Return type:

intptr_t

Note

For LTO-IR input, only LTO-IR compiled with toolkits prior to CUDA 12.0 will be accepted.