Struct hal_x86_64::control_regs::Cr0

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

Control Register 0

Implementations

impl Cr0

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

Protected Mode Enable (PE)

Enables protected mode.

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

Monitor Coprocessor (MP).

Enables monitoring of the coprocessor, typically for x87 instructions.

Controls (together with the [TASK_SWITCHED] flag) whether a WAIT or FWAIT instruction should cause an #NE exception.

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

x87 FPU Emulation (EM).

Force all x87 and MMX instructions to cause an #NE exception.

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

Task Switched (TS).

Set to 1 on hardware task switches. This allows lazily saving x87, MMX, and SSE state on hardware context switches.

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

Extension Type (ET).

Indicates support of 387DX math coprocessor instructions.

Always set on all recent x86 processors, cannot be cleared.

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

Numeric Error (NE).

Enables native error reporting for x87 FPU errors.

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

Write Protect (WP).

Enables write protection for ring 0 pages.

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

Alignment Mask (AM).

Enables user-mode alignment checking if the ALIGNMENT_CHECK bit in RFLAGS is also set.

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

Not Write Through (NW).

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

Cache Disable (NW).

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

Paging Enabled (PG).

Enables paging, if [PROTECTED_MODE_ENABLE] is also set.

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.

impl Cr0

pub fn read() -> Self

pub unsafe fn write(value: Self)

Write a value to CR0.

This function preserves the value of all reserved bits in CR0.

Safety

Writing to CR0 can do stuff.

pub unsafe fn update(f: impl FnOnce(Self) -> Self)

Safety

Writing to CR4 can do stuff.

Trait Implementations

impl Binary for Cr0

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

Formats the value using the given formatter.

impl Clone for Cr0

fn clone(&self) -> Cr0

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cr0

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

Formats the value using the given formatter.

impl Display for Cr0

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

Formats the value using the given formatter.

impl From<Cr0> for u64

fn from(Cr0: Cr0) -> Self

Converts to this type from the input type.

impl From<u64> for Cr0

fn from(val: u64) -> Self

Converts to this type from the input type.

impl LowerHex for Cr0

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

Formats the value using the given formatter.

impl PartialEq for Cr0

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl UpperHex for Cr0

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

Formats the value using the given formatter.

impl Copy for Cr0

impl Eq for Cr0

impl StructuralEq for Cr0

impl StructuralPartialEq for Cr0