Package ghidra.app.util.bin.format.pe
Class SectionHeader
java.lang.Object
ghidra.app.util.bin.format.pe.SectionHeader
- All Implemented Interfaces:
ByteArrayConverter
,StructConverter
A class to the represent the IMAGE_SECTION_HEADER
struct as defined in
winnt.h
.
typedef struct _IMAGE_SECTION_HEADER { BYTE Name[IMAGE_SIZEOF_SHORT_NAME]; union { DWORD PhysicalAddress; DWORD VirtualSize; // MANDATORY } Misc; DWORD VirtualAddress; // MANDATORY DWORD SizeOfRawData; // MANDATORY DWORD PointerToRawData; // MANDATORY DWORD PointerToRelocations; DWORD PointerToLinenumbers; WORD NumberOfRelocations; WORD NumberOfLinenumbers; DWORD Characteristics; // MANDATORY } IMAGE_SECTION_HEADER, *PIMAGE_SECTION_HEADER; *
#define IMAGE_SIZEOF_SECTION_HEADER 40
*-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
Align on 1024-byte boundary.static final int
Align on 128-byte boundary.static final int
Align on 16-byte boundary.static final int
Align on 1-byte boundary.static final int
Align on 2048-byte boundary.static final int
Align on 256-byte boundary.static final int
Align on 2-byte boundary.static final int
Align on 32-byte boundary.static final int
Align on 4096-byte boundary.static final int
Align on 4-byte boundary.static final int
Align on 512-byte boundary.static final int
Align on 64-byte boundary.static final int
Align on 8192-byte boundary.static final int
Align on 8-byte boundary.static final int
Section contains code.static final int
Section contains initialized data.static final int
Section contains uninitialized data.static final int
Section content can be accessed relative to GP.static final int
Section contents is communal data (comdat).static final int
Section contains information for use by the linker.static final int
Section contains extended relocations.static final int
Section contents will not become part of the image.static final int
The section can be discarded from the final executable.static final int
Section is executable.static final int
Section is not cachable.static final int
The section is not pageable, so it should always be physically present in memory.static final int
Section is readable.static final int
Section is shareable.static final int
Section is writeable.static final int
Reset speculative exceptions handling bits in the TLB entries for this section.static final int
The size of the section header.static final int
The size of the section header short name.static final String
The name to use when converting into a structure data type.static final int
-
Method Summary
Modifier and TypeMethodDescriptionint
Returns the flags OR'ed together, indicating the attributes of this section.Returns an input stream to underlying bytes of this section.getName()
Returns the ASCII name of the section.short
Returns the number of line numbers pointed to by the NumberOfRelocations field.short
Returns the number of relocations pointed to by the PointerToRelocations field.int
Returns the physical (file) address of this section.int
Return the file offset for COFF-style line numbers for this section.int
Returns the file offset where the data for the section begins.int
Returns the file offset of relocations for this section.Returns a readable ascii version of the name.int
Returns the size (in bytes) of data stored for the section in the executable or OBJ.int
In executables, returns the RVA where the section begins in memory.int
Returns the actual, used size of the section.static SectionHeader
readSectionHeader
(BinaryReader reader, long index, long stringTableOffset) Read aSectionHeader
from the specified stream starting atindex
.void
setSizeOfRawData
(int size) void
setVirtualSize
(int size) byte[]
toBytes
(DataConverter dc) Returns a byte array representing this implementor of this interface.Returns a structure datatype representing the contents of the implementor of this interface.toString()
void
writeBytes
(RandomAccessFile raf, int rafIndex, DataConverter dc, MemoryBlock block, boolean useBlockBytes) Writes the bytes from this section into the specified random access file.void
writeHeader
(RandomAccessFile raf, DataConverter dc) Writes this section header to the specified random access file.
-
Field Details
-
NAME
The name to use when converting into a structure data type.- See Also:
-
IMAGE_SIZEOF_SHORT_NAME
public static final int IMAGE_SIZEOF_SHORT_NAMEThe size of the section header short name.- See Also:
-
IMAGE_SIZEOF_SECTION_HEADER
public static final int IMAGE_SIZEOF_SECTION_HEADERThe size of the section header.- See Also:
-
IMAGE_SCN_CNT_CODE
public static final int IMAGE_SCN_CNT_CODESection contains code.- See Also:
-
IMAGE_SCN_CNT_INITIALIZED_DATA
public static final int IMAGE_SCN_CNT_INITIALIZED_DATASection contains initialized data.- See Also:
-
IMAGE_SCN_CNT_UNINITIALIZED_DATA
public static final int IMAGE_SCN_CNT_UNINITIALIZED_DATASection contains uninitialized data.- See Also:
-
IMAGE_SCN_LNK_INFO
public static final int IMAGE_SCN_LNK_INFOSection contains information for use by the linker. Only exists in OBJs.- See Also:
-
IMAGE_SCN_LNK_REMOVE
public static final int IMAGE_SCN_LNK_REMOVESection contents will not become part of the image. This only appears in OBJ files.- See Also:
-
IMAGE_SCN_LNK_COMDAT
public static final int IMAGE_SCN_LNK_COMDATSection contents is communal data (comdat). Communal data is data (or code) that can be defined in multiple OBJs. The linker will select one copy to include in the executable. Comdats are vital for support of C++ template functions and function-level linking. Comdat sections only appear in OBJ files.- See Also:
-
IMAGE_SCN_NO_DEFER_SPEC_EXC
public static final int IMAGE_SCN_NO_DEFER_SPEC_EXCReset speculative exceptions handling bits in the TLB entries for this section.- See Also:
-
IMAGE_SCN_GPREL
public static final int IMAGE_SCN_GPRELSection content can be accessed relative to GP.- See Also:
-
IMAGE_SCN_ALIGN_1BYTES
public static final int IMAGE_SCN_ALIGN_1BYTESAlign on 1-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_2BYTES
public static final int IMAGE_SCN_ALIGN_2BYTESAlign on 2-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_4BYTES
public static final int IMAGE_SCN_ALIGN_4BYTESAlign on 4-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_8BYTES
public static final int IMAGE_SCN_ALIGN_8BYTESAlign on 8-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_16BYTES
public static final int IMAGE_SCN_ALIGN_16BYTESAlign on 16-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_32BYTES
public static final int IMAGE_SCN_ALIGN_32BYTESAlign on 32-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_64BYTES
public static final int IMAGE_SCN_ALIGN_64BYTESAlign on 64-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_128BYTES
public static final int IMAGE_SCN_ALIGN_128BYTESAlign on 128-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_256BYTES
public static final int IMAGE_SCN_ALIGN_256BYTESAlign on 256-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_512BYTES
public static final int IMAGE_SCN_ALIGN_512BYTESAlign on 512-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_1024BYTES
public static final int IMAGE_SCN_ALIGN_1024BYTESAlign on 1024-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_2048BYTES
public static final int IMAGE_SCN_ALIGN_2048BYTESAlign on 2048-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_4096BYTES
public static final int IMAGE_SCN_ALIGN_4096BYTESAlign on 4096-byte boundary.- See Also:
-
IMAGE_SCN_ALIGN_8192BYTES
public static final int IMAGE_SCN_ALIGN_8192BYTESAlign on 8192-byte boundary.- See Also:
-
IMAGE_SCN_LNK_NRELOC_OVFL
public static final int IMAGE_SCN_LNK_NRELOC_OVFLSection contains extended relocations.- See Also:
-
IMAGE_SCN_MEM_DISCARDABLE
public static final int IMAGE_SCN_MEM_DISCARDABLEThe section can be discarded from the final executable. Used to hold information for the linker's use, including the .debug$ sections.- See Also:
-
IMAGE_SCN_MEM_NOT_CACHED
public static final int IMAGE_SCN_MEM_NOT_CACHEDSection is not cachable.- See Also:
-
IMAGE_SCN_MEM_NOT_PAGED
public static final int IMAGE_SCN_MEM_NOT_PAGEDThe section is not pageable, so it should always be physically present in memory. Often used for kernel-mode drivers.- See Also:
-
IMAGE_SCN_MEM_SHARED
public static final int IMAGE_SCN_MEM_SHAREDSection is shareable. The physical pages containing this section's data will be shared between all processes that have this executable loaded. Thus, every process will see the exact same values for data in this section. Useful for making global variables shared between all instances of a process. To make a section shared, use the /section:name,S linker switch.- See Also:
-
IMAGE_SCN_MEM_EXECUTE
public static final int IMAGE_SCN_MEM_EXECUTESection is executable.- See Also:
-
IMAGE_SCN_MEM_READ
public static final int IMAGE_SCN_MEM_READSection is readable.- See Also:
-
IMAGE_SCN_MEM_WRITE
public static final int IMAGE_SCN_MEM_WRITESection is writeable.- See Also:
-
NOT_SET
public static final int NOT_SET- See Also:
-
-
Method Details
-
readSectionHeader
public static SectionHeader readSectionHeader(BinaryReader reader, long index, long stringTableOffset) throws IOException Read aSectionHeader
from the specified stream starting atindex
.- Parameters:
reader
-BinaryReader
to read fromindex
- long offset in the reader where the section header startsstringTableOffset
- offset of the string table, or -1 if not available- Returns:
- new
SectionHeader
- Throws:
IOException
- if error reading data
-
getName
Returns the ASCII name of the section. A section name is not guaranteed to be null-terminated. If you specify a section name longer than eight characters, the linker truncates it to eight characters in the executable. A mechanism exists for allowing longer section names in OBJ files. Section names often start with a period, but this is not a requirement. Section names with a $ in the name get special treatment from the linker. Sections with identical names prior to the $ character are merged. The characters following the $ provide an alphabetic ordering for how the merged sections appear in the final section. There's quite a bit more to the subject of sections with $ in the name and how they're combined, but the details are outside the scope of this article- Returns:
- the ASCII name of the section
-
getReadableName
Returns a readable ascii version of the name. All non-readable characters are replaced with underscores.- Returns:
- a readable ascii version of the name
-
getPhysicalAddress
public int getPhysicalAddress()Returns the physical (file) address of this section.- Returns:
- the physical (file) address of this section
-
getVirtualAddress
public int getVirtualAddress()In executables, returns the RVA where the section begins in memory. Should be set to 0 in OBJs. this section should be loaded into memory.- Returns:
- the RVA where the section begins in memory.
-
getVirtualSize
public int getVirtualSize()Returns the actual, used size of the section. This field may be larger or smaller than the SizeOfRawData field. If the VirtualSize is larger, the SizeOfRawData field is the size of the initialized data from the executable, and the remaining bytes up to the VirtualSize should be zero-padded. This field is set to 0 in OBJ files.- Returns:
- the actual, used size of the section
-
getSizeOfRawData
public int getSizeOfRawData()Returns the size (in bytes) of data stored for the section in the executable or OBJ.- Returns:
- the size (in bytes) of data stored for the section
-
getPointerToRawData
public int getPointerToRawData()Returns the file offset where the data for the section begins. For executables, this value must be a multiple of the file alignment given in the PE header.If a section is uninitialized, this value will be 0.
- Returns:
- the file offset where the data for the section begins
-
getPointerToRelocations
public int getPointerToRelocations()Returns the file offset of relocations for this section.- Returns:
- the file offset of relocations for this section
-
getNumberOfRelocations
public short getNumberOfRelocations()Returns the number of relocations pointed to by the PointerToRelocations field.- Returns:
- the number of relocations
-
getPointerToLinenumbers
public int getPointerToLinenumbers()Return the file offset for COFF-style line numbers for this section.- Returns:
- the file offset for COFF-style line numbers for this section
-
getCharacteristics
public int getCharacteristics()Returns the flags OR'ed together, indicating the attributes of this section. Many of these flags can be set with the linker's /SECTION option. Common values include those listed in Figure 7.- Returns:
- the flags OR'ed together, indicating the attributes of this section
-
getNumberOfLinenumbers
public short getNumberOfLinenumbers()Returns the number of line numbers pointed to by the NumberOfRelocations field.- Returns:
- the number of line numbers
-
toBytes
Description copied from interface:ByteArrayConverter
Returns a byte array representing this implementor of this interface.- Specified by:
toBytes
in interfaceByteArrayConverter
- Parameters:
dc
- the data converter to use- Returns:
- a byte array representing this object
- Throws:
IOException
- if an IO-related error occurs
-
getDataStream
Returns an input stream to underlying bytes of this section.- Returns:
- an input stream to underlying bytes of this section
- Throws:
IOException
- if an i/o error occurs.
-
toString
-
toDataType
Description copied from interface:StructConverter
Returns a structure datatype representing the contents of the implementor of this interface.For example, given:
class A { int foo; double bar; }
The return value should be a structure data type with two data type components; an INT and a DOUBLE. The structure should contain field names and, if possible, field comments.
- Specified by:
toDataType
in interfaceStructConverter
- Returns:
- returns a structure datatype representing the implementor of this interface
- Throws:
DuplicateNameException
- when a datatype of the same name already exists- See Also:
-
writeHeader
Writes this section header to the specified random access file.- Parameters:
raf
- the random access filedc
- the data converter- Throws:
IOException
- if an I/O error occurs
-
writeBytes
public void writeBytes(RandomAccessFile raf, int rafIndex, DataConverter dc, MemoryBlock block, boolean useBlockBytes) throws IOException, MemoryAccessException Writes the bytes from this section into the specified random access file. The bytes will be written starting at the byte position specified bygetPointerToRawData()
.- Parameters:
raf
- the random access filerafIndex
- the index into the RAF where the bytes will be writtendc
- the data converterblock
- the memory block corresponding to this sectionuseBlockBytes
- if true, then use the bytes from the memory block, otherwise use the bytes from this section.- Throws:
IOException
- if there are errors writing to the fileMemoryAccessException
- if the byte from the memory block cannot be accesses
-
setVirtualSize
public void setVirtualSize(int size) -
setSizeOfRawData
public void setSizeOfRawData(int size)
-