Enum WriteError 

#[non_exhaustive]
pub enum WriteError {
    Invalid(ModelError),
    ReservedSectionName {
        section: SectionId,
    },
    SegmentsSharePage {
        first: SectionId,
        second: SectionId,
    },
    NoRoomForHeaders,
    Unsupported {
        what: &'static str,
    },
    TooLarge,
}

Why an object could not be written.

The enum is #[non_exhaustive]: match it with a wildcard arm.

Examples

use object_lang::{Architecture, Object, Section, SectionKind, WriteError};

let mut obj = Object::relocatable(Architecture::X86_64);
let note = obj.add_section(Section::new(".note.GNU-stack", SectionKind::Other));
assert_eq!(
    object_lang::elf::write(&obj),
    Err(WriteError::ReservedSectionName { section: note }),
);

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Invalid(ModelError)

The object breaks a rule of the model.

ReservedSectionName

A section uses a name the writer generates itself (ELF: .note.GNU-stack in a relocatable object, which records executable_stack).

Fields

section: SectionId

The section.

SegmentsSharePage

Two loadable sections of an executable with different permissions, or a BSS section followed by initialized data, share a page. Each permission change must start on a fresh page.

Fields

first: SectionId

The last section of the earlier segment.

second: SectionId

The first section of the later one.

NoRoomForHeaders

An executable’s lowest section is too close to address zero to map the file headers on the pages below it.

Unsupported

The object uses something this writer does not support yet; the message says what.

Fields

what: &'static str

What is unsupported.

TooLarge

The file would exceed the format’s size limits or the address space.

Trait Implementations

impl Clone for WriteError

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WriteError

impl Debug for WriteError

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

Formats the value using the given formatter.

impl Display for WriteError

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

Formats the value using the given formatter.

impl Eq for WriteError

impl Error for WriteError

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<ModelError> for WriteError

fn from(err: ModelError) -> Self

Converts to this type from the input type.

impl Hash for WriteError

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for WriteError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for WriteError