net.jsign.pe

Class Section

java.lang.Object

net.jsign.pe.Section

public class Section
extends Object

Section of an executable file.

Since:

1.0

Author:

Emmanuel Bourg

Method Summary

Modifier and Type	Method and Description
List<SectionFlag>	getCharacteristics() The flags that describe the characteristics of the section.
String	getName() An 8-byte, null-padded UTF-8 encoded string.
int	getNumberOfLineNumbers() The number of line-number entries for the section.
int	getNumberOfRelocations() The number of relocation entries for the section.
long	getPointerToLineNumbers() The file pointer to the beginning of line-number entries for the section.
long	getPointerToRawData() The file pointer to the first page of the section within the COFF file.
long	getPointerToRelocations() The file pointer to the beginning of relocation entries for the section.
long	getSizeOfRawData() The size of the section (for object files) or the size of the initialized data on disk (for image files).
long	getVirtualAddress() For executable images, the address of the first byte of the section relative to the image base when the section is loaded into memory.
long	getVirtualSize() The total size of the section when loaded into memory.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCharacteristics

public List<SectionFlag> getCharacteristics()

The flags that describe the characteristics of the section.

Returns:

the characteristics flags

getName

public String getName()

An 8-byte, null-padded UTF-8 encoded string. If the string is exactly 8 characters long, there is no terminating null. For longer names, this field contains a slash (/) that is 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 8 characters. Long names in object files are truncated if they are emitted to an executable file.

Returns:

the name of the section

getNumberOfLineNumbers

public int getNumberOfLineNumbers()

The number of line-number entries for the section. This value should be zero for an image because COFF debugging information is deprecated.

Returns:

the number of line-number entries

getNumberOfRelocations

public int getNumberOfRelocations()

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

Returns:

the number of relocation entries

getPointerToLineNumbers

public long getPointerToLineNumbers()

The file pointer to the beginning of line-number entries for the section. This is set to zero if there are no COFF line numbers. This value should be zero for an image because COFF debugging information is deprecated.

Returns:

the file pointer to the beginning of line-number entries

getPointerToRawData

public long getPointerToRawData()

The file pointer to the first page of the section within the COFF file. For executable images, this must be a multiple of FileAlignment from the optional header. For object files, the value should be aligned on a 4 byte boundary for best performance. When a section contains only uninitialized data, this field should be zero.

Returns:

the file pointer to the first page

getPointerToRelocations

public long getPointerToRelocations()

The file pointer to the beginning of relocation entries for the section. This is set to zero for executable images or if there are no relocations.

Returns:

the file pointer to the beginning of relocation entries

getSizeOfRawData

public long getSizeOfRawData()

The size of the section (for object files) or the size of the initialized data on disk (for image files). For executable images, this must be a multiple of FileAlignment from the optional header. If this is less than VirtualSize, the remainder of the section is zero-filled. Because the SizeOfRawData field is rounded but the VirtualSize field is not, it is possible for SizeOfRawData to be greater than VirtualSize as well. When a section contains only uninitialized data, this field should be zero.

Returns:

the size of the section

getVirtualAddress

public long getVirtualAddress()

For executable images, the address of the first byte of the section relative to the image base when the section is loaded into memory. For object files, this field is the address of the first byte before relocation is applied; for simplicity, compilers should set this to zero. Otherwise, it is an arbitrary value that is subtracted from offsets during relocation.

Returns:

the section address relative to the image base address

getVirtualSize

public long getVirtualSize()

The total size of the section when loaded into memory. If this value is greater than SizeOfRawData, the section is zero-padded. This field is valid only for executable images and should be set to zero for object files.

Returns:

the virtual size