Skip to main content

Segment

Struct Segment 

Source
pub struct Segment<T: AsRef<[u8]>, B> { /* private fields */ }
Expand description

Binary consisting of a single segment of encoded Instructions

This Binary serves a single buffer as a code segment starting from address 0.

§Example

The following example builds a segment at a specifig offset:

use riscv_etrace::binary::{self, Adaptable, Binary};
use riscv_etrace::instruction::{self, base};

let bootrom = b"\x97\x02\x00\x00\x93\x85\x02\x02\x73\x25\x40\xf1\x83\xb2\x82\x01\x67\x80\x02\x00";
let mut bootrom = binary::from_segment(bootrom, base::Set::Rv64I)
    .with_offset(0x1000);
assert_eq!(
    bootrom.get_insn(0x1010),
    Ok(instruction::Kind::new_jalr(0, 5, 0).into()),
);

Implementations§

Source§

impl<T: AsRef<[u8]>, B> Segment<T, B>

Source

pub fn new(data: T, base: B) -> Self

Create a new Binary for code of a given instruction base set

Trait Implementations§

Source§

impl<T: AsRef<[u8]>, B: Decode<I>, I: Info> Binary<I> for Segment<T, B>

Source§

type Error = SegmentError

Error type returned by get_insn
Source§

fn get_insn(&mut self, address: u64) -> Result<Instruction<I>, Self::Error>

Retrieve the Instruction at the given address
Source§

impl<T: Clone + AsRef<[u8]>, B: Clone> Clone for Segment<T, B>

Source§

fn clone(&self) -> Segment<T, B>

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T: Copy + AsRef<[u8]>, B: Copy> Copy for Segment<T, B>

Source§

impl<T: Debug + AsRef<[u8]>, B: Debug> Debug for Segment<T, B>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T: PartialEq + AsRef<[u8]>, B: PartialEq> PartialEq for Segment<T, B>

Source§

fn eq(&self, other: &Segment<T, B>) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

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

Inequality operator !=. Read more
Source§

impl<T: PartialEq + AsRef<[u8]>, B: PartialEq> StructuralPartialEq for Segment<T, B>

Auto Trait Implementations§

§

impl<T, B> Freeze for Segment<T, B>
where T: Freeze, B: Freeze,

§

impl<T, B> RefUnwindSafe for Segment<T, B>

§

impl<T, B> Send for Segment<T, B>
where T: Send, B: Send,

§

impl<T, B> Sync for Segment<T, B>
where T: Sync, B: Sync,

§

impl<T, B> Unpin for Segment<T, B>
where T: Unpin, B: Unpin,

§

impl<T, B> UnsafeUnpin for Segment<T, B>
where T: UnsafeUnpin, B: UnsafeUnpin,

§

impl<T, B> UnwindSafe for Segment<T, B>
where T: UnwindSafe, B: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Adaptable for T

Source§

fn with_offset(self, offset: u64) -> Offset<Self>

“Move” this binary by the given offset Read more
Source§

fn boxed<'a, I>(self) -> Binary<'a, I>
where I: Info, Self: Binary<I> + Send + Sync + 'a, Self::Error: MaybeMissError + 'static,

Available on crate feature alloc only.
Box this binary for dynamic dispatching Read more
Source§

fn boxer<'a, I>(self) -> Arc<dyn Fn() -> Binary<'a, I> + 'a>
where I: Info, Self: Binary<I> + Clone + Send + Sync + 'a, Self::Error: MaybeMissError + 'static,

Available on crate feature alloc only.
Transfer this binary into a factory producing boxed clones Read more
Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<D, I> Decode<(I, Bits)> for D
where D: Decode<I>, I: Info, (I, Bits): Info,

Source§

fn decode_16(&self, insn: u16) -> (I, Bits)

Decode a 16bit (“compressed”) instruction Info
Source§

fn decode_32(&self, insn: u32) -> (I, Bits)

Decode a 32bit (“normal”) instruction Info
Source§

fn decode_48(&self, insn: u64) -> (I, Bits)

Decode a 48bit instruction Info
Source§

fn decode_64(&self, insn: u64) -> (I, Bits)

Decode a 64bit instruction Info
Source§

fn decode_bits(&self, bits: Bits) -> I

Decode instruction Info from Bits
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.