Struct pdb2::ImageSectionHeader

pub struct ImageSectionHeader {
    pub name: [u8; 8],
    pub virtual_size: u32,
    pub virtual_address: u32,
    pub size_of_raw_data: u32,
    pub pointer_to_raw_data: u32,
    pub pointer_to_relocations: u32,
    pub pointer_to_line_numbers: u32,
    pub number_of_relocations: u16,
    pub number_of_line_numbers: u16,
    pub characteristics: SectionCharacteristics,
}

A PE IMAGE_SECTION_HEADER, as described in the Microsoft documentation.

Fields

name: [u8; 8]

An 8-byte, null-padded UTF-8 string. There is no terminating null character if the string is exactly eight characters long. For longer names, this member contains a forward slash (/) followed by an ASCII representation of a decimal number that is an offset into the string table. Executable images do not use a string table and do not support section names longer than eight characters.

virtual_size: u32

The total size of the section when loaded into memory, in bytes. If this value is greater than the size_of_raw_data member, the section is filled with zeroes. This field is valid only for executable images and should be set to 0 for object files.

In object files, this field would be replaced with the physical file address. Such headers are never embedded in PDBs.

virtual_address: u32

The address of the first byte of the section when loaded into memory, relative to the image base. For object files, this is the address of the first byte before relocation is applied.

size_of_raw_data: u32

The size of the initialized data on disk, in bytes. This value must be a multiple of the FileAlignment member of the IMAGE_OPTIONAL_HEADER structure. If this value is less than the virtual_size member, the remainder of the section is filled with zeroes. If the section contains only uninitialized data, the member is zero.

pointer_to_raw_data: u32

A file pointer to the first page within the COFF file. This value must be a multiple of the FileAlignment member of the IMAGE_OPTIONAL_HEADER structure. If a section contains only uninitialized data, set this member is zero.

pointer_to_relocations: u32

A file pointer to the beginning of the relocation entries for the section. If there are no relocations, this value is zero.

pointer_to_line_numbers: u32

A file pointer to the beginning of the line-number entries for the section. If there are no COFF line numbers, this value is zero.

number_of_relocations: u16

The number of relocation entries for the section. This value is zero for executable images.

If the value is 0xffff, the actual relocation count is stored in the virtual_address field of the first relocation. It is an error if this flag is set and there are fewer than 0xffff relocations in the section.

number_of_line_numbers: u16

The number of line-number entries for the section.

characteristics: SectionCharacteristics

The characteristics of the image.

Implementations

impl ImageSectionHeader

pub fn name(&self) -> &str

Returns the name of the section.

Trait Implementations

impl Clone for ImageSectionHeader

fn clone(&self) -> ImageSectionHeader

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for ImageSectionHeader

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

Formats the value using the given formatter.

impl Default for ImageSectionHeader

fn default() -> ImageSectionHeader

Returns the “default value” for a type.

impl PartialEq<ImageSectionHeader> for ImageSectionHeader

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for ImageSectionHeader

impl Eq for ImageSectionHeader

impl StructuralEq for ImageSectionHeader

impl StructuralPartialEq for ImageSectionHeader