?
Ce document utilise Manuel du site Web PHP chinois Libérer
import "debug/gosym"
概述
參數(shù)
概述
gosym 包可以訪問由 gc 編譯器生成的 Go 二進制文件中嵌入的 Go 符號和行號表。
參數(shù)
type DecodingError
func (e *DecodingError) Error() string
type Func
type LineTable
func NewLineTable(data []byte, text uint64) *LineTable
func (t *LineTable) LineToPC(line int, maxpc uint64) uint64
func (t *LineTable) PCToLine(pc uint64) int
type Obj
type Sym
func (s *Sym) BaseName() string
func (s *Sym) PackageName() string
func (s *Sym) ReceiverName() string
func (s *Sym) Static() bool
type Table
func NewTable(symtab []byte, pcln *LineTable) (*Table, error)
func (t *Table) LineToPC(file string, line int) (pc uint64, fn *Func, err error)
func (t *Table) LookupFunc(name string) *Func
func (t *Table) LookupSym(name string) *Sym
func (t *Table) PCToFunc(pc uint64) *Func
func (t *Table) PCToLine(pc uint64) (file string, line int, fn *Func)
func (t *Table) SymByAddr(addr uint64) *Sym
type UnknownFileError
func (e UnknownFileError) Error() string
type UnknownLineError
func (e *UnknownLineError) Error() string
打包文件
pclntab.go symtab.go
type DecodingError
DecodingError表示解碼符號表時發(fā)生錯誤。
type DecodingError struct { // 包含過濾或未導出的字段}func (*DecodingError) Error
func (e *DecodingError) Error() string
type Func
Func 收集有關單個功能的信息。
type Func struct {
Entry uint64 *Sym
End uint64
Params []*Sym
Locals []*Sym
FrameSize int
LineTable *LineTable
Obj *Obj}type LineTable
LineTable 是一個數(shù)據(jù)結構映射程序計數(shù)器到行號。
在 Go 1.1 及更早版本中，每個函數(shù)（由 Func 表示）都有自己的 LineTable，并且行號對應于程序中所有源文件行中所有文件的編號。絕對行號將不得不單獨轉換為文件內的文件名和行號。
在 Go 1.2 中，數(shù)據(jù)的格式發(fā)生了變化，因此整個程序都有一個 LineTable，由所有 Funcs 共享，并且沒有絕對行號，只有特定文件中的行號。
大多數(shù)情況下，LineTable 的方法應該被視為包的內部細節(jié); 調用者應該使用 Table 上的方法。
type LineTable struct {
Data []byte
PC uint64
Line int // 包含過濾或未導出的字段}func NewLineTable
func NewLineTable(data []byte, text uint64) *LineTable
NewLineTable 返回與編碼數(shù)據(jù)對應的新PC/line 表。文本必須是相應文本段的起始地址。
func (*LineTable) LineToPC
func (t *LineTable) LineToPC(line int, maxpc uint64) uint64
LineToPC 返回給定行號的程序計數(shù)器，只考慮maxpc 之前的程序計數(shù)器。調用者應該使用 Table 的 LineToPC 方法。
func (*LineTable) PCToLine
func (t *LineTable) PCToLine(pc uint64) int
PCToLine 返回給定程序計數(shù)器的行號。調用者應該使用 Table 的 PCToLine 方法。
type Obj
Obj 表示符號表中的函數(shù)集合。
將二進制分割成單獨的 Objs 的確切方法是符號表格式的內部細節(jié)。
在Go的早期版本中，每個源文件都變成了不同的 Obj。
在Go 1和Go 1.1中，每個軟件包為所有 Go 源和每個C源文件創(chuàng)建一個 Obj。
在Go 1.2中，整個程序都有一個Obj。
type Obj struct { // Funcs是Obj中的函數(shù)列表。
Funcs []Func // 在Go 1.1和更早版本中，路徑是相應符號的列表 // 到產(chǎn)生Obj的源文件名。 // 在Go 1.2中，Paths是零。 // 使用Table.Files的鍵獲取源文件列表。
Paths []Sym // 元（meta）}type Sym
Sym代表一個符號表項。
type Sym struct {
Value uint64
Type byte
Name string
GoType uint64 // 如果此符號是函數(shù)符號，則對應Func
Func *Func}func (*Sym) BaseName
func (s *Sym) BaseName() string
BaseName返回沒有包名或接收者名稱的符號名稱。
func (*Sym) PackageName
func (s *Sym) PackageName() string
PackageName 返回符號名稱的包部分，如果沒有則返回空字符串。
func (*Sym) ReceiverName
func (s *Sym) ReceiverName() string
ReceiverName 返回此符號的接收器類型名稱，如果沒有，則返回空字符串。
func (*Sym) Static
func (s *Sym) Static() bool
靜態(tài)報告此符號是否為靜態(tài)（在其文件外部不可見）。
type Table
表格代表一個 Go 符號表。它存儲從程序解碼的所有符號，并提供在符號，名稱和地址之間進行轉換的方法。
type Table struct {
Syms []Sym
Funcs []Func
Files map[string]*Obj // 無論是Go 1.2還是更高版本的二進制文件
Objs []Obj // 無論是Go 1.2還是更高版本的二進制文件 // 包含過濾或未導出的字段}func NewTable
func NewTable(symtab []byte, pcln *LineTable) (*Table, error)
NewTable 對數(shù)據(jù)中的 Go 符號表進行解碼，返回一個內存中表示。
func (*Table) LineToPC
func (t *Table) LineToPC(file string, line int) (pc uint64, fn *Func, err error)
LineToPC 在指定文件的給定行中查找第一個程序計數(shù)器。如果查找此行時發(fā)生錯誤，它將返回 UnknownPathError 或 UnknownLineError。
func (*Table) LookupFunc
func (t *Table) LookupFunc(name string) *Func
LookupFunc 返回給定名稱的文本，數(shù)據(jù)或 bss 符號，如果沒有找到這樣的符號，則返回 nil。
func (*Table) LookupSym
func (t *Table) LookupSym(name string) *Sym
LookupSym 返回給定名稱的文本，數(shù)據(jù)或 bss 符號，如果沒有找到這樣的符號，則返回 nil。
func (*Table) PCToFunc
func (t *Table) PCToFunc(pc uint64) *Func
PCToFunc 返回包含程序計數(shù)器 pc 的函數(shù)，如果沒有這種函數(shù)，則返回 nil。
func (*Table) PCToLine
func (t *Table) PCToLine(pc uint64) (file string, line int, fn *Func)
PCToLine 查找程序計數(shù)器的行號信息。如果沒有信息，則返回 fn == nil。
func (*Table) SymByAddr
func (t *Table) SymByAddr(addr uint64) *Sym
SymByAddr 返回從給定地址開始的文本，數(shù)據(jù)或 bss 符號。
type UnknownFileError
UnknownFileError 表示找不到符號表中的特定文件。
type UnknownFileError string
func (UnknownFileError) Error
func (e UnknownFileError) Error() string
type UnknownLineError
UnknownLineError 表示無法將行映射到程序計數(shù)器，因為行超出了文件的界限或者因為給定行上沒有代碼。
type UnknownLineError struct {
File string
Line int}func (*UnknownLineError) Error
func (e *UnknownLineError) Error() string