Struct ControlRegister3

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

Available on x86 or x86-64 only.

CR3: System control register that contains the top-level page table address and two associated caching flags.

Getters and setters for this structure only access a value in memory, not the register itself. Use the get and set methods to work with the actual register.

Implementations

impl ControlRegister3

pub fn write_through(&self) -> bool

CR3.PWT: Enables write-through caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn cache_disabled(&self) -> bool

CR3.PCD: Disables caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn process_context_id(&self) -> u16

Available on x86-64 only.

CR4.PCIDE: The process-context identifier (PCID) associated with this series of page tables.

Requires 64-bit mode and ControlRegister4::process_context_ids.

pub fn set_write_through(&mut self, value: bool)

CR3.PWT: Enables write-through caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn with_write_through(&mut self, value: bool) -> Self

CR3.PWT: Enables write-through caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn set_cache_disabled(&mut self, value: bool)

CR3.PCD: Disables caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn with_cache_disabled(&mut self, value: bool) -> Self

CR3.PCD: Disables caching for the top-level page table.

Does not apply when ControlRegister4::process_context_ids or ControlRegister4::physical_address_extension is enabled.

pub fn set_process_context_id(&mut self, value: u16)

Available on x86-64 only.

CR4.PCIDE: The process-context identifier (PCID) associated with this series of page tables.

Requires 64-bit mode and ControlRegister4::process_context_ids.

pub fn with_process_context_id(&self, value: u16) -> Self

Available on x86-64 only.

CR4.PCIDE: The process-context identifier (PCID) associated with this series of page tables.

Requires 64-bit mode and ControlRegister4::process_context_ids.

impl ControlRegister3

pub fn get() -> Self

Retrieve the current value of this register

pub unsafe fn set(value: Self)

Update the register to the given value.

Safety

Altering certain system flags can have dramatic effects on the execution of this and other programs, including memory safety.

impl ControlRegister3

pub fn address(self) -> usize

Get the address of the top-level page table.

pub fn set_address(&mut self, value: usize)

Set the address of the top-level page table.

Panics

Panics if the new address is not 4K-aligned.

Trait Implementations

impl Bitfield<usize> for ControlRegister3

fn new(value: T) -> Self

Construct a new bitfield type from its underlying representation

fn value(self) -> T

Unwrap the bitfield into its underlying representation

impl Clone for ControlRegister3

fn clone(&self) -> ControlRegister3

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ControlRegister3

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

Formats the value using the given formatter.

impl Default for ControlRegister3

fn default() -> ControlRegister3

Returns the “default value” for a type.

impl From<ControlRegister3> for usize

fn from(val: ControlRegister3) -> Self

Converts to this type from the input type.

impl From<usize> for ControlRegister3

fn from(val: usize) -> Self

Converts to this type from the input type.

impl PartialEq for ControlRegister3

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl Copy for ControlRegister3

impl Eq for ControlRegister3

impl StructuralPartialEq for ControlRegister3