Enum PageReadError 

pub enum PageReadError {
    NotPresent {
        gva: Gva,
        which_pxe: PxeKind,
    },
    NotInDump {
        gva: Option<(Gva, Option<PxeKind>)>,
        gpa: Gpa,
    },
}

Represent the fundamental reason a single page read can fail.

Variants

NotPresent

Virtual address translation failed because a page table entry is not present (it exists in the dump but is marked as not present).

Fields

gva: Gva

which_pxe: PxeKind

NotInDump

A physical page is missing from the dump.

Fields

gva: Option<(Gva, Option<PxeKind>)>

gpa: Gpa

Trait Implementations

impl Clone for PageReadError

fn clone(&self) -> PageReadError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PageReadError

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

Formats the value using the given formatter.

impl Display for PageReadError

Memory errors that can occur during memory reads.

There are several failure conditions that can happen while trying to read virtual (or physical) memory out of a crash-dump that might not be obvious.

For example, consider reading two 4K pages from the virtual address 0x1337_000; it can fail because:

• The virtual address (the first 4K page) isn’t present in the address space at the PxeKind::Pde level: PageReadError::NotPresent { gva: 0x1337_000, which_pxe: PxeKind::Pde })
• The PxeKind::Pde that needs reading as part of the address translation (of the first page) isn’t part of the crash-dump: PageReadError::NotInDump { gva: Some((0x1337_000, PxeKind::Pde)), gpa: .. })`
• The physical page backing that virtual address isn’t included in the crash-dump: Error::PageRead(PageReadError::NotInDump { gva: Some((0x1337_000, None)), gpa: .. })
• Reading the second (and only the second) page failed because of any of the previous reasons: PartialRead { expected_amount: 8_192, actual_amount: 4_096, reason: PageReadError::.. }

Similarly, for physical memory reads starting at 0x1337_000:

• The physical page isn’t in the crash-dump: MemoryError::PageRead(PageReadError::NotInDump { gpa: 0x1337_000 })
• Reading the second page failed: PartialRead { expected_amount: 8_192, actual_amount: 4_096, reason: PageReadError::NotInDump { gva: None, gpa: 0x1338_000 } }

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

Formats the value using the given formatter.

impl Error for PageReadError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<PageReadError> for Error

fn from(value: PageReadError) -> Self

Converts to this type from the input type.