Struct hal_x86_64::cpu::msr::Efer

pub struct Efer(/* private fields */);

Bit flags for the Extended Feature Enable Register (EFER) Msr.

This MSR was added by AMD in the K6 processor, and became part of the architecture in AMD64. It controls features related to entering long mode.

To access the EFER, use the Msr::ia32_efer constructor.

Implementations

impl Efer

pub const SYSTEM_CALL_EXTENSIONS: Pack64<bool, Self> = _

System Call Extensions (SCE).

This enables the SYSCALL and SYSRET instructions.

pub const LONG_MODE_ENABLE: Pack64<bool, Self> = _

Long Mode Enable (LME).

Setting this bit enables long mode.

pub const LONG_MODE_ACTIVE: Pack64<bool, Self> = _

Long Mode Active (LMA).

This bit is set if the processor is in long mode.

pub const NO_EXECUTE_ENABLE: Pack64<bool, Self> = _

No-Execute Enable (NXE).

pub const SECURE_VM_ENABLE: Pack64<bool, Self> = _

Secure Virtual Machine Enable (SVME).

pub const LONG_MODE_SEGMENT_LIMIT_ENABLE: Pack64<bool, Self> = _

Long Mode Segment Limit Enable (LMSLE).

pub const FAST_FXSAVE_FXRSTOR: Pack64<bool, Self> = _

Fast FXSAVE/FXRSTOR (FFXSR).

pub const TRANSLATION_CACHE_EXTENSION: Pack64<bool, Self> = _

Translation Cache Extension (TCE).

pub const fn from_bits(bits: u64) -> Self

Constructs a new instance of Self from the provided raw bits.

pub const fn new() -> Self

Constructs a new instance of Self with all bits set to 0.

pub const fn bits(self) -> u64

Returns the raw bit representatiion of self as an integer.

pub fn with<T>(self, field: Pack64<T, Self>, value: T) -> Self

where T: FromBits<u64>,

Packs the bit representation of value into self at the bit range designated by field, returning a new bitfield.

pub fn set<T>(&mut self, field: Pack64<T, Self>, value: T) -> &mut Self

where T: FromBits<u64>,

Packs the bit representation of value into self at the range designated by field, mutating self in place.

pub fn get<T>(self, field: Pack64<T, Self>) -> T

where T: FromBits<u64>,

Unpacks the bit range represented by field from self, and converts it into a T-typed value.

Panics

This method panics if self does not contain a valid bit pattern for a T-typed value, as determined by T’s FromBits::try_from_bits implementation.

pub fn try_get<T>(self, field: Pack64<T, Self>) -> Result<T, T::Error>

where T: FromBits<u64>,

Unpacks the bit range represented by field from self and attempts to convert it into a T-typed value.

Returns

• Ok(T) if a T-typed value could be constructed from the bits in src
• Err(T::Error) if src does not contain a valid bit pattern for a T-typed value, as determined by T’s [FromBits::try_from_bits implementation.

pub fn assert_valid()

Asserts that all the packing specs for this type are valid.

This is intended to be used in unit tests.

pub fn display_ascii(&self) -> impl Display

Returns a value that formats this bitfield in a multi-line format, using only ASCII characters.

This is equivalent to formatting this bitfield using a {} display specifier, but will never use Unicode box-drawing characters, even when an upstream formatter uses the {:#} fmt::Display specifier. This is intended for use on platforms where Unicode box drawing characters are never available.

pub fn display_unicode(&self) -> impl Display

Returns a value that formats this bitfield in a multi-line format, always using Unicode box-drawing characters.

This is equivalent to formatting this bitfield using a {:#} format specifier, but will always use Unicode box-drawing characters, even when an upstream formatter uses the {} fmt::Display specifier.

Trait Implementations

impl Binary for Efer

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

Formats the value using the given formatter.

impl Clone for Efer

fn clone(&self) -> Efer

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Efer

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

Formats the value using the given formatter.

impl Display for Efer

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

Formats the value using the given formatter.

impl From<Efer> for u64

fn from(Efer: Efer) -> Self

Converts to this type from the input type.

impl From<u64> for Efer

fn from(val: u64) -> Self

Converts to this type from the input type.

impl LowerHex for Efer

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

Formats the value using the given formatter.

impl UpperHex for Efer

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

Formats the value using the given formatter.

impl Copy for Efer