Struct EntryPoint 

pub struct EntryPoint<'a> { /* private fields */ }

Unified abstraction over SMBIOS 2.1 and 3.0 entry points.

Implementations

impl<'a> EntryPoint<'a>

pub fn new(inner: EntryPointType<'a>) -> Self

Creates an EntryPoint wrapper around an already-validated entry point type.

pub fn from_bytes(bytes: &'a [u8]) -> Result<Self, Status>

Attempts to parse and validate an EntryPoint from a byte slice.

pub unsafe fn create(ep_start: usize) -> Result<EntryPoint<'static>, Status>

Creates an EntryPoint from a raw memory address.

Safety

ep_start must point to valid mapped memory containing at least size_of::<EntryPoint2_1>() (0x1f) bytes or size_of::<EntryPoint3_0>() (0x18) bytes.

pub fn struct_table_phys(&self) -> u64

Returns the physical address of the structure table.

pub fn struct_table_length(&self) -> u32

Returns the length of the structure table in bytes.

Note that for SMBIOS 3.0, this returns max_struct_size, and the structures should be checked for the End-of-Table type (StructType::END_OF_TABLE).

pub fn max_struct_size(&self) -> u32

Returns the maximum structure size in bytes.

pub fn version(&self) -> SpecVersion

Returns the specification version supported by this entry point.

pub fn has_struct_count(&self) -> bool

Returns true if the entry point specifies a structure count (SMBIOS 2.1).

pub fn struct_count(&self) -> u16

Returns the number of structures (SMBIOS 2.1 only).

Panics

Panics if called on an SMBIOS 3.0 entry point where structure count is not present.

pub fn walk_structs<F>(&self, struct_table: &[u8], cb: F) -> Result<(), Status>

where F: FnMut(SpecVersion, &Header, &StringTable<'_>) -> Result<(), Status>,

Walks the known SMBIOS structures within the provided struct_table slice. The callback will be called once for each structure found.

Return values from the callback:

• Err(Status::STOP): aborted and returns Ok(())
• Ok(()) or Err(Status::NEXT): walk continues to the next structure
• Any other error: walk is aborted and returns the error

pub unsafe fn walk_structs_raw<F>( &self, struct_table_virt: usize, cb: F, ) -> Result<(), Status>

where F: FnMut(SpecVersion, &Header, &StringTable<'_>) -> Result<(), Status>,

Walks the known SMBIOS structures mapped at virtual address struct_table_virt.

Safety

struct_table_virt must point to valid mapped memory containing at least struct_table_length() bytes.

Trait Implementations

impl<'a> Clone for EntryPoint<'a>

fn clone(&self) -> EntryPoint<'a>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for EntryPoint<'a>

impl<'a> Debug for EntryPoint<'a>

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

Formats the value using the given formatter.

impl<'a> From<&'a EntryPoint2_1> for EntryPoint<'a>

fn from(ep: &'a EntryPoint2_1) -> Self

Converts to this type from the input type.

impl<'a> From<&'a EntryPoint3_0> for EntryPoint<'a>

fn from(ep: &'a EntryPoint3_0) -> Self

Converts to this type from the input type.

impl<'a> PartialEq for EntryPoint<'a>

fn eq(&self, other: &EntryPoint<'a>) -> bool

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for EntryPoint<'a>