Struct hal_x86_64::control_regs::Cr4

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

Control Register 4

Implementations

impl Cr4

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

Virtual 8086 Mode Extensions (VME).

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

Protected-Mode Virtual Interrupts (PVI).

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

Time Stamp Disable (TSD).

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

Debugging Extensions (DE).

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

Page Size Extension (PSE).

This enables the use of 4MB physical pages; always ignored in long mode.

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

Physical Address Extension (PAE).

Enables the use of 2MB physical pages. Required in long mode.

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

Machine Check Exception Enable (MCE).

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

Page Global Enable (PGE).

Allows marking pages as global.

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

Performance-Monitoring Counter Enable (PCE).

Allows the

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

Operating System FXSAVE/FXRSTOR Support

If enabled, the FXSAVE and FXRSTOR instructions are available in both 64-bit and compatibility mode.

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

Operating System Support for Unmasked Floating-Point Exceptions

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

User-Mode Instruction Prevention (UMIP).

If set, SGDT, SIDT, SLDT, SMSW, and STR, instructions will result in a general protection fault (#GP) when in ring > 0.

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

Virtual Machine Extensions (VMX) Enable

Note: this extension is INTEL ONLY.

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

Safer Mode Extensions (SMX) Enable

Note: this extension is INTEL ONLY.

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

FSBASE/GSBASE Enable.

Enables the instructions RDFSBASE,RDGSBASE, WRFSBASE, and WRGSBASE.

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

PCID Enable (PCIDE).

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

OS Support for XSAVE and Processor Extended States Enable

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

Supervisor Mode Execution Protection Enable (SMEP).

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

Supervisor Mode Access Prevention Enable (`SMAP)

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

Protection Key (Used) Enable (PKE).

Enables protection keys for user-mode pages.

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

Control-flow Enforcement Technology Enable (CET).

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

Protection Key (Supervisor) Enable (PKS).

Enables protection keys for user-mode pages.

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 Cr4

pub fn read() -> Self

pub unsafe fn write(value: Self)

Safety

Writing to CR4 can do stuff.

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

Safety

Writing to CR4 can do stuff.

Trait Implementations

impl Binary for Cr4

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

Formats the value using the given formatter.

impl Clone for Cr4

fn clone(&self) -> Cr4

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Cr4

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

Formats the value using the given formatter.

impl Display for Cr4

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

Formats the value using the given formatter.

impl From<Cr4> for u64

fn from(Cr4: Cr4) -> Self

Converts to this type from the input type.

impl From<u64> for Cr4

fn from(val: u64) -> Self

Converts to this type from the input type.

impl LowerHex for Cr4

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

Formats the value using the given formatter.

impl PartialEq for Cr4

fn eq(&self, other: &Cr4) -> 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 Cr4

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

Formats the value using the given formatter.

impl Copy for Cr4

impl Eq for Cr4

impl StructuralEq for Cr4

impl StructuralPartialEq for Cr4