Struct tartan_arch::x86_common::protection::Selector

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

Available on x86 or x86-64 only.

A reference to an entry in a segment descriptor table.

Used as the value of the segment registers CS, DS, etc. as well as the LocalDescriptorTableRegister and TaskRegister.

Implementations

impl Selector

pub fn privilege_level(&self) -> u8

RPL: The privilege level “requested” when accessing the referenced segment.

This may be different than the current privilege level (CPL), in which case the access must allowed for both the CPL and RPL. This is intended to allow OS code to limit its privileges when executing on behalf of user code.

pub fn local(&self) -> bool

Indicates that this selector references a descriptor in the local descriptor table (LDT). Otherwise, it references the global descriptor table (GDT).

pub fn set_privilege_level(&mut self, value: u8)

RPL: The privilege level “requested” when accessing the referenced segment.

This may be different than the current privilege level (CPL), in which case the access must allowed for both the CPL and RPL. This is intended to allow OS code to limit its privileges when executing on behalf of user code.

pub fn with_privilege_level(&self, value: u8) -> Self

RPL: The privilege level “requested” when accessing the referenced segment.

This may be different than the current privilege level (CPL), in which case the access must allowed for both the CPL and RPL. This is intended to allow OS code to limit its privileges when executing on behalf of user code.

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

Indicates that this selector references a descriptor in the local descriptor table (LDT). Otherwise, it references the global descriptor table (GDT).

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

Indicates that this selector references a descriptor in the local descriptor table (LDT). Otherwise, it references the global descriptor table (GDT).

impl Selector

pub const fn new(offset: u16, privilege_level: u8, local: bool) -> Self

Create a new selector with the given field values

pub const fn null() -> Self

Create a null selector

pub fn offset(self) -> u16

The offset of the referenced segment entry in the descriptor table.

pub fn set_offset(&mut self, offset: u16)

Update the offset of the referenced entry in the descriptor table.

Panics

Panics if the new offset is not aligned on an 8-byte boundary.

pub fn descriptor_address(self) -> usize

Calculate the address of the descriptor referenced by this selector

Trait Implementations

impl Bitfield<u16> for Selector

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 Selector

fn clone(&self) -> Selector

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Selector

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

Formats the value using the given formatter.

impl Default for Selector

fn default() -> Selector

Returns the “default value” for a type.

impl From<Selector> for u16

fn from(val: Selector) -> Self

Converts to this type from the input type.

impl From<u16> for Selector

fn from(val: u16) -> Self

Converts to this type from the input type.

impl PartialEq for Selector

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

impl Eq for Selector

impl StructuralPartialEq for Selector