Struct nvvm::NvvmProgram

pub struct NvvmProgram { /* fields omitted */ }

Implementations

impl NvvmProgram

pub fn new() -> Result<Self, NvvmError>

Make a new NVVM program.

pub fn compile(&self, options: &[NvvmOption]) -> Result<Vec<u8>, NvvmError>

Compile this program into PTX assembly bytes (they should be ascii per the PTX ISA ref but they are returned as bytes to be safe).

pub fn add_module(&self, bitcode: &[u8], name: String) -> Result<(), NvvmError>

Add a bitcode module to this nvvm program.

pub fn add_lazy_module(
    &self,
    bitcode: &[u8],
    name: String
) -> Result<(), NvvmError>

Add a bitcode module lazily to this nvvm program. This means that a symbol in this module is only loaded if it is used by a previous module. According to libnvvm docs, this also makes the symbols internal to the NVVM IR module, allowing for further optimizations.

Do not feed LLVM IR to this method, add_module seems to allow it for now, but it yields an empty ptx file if given to this method

pub fn compiler_log(&self) -> Result<Option<String>, NvvmError>

Get the compiler/verifier log message. This includes any errors that may have happened during compilation or during verification as well as any warnings. If you are having trouble with your program yielding a compilation error, looking at this log after attempting compilation should help.

Returns None if the log is empty and automatically strips off the nul at the end of the log.

pub fn verify(&self) -> Result<(), NvvmError>

Verify the program without actually compiling it. In the case of invalid IR, you can find more detailed error info by calling compiler_log.

Trait Implementations

impl Drop for NvvmProgram

fn drop(&mut self)

Executes the destructor for this type.