Пакет macho

• import "debug/macho"
• Обзор
• Указатель

Обзор

Пакет macho реализует доступ к объектным файлам Mach-O.

Безопасность

Этот пакет не предназначен для защиты от злонамеренных входных данных и не входит в область действия https://go.dev/security/policy. В частности, при разборе объектных файлов выполняется только базовая проверка. Поэтому при разборе недоверенных входных данных следует соблюдать осторожность: разбор некорректных файлов может потребовать значительных ресурсов или привести к панике.

Указатель

• Константы
• Переменные
• тип Cpu
• func (i Cpu) GoString() string
• func (i Cpu) String() string
• тип Dylib
• тип DylibCmd
• тип Dysymtab
• тип DysymtabCmd
• тип FatArch
• тип FatArchHeader
• тип FatFile
• func NewFatFile(r io.ReaderAt) (*FatFile, error)
• func OpenFat(name string) (*FatFile, error)
• func (ff *FatFile) Close() error
• тип 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
• тип FileHeader
• тип FormatError
• func (e *FormatError) Error() string
• тип Load
• тип LoadBytes
• func (b LoadBytes) Raw() []byte
• тип LoadCmd
• func (i LoadCmd) GoString() string
• func (i LoadCmd) String() string
• тип Nlist32
• тип Nlist64
• тип Regs386
• тип RegsAMD64
• тип Reloc
• тип RelocTypeARM
• func (r RelocTypeARM) GoString() string
• func (i RelocTypeARM) String() string
• тип RelocTypeARM64
• func (r RelocTypeARM64) GoString() string
• func (i RelocTypeARM64) String() string
• тип RelocTypeGeneric
• func (r RelocTypeGeneric) GoString() string
• func (i RelocTypeGeneric) String() string
• тип RelocTypeX86_64
• func (r RelocTypeX86_64) GoString() string
• func (i RelocTypeX86_64) String() string
• тип Rpath
• тип RpathCmd
• тип Section
• func (s *Section) Data() ([]byte, error)
• func (s *Section) Open() io.ReadSeeker
• тип Section32
• тип Section64
• тип SectionHeader
• тип Segment
• func (s *Segment) Data() ([]byte, error)
• func (s *Segment) Open() io.ReadSeeker
• тип Segment32
• тип Segment64
• тип SegmentHeader
• тип Symbol
• тип Symtab
• тип SymtabCmd
• тип Thread
• тип 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}

тип Cpu

Cpu — это тип процессора Mach-O.

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

тип Dylib

Dylib представляет команду загрузки динамической библиотеки Mach-O.

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

тип DylibCmd

DylibCmd — это команда загрузки динамической библиотеки Mach-O.

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

тип Dysymtab

Dysymtab представляет команду динамической таблицы символов Mach-O.

type Dysymtab struct {
    LoadBytes
    DysymtabCmd
    IndirectSyms []uint32 // indices into Symtab.Syms
}

тип 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
}

тип FatArch 1.3

FatArch — это файл Mach-O внутри FatFile.

type FatArch struct {
    FatArchHeader
    *File
}

тип FatArchHeader 1.3

FatArchHeader представляет заголовок fat для архитектуры конкретного образа.

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

тип FatFile 1.3

FatFile — это универсальный двоичный файл Mach-O, содержащий как минимум одну архитектуру.

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

func NewFatFile 1.3

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

NewFatFile создает новый FatFile для доступа ко всем образам Mach-O в универсальном двоичном файле. Предполагается, что двоичный файл Mach-O начинается с позиции 0 в ReaderAt.

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

тип File

File представляет открытый файл Mach-O.

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

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

func NewFile

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

NewFile создает новый File для доступа к двоичному файлу Mach-O в базовом источнике чтения. Предполагается, что двоичный файл Mach-O начинается с позиции 0 в ReaderAt.

func Open

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

Open открывает файл с указанным именем с помощью os.Open и подготавливает его к использованию в качестве двоичного файла Mach-O.

func (*File) Close

func (f *File) Close() error

Close закрывает File. Если File был создан непосредственно с помощью NewFile, а не Open, вызов Close не оказывает эффекта.

func (*File) DWARF

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

DWARF возвращает отладочную информацию DWARF для файла Mach-O.

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 возвращает первый сегмент с указанным именем или nil, если такого сегмента нет.

тип FileHeader

FileHeader представляет заголовок файла Mach-O.

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

тип FormatError

FormatError возвращается некоторыми операциями, если данные имеют неверный формат объектного файла.

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

func (*FormatError) Error

func (e *FormatError) Error() string

тип Load

Load представляет любую команду загрузки Mach-O.

type Load interface {
    Raw() []byte
}

тип LoadBytes

LoadBytes — это необработанные байты команды загрузки Mach-O, не интерпретированные как структура данных.

type LoadBytes []byte

func (LoadBytes) Raw

func (b LoadBytes) Raw() []byte

тип LoadCmd

LoadCmd — это команда загрузки Mach-O.

type LoadCmd uint32

const (
    LoadCmdSegment    LoadCmd = 0x1
    LoadCmdSymtab     LoadCmd = 0x2
    LoadCmdThread     LoadCmd = 0x4
    LoadCmdUnixThread LoadCmd = 0x5 // thread+stack
    LoadCmdDysymtab   LoadCmd = 0xb
    LoadCmdDylib      LoadCmd = 0xc // load dylib command
    LoadCmdDylinker   LoadCmd = 0xf // id dylinker command (not load dylinker command)
    LoadCmdSegment64  LoadCmd = 0x19
    LoadCmdRpath      LoadCmd = 0x8000001c
)

func (LoadCmd) GoString

func (i LoadCmd) GoString() string

func (LoadCmd) String

func (i LoadCmd) String() string

тип Nlist32

Nlist32 — это запись 32-разрядной таблицы символов Mach-O.

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

тип Nlist64

Nlist64 — это запись 64-разрядной таблицы символов Mach-O.

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

тип 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
}

тип 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
}

тип Reloc 1.10

Reloc представляет перемещение Mach-O.

type Reloc struct {
    Addr  uint32
    Value uint32
    // when Scattered == false && Extern == true, Value is the symbol number.
    // when Scattered == false && Extern == false, Value is the section number.
    // when Scattered == true, Value is the value that this reloc refers to.
    Type      uint8
    Len       uint8 // 0=byte, 1=word, 2=long, 3=quad
    Pcrel     bool
    Extern    bool // valid if Scattered == false
    Scattered bool
}

тип 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

тип 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

тип 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

тип 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

тип Rpath 1.10

Rpath представляет команду rpath Mach-O.

type Rpath struct {
    LoadBytes
    Path string
}

тип RpathCmd 1.10

RpathCmd — это команда rpath Mach-O.

type RpathCmd struct {
    Cmd  LoadCmd
    Len  uint32
    Path uint32
}

тип Section

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

    // Embed ReaderAt for ReadAt method.
    // Do not embed SectionReader directly
    // to avoid having Read and Seek.
    // If a client wants Read and Seek it must use
    // Open() to avoid fighting over the seek offset
    // with other clients.
    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 возвращает новый ReadSeeker для чтения раздела Mach-O.

тип 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
}

тип 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
}

тип SectionHeader

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

тип Segment

Segment представляет команду загрузки 32- или 64-разрядного сегмента Mach-O.

type Segment struct {
    LoadBytes
    SegmentHeader

    // Embed ReaderAt for ReadAt method.
    // Do not embed SectionReader directly
    // to avoid having Read and Seek.
    // If a client wants Read and Seek it must use
    // Open() to avoid fighting over the seek offset
    // with other clients.
    io.ReaderAt
    // contains filtered or unexported fields
}

func (*Segment) Data

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

Data считывает и возвращает содержимое сегмента.

func (*Segment) Open

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

Open возвращает новый ReadSeeker для чтения сегмента.

тип 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
}

тип 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
}

тип SegmentHeader

SegmentHeader — это заголовок команды загрузки 32- или 64-разрядного сегмента Mach-O.

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
}

тип Symbol

Symbol — это запись 32- или 64-разрядной таблицы символов Mach-O.

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

тип Symtab

Symtab представляет команду таблицы символов Mach-O.

type Symtab struct {
    LoadBytes
    SymtabCmd
    Syms []Symbol
}

тип SymtabCmd

SymtabCmd — это команда таблицы символов Mach-O.

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

тип Thread

Thread — это команда состояния потока Mach-O.

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

тип 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