macho

package
v1.26.2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: May 16, 2026 License: MIT Imports: 3 Imported by: 0

Documentation

Overview

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

セキュリティ

このパッケージは、敵対的な入力に対して強化されるように設計されていません、そして https://go.dev/security/policy の範囲外です。特に、オブジェクトファイルを解析する際には基本的な 検証のみが行われます。そのため、信頼できない入力を解析する際には注意が必要です、なぜなら、 不正なファイルを解析すると、大量のリソースを消費するか、パニックを引き起こす可能性があります。

Index

Constants

View Source 
const (
	Magic32  uint32 = 0xfeedface
	Magic64  uint32 = 0xfeedfacf
	MagicFat uint32 = 0xcafebabe
)
View Source 
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
)

Variables

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

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

Functions

This section is empty.

Types

type Cpu 

type Cpu uint32

Cpuは、Mach-OのCPUタイプを表します。 

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 

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

Dylibは、Mach-Oの動的ライブラリロードコマンドを表します。

type DylibCmd 

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

DylibCmdは、Mach-Oの動的ライブラリロードコマンドです。

type Dysymtab 

type Dysymtab struct {
	LoadBytes
	DysymtabCmd
	IndirectSyms []uint32
}

A Dysymtab represents a Mach-O dynamic symbol table command.

type DysymtabCmd 

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
}

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

type FatArch added in v1.3.0 

type FatArch struct {
	FatArchHeader
	*File
}

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

type FatArchHeader added in v1.3.0 

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

FatArchHeaderは、特定のイメージアーキテクチャのためのファットヘッダーを表します。

type FatFile added in v1.3.0 

type FatFile struct {
	Magic  uint32
	Arches []FatArch
	// contains filtered or unexported fields
}

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

func NewFatFile added in v1.3.0 

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

NewFatFileは、ユニバーサルバイナリ内のすべてのMach-Oイメージにアクセスするための新しい FatFile を作成します。 Mach-Oバイナリは、ReaderAtの位置0で開始することが期待されています。

func OpenFat added in v1.3.0 

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

OpenFatは、os.Open を使用して指定されたファイルを開き、それをMach-Oユニバーサルバイナリとして使用するための準備をします。

func (*FatFile) Close added in v1.3.0 

func (ff *FatFile) Close() error

type File 

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

	Symtab   *Symtab
	Dysymtab *Dysymtab
	// contains filtered or unexported fields
}

Fileは、開かれたMach-Oファイルを表します。

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は、File を閉じます。 File が 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 

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

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

type FormatError 

type FormatError struct {
	// contains filtered or unexported fields
}

FormatErrorは、データがオブジェクトファイルの正しい形式でない場合、 一部の操作によって返されます。

func (*FormatError) Error 

func (e *FormatError) Error() string

type Load 

type Load interface {
	Raw() []byte
}

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

type LoadBytes 

type LoadBytes []byte

LoadBytesは、Mach-Oロードコマンドの解釈されていないバイトを表します。

func (LoadBytes) Raw 

func (b LoadBytes) Raw() []byte

type LoadCmd 

type LoadCmd uint32

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

const (
	LoadCmdSegment    LoadCmd = 0x1
	LoadCmdSymtab     LoadCmd = 0x2
	LoadCmdThread     LoadCmd = 0x4
	LoadCmdUnixThread LoadCmd = 0x5
	LoadCmdDysymtab   LoadCmd = 0xb
	LoadCmdDylib      LoadCmd = 0xc
	LoadCmdDylinker   LoadCmd = 0xf
	LoadCmdSegment64  LoadCmd = 0x19
	LoadCmdRpath      LoadCmd = 0x8000001c
)

func (LoadCmd) GoString 

func (i LoadCmd) GoString() string

func (LoadCmd) String 

func (i LoadCmd) String() string

type Nlist32 

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

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

type Nlist64 

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

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

type Regs386 

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
}

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

type RegsAMD64 

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
}

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

type Reloc added in v1.10.0 

type Reloc struct {
	Addr  uint32
	Value uint32
	// Scattered == false かつ Extern == true の場合、Valueはシンボル番号です。
	// Scattered == false かつ Extern == false の場合、Valueはセクション番号です。
	// Scattered == true の場合、Valueはこの再配置が参照する値です。
	Type      uint8
	Len       uint8
	Pcrel     bool
	Extern    bool
	Scattered bool
}

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

type RelocTypeARM added in v1.10.0 

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 added in v1.10.0 

func (r RelocTypeARM) GoString() string

func (RelocTypeARM) String added in v1.10.0 

func (i RelocTypeARM) String() string

type RelocTypeARM64 added in v1.10.0 

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 added in v1.10.0 

func (r RelocTypeARM64) GoString() string

func (RelocTypeARM64) String added in v1.10.0 

func (i RelocTypeARM64) String() string

type RelocTypeGeneric added in v1.10.0 

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 added in v1.10.0 

func (r RelocTypeGeneric) GoString() string

func (RelocTypeGeneric) String added in v1.10.0 

func (i RelocTypeGeneric) String() string

type RelocTypeX86_64 added in v1.10.0 

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 added in v1.10.0 

func (r RelocTypeX86_64) GoString() string

func (RelocTypeX86_64) String added in v1.10.0 

func (i RelocTypeX86_64) String() string

type Rpath added in v1.10.0 

type Rpath struct {
	LoadBytes
	Path string
}

Rpathは、Mach-O rpathコマンドを表します。

type RpathCmd added in v1.10.0 

type RpathCmd struct {
	Cmd  LoadCmd
	Len  uint32
	Path uint32
}

RpathCmdは、Mach-Oのrpathコマンドです。

type Section 

type Section struct {
	SectionHeader
	Relocs []Reloc

	// ReadAtメソッドのためにReaderAtを埋め込みます。
	// ReadとSeekを避けるために、SectionReaderを直接埋め込まないでください。
	// クライアントがReadとSeekを使用したい場合は、
	// 他のクライアントとのシークオフセットの競合を避けるために
	// Open()を使用する必要があります。
	io.ReaderAt
	// contains filtered or unexported fields
}

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 

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
}

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

type Section64 

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
}

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

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 

type Segment struct {
	LoadBytes
	SegmentHeader

	// ReadAtメソッドのためにReaderAtを埋め込みます。
	// ReadとSeekを避けるために、SectionReaderを直接埋め込まないでください。
	// クライアントがReadとSeekを使用したい場合は、
	// 他のクライアントとのシークオフセットの競合を避けるために
	// Open()を使用する必要があります。
	io.ReaderAt
	// contains filtered or unexported fields
}

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

func (*Segment) Data 

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

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

func (*Segment) Open 

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

Openは、セグメントを読み取る新しいReadSeekerを返します。

type Segment32 

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
}

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

type Segment64 

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
}

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

type SegmentHeader 

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
}

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

type Symbol 

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

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

type Symtab 

type Symtab struct {
	LoadBytes
	SymtabCmd
	Syms []Symbol
}

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

type SymtabCmd 

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

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

type Thread 

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

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

type Type 

type Type uint32

Typeは、Mach-Oファイルのタイプを表します。例えば、オブジェクトファイル、実行可能ファイル、または動的ライブラリなどです。 

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

func (Type) GoString added in v1.10.0 

func (t Type) GoString() string

func (Type) String added in v1.10.0 

func (t Type) String() string

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.