Struct inkwell::targets::TargetMachine

pub struct TargetMachine { /* fields omitted */ }

Methods

impl TargetMachine

pub fn get_target(&self) -> Target

pub fn get_triple(&self) -> LLVMString

pub fn get_default_triple() -> LLVMString

Gets the default triple for the current system.

Example

use inkwell::targets::TargetMachine;

use std::ffi::CString;

let default_triple = TargetMachine::get_default_triple();

assert_eq!(*default_triple, *CString::new("x86_64-pc-linux-gnu").unwrap());

pub fn normalize_target_triple(triple: Either<&str, &CStr>) -> LLVMString

pub fn get_host_cpu_name() -> LLVMString

Gets a string containing the host CPU's name (triple).

Example Output

x86_64-pc-linux-gnu

pub fn get_host_cpu_features() -> LLVMString

Gets a comma separated list of supported features by the host CPU.

Example Output

+sse2,+cx16,+sahf,-tbm

pub fn get_cpu(&self) -> LLVMString

pub fn get_feature_string(&self) -> &CStr

pub fn get_target_data(&self) -> TargetData

Create TargetData from this target machine

pub fn set_asm_verbosity(&self, verbosity: bool)

pub fn add_analysis_passes<T>(&self, pass_manager: &PassManager<T>)

pub fn write_to_memory_buffer(
    &self,
    module: &Module,
    file_type: FileType
) -> Result<MemoryBuffer, LLVMString>

Writes a TargetMachine to a MemoryBuffer.

Example

use inkwell::OptimizationLevel;
use inkwell::context::Context;
use inkwell::targets::{CodeModel, RelocMode, FileType, Target, TargetMachine, InitializationConfig};

Target::initialize_x86(&InitializationConfig::default());

let opt = OptimizationLevel::Default;
let reloc = RelocMode::Default;
let model = CodeModel::Default;
let target = Target::from_name("x86-64").unwrap();
let target_machine = target.create_target_machine("x86_64-pc-linux-gnu", "x86-64", "+avx2", opt, reloc, model).unwrap();

let context = Context::create();
let module = context.create_module("my_module");
let void_type = context.void_type();
let fn_type = void_type.fn_type(&[], false);

module.add_function("my_fn", fn_type, None);

let buffer = target_machine.write_to_memory_buffer(&module, FileType::Assembly).unwrap();

pub fn write_to_file(
    &self,
    module: &Module,
    file_type: FileType,
    path: &Path
) -> Result<(), LLVMString>

Saves a TargetMachine to a file.

Example

use inkwell::OptimizationLevel;
use inkwell::context::Context;
use inkwell::targets::{CodeModel, RelocMode, FileType, Target, TargetMachine, InitializationConfig};

use std::path::Path;

Target::initialize_x86(&InitializationConfig::default());

let opt = OptimizationLevel::Default;
let reloc = RelocMode::Default;
let model = CodeModel::Default;
let path = Path::new("/tmp/some/path/main.asm");
let target = Target::from_name("x86-64").unwrap();
let target_machine = target.create_target_machine("x86_64-pc-linux-gnu", "x86-64", "+avx2", opt, reloc, model).unwrap();

let context = Context::create();
let module = context.create_module("my_module");
let void_type = context.void_type();
let fn_type = void_type.fn_type(&[], false);

module.add_function("my_fn", fn_type, None);

assert!(target_machine.write_to_file(&module, FileType::Object, &path).is_ok());

Trait Implementations

impl Drop for TargetMachine

fn drop(&mut self)

Executes the destructor for this type.

impl Debug for TargetMachine

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

Formats the value using the given formatter.