debug/macho

package macho

import "debug/macho"

Package macho implements access to Mach-O object files.

const (
 Magic32 uint32 = 0xfeedface
 Magic64 uint32 = 0xfeedfacf
 MagicFat uint32 = 0xcafebabe
)

Variables ¶

❖

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

ErrNotFat is returned from NewFatFile or OpenFat when the file is not a universal binary but may be a thin binary, based on its magic number.

type Cpu ¶ Uses

❖

type Cpu uint32

A Cpu is a Mach-O cpu type.

❖

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

func (Cpu) GoString ¶ Uses

❖

func (i Cpu) GoString() string

func (Cpu) String ¶ Uses

❖

func (i Cpu) String() string

type Dylib ¶ Uses

❖

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

A Dylib represents a Mach-O load dynamic library command.

type DylibCmd ¶ Uses

❖

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

A DylibCmd is a Mach-O load dynamic library command.

type Dysymtab ¶ Uses

❖

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

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

type DysymtabCmd ¶ Uses

❖

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
}

A DysymtabCmd is a Mach-O dynamic symbol table command.

type FatArch ¶ Uses

❖

type FatArch struct {
 FatArchHeader
 *File
}

A FatArch is a Mach-O File inside a FatFile.

type FatArchHeader ¶ Uses

❖

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

A FatArchHeader represents a fat header for a specific image architecture.

type FatFile ¶ Uses

❖

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

A FatFile is a Mach-O universal binary that contains at least one architecture.

func NewFatFile ¶ Uses

❖

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

NewFatFile creates a new FatFile for accessing all the Mach-O images in a universal binary. The Mach-O binary is expected to start at position 0 in the ReaderAt.

func OpenFat ¶ Uses

❖

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

OpenFat opens the named file using os.Open and prepares it for use as a Mach-O universal binary.

func (*FatFile) Close ¶ Uses

❖

func (ff *FatFile) Close() error

type File ¶ Uses

❖

type File struct {
 FileHeader
 ByteOrder binary.ByteOrder
 Loads []Load
 Sections []*Section
 Symtab *Symtab
 Dysymtab *Dysymtab
 // contains filtered or unexported fields
}

A File represents an open Mach-O file.

func NewFile ¶ Uses

❖

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

NewFile creates a new File for accessing a Mach-O binary in an underlying reader. The Mach-O binary is expected to start at position 0 in the ReaderAt.

func Open ¶ Uses

❖

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

Open opens the named file using os.Open and prepares it for use as a Mach-O binary.

func (*File) Close ¶ Uses

❖

func (f *File) Close() error

Close closes the File. If the File was created using NewFile directly instead of Open, Close has no effect.

func (*File) DWARF ¶ Uses

❖

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

DWARF returns the DWARF debug information for the Mach-O file.

func (*File) ImportedLibraries ¶ Uses

❖

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

ImportedLibraries returns the paths of all libraries referred to by the binary f that are expected to be linked with the binary at dynamic link time.

func (*File) ImportedSymbols ¶ Uses

❖

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

ImportedSymbols returns the names of all symbols referred to by the binary f that are expected to be satisfied by other libraries at dynamic load time.

func (*File) Section ¶ Uses

❖

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

Section returns the first section with the given name, or nil if no such section exists.

func (*File) Segment ¶ Uses

❖

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

Segment returns the first Segment with the given name, or nil if no such segment exists.

type FileHeader ¶ Uses

❖

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

A FileHeader represents a Mach-O file header.

type FormatError ¶ Uses

❖

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

FormatError is returned by some operations if the data does not have the correct format for an object file.

func (*FormatError) Error ¶ Uses

❖

func (e *FormatError) Error() string

type Load ¶ Uses

❖

type Load interface {
 Raw() []byte
}

A Load represents any Mach-O load command.

type LoadBytes ¶ Uses

❖

type LoadBytes []byte

A LoadBytes is the uninterpreted bytes of a Mach-O load command.

func (LoadBytes) Raw ¶ Uses

❖

func (b LoadBytes) Raw() []byte

type LoadCmd ¶ Uses

❖

type LoadCmd uint32

A LoadCmd is a Mach-O load command.

❖

const (
 LoadCmdSegment LoadCmd = 1
 LoadCmdSymtab LoadCmd = 2
 LoadCmdThread LoadCmd = 4
 LoadCmdUnixThread LoadCmd = 5 // thread+stack
 LoadCmdDysymtab LoadCmd = 11
 LoadCmdDylib LoadCmd = 12
 LoadCmdDylinker LoadCmd = 15
 LoadCmdSegment64 LoadCmd = 25
)

func (LoadCmd) GoString ¶ Uses

❖

func (i LoadCmd) GoString() string

func (LoadCmd) String ¶ Uses

❖

func (i LoadCmd) String() string

type Nlist32 ¶ Uses

❖

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

An Nlist32 is a Mach-O 32-bit symbol table entry.

type Nlist64 ¶ Uses

❖

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

An Nlist64 is a Mach-O 64-bit symbol table entry.

type Regs386 ¶ Uses

❖

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 is the Mach-O 386 register structure.

type RegsAMD64 ¶ Uses

❖

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 is the Mach-O AMD64 register structure.

type Section ¶ Uses

❖

type Section struct {
 SectionHeader
 // 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 ¶ Uses

❖

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

Data reads and returns the contents of the Mach-O section.

func (*Section) Open ¶ Uses

❖

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

Open returns a new ReadSeeker reading the Mach-O section.

type Section32 ¶ Uses

❖

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
}

A Section32 is a 32-bit Mach-O section header.

type Section64 ¶ Uses

❖

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
}

A Section64 is a 64-bit Mach-O section header.

type SectionHeader ¶ Uses

❖

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

type Segment ¶ Uses

❖

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
}

A Segment represents a Mach-O 32-bit or 64-bit load segment command.

func (*Segment) Data ¶ Uses

❖

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

Data reads and returns the contents of the segment.

func (*Segment) Open ¶ Uses

❖

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

Open returns a new ReadSeeker reading the segment.

type Segment32 ¶ Uses

❖

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
}

A Segment32 is a 32-bit Mach-O segment load command.

type Segment64 ¶ Uses

❖

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
}

A Segment64 is a 64-bit Mach-O segment load command.

type SegmentHeader ¶ Uses

❖

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
}

A SegmentHeader is the header for a Mach-O 32-bit or 64-bit load segment command.

type Symbol ¶ Uses

❖

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

A Symbol is a Mach-O 32-bit or 64-bit symbol table entry.

type Symtab ¶ Uses

❖

type Symtab struct {
 LoadBytes
 SymtabCmd
 Syms []Symbol
}

A Symtab represents a Mach-O symbol table command.

type SymtabCmd ¶ Uses

❖

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

A SymtabCmd is a Mach-O symbol table command.

type Thread ¶ Uses

❖

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

A Thread is a Mach-O thread state command.

type Type ¶ Uses

❖

type Type uint32

A Type is the Mach-O file type, e.g. an object file, executable, or dynamic library.

❖

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