Enum Section 

pub enum Section {
    NOP,
    Code(Code),
    RunAtOffset(u16, u16),
    SectionSwitch(u16),
    BSS(u32),
    Patch(Patch),
    XDEF(XDEF),
    XREF(XREF),
    LNKHeader(LNKHeader),
    LocalSymbol(LocalSymbol),
    GroupSymbol(GroupSymbol),
    ByteSizeRegister(u16),
    WordSizeRegister(u16),
    LongSizeRegister(u16),
    Filename(Filename),
    SetToFile(u16, u32),
    SetToLine(u32),
    IncrementLineNumber,
    IncrementLineNumberByte(u8),
    IncrementLineNumberWord(u32),
    VeryLocalSymbol(LocalSymbol),
    Set3ByteRegister(u16),
    SetMXInfo(SetMXInfo),
    CPU(u8),
    XBSS(XBSS),
    IncSLDLineNum(u16),
    IncSLDLineNumByte(u16, u8),
    IncSLDLineNumWord(u16, u32),
    SetSLDLineNum(SetSLDLineNum),
    SetSLDLineNumFile(SetSLDLineNumFile),
    EndSLDInfo(u16),
    RepeatByte(u32),
    RepeatWord(u32),
    RepeatLong(u32),
    ProcedureCall(ProcedureCall),
    ProcedureDefinition(ProcedureDefinition),
    Repeat3Byte(u32),
    FunctionStart(FunctionStart),
    FunctionEnd(SectionOffsetLine),
    BlockStart(SectionOffsetLine),
    BlockEnd(SectionOffsetLine),
    Def(Def),
    Def2(Def2),
}

A section within an OBJ file.

Sections can contain code, data, relocations, symbols, or debug information. The section list is terminated by a NOP entry.

Section Types

• Code: Executable machine code
• BSS: Uninitialized data
• XDEF/XREF: Symbol exports and imports
• Patch: Relocation information
• Debug information: Line numbers, function info, etc.
• And many more!

Variants

NOP

End of file marker.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x0

Code(Code)

Machine code.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x2
1	Code	A Code structure

RunAtOffset(u16, u16)

Run at offset.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x4
1	u16
3	u16

SectionSwitch(u16)

Switch to different section.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x2
1	u16	Section ID

BSS(u32)

Uninitialized data (BSS) with size in bytes.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x8
1	u32	Size in bytes

Patch(Patch)

Relocation patch.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0xA
1	Patch	A Patch structure

XDEF(XDEF)

External symbol definition.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0xC
1	XDEF	An XDEF structure.

XREF(XREF)

External symbol reference.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0xE
1	XREF	An XREF structure.

LNKHeader(LNKHeader)

Section header.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x10
1	LNKHeader	An LNKHeader structure.

LocalSymbol(LocalSymbol)

Local symbol.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x12
1	LocalSymbol	A LocalSymbol structure

GroupSymbol(GroupSymbol)

Group symbol.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x14
1	GroupSymbol	A GroupSymbol structure.

ByteSizeRegister(u16)

Untested

WordSizeRegister(u16)

Untested

LongSizeRegister(u16)

Untested

Filename(Filename)

File name reference.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x1C
1	Filename	A Filename structure.

SetToFile(u16, u32)

Untested

SetToLine(u32)

Untested

IncrementLineNumber

Untested

IncrementLineNumberByte(u8)

Untested

IncrementLineNumberWord(u32)

Untested

VeryLocalSymbol(LocalSymbol)

Untested

Set3ByteRegister(u16)

Untested

SetMXInfo(SetMXInfo)

Set MX info.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x2C
1	SetMXInfo	A SetMXInfo structure.

CPU(u8)

CPU type specification.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x2E
1	u8	A CPU identifier.

Constants for CPU identifiers can be found in the cputype module.

XBSS(XBSS)

External BSS symbol.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x30
1	XBSS	An XBSS structure.

IncSLDLineNum(u16)

Increment line number.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x32
1	u16	The offset where the new line number starts.

See also: IncSLDLineNumByte, IncSLDLineNumWord

IncSLDLineNumByte(u16, u8)

Increment line number by an amount.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x34
1	u16	The offset where the new line number starts.
3	u8	The amount to increment the line number.

See also IncSLDLineNum, IncSLDLineNumWord

IncSLDLineNumWord(u16, u32)

Increment line number by an amount.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x34
1	u16	The offset where the new line number starts.
3	u8	The amount to increment the line number.

See also: IncSLDLineNum, IncSLDLineNumByte

SetSLDLineNum(SetSLDLineNum)

Set line number.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x38
1	SetSLDLineNum	A SetSLDLineNum structure.

See also: SetSLDLineNumFile

SetSLDLineNumFile(SetSLDLineNumFile)

Set line number with file name.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x3A
1	SetSLDLineNumFile	A SetSLDLineNumFile structure.

See also: SetSLDLineNum

EndSLDInfo(u16)

End of SLD info.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x3C
1	u16	Offset where SLD info ends.

RepeatByte(u32)

Untested

RepeatWord(u32)

Untested

RepeatLong(u32)

Untested

ProcedureCall(ProcedureCall)

Untested

ProcedureDefinition(ProcedureDefinition)

Untested

Repeat3Byte(u32)

Untested

FunctionStart(FunctionStart)

Function start marker.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x4A
1	FunctionStart	A FunctionStart structure.

FunctionEnd(SectionOffsetLine)

Function end marker.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x4C
1	SectionOffsetLine	A SectionOffsetLine structure.

BlockStart(SectionOffsetLine)

Block start marker.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x4E
1	SectionOffsetLine	A SectionOffsetLine structure.

BlockEnd(SectionOffsetLine)

Block end marker.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x50
1	SectionOffsetLine	A SectionOffsetLine structure.

Def(Def)

Variable/type definition.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x52
1	Def	A Def structure.

Def2(Def2)

Extended definition with tag.

Structure on Disk

Offset	Type	Description
0	u8	Magic: 0x54
1	Def2	A Def2 structure.

Trait Implementations

impl BinRead for Section

type Args<'__binrw_generated_args_lifetime> = ()

The type used for the args parameter of read_args() and read_options().

fn read_options<R: Read + Seek>( __binrw_generated_var_reader: &mut R, __binrw_generated_var_endian: Endian, __binrw_generated_var_arguments: Self::Args<'_>, ) -> BinResult<Self>

Read Self from the reader using the given Endian and arguments.

fn read<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self: ReadEndian, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments.

fn read_be<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments and assuming big-endian byte order.

fn read_le<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read Self from the reader using default arguments and assuming little-endian byte order.

fn read_ne<R>(reader: &mut R) -> Result<Self, Error>

where R: Read + Seek, Self::Args<'a>: for<'a> Required,

Read T from the reader assuming native-endian byte order.

fn read_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek, Self: ReadEndian,

Read Self from the reader using the given arguments.

fn read_be_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming big-endian byte order, using the given arguments.

fn read_le_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read Self from the reader, assuming little-endian byte order, using the given arguments.

fn read_ne_args<R>(reader: &mut R, args: Self::Args<'_>) -> Result<Self, Error>

where R: Read + Seek,

Read T from the reader, assuming native-endian byte order, using the given arguments.

impl BinWrite for Section

type Args<'__binrw_generated_args_lifetime> = ()

The type used for the args parameter of write_args() and write_options().

fn write_options<W: Write + Seek>( &self, __binrw_generated_var_writer: &mut W, __binrw_generated_var_endian: Endian, __binrw_generated_var_arguments: Self::Args<'_>, ) -> BinResult<()>

Write Self to the writer using the given Endian and arguments.

fn write<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Write + Seek, Self: WriteEndian, Self::Args<'a>: for<'a> Required,

Write Self to the writer using default arguments.

fn write_be<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Write + Seek, Self::Args<'a>: for<'a> Required,

Write Self to the writer assuming big-endian byte order.

fn write_le<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Write + Seek, Self::Args<'a>: for<'a> Required,

Write Self to the writer assuming little-endian byte order.

fn write_ne<W>(&self, writer: &mut W) -> Result<(), Error>

where W: Write + Seek, Self::Args<'a>: for<'a> Required,

Write Self to the writer assuming native-endian byte order.

fn write_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek, Self: WriteEndian,

Write Self to the writer using the given arguments.

fn write_be_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek,

Write Self to the writer, assuming big-endian byte order, using the given arguments.

fn write_le_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek,

Write Self to the writer, assuming little-endian byte order, using the given arguments.

fn write_ne_args<W>( &self, writer: &mut W, args: Self::Args<'_>, ) -> Result<(), Error>

where W: Write + Seek,

Write Self to the writer, assuming native-endian byte order, using the given arguments.

impl Clone for Section

fn clone(&self) -> Section

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Section

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

Formats the value using the given formatter.

impl Display for Section

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

Formats the value using the given formatter.

impl DisplayWithOptions for Section

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

impl PartialEq for Section

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

const ENDIAN: EndianKind

The endianness of the type.

impl WriteEndian for Section

const ENDIAN: EndianKind

The endianness of the type.

impl StructuralPartialEq for Section