ddn.elf.segments

ELF program header (segment) handling functionality.

This module provides utilities for reading and manipulating ELF program headers (segments). Segments contain information about how the program is loaded into memory.

struct ElfSegment ProgramHeaderBuilder SegmentRange SegmentTypeRange

fn getLoadableSegments getSegmentByIndex getSegmentCount getSegments getSegmentsByType getSegmentsContainingSection sectionContainedInSegment

Types 4

structElfSegment

Represents an ELF segment (program header).

This struct provides lazy access to segment information.

Fields

private ElfFile _file

private size_t _index

private gelf.ProgramHeader _header

private bool _headerLoaded

private const(ubyte)[] _data

private bool _dataLoaded

Methods

private void _loadHeader()Load the program header from the ELF file.

private void _loadData()Load the segment data from the ELF file.

size_t index() pure nothrow @nogc @safe constGet the segment index.

gelf.ProgramHeader getHeader()Get the program header for this segment.

types.SegmentType getType()Get the segment type.

types.SegmentFlags getFlags()Get the segment flags.

const(ubyte)[] getData()Get the segment data from the file.

ulong getFileOffset()Get the segment's file offset.

ulong getVirtualAddress()Get the segment's virtual address.

ulong getPhysicalAddress()Get the segment's physical address.

ulong getFileSize()Get the segment's size in the file.

ulong getMemorySize()Get the segment's size in memory.

ulong getAlignment()Get the segment's alignment.

bool isLoadable()Check if this segment is loadable (PT_LOAD).

bool isDynamic()Check if this segment contains dynamic linking information.

bool isInterpreter()Check if this segment contains the interpreter path.

bool isReadable()Check if this segment is readable.

bool isWritable()Check if this segment is writable.

bool isExecutable()Check if this segment is executable.

Constructors

this(ElfFile file, size_t index)Constructor.

structSegmentTypeRange

Forward range for iterating over segments of a specific type.

Implements the D InputRange and ForwardRange interfaces, providing lazy access to ElfSegment instances.

Fields

private types.SegmentType _type

private gelf.ProgramHeader[] _headers

private size_t[] _originalIndices

private size_t _currentIndex

private ElfFile _file

Methods

bool empty() pure nothrow @nogc @safe constChecks if the range is empty.

ElfSegment front()Get the current segment.

void popFront()Advances to the next segment of the target type.

typeof(this) save()Saves the current state of the range.

Constructors

this(types.SegmentType type,  gelf.ProgramHeader[]  headers,
          size_t[]  originalIndices,  size_t currentIndex,  ElfFile file)

Constructor for creating a saved copy of the range.

this(ElfFile file, types.SegmentType type)Constructor for creating a range that filters segments by type.

structSegmentRange

Forward range for iterating over all segments in an ELF file.

Implements the D InputRange and ForwardRange interfaces, providing lazy access to ElfSegment instances.

Fields

private size_t _currentIndex

private size_t _totalSegments

private ElfFile _file

Methods

typeof(this) save()Save the current state of the range.

bool empty() pure nothrow @nogc @safe constCheck if the range is empty.

ElfSegment front()Get the current segment.

void popFront()Advance to the next segment.

Constructors

this(size_t currentIndex, size_t totalSegments, ElfFile file)Private constructor with state.

this(ElfFile file)Constructor for iterating all segments.

structProgramHeaderBuilder

Builder for creating ELF program headers (segments).

This struct allows incremental construction of a program header table.

Fields

private gelf.ProgramHeader[] _segments

Methods

ProgramHeaderBuilder create() staticCreate a new empty program header builder.

size_t addSegment(types.SegmentType type,  types.SegmentFlags flags,
          ulong  offset,  ulong  vaddr,  ulong  paddr,
          ulong  fileSize,  ulong  memSize,  ulong  alignment)

Add a segment to the program header table.

size_t count() pure nothrow @nogc @safe constGet the number of segments.

gelf.ProgramHeader getSegment(size_t index)Get a segment by index.

ubyte[] build(types.ElfClass cls =  types.ElfClass.CLASS64,
          io.ElfEndian endian =  io.ElfEndian.LITTLE)

Build the final program header table byte array.

size_t entrySize(types.ElfClass cls = types.ElfClass.CLASS64) const pure nothrow @nogc @safeGet the size of a program header entry for the given class.

void clear()Clear all segments from the builder.

Constructors

this(gelf.ProgramHeader[] segments)Private constructor with segment array.

Functions 7

fnsize_t getSegmentCount(ElfFile file)Get the number of program headers (segments) in an ELF file.

fnSegmentRange getSegments(ElfFile file)Get a range for iterating over all segments in an ELF file.

fnElfSegment getSegmentByIndex(ElfFile file, size_t index)Get a segment by its index.

fnSegmentTypeRange getSegmentsByType(ElfFile file, types.SegmentType type)Get a range for iterating over segments of a specific type.

fnSegmentTypeRange getLoadableSegments(ElfFile file)Get a range for iterating over loadable segments (PT_LOAD).

fnSegmentTypeRange getSegmentsContainingSection(ElfFile file, ElfSection section)Get segments that fully contain a specific section.

private fn

bool sectionContainedInSegment(gelf.ProgramHeader phdr,
       gelf.SectionHeader shdr)

Check whether a section is fully contained in a program header.