PEFile (Jsign - Code signing for Windows executables (Core) 2.1-signserver5.1 API)

java.lang.Object
- net.jsign.pe.PEFile

All Implemented Interfaces:

Closeable, AutoCloseable
```
public class PEFile
extends Object
implements Closeable
```
Portable Executable File. This class is thread safe.

Since:

1.0

Author:

Emmanuel Bourg

See Also:

Microsoft PE and COFF Specification

Constructor Summary

Constructors
Constructor and Description

PEFile(File file)
Create a PEFile from the specified file.

PEFile(SeekableByteChannel channel)
Create a PEFile from the specified channel.

Constructors
Constructor and Description
`PEFile(File file)` Create a PEFile from the specified file.
`PEFile(SeekableByteChannel channel)` Create a PEFile from the specified channel.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`close()`
`long`	`computeChecksum()` Compute the checksum of the image file.
`byte[]`	`computeDigest(DigestAlgorithm algorithm)` Compute the checksum of the file using the specified digest algorithm.
`long`	`getAddressOfEntryPoint()` The address of the entry point relative to the image base when the executable file is loaded into memory.
`long`	`getBaseOfCode()` The address that is relative to the image base of the beginning-of-code section when it is loaded into memory.
`long`	`getBaseOfData()` The address that is relative to the image base of the beginning-of-data section when it is loaded into memory (PE32 only).
`int`	`getCharacteristics()` The flags that indicate the attributes of the file.
`long`	`getCheckSum()` The image file checksum.
`DataDirectory`	`getDataDirectory(DataDirectoryType type)` Returns the data directory of the specified type.
`int`	`getDllCharacteristics()`
`long`	`getFileAlignment()` The alignment factor (in bytes) that is used to align the raw data of sections in the image file.
`PEFormat`	`getFormat()`
`long`	`getImageBase()` The preferred address of the first byte of image when loaded into memory; must be a multiple of 64 K.
`long`	`getLoaderFlags()` Reserved, must be zero.
`MachineType`	`getMachineType()`
`int`	`getMajorImageVersion()` The major version number of the image.
`int`	`getMajorLinkerVersion()` The linker major version number.
`int`	`getMajorOperatingSystemVersion()` The major version number of the required operating system.
`int`	`getMajorSubsystemVersion()` The major version number of the subsystem.
`int`	`getMinorImageVersion()` The minor version number of the image.
`int`	`getMinorLinkerVersion()` The linker minor version number.
`int`	`getMinorOperatingSystemVersion()` The minor version number of the required operating system.
`int`	`getMinorSubsystemVersion()` The minor version number of the subsystem.
`int`	`getNumberOfRvaAndSizes()` The number of data-directory entries in the remainder of the optional header.
`int`	`getNumberOfSections()` The number of sections.
`long`	`getNumberOfSymbols()` The number of entries in the symbol table.
`long`	`getPointerToSymbolTable()` The file offset of the COFF symbol table, or zero if no COFF symbol table is present.
`long`	`getSectionAlignment()` The alignment (in bytes) of sections when they are loaded into memory.
`List<Section>`	`getSections()`
`List<CMSSignedData>`	`getSignatures()` Returns the authenticode signatures on the file.
`long`	`getSizeOfCode()` The size of the code (text) section, or the sum of all code sections if there are multiple sections.
`long`	`getSizeOfHeaders()` The combined size of an MS DOS stub, PE header, and section headers rounded up to a multiple of FileAlignment.
`long`	`getSizeOfHeapCommit()` The size of the local heap space to commit.
`long`	`getSizeOfHeapReserve()` The size of the local heap space to reserve.
`long`	`getSizeOfImage()` The size (in bytes) of the image, including all headers, as the image is loaded in memory.
`long`	`getSizeOfInitializedData()` The size of the initialized data section, or the sum of all such sections if there are multiple data sections.
`int`	`getSizeOfOptionalHeader()` The size of the optional header, which is required for executable files but not for object files.
`long`	`getSizeOfStackCommit()` The size of the stack to commit.
`long`	`getSizeOfStackReserve()` The size of the stack to reserve.
`long`	`getSizeOfUninitializedData()` The size of the uninitialized data section (BSS), or the sum of all such sections if there are multiple BSS sections.
`Subsystem`	`getSubsystem()` The subsystem that is required to run this image.
`Date`	`getTimeDateStamp()` The low 32 bits of the number of seconds since 00:00 January 1, 1970 (a C runtime time_t value), that indicates when the file was created.
`long`	`getWin32VersionValue()` Reserved, must be zero.
`void`	`pad(int multiple)` Increase the size of the file up to a size that is a multiple of the specified value.
`void`	`printInfo(OutputStream out)` Print detailed informations about the PE file.
`void`	`printInfo(PrintWriter out)` Print detailed informations about the PE file.
`void`	`updateChecksum()`
`void`	`writeDataDirectory(DataDirectoryType type, byte[] data)` Writes the data directory of the specified type.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - PEFile
```
public PEFile(File file)
       throws IOException
```
    Create a PEFile from the specified file.
    
    Parameters:
    
    file -
    
    Throws:
    
    IOException
  - PEFile
```
public PEFile(SeekableByteChannel channel)
       throws IOException
```
    Create a PEFile from the specified channel.
    
    Throws:
    
    IOException
    
    Since:
    
    2.0
- Method Detail
  - close
```
public void close()
           throws IOException
```
    Specified by:
    
    close in interface Closeable
    
    Specified by:
    
    close in interface AutoCloseable
    
    Throws:
    
    IOException
  - computeChecksum
```
public long computeChecksum()
```
    Compute the checksum of the image file. The algorithm for computing the checksum is incorporated into IMAGHELP.DLL.
  - computeDigest
```
public byte[] computeDigest(DigestAlgorithm algorithm)
                     throws IOException
```
    Compute the checksum of the file using the specified digest algorithm.
    
    Parameters:
    
    algorithm - the digest algorithm, typically SHA1
    
    Throws:
    
    IOException
  - getAddressOfEntryPoint
```
public long getAddressOfEntryPoint()
```
    The address of the entry point relative to the image base when the executable file is loaded into memory. For program images, this is the starting address. For device drivers, this is the address of the initialization function. An entry point is optional for DLLs. When no entry point is present, this field must be zero.
  - getBaseOfCode
```
public long getBaseOfCode()
```
    The address that is relative to the image base of the beginning-of-code section when it is loaded into memory.
  - getBaseOfData
```
public long getBaseOfData()
```
    The address that is relative to the image base of the beginning-of-data section when it is loaded into memory (PE32 only).
  - getCharacteristics
```
public int getCharacteristics()
```
    The flags that indicate the attributes of the file.
  - getCheckSum
```
public long getCheckSum()
```
    The image file checksum.
  - getDataDirectory
```
public DataDirectory getDataDirectory(DataDirectoryType type)
```
    Returns the data directory of the specified type.
  - getDllCharacteristics
```
public int getDllCharacteristics()
```
  - getFileAlignment
```
public long getFileAlignment()
```
    The alignment factor (in bytes) that is used to align the raw data of sections in the image file. The value should be a power of 2 between 512 and 64 K, inclusive. The default is 512. If the SectionAlignment is less than the architecture?s page size, then FileAlignment must match SectionAlignment.
  - getFormat
```
public PEFormat getFormat()
```
  - getImageBase
```
public long getImageBase()
```
    The preferred address of the first byte of image when loaded into memory; must be a multiple of 64 K. The default for DLLs is 0x10000000. The default for Windows CE EXEs is 0x00010000. The default for Windows NT, Windows 2000, Windows XP, Windows 95, Windows 98, and Windows Me is 0x00400000.
  - getLoaderFlags
```
public long getLoaderFlags()
```
    Reserved, must be zero.
  - getMachineType
```
public MachineType getMachineType()
```
  - getMajorImageVersion
```
public int getMajorImageVersion()
```
    The major version number of the image.
  - getMajorLinkerVersion
```
public int getMajorLinkerVersion()
```
    The linker major version number.
  - getMajorOperatingSystemVersion
```
public int getMajorOperatingSystemVersion()
```
    The major version number of the required operating system.
  - getMajorSubsystemVersion
```
public int getMajorSubsystemVersion()
```
    The major version number of the subsystem.
  - getMinorImageVersion
```
public int getMinorImageVersion()
```
    The minor version number of the image.
  - getMinorLinkerVersion
```
public int getMinorLinkerVersion()
```
    The linker minor version number.
  - getMinorOperatingSystemVersion
```
public int getMinorOperatingSystemVersion()
```
    The minor version number of the required operating system.
  - getMinorSubsystemVersion
```
public int getMinorSubsystemVersion()
```
    The minor version number of the subsystem.
  - getNumberOfRvaAndSizes
```
public int getNumberOfRvaAndSizes()
```
    The number of data-directory entries in the remainder of the optional header. Each describes a location and size.
  - getNumberOfSections
```
public int getNumberOfSections()
```
    The number of sections. This indicates the size of the section table, which immediately follows the headers.
  - getNumberOfSymbols
```
public long getNumberOfSymbols()
```
    The number of entries in the symbol table. This data can be used to locate the string table, which immediately follows the symbol table. This value should be zero for an image because COFF debugging information is deprecated.
  - getPointerToSymbolTable
```
public long getPointerToSymbolTable()
```
    The file offset of the COFF symbol table, or zero if no COFF symbol table is present. This value should be zero for an image because COFF debugging information is deprecated.
  - getSectionAlignment
```
public long getSectionAlignment()
```
    The alignment (in bytes) of sections when they are loaded into memory. It must be greater than or equal to FileAlignment. The default is the page size for the architecture.
  - getSections
```
public List<Section> getSections()
```
  - getSignatures
```
public List<CMSSignedData> getSignatures()
```
    Returns the authenticode signatures on the file.
  - getSizeOfCode
```
public long getSizeOfCode()
```
    The size of the code (text) section, or the sum of all code sections if there are multiple sections.
  - getSizeOfHeaders
```
public long getSizeOfHeaders()
```
    The combined size of an MS DOS stub, PE header, and section headers rounded up to a multiple of FileAlignment.
  - getSizeOfHeapCommit
```
public long getSizeOfHeapCommit()
```
    The size of the local heap space to commit.
  - getSizeOfHeapReserve
```
public long getSizeOfHeapReserve()
```
    The size of the local heap space to reserve. Only SizeOfHeapCommit is committed; the rest is made available one page at a time until the reserve size is reached.
  - getSizeOfImage
```
public long getSizeOfImage()
```
    The size (in bytes) of the image, including all headers, as the image is loaded in memory. It must be a multiple of SectionAlignment.
  - getSizeOfInitializedData
```
public long getSizeOfInitializedData()
```
    The size of the initialized data section, or the sum of all such sections if there are multiple data sections.
  - getSizeOfOptionalHeader
```
public int getSizeOfOptionalHeader()
```
    The size of the optional header, which is required for executable files but not for object files. This value should be zero for an object file.
  - getSizeOfStackCommit
```
public long getSizeOfStackCommit()
```
    The size of the stack to commit.
  - getSizeOfStackReserve
```
public long getSizeOfStackReserve()
```
    The size of the stack to reserve. Only SizeOfStackCommit is committed; the rest is made available one page at a time until the reserve size is reached.
  - getSizeOfUninitializedData
```
public long getSizeOfUninitializedData()
```
    The size of the uninitialized data section (BSS), or the sum of all such sections if there are multiple BSS sections.
  - getSubsystem
```
public Subsystem getSubsystem()
```
    The subsystem that is required to run this image.
  - getTimeDateStamp
```
public Date getTimeDateStamp()
```
    The low 32 bits of the number of seconds since 00:00 January 1, 1970 (a C runtime time_t value), that indicates when the file was created.
  - getWin32VersionValue
```
public long getWin32VersionValue()
```
    Reserved, must be zero.
  - pad
```
public void pad(int multiple)
         throws IOException
```
    Increase the size of the file up to a size that is a multiple of the specified value.
    
    Parameters:
    
    multiple -
    
    Throws:
    
    IOException
  - printInfo
```
public void printInfo(OutputStream out)
```
    Print detailed informations about the PE file.
  - printInfo
```
public void printInfo(PrintWriter out)
```
    Print detailed informations about the PE file.
  - updateChecksum
```
public void updateChecksum()
```
  - writeDataDirectory
```
public void writeDataDirectory(DataDirectoryType type,
                               byte[] data)
                        throws IOException
```
    Writes the data directory of the specified type. The data is either appended at the end of the file or written over the previous data of the same type if there is enough space.
    
    Parameters:
    
    type - the type of the data directory
    
    data - the content of the data directory
    
    Throws:
    
    IOException

Class PEFile

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

PEFile

PEFile

Method Detail

close

computeChecksum

computeDigest

getAddressOfEntryPoint

getBaseOfCode

getBaseOfData

getCharacteristics

getCheckSum

getDataDirectory

getDllCharacteristics

getFileAlignment

getFormat

getImageBase

getLoaderFlags

getMachineType

getMajorImageVersion

getMajorLinkerVersion

getMajorOperatingSystemVersion

getMajorSubsystemVersion

getMinorImageVersion

getMinorLinkerVersion

getMinorOperatingSystemVersion

getMinorSubsystemVersion

getNumberOfRvaAndSizes

getNumberOfSections

getNumberOfSymbols

getPointerToSymbolTable

getSectionAlignment

getSections

getSignatures

getSizeOfCode

getSizeOfHeaders

getSizeOfHeapCommit

getSizeOfHeapReserve

getSizeOfImage

getSizeOfInitializedData

getSizeOfOptionalHeader

getSizeOfStackCommit

getSizeOfStackReserve

getSizeOfUninitializedData

getSubsystem

getTimeDateStamp

getWin32VersionValue

pad

printInfo

printInfo

updateChecksum

writeDataDirectory