Пакет macho
Обзор
Пакет macho реализует доступ к файлам объектов Mach-O.
Безопасность
Этот пакет не предназначен для защиты от вредоносных входных данных и находится за пределами области действия https://go.dev/security/policy. В частности, при разборе файлов объектов выполняется только базовая валидация. Поэтому при разборе недоверенных входных данных следует проявлять осторожность, так как разбор повреждённых файлов может потребовать значительных ресурсов или вызвать панику.
Индекс
Файлы пакета
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
) функция (Cpu) GoString
func (i Cpu) GoString() string
функция (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
}
функция NewFatFile 1.3
func NewFatFile(r io.ReaderAt) (*FatFile, error)
NewFatFile создаёт новый FatFile для доступа ко всем изображениям Mach-O в универсальном бинарнике. Ожидается, что Mach-O бинарник начнётся с позиции 0 в ReaderAt.
функция OpenFat 1.3
func OpenFat(name string) (*FatFile, error)
OpenFat открывает указанный файл с помощью os.Open и подготавливает его для использования в качестве универсального бинарника Mach-O.
функция (*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
}
функция NewFile
func NewFile(r io.ReaderAt) (*File, error)
NewFile создаёт новый File для доступа к Mach-O бинарнику в базовом ридере. Ожидается, что Mach-O бинарник начнётся с позиции 0 в ReaderAt.
функция Open
func Open(name string) (*File, error)
Open открывает указанный файл с помощью os.Open и подготавливает его для использования как Mach-O бинарника.
функция (*File) Close
func (f *File) Close() error
Close закрывает File. Если File был создан с помощью NewFile напрямую вместо Open, Close не имеет эффекта.
функция (*File) DWARF
func (f *File) DWARF() (*dwarf.Data, error)
DWARF возвращает отладочную информацию DWARF для файла Mach-O.
функция (*File) ImportedLibraries
func (f *File) ImportedLibraries() ([]string, error)
ImportedLibraries возвращает пути всех библиотек, на которые ссылается бинарник f, которые должны быть связаны с бинарником во время динамической компоновки.
функция (*File) ImportedSymbols
func (f *File) ImportedSymbols() ([]string, error)
ImportedSymbols возвращает имена всех символов, на которые ссылается бинарник f, которые должны быть удовлетворены другими библиотеками во время динамической загрузки.
функция (*File) Section
func (f *File) Section(name string) *Section
Section возвращает первый раздел с заданным именем или nil, если такого раздела нет.
функция (*File) Segment
func (f *File) Segment(name string) *Segment
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
}
функция (*FormatError) Error
func (e *FormatError) Error() string
тип Load
Load представляет любую команду загрузки Mach-O.
type Load interface {
Raw() []byte
} тип LoadBytes
LoadBytes — это неинтерпретированные байты команды Mach-O для загрузки.
type LoadBytes []byte
функция (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
) функция (LoadCmd) GoString
func (i LoadCmd) GoString() string
функция (LoadCmd) String
func (i LoadCmd) String() string
тип Nlist32
Nlist32 — это запись таблицы символов Mach-O 32-битного размера.
type Nlist32 struct {
Name uint32
Type uint8
Sect uint8
Desc uint16
Value uint32
}
тип Nlist64
Nlist64 — это запись таблицы символов Mach-O 64-битного размера.
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
) функция (RelocTypeARM) GoString 1.10
func (r RelocTypeARM) GoString() string
функция (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
) функция (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
A Rpath представляет команду Mach-O rpath.
type Rpath struct {
LoadBytes
Path string
}
тип RpathCmd 1.10
A RpathCmd — это команда Mach-O rpath.
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
A Section32 — это заголовок раздела Mach-O 32-битной архитектуры.
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
A Section64 — это заголовок раздела Mach-O 64-битной архитектуры.
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
A Segment представляет команду загрузки сегмента Mach-O 32-битной или 64-битной архитектуры.
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
A Segment32 — это команда загрузки сегмента Mach-O 32-битной архитектуры.
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
A Segment64 — это команда загрузки сегмента Mach-O 64-битной архитектуры.
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
A 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
}
тип Symbol
A Symbol — это запись таблицы символов Mach-O 32-битной или 64-битной архитектуры.
type Symbol struct {
Name string
Type uint8
Sect uint8
Desc uint16
Value uint64
}
тип Symtab
A Symtab представляет команду таблицы символов Mach-O.
type Symtab struct {
LoadBytes
SymtabCmd
Syms []Symbol
}
тип SymtabCmd
A SymtabCmd — это команда таблицы символов Mach-O.
type SymtabCmd struct {
Cmd LoadCmd
Len uint32
Symoff uint32
Nsyms uint32
Stroff uint32
Strsize uint32
}
тип Thread
A Thread — это команда состояния потока Mach-O.
type Thread struct {
Cmd LoadCmd
Len uint32
Type uint32
Data []uint32
}
тип Type
A 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
© Google, Inc.
Licensed under the Creative Commons Attribution License 3.0.
http://golang.org/pkg/debug/macho/
