profiling

Documentation

Index

• Variables
• type GoLibrary
  • func NewGoLibrary() *GoLibrary
  • func (l *GoLibrary) AnalyzeSymbols(filePath string) ([]*Symbol, error)
  • func (l *GoLibrary) IsSupport(filePath string) bool
  • func (l *GoLibrary) ToModule(pid int32, modName, modPath string, moduleRange []*ModuleRange) (*Module, error)
• type Info
  • func NewInfo(modules map[string]*Module) *Info
  • func (i *Info) FindMultipleSymbolByRegex(rep string) ([]string, error)
  • func (i *Info) FindSymbolAddress(name string) uint64
  • func (i *Info) FindSymbolByRegex(rep string) (string, error)
  • func (i *Info) FindSymbolName(address uint64) string
  • func (i *Info) FindSymbols(addresses []uint64, defaultSymbol string) []string
• type KernelFinder
  • func NewKernelFinder() *KernelFinder
  • func (k *KernelFinder) Analyze(filepath string) (*Info, error)
  • func (k *KernelFinder) IsSupport(filepath string) bool
• type Module
• type ModuleRange
• type ModuleType
• type NotSupport
  • func NewNotSupport() *NotSupport
  • func (l *NotSupport) AnalyzeSymbols(filePath string) ([]*Symbol, error)
  • func (l *NotSupport) IsSupport(filePath string) bool
  • func (l *NotSupport) ToModule(pid int32, modName, modPath string, moduleRange []*ModuleRange) (*Module, error)
• type StatFinder
• type Symbol

Variables

var ErrNotSupport = fmt.Errorf("not support")

var (
	KernelSymbolFilePath = "/proc/kallsyms"
)

Types

type GoLibrary

type GoLibrary struct {
}

GoLibrary is using build-in elf reader to read

func NewGoLibrary

func NewGoLibrary() *GoLibrary

func (*GoLibrary) AnalyzeSymbols

func (l *GoLibrary) AnalyzeSymbols(filePath string) ([]*Symbol, error)

func (*GoLibrary) IsSupport

func (l *GoLibrary) IsSupport(filePath string) bool

func (*GoLibrary) ToModule

func (l *GoLibrary) ToModule(pid int32, modName, modPath string, moduleRange []*ModuleRange) (*Module, error)

type Info

type Info struct {
	Modules []*Module
	// contains filtered or unexported fields
}

Info of profiling process

func NewInfo

func NewInfo(modules map[string]*Module) *Info

func (*Info) FindMultipleSymbolByRegex

func (i *Info) FindMultipleSymbolByRegex(rep string) ([]string, error)

func (*Info) FindSymbolAddress

func (i *Info) FindSymbolAddress(name string) uint64

func (*Info) FindSymbolByRegex

func (i *Info) FindSymbolByRegex(rep string) (string, error)

func (*Info) FindSymbolName

func (i *Info) FindSymbolName(address uint64) string

FindSymbolName by address

func (*Info) FindSymbols

func (i *Info) FindSymbols(addresses []uint64, defaultSymbol string) []string

FindSymbols from address list, if could not found symbol name then append default symbol to array

type KernelFinder

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

func NewKernelFinder

func NewKernelFinder() *KernelFinder

func (*KernelFinder) Analyze

func (k *KernelFinder) Analyze(filepath string) (*Info, error)

func (*KernelFinder) IsSupport

func (k *KernelFinder) IsSupport(filepath string) bool

type Module

type Module struct {
	Ranges           []*ModuleRange
	Name             string
	Path             string
	Type             ModuleType
	SoOffset, SoAddr uint64
	Symbols          []*Symbol
}

type ModuleRange

type ModuleRange struct {
	StartAddr, EndAddr, FileOffset uint64
}

type ModuleType

type ModuleType int8

const (
	ModuleTypeExec ModuleType = iota
	ModuleTypeSo
	ModuleTypePerfMap
	ModuleTypeVDSO
	ModuleTypeUnknown
)

type NotSupport

type NotSupport struct {
}

func NewNotSupport

func NewNotSupport() *NotSupport

func (*NotSupport) AnalyzeSymbols

func (l *NotSupport) AnalyzeSymbols(filePath string) ([]*Symbol, error)

func (*NotSupport) IsSupport

func (l *NotSupport) IsSupport(filePath string) bool

func (*NotSupport) ToModule

func (l *NotSupport) ToModule(pid int32, modName, modPath string, moduleRange []*ModuleRange) (*Module, error)

type StatFinder

type StatFinder interface {
	// IsSupport to stat the executable file for profiling
	IsSupport(filePath string) bool
	// AnalyzeSymbols in the file
	AnalyzeSymbols(filePath string) ([]*Symbol, error)
	// ToModule to init a new module
	ToModule(pid int32, modName, modPath string, moduleRange []*ModuleRange) (*Module, error)
}

type Symbol

type Symbol struct {
	Name     string
	Location uint64
	Size     uint64
}

Symbol of executable file