safeelf

Documentation

Overview

Package safeelf provides safe (from panics) wrappers around ELF parsing

Index

• Constants
• Variables
• type File
  • func NewFile(r io.ReaderAt) (safe *File, err error)
  • func Open(path string) (safe *File, err error)
  • func (se *File) DWARF() (d *dwarf.Data, err error)
  • func (se *File) DynamicSymbols() (syms []Symbol, err error)
  • func (se *File) Symbols() (syms []Symbol, err error)
• type Prog
• type Section
• type SectionIndex
• type SectionType
• type Symbol

Constants

const ELFCLASS32 = elf.ELFCLASS32

const ELFCLASS64 = elf.ELFCLASS64

const EM_AARCH64 = elf.EM_AARCH64

const EM_X86_64 = elf.EM_X86_64

const ET_DYN = elf.ET_DYN

const ET_EXEC = elf.ET_EXEC

const PF_W = elf.PF_W

const PF_X = elf.PF_X

const PT_LOAD = elf.PT_LOAD

const PT_TLS = elf.PT_TLS

const SHF_ALLOC = elf.SHF_ALLOC

const SHF_EXECINSTR = elf.SHF_EXECINSTR

const SHT_DYNSYM = elf.SHT_DYNSYM

const SHT_SYMTAB = elf.SHT_SYMTAB

const STB_GLOBAL = elf.STB_GLOBAL

const STT_FUNC = elf.STT_FUNC

const Sym32Size = elf.Sym32Size

const Sym64Size = elf.Sym64Size

Variables

var ErrNoSymbols = elf.ErrNoSymbols

Types

type File

type File struct {
	*elf.File
}

File is a safe wrapper around *elf.File that handles any panics in parsing

func NewFile

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

NewFile reads an ELF safely.

Any panic during parsing is turned into an error. This is necessary since there are a bunch of unfixed bugs in debug/elf.

https://github.com/golang/go/issues?q=is%3Aissue+is%3Aopen+debug%2Felf+in%3Atitle

func Open

func Open(path string) (safe *File, err error)

Open reads an ELF from a file.

It works like NewFile, with the exception that safe.Close will close the underlying file.

func (*File) DWARF

func (se *File) DWARF() (d *dwarf.Data, err error)

DWARF is the safe version of elf.File.DWARF.

func (*File) DynamicSymbols

func (se *File) DynamicSymbols() (syms []Symbol, err error)

DynamicSymbols is the safe version of elf.File.DynamicSymbols.

func (*File) Symbols

func (se *File) Symbols() (syms []Symbol, err error)

Symbols is the safe version of elf.File.Symbols.

type Prog

type Prog = elf.Prog

type Section

type Section = elf.Section

type SectionIndex

type SectionIndex = elf.SectionIndex

type SectionType

type SectionType = elf.SectionType

type Symbol

type Symbol = elf.Symbol