Skip to main content

Parser

Struct Parser 

Source
pub struct Parser { /* private fields */ }
Expand description

The parser of the proka executable.

§Usage

To use this parser, you must put an slice into the initializations.

If the content of the proka executable is in memory, the best way is to use core::slice::from_raw_parts.

Implementations§

Source§

impl Parser

Source

pub unsafe fn init(buf: &'static [u8]) -> Result<Self, Error>

Initialize the parser by passing a slice.

§Safety

You must ensure these before invoking this function:

  • The slice’s pointer is accessible and properly mapped;
  • The slice’s content is a valid executable (internally checked);
  • The slice must contain the header and all section tables (internally checked).

If this crate is used on the kernel-side, you must first map the memory that the slice points to before invoking this function.

Source

pub fn validate(&self) -> bool

Do more validation after initialization.

§Content

This will validates:

  • Is the header min >= max;
  • Is each section’s base correct;
  • Is the section’s length not zeroed.
  • Is section base out of length.
Source

pub fn header(&self) -> Header

Get the header in this buffer.

Source

pub fn sections(&self) -> SectionIter

Get each section table.

Trait Implementations§

Source§

impl Clone for Parser

Source§

fn clone(&self) -> Parser

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 Debug for Parser

Source§

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

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

impl Copy for Parser

Auto Trait Implementations§

Blanket Implementations§

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<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, 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.