...

パッケージ macho

import "debug/macho"
概要
目次

概要 ▾

macho パッケージは,Mach-O オブジェクトファイルへのアクセスを実装します。

目次 ▾

定数
変数
type Cpu
    func (i Cpu) GoString() string
    func (i Cpu) String() string
type Dylib
type DylibCmd
type Dysymtab
type DysymtabCmd
type FatArch
type FatArchHeader
type FatFile
    func NewFatFile(r io.ReaderAt) (*FatFile, error)
    func OpenFat(name string) (*FatFile, error)
    func (ff *FatFile) Close() error
type File
    func NewFile(r io.ReaderAt) (*File, error)
    func Open(name string) (*File, error)
    func (f *File) Close() error
    func (f *File) DWARF() (*dwarf.Data, error)
    func (f *File) ImportedLibraries() ([]string, error)
    func (f *File) ImportedSymbols() ([]string, error)
    func (f *File) Section(name string) *Section
    func (f *File) Segment(name string) *Segment
type FileHeader
type FormatError
    func (e *FormatError) Error() string
type Load
type LoadBytes
    func (b LoadBytes) Raw() []byte
type LoadCmd
    func (i LoadCmd) GoString() string
    func (i LoadCmd) String() string
type Nlist32
type Nlist64
type Regs386
type RegsAMD64
type Reloc
type RelocTypeARM
    func (r RelocTypeARM) GoString() string
    func (i RelocTypeARM) String() string
type RelocTypeARM64
    func (r RelocTypeARM64) GoString() string
    func (i RelocTypeARM64) String() string
type RelocTypeGeneric
    func (r RelocTypeGeneric) GoString() string
    func (i RelocTypeGeneric) String() string
type RelocTypeX86_64
    func (r RelocTypeX86_64) GoString() string
    func (i RelocTypeX86_64) String() string
type Rpath
type RpathCmd
type Section
    func (s *Section) Data() ([]byte, error)
    func (s *Section) Open() io.ReadSeeker
type Section32
type Section64
type SectionHeader
type Segment
    func (s *Segment) Data() ([]byte, error)
    func (s *Segment) Open() io.ReadSeeker
type Segment32
type Segment64
type SegmentHeader
type Symbol
type Symtab
type SymtabCmd
type Thread
type Type
    func (t Type) GoString() string
    func (t Type) String() string

パッケージファイル

fat.go file.go macho.go reloctype.go reloctype_string.go

定数

const (
    Magic32  uint32 = 0xfeedface
    Magic64  uint32 = 0xfeedfacf
    MagicFat uint32 = 0xcafebabe
)
const (
    FlagNoUndefs              uint32 = 0x1
    FlagIncrLink              uint32 = 0x2
    FlagDyldLink              uint32 = 0x4
    FlagBindAtLoad            uint32 = 0x8
    FlagPrebound              uint32 = 0x10
    FlagSplitSegs             uint32 = 0x20
    FlagLazyInit              uint32 = 0x40
    FlagTwoLevel              uint32 = 0x80
    FlagForceFlat             uint32 = 0x100
    FlagNoMultiDefs           uint32 = 0x200
    FlagNoFixPrebinding       uint32 = 0x400
    FlagPrebindable           uint32 = 0x800
    FlagAllModsBound          uint32 = 0x1000
    FlagSubsectionsViaSymbols uint32 = 0x2000
    FlagCanonical             uint32 = 0x4000
    FlagWeakDefines           uint32 = 0x8000
    FlagBindsToWeak           uint32 = 0x10000
    FlagAllowStackExecution   uint32 = 0x20000
    FlagRootSafe              uint32 = 0x40000
    FlagSetuidSafe            uint32 = 0x80000
    FlagNoReexportedDylibs    uint32 = 0x100000
    FlagPIE                   uint32 = 0x200000
    FlagDeadStrippableDylib   uint32 = 0x400000
    FlagHasTLVDescriptors     uint32 = 0x800000
    FlagNoHeapExecution       uint32 = 0x1000000
    FlagAppExtensionSafe      uint32 = 0x2000000
)

変数

ErrNotFat は,ファイルがユニバーサルバイナリではなく,そのマジックナンバーに基づいてシンバイナリである場合に, NewFatFile または OpenFat から返されます。

var ErrNotFat = &FormatError{0, "not a fat Mach-O file", nil}

type Cpu

CPU は Mach-OCPU 型です。

type Cpu uint32
const (
    Cpu386   Cpu = 7
    CpuAmd64 Cpu = Cpu386 | cpuArch64
    CpuArm   Cpu = 12
    CpuArm64 Cpu = CpuArm | cpuArch64
    CpuPpc   Cpu = 18
    CpuPpc64 Cpu = CpuPpc | cpuArch64
)

func (Cpu) GoString

func (i Cpu) GoString() string

func (Cpu) String

func (i Cpu) String() string

type Dylib

Dylib は Mach-O load dynamic ライブラリコマンドを表します。

type Dylib struct {
    LoadBytes
    Name           string
    Time           uint32
    CurrentVersion uint32
    CompatVersion  uint32
}

type DylibCmd

DylibCmd は Mach-O load dynamic ライブラリコマンドです。

type DylibCmd struct {
    Cmd            LoadCmd
    Len            uint32
    Name           uint32
    Time           uint32
    CurrentVersion uint32
    CompatVersion  uint32
}

type Dysymtab

Dysymtab は Mach-O 動的シンボルテーブルコマンドを表します。

type Dysymtab struct {
    LoadBytes
    DysymtabCmd
    IndirectSyms []uint32 // Symtab.Syms へのインデックス
}

type DysymtabCmd

DysymtabCmd は Mach-O 動的シンボルテーブルコマンドです。

type DysymtabCmd struct {
    Cmd            LoadCmd
    Len            uint32
    Ilocalsym      uint32
    Nlocalsym      uint32
    Iextdefsym     uint32
    Nextdefsym     uint32
    Iundefsym      uint32
    Nundefsym      uint32
    Tocoffset      uint32
    Ntoc           uint32
    Modtaboff      uint32
    Nmodtab        uint32
    Extrefsymoff   uint32
    Nextrefsyms    uint32
    Indirectsymoff uint32
    Nindirectsyms  uint32
    Extreloff      uint32
    Nextrel        uint32
    Locreloff      uint32
    Nlocrel        uint32
}

type FatArch 1.3

FatArch は FatFile の中の Mach-O ファイルです。

type FatArch struct {
    FatArchHeader
    *File
}

type FatArchHeader 1.3

FatArchHeader は,特定の画像アーキテクチャ用のファットヘッダを表します。

type FatArchHeader struct {
    Cpu    Cpu
    SubCpu uint32
    Offset uint32
    Size   uint32
    Align  uint32
}

type FatFile 1.3

FatFile は,少なくとも 1 つのアーキテクチャを含む Mach-O ユニバーサルバイナリです。

type FatFile struct {
    Magic  uint32
    Arches []FatArch
    // エクスポートされていないフィールドがあります
}

func NewFatFile 1.3

func NewFatFile(r io.ReaderAt) (*FatFile, error)

NewFatFile は,ユニバーサルバイナリですべての Mach-O イメージにアクセスするための新しい FatFile を作成します。 Mach-O バイナリは, ReaderAt の位置 0 から始まると予想されます。

func OpenFat 1.3

func OpenFat(name string) (*FatFile, error)

OpenFat は os.Open を使って名前付きファイルを開き, Mach-O ユニバーサルバイナリとして使用する準備をします。

func (*FatFile) Close 1.3

func (ff *FatFile) Close() error

type File

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

type File struct {
    FileHeader
    ByteOrder binary.ByteOrder
    Loads     []Load
    Sections  []*Section

    Symtab   *Symtab
    Dysymtab *Dysymtab
    // エクスポートされていないフィールドがあります
}

func NewFile

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

NewFile は,内部のリーダーの Mach-O バイナリにアクセスするための新しい File を作成します。 Mach-O バイナリは, ReaderAt の位置 0 から始まると予想されます。

func Open

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

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

func (*File) Close

func (f *File) Close() error

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

func (*File) DWARF

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

DWARF は, Mach-O ファイルの DWARF デバッグ情報を返します。

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 を返します。

func (*File) Segment

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

Segment は与えられた名前の最初の Segment を返します。 そのようなセグメントが存在しない場合は nil を返します。

type FileHeader

FileHeader は Mach-O ファイルヘッダを表します。

type FileHeader struct {
    Magic  uint32
    Cpu    Cpu
    SubCpu uint32
    Type   Type
    Ncmd   uint32
    Cmdsz  uint32
    Flags  uint32
}

type FormatError

FormatError は,データがオブジェクトファイルの正しいフォーマットでない場合に返されます。

type FormatError struct {
    // エクスポートされていないフィールドがあります
}

func (*FormatError) Error

func (e *FormatError) Error() string

type Load

Load は Mach-O ロードコマンドを表します。

type Load interface {
    Raw() []byte
}

type LoadBytes

LoadBytes は, Mach-O ロードコマンドの未解釈のバイトです。

type LoadBytes []byte

func (LoadBytes) Raw

func (b LoadBytes) Raw() []byte

type LoadCmd

LoadCmd は Mach-O ロードコマンドです。

type LoadCmd uint32
const (
    LoadCmdSegment    LoadCmd = 0x1
    LoadCmdSymtab     LoadCmd = 0x2
    LoadCmdThread     LoadCmd = 0x4
    LoadCmdUnixThread LoadCmd = 0x5 // スレッド + スタック
    LoadCmdDysymtab   LoadCmd = 0xb
    LoadCmdDylib      LoadCmd = 0xc // load dylib コマンド
    LoadCmdDylinker   LoadCmd = 0xf // id dylinker コマンド (load dylinker コマンドではありません)
    LoadCmdSegment64  LoadCmd = 0x19
    LoadCmdRpath      LoadCmd = 0x8000001c
)

func (LoadCmd) GoString

func (i LoadCmd) GoString() string

func (LoadCmd) String

func (i LoadCmd) String() string

type Nlist32

Nlist32 は, Mach-O 32 ビットシンボルテーブルエントリです。

type Nlist32 struct {
    Name  uint32
    Type  uint8
    Sect  uint8
    Desc  uint16
    Value uint32
}

type Nlist64

Nlist64 は, Mach-O 64 ビットシンボルテーブルエントリです。

type Nlist64 struct {
    Name  uint32
    Type  uint8
    Sect  uint8
    Desc  uint16
    Value uint64
}

type Regs386

Regs386 は Mach-O 386 レジスタ構造です。

type Regs386 struct {
    AX    uint32
    BX    uint32
    CX    uint32
    DX    uint32
    DI    uint32
    SI    uint32
    BP    uint32
    SP    uint32
    SS    uint32
    FLAGS uint32
    IP    uint32
    CS    uint32
    DS    uint32
    ES    uint32
    FS    uint32
    GS    uint32
}

type RegsAMD64

RegsAMD64 は Mach-O AMD64 レジスタ構造です。

type RegsAMD64 struct {
    AX    uint64
    BX    uint64
    CX    uint64
    DX    uint64
    DI    uint64
    SI    uint64
    BP    uint64
    SP    uint64
    R8    uint64
    R9    uint64
    R10   uint64
    R11   uint64
    R12   uint64
    R13   uint64
    R14   uint64
    R15   uint64
    IP    uint64
    FLAGS uint64
    CS    uint64
    FS    uint64
    GS    uint64
}

type Reloc 1.10

Reloc は Mach-O の再配置を表します。

type Reloc struct {
    Addr  uint32
    Value uint32
    // Scattered == false && Extern == true の場合,値はシンボル番号です。
    // Scattered == false && Extern == false の場合, Value はセクション番号です。
    // Scattered == true の場合, Value はこの再配置が参照する値です。
    Type      uint8
    Len       uint8 // 0=バイト, 1=ワード, 2=ロング, 3=クワッド
    Pcrel     bool
    Extern    bool // Scattered == false の場合に有効
    Scattered bool
}

type RelocTypeARM 1.10

type RelocTypeARM int
const (
    ARM_RELOC_VANILLA        RelocTypeARM = 0
    ARM_RELOC_PAIR           RelocTypeARM = 1
    ARM_RELOC_SECTDIFF       RelocTypeARM = 2
    ARM_RELOC_LOCAL_SECTDIFF RelocTypeARM = 3
    ARM_RELOC_PB_LA_PTR      RelocTypeARM = 4
    ARM_RELOC_BR24           RelocTypeARM = 5
    ARM_THUMB_RELOC_BR22     RelocTypeARM = 6
    ARM_THUMB_32BIT_BRANCH   RelocTypeARM = 7
    ARM_RELOC_HALF           RelocTypeARM = 8
    ARM_RELOC_HALF_SECTDIFF  RelocTypeARM = 9
)

func (RelocTypeARM) GoString 1.10

func (r RelocTypeARM) GoString() string

func (RelocTypeARM) String 1.10

func (i RelocTypeARM) String() string

type RelocTypeARM64 1.10

type RelocTypeARM64 int
const (
    ARM64_RELOC_UNSIGNED            RelocTypeARM64 = 0
    ARM64_RELOC_SUBTRACTOR          RelocTypeARM64 = 1
    ARM64_RELOC_BRANCH26            RelocTypeARM64 = 2
    ARM64_RELOC_PAGE21              RelocTypeARM64 = 3
    ARM64_RELOC_PAGEOFF12           RelocTypeARM64 = 4
    ARM64_RELOC_GOT_LOAD_PAGE21     RelocTypeARM64 = 5
    ARM64_RELOC_GOT_LOAD_PAGEOFF12  RelocTypeARM64 = 6
    ARM64_RELOC_POINTER_TO_GOT      RelocTypeARM64 = 7
    ARM64_RELOC_TLVP_LOAD_PAGE21    RelocTypeARM64 = 8
    ARM64_RELOC_TLVP_LOAD_PAGEOFF12 RelocTypeARM64 = 9
    ARM64_RELOC_ADDEND              RelocTypeARM64 = 10
)

func (RelocTypeARM64) GoString 1.10

func (r RelocTypeARM64) GoString() string

func (RelocTypeARM64) String 1.10

func (i RelocTypeARM64) String() string

type RelocTypeGeneric 1.10

type RelocTypeGeneric int
const (
    GENERIC_RELOC_VANILLA        RelocTypeGeneric = 0
    GENERIC_RELOC_PAIR           RelocTypeGeneric = 1
    GENERIC_RELOC_SECTDIFF       RelocTypeGeneric = 2
    GENERIC_RELOC_PB_LA_PTR      RelocTypeGeneric = 3
    GENERIC_RELOC_LOCAL_SECTDIFF RelocTypeGeneric = 4
    GENERIC_RELOC_TLV            RelocTypeGeneric = 5
)

func (RelocTypeGeneric) GoString 1.10

func (r RelocTypeGeneric) GoString() string

func (RelocTypeGeneric) String 1.10

func (i RelocTypeGeneric) String() string

type RelocTypeX86_64 1.10

type RelocTypeX86_64 int
const (
    X86_64_RELOC_UNSIGNED   RelocTypeX86_64 = 0
    X86_64_RELOC_SIGNED     RelocTypeX86_64 = 1
    X86_64_RELOC_BRANCH     RelocTypeX86_64 = 2
    X86_64_RELOC_GOT_LOAD   RelocTypeX86_64 = 3
    X86_64_RELOC_GOT        RelocTypeX86_64 = 4
    X86_64_RELOC_SUBTRACTOR RelocTypeX86_64 = 5
    X86_64_RELOC_SIGNED_1   RelocTypeX86_64 = 6
    X86_64_RELOC_SIGNED_2   RelocTypeX86_64 = 7
    X86_64_RELOC_SIGNED_4   RelocTypeX86_64 = 8
    X86_64_RELOC_TLV        RelocTypeX86_64 = 9
)

func (RelocTypeX86_64) GoString 1.10

func (r RelocTypeX86_64) GoString() string

func (RelocTypeX86_64) String 1.10

func (i RelocTypeX86_64) String() string

type Rpath 1.10

Rpath は Mach-O r パスコマンドを表します。

type Rpath struct {
    LoadBytes
    Path string
}

type RpathCmd 1.10

RpathCmd は Mach-O r パスコマンドです。

type RpathCmd struct {
    Cmd  LoadCmd
    Len  uint32
    Path uint32
}

type Section

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

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

func (*Section) Data

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

Data は Mach-O セクションの内容を読み込んで返します。

func (*Section) Open

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

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

type Section32

Section32 は 32 ビットの Mach-O セクションヘッダです。

type Section32 struct {
    Name     [16]byte
    Seg      [16]byte
    Addr     uint32
    Size     uint32
    Offset   uint32
    Align    uint32
    Reloff   uint32
    Nreloc   uint32
    Flags    uint32
    Reserve1 uint32
    Reserve2 uint32
}

type Section64

Section64 は 64 ビットの Mach-O セクションヘッダです。

type Section64 struct {
    Name     [16]byte
    Seg      [16]byte
    Addr     uint64
    Size     uint64
    Offset   uint32
    Align    uint32
    Reloff   uint32
    Nreloc   uint32
    Flags    uint32
    Reserve1 uint32
    Reserve2 uint32
    Reserve3 uint32
}

type SectionHeader

type SectionHeader struct {
    Name   string
    Seg    string
    Addr   uint64
    Size   uint64
    Offset uint32
    Align  uint32
    Reloff uint32
    Nreloc uint32
    Flags  uint32
}

type Segment

Segment は, Mach-O 32 ビットまたは 64 ビットロードセグメントコマンドを表します。

type Segment struct {
    LoadBytes
    SegmentHeader

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

func (*Segment) Data

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

Data はセグメントの内容を読み取り,返します。

func (*Segment) Open

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

Open はセグメントを読んでいる新しい ReadSeeker を返します。

type Segment32

Segment32 は 32 ビット Mach-O セグメントロードコマンドです。

type Segment32 struct {
    Cmd     LoadCmd
    Len     uint32
    Name    [16]byte
    Addr    uint32
    Memsz   uint32
    Offset  uint32
    Filesz  uint32
    Maxprot uint32
    Prot    uint32
    Nsect   uint32
    Flag    uint32
}

type Segment64

Segment64 は 64 ビット Mach-O セグメントロードコマンドです。

type Segment64 struct {
    Cmd     LoadCmd
    Len     uint32
    Name    [16]byte
    Addr    uint64
    Memsz   uint64
    Offset  uint64
    Filesz  uint64
    Maxprot uint32
    Prot    uint32
    Nsect   uint32
    Flag    uint32
}

type SegmentHeader

SegmentHeader は, Mach-O 32 ビットまたは 64 ビットロードセグメントコマンドのヘッダーです。

type SegmentHeader struct {
    Cmd     LoadCmd
    Len     uint32
    Name    string
    Addr    uint64
    Memsz   uint64
    Offset  uint64
    Filesz  uint64
    Maxprot uint32
    Prot    uint32
    Nsect   uint32
    Flag    uint32
}

type Symbol

Symbol は, Mach-O 32 ビットまたは 64 ビットのシンボルテーブルエントリです。

type Symbol struct {
    Name  string
    Type  uint8
    Sect  uint8
    Desc  uint16
    Value uint64
}

type Symtab

Symtab は Mach-O シンボルテーブルコマンドを表します。

type Symtab struct {
    LoadBytes
    SymtabCmd
    Syms []Symbol
}

type SymtabCmd

SymtabCmd は Mach-O シンボルテーブルコマンドです。

type SymtabCmd struct {
    Cmd     LoadCmd
    Len     uint32
    Symoff  uint32
    Nsyms   uint32
    Stroff  uint32
    Strsize uint32
}

type Thread

Thread は Mach-O スレッド状態コマンドです。

type Thread struct {
    Cmd  LoadCmd
    Len  uint32
    Type uint32
    Data []uint32
}

type Type

Type は Mach-O ファイルの種類です。例えば,オブジェクトファイル,実行可能ファイル,または動的ライブラリ。

type Type uint32
const (
    TypeObj    Type = 1
    TypeExec   Type = 2
    TypeDylib  Type = 6
    TypeBundle Type = 8
)

func (Type) GoString 1.10

func (t Type) GoString() string

func (Type) String 1.10

func (t Type) String() string