nvvm

The cuda.bindings.nvvm Python module wraps the libNVVM C API.

Functions

cuda.bindings.nvvm.version() → tuple

Get the NVVM version.

Returns:

• int: NVVM major version number.

• int: NVVM minor version number.

Return type:

A 2-tuple containing

See also

nvvmVersion

cuda.bindings.nvvm.ir_version() → tuple

Get the NVVM IR version.

Returns:

• int: NVVM IR major version number.

• int: NVVM IR minor version number.

• int: NVVM IR debug metadata major version number.

• int: NVVM IR debug metadata minor version number.

Return type:

A 4-tuple containing

See also

nvvmIRVersion

cuda.bindings.nvvm.create_program() → intptr_t

Create a program, and set the value of its handle to *prog.

Returns:

NVVM program.

Return type:

intptr_t

See also

nvvmCreateProgram

cuda.bindings.nvvm.add_module_to_program(intptr_t prog, buffer, size_t size, name)

Add a module level NVVM IR to a program.

Parameters:

• prog (intptr_t) – NVVM program.

• buffer (bytes) – NVVM IR module in the bitcode or text representation.

• size (size_t) – Size of the NVVM IR module.

• name (str) – Name of the NVVM IR module. If NULL, “<unnamed>” is used as the name.

See also

nvvmAddModuleToProgram

cuda.bindings.nvvm.lazy_add_module_to_program(intptr_t prog, buffer, size_t size, name)

Add a module level NVVM IR to a program.

Parameters:

• prog (intptr_t) – NVVM program.

• buffer (bytes) – NVVM IR module in the bitcode representation.

• size (size_t) – Size of the NVVM IR module.

• name (str) – Name of the NVVM IR module. If NULL, “<unnamed>” is used as the name.

See also

nvvmLazyAddModuleToProgram

cuda.bindings.nvvm.compile_program(intptr_t prog, int num_options, options)

Compile the NVVM program.

Parameters:

• prog (intptr_t) – NVVM program.

• num_options (int) – Number of compiler options passed.

• options (object) –

  Compiler options in the form of C string array. It can be:

  • an int as the pointer address to the nested sequence, or

  • a Python sequence of ints, each of which is a pointer address to a valid sequence of ‘char’, or

  • a nested Python sequence of str.

See also

nvvmCompileProgram

cuda.bindings.nvvm.verify_program(intptr_t prog, int num_options, options)

Verify the NVVM program.

Parameters:

• prog (intptr_t) – NVVM program.

• num_options (int) – Number of compiler options passed.

• options (object) –

  Compiler options in the form of C string array. It can be:

  • an int as the pointer address to the nested sequence, or

  • a Python sequence of ints, each of which is a pointer address to a valid sequence of ‘char’, or

  • a nested Python sequence of str.

See also

nvvmVerifyProgram

cuda.bindings.nvvm.get_compiled_result_size(intptr_t prog) → size_t

Get the size of the compiled result.

Parameters:

prog (intptr_t) – NVVM program.

Returns:

Size of the compiled result (including the trailing NULL).

Return type:

size_t

See also

nvvmGetCompiledResultSize

cuda.bindings.nvvm.get_compiled_result(intptr_t prog, buffer)

Get the compiled result.

Parameters:

• prog (intptr_t) – NVVM program.

• buffer (bytes) – Compiled result.

See also

nvvmGetCompiledResult

cuda.bindings.nvvm.get_program_log_size(intptr_t prog) → size_t

Get the Size of Compiler/Verifier Message.

Parameters:

prog (intptr_t) – NVVM program.

Returns:

Size of the compilation/verification log (including the trailing NULL).

Return type:

size_t

See also

nvvmGetProgramLogSize

cuda.bindings.nvvm.get_program_log(intptr_t prog, buffer)

Get the Compiler/Verifier Message.

Parameters:

• prog (intptr_t) – NVVM program.

• buffer (bytes) – Compilation/Verification log.

See also

nvvmGetProgramLog

Types

class cuda.bindings.nvvm.Result(value, names=<not given>, *values, module=None, qualname=None, type=None, start=1, boundary=None)

See nvvmResult.

SUCCESS = 0

ERROR_OUT_OF_MEMORY = 1

ERROR_PROGRAM_CREATION_FAILURE = 2

ERROR_IR_VERSION_MISMATCH = 3

ERROR_INVALID_INPUT = 4

ERROR_INVALID_PROGRAM = 5

ERROR_INVALID_IR = 6

ERROR_INVALID_OPTION = 7

ERROR_NO_MODULE_IN_PROGRAM = 8

ERROR_COMPILATION = 9

ERROR_CANCELLED = 10