Struct ErrorStatus

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

Value of the Error Status Register (ESR).

See Intel SDM Vol. 3A, Ch. 7, Section 12.5.3, “Error Handling”.

Implementations

impl ErrorStatus

pub const SEND_CHECKSUM_ERROR: Pack32<bool, ErrorStatus>

Set when the local APIC detects a checksum error for a message that it sent on the APIC bus.

Used only on P6 family and Pentium processors.

pub const RECV_CHECKSUM_ERROR: Pack32<bool, ErrorStatus>

Set when the local APIC detects a checksum error for a message that it received on the APIC bus.

Used only on P6 family and Pentium processors.

pub const SEND_ACCEPT_ERROR: Pack32<bool, ErrorStatus>

Set when the local APIC detects that a message it sent was not accepted by any APIC on the APIC bus

Used only on P6 family and Pentium processors.

pub const RECV_ACCEPT_ERROR: Pack32<bool, ErrorStatus>

Set when the local APIC detects that a message it received was not accepted by any APIC on the APIC bus.

Used only on P6 family and Pentium processors.

pub const REDIRECTABLE_IPI: Pack32<bool, ErrorStatus>

Set when the local APIC detects an attempt to send an IPI with the lowest-priority delivery mode and the local APIC does not support the sending of such IPIs. This bit is used on some Intel Core and Intel Xeon processors.

pub const SEND_ILLEGAL_VECTOR: Pack32<bool, ErrorStatus>

Set when the local APIC detects an illegal vector (one in the range 0 to 15) in the message that it is sending. This occurs as the result of a write to the ICR (in both xAPIC and x2APIC modes) or to SELF IPI register (x2APIC mode only) with an illegal vector.

If the local APIC does not support the sending of lowest-priority IPIs and software writes the ICR to send a lowest-priority IPI with an illegal vector, the local APIC sets only the “redirectable IPI” error bit. The interrupt is not processed and hence the “Send Illegal Vector” bit is not set in the ESR.

pub const RECV_ILLEGAL_VECTOR: Pack32<bool, ErrorStatus>

Set when the local APIC detects an illegal vector (one in the range 0 to 15) in an interrupt message it receives or in an interrupt generated locally from the local vector table or via a self IPI. Such interrupts are not delivered to the processor; the local APIC will never set an IRR bit in the range 0 to 15.

pub const ILLEGAL_REGISTER_ACCESS: Pack32<bool, ErrorStatus>

Set when the local APIC is in xAPIC mode and software attempts to access a register that is reserved in the processor’s local-APIC register-address space; see Table 10-1. (The local-APIC register-address spacemprises the 4 KBytes at the physical address specified in the IA32_APIC_BASE MSR.) Used only on Intel Core, Intel Atom, Pentium 4, Intel Xeon, and P6 family processors.

In x2APIC mode, software accesses the APIC registers using the RDMSR and WRMSR instructions. Use of one of these instructions to access a reserved register cause a general-protection exception (see Section 10.12.1.3). They do not set the “Illegal Register Access” bit in the ESR.

pub const fn from_bits(bits: u32) -> ErrorStatus

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

pub const fn new() -> ErrorStatus

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

pub const fn bits(self) -> u32

Returns the raw bit representatiion of self as an integer.

pub fn with<T>(self, field: Pack32<T, ErrorStatus>, value: T) -> ErrorStatus

where T: FromBits<u32>,

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: Pack32<T, ErrorStatus>, value: T, ) -> &mut ErrorStatus

where T: FromBits<u32>,

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

pub fn get<T>(self, field: Pack32<T, ErrorStatus>) -> T

where T: FromBits<u32>,

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: Pack32<T, ErrorStatus>, ) -> Result<T, <T as FromBits<u32>>::Error>

where T: FromBits<u32>,

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 ErrorStatus

pub fn is_error(&self) -> bool

Returns true if an error is present, or false if no error bits are set.

Trait Implementations

impl Binary for ErrorStatus

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

Formats the value using the given formatter.

impl Clone for ErrorStatus

fn clone(&self) -> ErrorStatus

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ErrorStatus

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

Formats the value using the given formatter.

impl Default for ErrorStatus

fn default() -> ErrorStatus

Returns the “default value” for a type.

impl Display for ErrorStatus

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

Formats the value using the given formatter.

impl From<u32> for ErrorStatus

fn from(val: u32) -> ErrorStatus

Converts to this type from the input type.

impl LowerHex for ErrorStatus

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

Formats the value using the given formatter.

impl UpperHex for ErrorStatus

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

Formats the value using the given formatter.

impl Copy for ErrorStatus