Package: debug/gosym

type DecodingError (struct) DecodingError represents an error during the decoding of the symbol table. Methods (only one) (*DecodingError) Error() string Implements (at least one exported) *DecodingError : error

type Func (struct) A Func collects information about a single function. Fields (total 13) End uint64 Entry uint64 FrameSize int LineTable *LineTable Locals []*Sym // nil for Go 1.3 and later binaries Obj *Obj Params []*Sym // nil for Go 1.3 and later binaries Sym *Sym Sym.Func *Func If this symbol is a function symbol, the corresponding Func Sym.GoType uint64 Sym.Name string Sym.Type byte Sym.Value uint64 Methods (total 4) ( Func) BaseName() string BaseName returns the symbol name without the package or receiver name. ( Func) PackageName() string PackageName returns the package part of the symbol name, or the empty string if there is none. ( Func) ReceiverName() string ReceiverName returns the receiver type name of this symbol, or the empty string if there is none. A receiver name is only detected in the case that s.Name is fully-specified with a package name. ( Func) Static() bool Static reports whether this symbol is static (not visible outside its file). As Outputs Of (at least 4) func (*Table).LineToPC(file string, line int) (pc uint64, fn *Func, err error) func (*Table).LookupFunc(name string) *Func func (*Table).PCToFunc(pc uint64) *Func func (*Table).PCToLine(pc uint64) (file string, line int, fn *Func)

type LineTable (struct) A LineTable is a data structure mapping program counters to line numbers. In Go 1.1 and earlier, each function (represented by a [Func]) had its own LineTable, and the line number corresponded to a numbering of all source lines in the program, across all files. That absolute line number would then have to be converted separately to a file name and line number within the file. In Go 1.2, the format of the data changed so that there is a single LineTable for the entire program, shared by all Funcs, and there are no absolute line numbers, just line numbers within specific files. For the most part, LineTable's methods should be treated as an internal detail of the package; callers should use the methods on [Table] instead. Fields (total 3) Data []byte Line int PC uint64 Methods (total 2) (*LineTable) LineToPC(line int, maxpc uint64) uint64 LineToPC returns the program counter for the given line number, considering only program counters before maxpc. Deprecated: Use Table's LineToPC method instead. (*LineTable) PCToLine(pc uint64) int PCToLine returns the line number for the given program counter. Deprecated: Use Table's PCToLine method instead. As Outputs Of (at least one exported) func NewLineTable(data []byte, text uint64) *LineTable As Inputs Of (at least one exported) func NewTable(symtab []byte, pcln *LineTable) (*Table, error)

type Obj (struct) An Obj represents a collection of functions in a symbol table. The exact method of division of a binary into separate Objs is an internal detail of the symbol table format. In early versions of Go each source file became a different Obj. In Go 1 and Go 1.1, each package produced one Obj for all Go sources and one Obj per C source file. In Go 1.2, there is a single Obj for the entire program. Fields (total 2) Funcs []Func Funcs is a list of functions in the Obj. Paths []Sym In Go 1.1 and earlier, Paths is a list of symbols corresponding to the source file names that produced the Obj. In Go 1.2, Paths is nil. Use the keys of Table.Files to obtain a list of source files. // meta

type Sym (struct) A Sym represents a single symbol table entry. Fields (total 5) Func *Func If this symbol is a function symbol, the corresponding Func GoType uint64 Name string Type byte Value uint64 Methods (total 4) (*Sym) BaseName() string BaseName returns the symbol name without the package or receiver name. (*Sym) PackageName() string PackageName returns the package part of the symbol name, or the empty string if there is none. (*Sym) ReceiverName() string ReceiverName returns the receiver type name of this symbol, or the empty string if there is none. A receiver name is only detected in the case that s.Name is fully-specified with a package name. (*Sym) Static() bool Static reports whether this symbol is static (not visible outside its file). As Outputs Of (at least 2) func (*Table).LookupSym(name string) *Sym func (*Table).SymByAddr(addr uint64) *Sym

type Table (struct) Table represents a Go symbol table. It stores all of the symbols decoded from the program and provides methods to translate between symbols, names, and addresses. Fields (total 4) Files map[string]*Obj // for Go 1.2 and later all files map to one Obj Funcs []Func Objs []Obj // for Go 1.2 and later only one Obj in slice Syms []Sym // nil for Go 1.3 and later binaries Methods (total 6) (*Table) LineToPC(file string, line int) (pc uint64, fn *Func, err error) LineToPC looks up the first program counter on the given line in the named file. It returns [UnknownFileError] or [UnknownLineError] if there is an error looking up this line. (*Table) LookupFunc(name string) *Func LookupFunc returns the text, data, or bss symbol with the given name, or nil if no such symbol is found. (*Table) LookupSym(name string) *Sym LookupSym returns the text, data, or bss symbol with the given name, or nil if no such symbol is found. (*Table) PCToFunc(pc uint64) *Func PCToFunc returns the function containing the program counter pc, or nil if there is no such function. (*Table) PCToLine(pc uint64) (file string, line int, fn *Func) PCToLine looks up line number information for a program counter. If there is no information, it returns fn == nil. (*Table) SymByAddr(addr uint64) *Sym SymByAddr returns the text, data, or bss symbol starting at the given address. As Outputs Of (at least one exported) func NewTable(symtab []byte, pcln *LineTable) (*Table, error)

type UnknownFileError string (basic type) UnknownFileError represents a failure to find the specific file in the symbol table. Methods (only one) ( UnknownFileError) Error() string Implements (at least one exported) UnknownFileError : error

type UnknownLineError (struct) UnknownLineError represents a failure to map a line to a program counter, either because the line is beyond the bounds of the file or because there is no code on the given line. Fields (total 2) File string Line int Methods (only one) (*UnknownLineError) Error() string Implements (at least one exported) *UnknownLineError : error