©
本文档使用
php中文网手册 发布
import "debug/gosym"
概述
参数
gosym 包可以访问由 gc 编译器生成的 Go 二进制文件中嵌入的 Go 符号和行号表。
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
DecodingError表示解码符号表时发生错误。
type DecodingError struct { // 包含过滤或未导出的字段}func (e *DecodingError) Error() string
Func 收集有关单个功能的信息。
type Func struct {
Entry uint64 *Sym
End uint64
Params []*Sym
Locals []*Sym
FrameSize int
LineTable *LineTable
Obj *Obj}LineTable 是一个数据结构映射程序计数器到行号。
在 Go 1.1 及更早版本中，每个函数（由 Func 表示）都有自己的 LineTable，并且行号对应于程序中所有源文件行中所有文件的编号。绝对行号将不得不单独转换为文件内的文件名和行号。
在 Go 1.2 中，数据的格式发生了变化，因此整个程序都有一个 LineTable，由所有 Funcs 共享，并且没有绝对行号，只有特定文件中的行号。
大多数情况下，LineTable 的方法应该被视为包的内部细节; 调用者应该使用 Table 上的方法。
type LineTable struct {
Data []byte
PC uint64
Line int // 包含过滤或未导出的字段}func NewLineTable(data []byte, text uint64) *LineTable
NewLineTable 返回与编码数据对应的新PC/line 表。文本必须是相应文本段的起始地址。
func (t *LineTable) LineToPC(line int, maxpc uint64) uint64
LineToPC 返回给定行号的程序计数器，只考虑maxpc 之前的程序计数器。调用者应该使用 Table 的 LineToPC 方法。
func (t *LineTable) PCToLine(pc uint64) int
PCToLine 返回给定程序计数器的行号。调用者应该使用 Table 的 PCToLine 方法。
Obj 表示符号表中的函数集合。
将二进制分割成单独的 Objs 的确切方法是符号表格式的内部细节。
在Go的早期版本中，每个源文件都变成了不同的 Obj。
在Go 1和Go 1.1中，每个软件包为所有 Go 源和每个C源文件创建一个 Obj。
在Go 1.2中，整个程序都有一个Obj。
type Obj struct { // Funcs是Obj中的函数列表。
Funcs []Func // 在Go 1.1和更早版本中，路径是相应符号的列表 // 到产生Obj的源文件名。 // 在Go 1.2中，Paths是零。 // 使用Table.Files的键获取源文件列表。
Paths []Sym // 元（meta）}Sym代表一个符号表项。
type Sym struct {
Value uint64
Type byte
Name string
GoType uint64 // 如果此符号是函数符号，则对应Func
Func *Func}func (s *Sym) BaseName() string
BaseName返回没有包名或接收者名称的符号名称。
func (s *Sym) PackageName() string
PackageName 返回符号名称的包部分，如果没有则返回空字符串。
func (s *Sym) ReceiverName() string
ReceiverName 返回此符号的接收器类型名称，如果没有，则返回空字符串。
func (s *Sym) Static() bool
静态报告此符号是否为静态（在其文件外部不可见）。
表格代表一个 Go 符号表。它存储从程序解码的所有符号，并提供在符号，名称和地址之间进行转换的方法。
type Table struct {
Syms []Sym
Funcs []Func
Files map[string]*Obj // 无论是Go 1.2还是更高版本的二进制文件
Objs []Obj // 无论是Go 1.2还是更高版本的二进制文件 // 包含过滤或未导出的字段}func NewTable(symtab []byte, pcln *LineTable) (*Table, error)
NewTable 对数据中的 Go 符号表进行解码，返回一个内存中表示。
func (t *Table) LineToPC(file string, line int) (pc uint64, fn *Func, err error)
LineToPC 在指定文件的给定行中查找第一个程序计数器。如果查找此行时发生错误，它将返回 UnknownPathError 或 UnknownLineError。
func (t *Table) LookupFunc(name string) *Func
LookupFunc 返回给定名称的文本，数据或 bss 符号，如果没有找到这样的符号，则返回 nil。
func (t *Table) LookupSym(name string) *Sym
LookupSym 返回给定名称的文本，数据或 bss 符号，如果没有找到这样的符号，则返回 nil。
func (t *Table) PCToFunc(pc uint64) *Func
PCToFunc 返回包含程序计数器 pc 的函数，如果没有这种函数，则返回 nil。
func (t *Table) PCToLine(pc uint64) (file string, line int, fn *Func)
PCToLine 查找程序计数器的行号信息。如果没有信息，则返回 fn == nil。
func (t *Table) SymByAddr(addr uint64) *Sym
SymByAddr 返回从给定地址开始的文本，数据或 bss 符号。
UnknownFileError 表示找不到符号表中的特定文件。
type UnknownFileError string
func (e UnknownFileError) Error() string
UnknownLineError 表示无法将行映射到程序计数器，因为行超出了文件的界限或者因为给定行上没有代码。
type UnknownLineError struct {
File string
Line int}func (e *UnknownLineError) Error() string