...

パッケージ pe

import "debug/pe"
概要
目次

概要 ▾

pe パッケージは,PE (Microsoft Windows ポータブル実行可能ファイル) ファイルへのアクセスを実装します。

定数

const (
    IMAGE_FILE_MACHINE_UNKNOWN   = 0x0
    IMAGE_FILE_MACHINE_AM33      = 0x1d3
    IMAGE_FILE_MACHINE_AMD64     = 0x8664
    IMAGE_FILE_MACHINE_ARM       = 0x1c0
    IMAGE_FILE_MACHINE_ARMNT     = 0x1c4
    IMAGE_FILE_MACHINE_ARM64     = 0xaa64
    IMAGE_FILE_MACHINE_EBC       = 0xebc
    IMAGE_FILE_MACHINE_I386      = 0x14c
    IMAGE_FILE_MACHINE_IA64      = 0x200
    IMAGE_FILE_MACHINE_M32R      = 0x9041
    IMAGE_FILE_MACHINE_MIPS16    = 0x266
    IMAGE_FILE_MACHINE_MIPSFPU   = 0x366
    IMAGE_FILE_MACHINE_MIPSFPU16 = 0x466
    IMAGE_FILE_MACHINE_POWERPC   = 0x1f0
    IMAGE_FILE_MACHINE_POWERPCFP = 0x1f1
    IMAGE_FILE_MACHINE_R4000     = 0x166
    IMAGE_FILE_MACHINE_SH3       = 0x1a2
    IMAGE_FILE_MACHINE_SH3DSP    = 0x1a3
    IMAGE_FILE_MACHINE_SH4       = 0x1a6
    IMAGE_FILE_MACHINE_SH5       = 0x1a8
    IMAGE_FILE_MACHINE_THUMB     = 0x1c2
    IMAGE_FILE_MACHINE_WCEMIPSV2 = 0x169
)

IMAGE_DIRECTORY_ENTRY 定数

const (
    IMAGE_DIRECTORY_ENTRY_EXPORT         = 0
    IMAGE_DIRECTORY_ENTRY_IMPORT         = 1
    IMAGE_DIRECTORY_ENTRY_RESOURCE       = 2
    IMAGE_DIRECTORY_ENTRY_EXCEPTION      = 3
    IMAGE_DIRECTORY_ENTRY_SECURITY       = 4
    IMAGE_DIRECTORY_ENTRY_BASERELOC      = 5
    IMAGE_DIRECTORY_ENTRY_DEBUG          = 6
    IMAGE_DIRECTORY_ENTRY_ARCHITECTURE   = 7
    IMAGE_DIRECTORY_ENTRY_GLOBALPTR      = 8
    IMAGE_DIRECTORY_ENTRY_TLS            = 9
    IMAGE_DIRECTORY_ENTRY_LOAD_CONFIG    = 10
    IMAGE_DIRECTORY_ENTRY_BOUND_IMPORT   = 11
    IMAGE_DIRECTORY_ENTRY_IAT            = 12
    IMAGE_DIRECTORY_ENTRY_DELAY_IMPORT   = 13
    IMAGE_DIRECTORY_ENTRY_COM_DESCRIPTOR = 14
)
const COFFSymbolSize = 18

type COFFSymbol 1.1

COFFSymbol は, 1 つの COFF シンボルテーブルレコードを表します。

type COFFSymbol struct {
    Name               [8]uint8
    Value              uint32
    SectionNumber      int16
    Type               uint16
    StorageClass       uint8
    NumberOfAuxSymbols uint8
}

func (*COFFSymbol) FullName 1.8

func (sym *COFFSymbol) FullName(st StringTable) (string, error)

FullName はシンボル sym の実名を見つけます。 通常 name は sym.Name に保存されますが, 8 文字より長い場合は代わりに COFF 文字列テーブル st に保存されます。

type DataDirectory 1.3

type DataDirectory struct {
    VirtualAddress uint32
    Size           uint32
}

type File

File は開いている PE ファイルを表します。

type File struct {
    FileHeader
    OptionalHeader interface{} // 型 *OptionalHeader32 または *OptionalHeader64; added in Go 1.3
    Sections       []*Section
    Symbols        []*Symbol    // 補助シンボルレコードが削除された COFF シンボル; added in Go 1.1
    COFFSymbols    []COFFSymbol // すべての COFF シンボル (補助シンボルレコードを含む); added in Go 1.8
    StringTable    StringTable // Go 1.8
    // エクスポートされていないフィールドがあります
}

func NewFile

func NewFile(r io.ReaderAt) (*File, error)

NewFile は,内部のリーダーの PE バイナリにアクセスするための新しい File を作成します。

func Open

func Open(name string) (*File, error)

Open は, os.Open を使用して名前付きファイルを開き, PE バイナリとして使用するための準備をします。

func (*File) Close

func (f *File) Close() error

Close はファイルを閉じます。 ファイルが Open ではなく NewFile を使用して直接作成された場合, Close は効果がありません。

func (*File) DWARF

func (f *File) DWARF() (*dwarf.Data, error)

func (*File) ImportedLibraries

func (f *File) ImportedLibraries() ([]string, error)

ImportedLibraries は,動的リンク時にバイナリとリンクされると予想されるバイナリ f によって参照されるすべてのライブラリの名前を返します。

func (*File) ImportedSymbols

func (f *File) ImportedSymbols() ([]string, error)

ImportedSymbols は,動的ロード時に他のライブラリによって満たされると予想されるバイナリ f によって参照されるすべてのシンボルの名前を返します。 弱いシンボルを返しません。

func (*File) Section

func (f *File) Section(name string) *Section

Section は与えられた名前の最初のセクションを返します。 そのようなセクションが存在しない場合は nil を返します。

type FileHeader

type FileHeader struct {
    Machine              uint16
    NumberOfSections     uint16
    TimeDateStamp        uint32
    PointerToSymbolTable uint32
    NumberOfSymbols      uint32
    SizeOfOptionalHeader uint16
    Characteristics      uint16
}

type FormatError

FormatError は未使用です。 型は互換性のために保持されています。

type FormatError struct {
}

func (*FormatError) Error

func (e *FormatError) Error() string

type ImportDirectory

type ImportDirectory struct {
    OriginalFirstThunk uint32
    TimeDateStamp      uint32
    ForwarderChain     uint32
    Name               uint32
    FirstThunk         uint32
    // エクスポートされていないフィールドがあります
}

type OptionalHeader32 1.3

type OptionalHeader32 struct {
    Magic                       uint16
    MajorLinkerVersion          uint8
    MinorLinkerVersion          uint8
    SizeOfCode                  uint32
    SizeOfInitializedData       uint32
    SizeOfUninitializedData     uint32
    AddressOfEntryPoint         uint32
    BaseOfCode                  uint32
    BaseOfData                  uint32
    ImageBase                   uint32
    SectionAlignment            uint32
    FileAlignment               uint32
    MajorOperatingSystemVersion uint16
    MinorOperatingSystemVersion uint16
    MajorImageVersion           uint16
    MinorImageVersion           uint16
    MajorSubsystemVersion       uint16
    MinorSubsystemVersion       uint16
    Win32VersionValue           uint32
    SizeOfImage                 uint32
    SizeOfHeaders               uint32
    CheckSum                    uint32
    Subsystem                   uint16
    DllCharacteristics          uint16
    SizeOfStackReserve          uint32
    SizeOfStackCommit           uint32
    SizeOfHeapReserve           uint32
    SizeOfHeapCommit            uint32
    LoaderFlags                 uint32
    NumberOfRvaAndSizes         uint32
    DataDirectory               [16]DataDirectory
}

type OptionalHeader64 1.3

type OptionalHeader64 struct {
    Magic                       uint16
    MajorLinkerVersion          uint8
    MinorLinkerVersion          uint8
    SizeOfCode                  uint32
    SizeOfInitializedData       uint32
    SizeOfUninitializedData     uint32
    AddressOfEntryPoint         uint32
    BaseOfCode                  uint32
    ImageBase                   uint64
    SectionAlignment            uint32
    FileAlignment               uint32
    MajorOperatingSystemVersion uint16
    MinorOperatingSystemVersion uint16
    MajorImageVersion           uint16
    MinorImageVersion           uint16
    MajorSubsystemVersion       uint16
    MinorSubsystemVersion       uint16
    Win32VersionValue           uint32
    SizeOfImage                 uint32
    SizeOfHeaders               uint32
    CheckSum                    uint32
    Subsystem                   uint16
    DllCharacteristics          uint16
    SizeOfStackReserve          uint64
    SizeOfStackCommit           uint64
    SizeOfHeapReserve           uint64
    SizeOfHeapCommit            uint64
    LoaderFlags                 uint32
    NumberOfRvaAndSizes         uint32
    DataDirectory               [16]DataDirectory
}

type Reloc 1.8

Reloc は PE COFF の再配置を表します。 各セクションには独自の再配置リストが含まれています。

type Reloc struct {
    VirtualAddress   uint32
    SymbolTableIndex uint32
    Type             uint16
}

type Section

Section は PE COFF セクションへのアクセスを提供します。

type Section struct {
    SectionHeader
    Relocs []Reloc // Go 1.8

    // ReadAt メソッドに ReaderAt を埋め込みます。
    // Read や Seek を避けるために, SectionReader を直接埋め込んではいけません。
    // クライアントが Read and Seek を望んでいる場合は,他のクライアントとのシークオフセットの競合を避けるために Open() を使用する必要があります。
    io.ReaderAt
    // エクスポートされていないフィールドがあります
}

func (*Section) Data

func (s *Section) Data() ([]byte, error)

Data は PE セクションの内容を読み取り,返します。

func (*Section) Open

func (s *Section) Open() io.ReadSeeker

Open は PE セクションを読んでいる新しい ReadSeeker を返します。

type SectionHeader

SectionHeader は, Name フィールドが Go 文字列に置き換えられた SectionHeader32 に似ています。

type SectionHeader struct {
    Name                 string
    VirtualSize          uint32
    VirtualAddress       uint32
    Size                 uint32
    Offset               uint32
    PointerToRelocations uint32
    PointerToLineNumbers uint32
    NumberOfRelocations  uint16
    NumberOfLineNumbers  uint16
    Characteristics      uint32
}

type SectionHeader32

SectionHeader32 は実際の PE COFF セクションヘッダーを表します。

type SectionHeader32 struct {
    Name                 [8]uint8
    VirtualSize          uint32
    VirtualAddress       uint32
    SizeOfRawData        uint32
    PointerToRawData     uint32
    PointerToRelocations uint32
    PointerToLineNumbers uint32
    NumberOfRelocations  uint16
    NumberOfLineNumbers  uint16
    Characteristics      uint32
}

type StringTable 1.8

StringTable は COFF 文字列テーブルです。

type StringTable []byte

func (StringTable) String 1.8

func (st StringTable) String(start uint32) (string, error)

String は,オフセット開始位置で COFF 文字列テーブル st から文字列を抽出します。

type Symbol 1.1

Symbol は, COFFSymbol の Name フィールドを Go 文字列に置き換えたものに似ています。 Symbol には NumberOfAuxSymbols もありません。

type Symbol struct {
    Name          string
    Value         uint32
    SectionNumber int16
    Type          uint16
    StorageClass  uint8
}