?
本文檔使用 php中文網(wǎng)手冊 發(fā)布
import "debug/gosym"
概述
參數(shù)
概述
gosym 包可以訪問由 gc 編譯器生成的 Go 二進(jìn)制文件中嵌入的 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表示解碼符號表時(shí)發(fā)生錯(cuò)誤。
type DecodingError struct { // 包含過濾或未導(dǎo)出的字段}func (*DecodingError) Error
func (e *DecodingError) Error() string
type Func
Func 收集有關(guān)單個(gè)功能的信息。
type Func struct {
Entry uint64 *Sym
End uint64
Params []*Sym
Locals []*Sym
FrameSize int
LineTable *LineTable
Obj *Obj}type LineTable
LineTable 是一個(gè)數(shù)據(jù)結(jié)構(gòu)映射程序計(jì)數(shù)器到行號。
在 Go 1.1 及更早版本中，每個(gè)函數(shù)（由 Func 表示）都有自己的 LineTable，并且行號對應(yīng)于程序中所有源文件行中所有文件的編號。絕對行號將不得不單獨(dú)轉(zhuǎn)換為文件內(nèi)的文件名和行號。
在 Go 1.2 中，數(shù)據(jù)的格式發(fā)生了變化，因此整個(gè)程序都有一個(gè) LineTable，由所有 Funcs 共享，并且沒有絕對行號，只有特定文件中的行號。
大多數(shù)情況下，LineTable 的方法應(yīng)該被視為包的內(nèi)部細(xì)節(jié); 調(diào)用者應(yīng)該使用 Table 上的方法。
type LineTable struct {
Data []byte
PC uint64
Line int // 包含過濾或未導(dǎo)出的字段}func NewLineTable
func NewLineTable(data []byte, text uint64) *LineTable
NewLineTable 返回與編碼數(shù)據(jù)對應(yīng)的新PC/line 表。文本必須是相應(yīng)文本段的起始地址。
func (*LineTable) LineToPC
func (t *LineTable) LineToPC(line int, maxpc uint64) uint64
LineToPC 返回給定行號的程序計(jì)數(shù)器，只考慮maxpc 之前的程序計(jì)數(shù)器。調(diào)用者應(yīng)該使用 Table 的 LineToPC 方法。
func (*LineTable) PCToLine
func (t *LineTable) PCToLine(pc uint64) int
PCToLine 返回給定程序計(jì)數(shù)器的行號。調(diào)用者應(yīng)該使用 Table 的 PCToLine 方法。
type Obj
Obj 表示符號表中的函數(shù)集合。
將二進(jìn)制分割成單獨(dú)的 Objs 的確切方法是符號表格式的內(nèi)部細(xì)節(jié)。
在Go的早期版本中，每個(gè)源文件都變成了不同的 Obj。
在Go 1和Go 1.1中，每個(gè)軟件包為所有 Go 源和每個(gè)C源文件創(chuàng)建一個(gè) Obj。
在Go 1.2中，整個(gè)程序都有一個(gè)Obj。
type Obj struct { // Funcs是Obj中的函數(shù)列表。
Funcs []Func // 在Go 1.1和更早版本中，路徑是相應(yīng)符號的列表 // 到產(chǎn)生Obj的源文件名。 // 在Go 1.2中，Paths是零。 // 使用Table.Files的鍵獲取源文件列表。
Paths []Sym // 元（meta）}type Sym
Sym代表一個(gè)符號表項(xiàng)。
type Sym struct {
Value uint64
Type byte
Name string
GoType uint64 // 如果此符號是函數(shù)符號，則對應(yīng)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)報(bào)告此符號是否為靜態(tài)（在其文件外部不可見）。
type Table
表格代表一個(gè) Go 符號表。它存儲(chǔ)從程序解碼的所有符號，并提供在符號，名稱和地址之間進(jìn)行轉(zhuǎn)換的方法。
type Table struct {
Syms []Sym
Funcs []Func
Files map[string]*Obj // 無論是Go 1.2還是更高版本的二進(jìn)制文件
Objs []Obj // 無論是Go 1.2還是更高版本的二進(jìn)制文件 // 包含過濾或未導(dǎo)出的字段}func NewTable
func NewTable(symtab []byte, pcln *LineTable) (*Table, error)
NewTable 對數(shù)據(jù)中的 Go 符號表進(jìn)行解碼，返回一個(gè)內(nèi)存中表示。
func (*Table) LineToPC
func (t *Table) LineToPC(file string, line int) (pc uint64, fn *Func, err error)
LineToPC 在指定文件的給定行中查找第一個(gè)程序計(jì)數(shù)器。如果查找此行時(shí)發(fā)生錯(cuò)誤，它將返回 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 返回包含程序計(jì)數(shù)器 pc 的函數(shù)，如果沒有這種函數(shù)，則返回 nil。
func (*Table) PCToLine
func (t *Table) PCToLine(pc uint64) (file string, line int, fn *Func)
PCToLine 查找程序計(jì)數(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 表示無法將行映射到程序計(jì)數(shù)器，因?yàn)樾谐隽宋募慕缦藁蛘咭驗(yàn)榻o定行上沒有代碼。
type UnknownLineError struct {
File string
Line int}func (*UnknownLineError) Error
func (e *UnknownLineError) Error() string