Struct RiscvTarget 

pub struct RiscvTarget { /* private fields */ }

Struct that represents a RISC-V target.

Implementations

impl RiscvTarget

pub fn build<'a>( target: &'a str, cargo_flags: &'a str, ) -> Result<Self, Error<'a>>

Builds a RISC-V target from a target triple and cargo flags. This function is expected to be called from a build script.

The target triple is expected to be in the form riscv{width}{extensions}-vendor-os[-bin]. If the target triple is invalid, an error is returned.

Example

// In build.rs
let target = std::env::var("TARGET").unwrap();
let cargo_flags = std::env::var("CARGO_ENCODED_RUSTFLAGS").unwrap();
let target = riscv_target_parser::RiscvTarget::build(&target, &cargo_flags).unwrap(); // This will panic if the target is invalid

pub fn rustc_flags(&self) -> Vec<String>

Returns a list of flags to pass to rustc for the given RISC-V target. This function is expected to be called from a build script.

Example

let target = std::env::var("TARGET").unwrap();
let cargo_flags = std::env::var("CARGO_ENCODED_RUSTFLAGS").unwrap();
let target = riscv_target_parser::RiscvTarget::build(&target, &cargo_flags).unwrap();
for flag in target.rustc_flags() {
   println!("cargo:rustc-check-cfg=cfg({})", flag);
   println!("cargo:rustc-cfg={}", flag);
}

pub fn llvm_base_isa(&self) -> String

Returns the LLVM base ISA for the given RISC-V target.

pub fn llvm_arch_patch(&self) -> String

Returns the arch code to patch LLVM spurious errors.

Note

This is a provisional patch and is limited to work for the riscv-rt crate only.

Related issues

• https://github.com/rust-embedded/riscv/issues/175
• https://github.com/rust-lang/rust/issues/80608
• https://github.com/llvm/llvm-project/issues/61991

pub fn width(&self) -> Width

Returns the width of the RISC-V architecture.

pub fn base_extension(&self) -> Option<Extension>

Returns the base extension of the RISC-V architecture (if any).

Trait Implementations

impl Clone for RiscvTarget

fn clone(&self) -> RiscvTarget

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for RiscvTarget

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

Formats the value using the given formatter.

impl PartialEq for RiscvTarget

fn eq(&self, other: &RiscvTarget) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> TryFrom<TargetTriple<'a>> for RiscvTarget

type Error = Error<'a>

The type returned in the event of a conversion error.

fn try_from(triple: TargetTriple<'a>) -> Result<Self, Self::Error>

Performs the conversion.

impl Eq for RiscvTarget

impl StructuralPartialEq for RiscvTarget