94 lines
3.1 KiB
Go
94 lines
3.1 KiB
Go
|
// Copyright 2014 The Go Authors. All rights reserved.
|
||
|
|
// Use of this source code is governed by a BSD-style
|
||
|
|
// license that can be found in the LICENSE file.
|
||
|
|
|
||
|
|
package runtime
|
||
|
|
|
||
|
|
// Frames may be used to get function/file/line information for a
|
||
|
|
// slice of PC values returned by Callers.
|
||
|
|
type Frames struct {
|
||
|
|
// callers is a slice of PCs that have not yet been expanded to frames.
|
||
|
|
callers []uintptr
|
||
|
|
|
||
|
|
// frames is a slice of Frames that have yet to be returned.
|
||
|
|
frames []Frame
|
||
|
|
frameStore [2]Frame
|
||
|
|
}
|
||
|
|
|
||
|
|
// Frame is the information returned by Frames for each call frame.
|
||
|
|
type Frame struct {
|
||
|
|
// PC is the program counter for the location in this frame.
|
||
|
|
// For a frame that calls another frame, this will be the
|
||
|
|
// program counter of a call instruction. Because of inlining,
|
||
|
|
// multiple frames may have the same PC value, but different
|
||
|
|
// symbolic information.
|
||
|
|
PC uintptr
|
||
|
|
|
||
|
|
// Func is the Func value of this call frame. This may be nil
|
||
|
|
// for non-Go code or fully inlined functions.
|
||
|
|
Func *Func
|
||
|
|
|
||
|
|
// Function is the package path-qualified function name of
|
||
|
|
// this call frame. If non-empty, this string uniquely
|
||
|
|
// identifies a single function in the program.
|
||
|
|
// This may be the empty string if not known.
|
||
|
|
// If Func is not nil then Function == Func.Name().
|
||
|
|
Function string
|
||
|
|
|
||
|
|
// File and Line are the file name and line number of the
|
||
|
|
// location in this frame. For non-leaf frames, this will be
|
||
|
|
// the location of a call. These may be the empty string and
|
||
|
|
// zero, respectively, if not known.
|
||
|
|
File string
|
||
|
|
Line int
|
||
|
|
|
||
|
|
// startLine is the line number of the beginning of the function in
|
||
|
|
// this frame. Specifically, it is the line number of the func keyword
|
||
|
|
// for Go functions. Note that //line directives can change the
|
||
|
|
// filename and/or line number arbitrarily within a function, meaning
|
||
|
|
// that the Line - startLine offset is not always meaningful.
|
||
|
|
//
|
||
|
|
// This may be zero if not known.
|
||
|
|
startLine int
|
||
|
|
|
||
|
|
// Entry point program counter for the function; may be zero
|
||
|
|
// if not known. If Func is not nil then Entry ==
|
||
|
|
// Func.Entry().
|
||
|
|
Entry uintptr
|
||
|
|
|
||
|
|
// The runtime's internal view of the function. This field
|
||
|
|
// is set (funcInfo.valid() returns true) only for Go functions,
|
||
|
|
// not for C functions.
|
||
|
|
funcInfo funcInfo
|
||
|
|
}
|
||
|
|
|
||
|
|
func (ci *Frames) Next() (frame Frame, more bool) {
|
||
|
|
panic("todo: runtime.Frames.Next")
|
||
|
|
}
|
||
|
|
|
||
|
|
// CallersFrames takes a slice of PC values returned by Callers and
|
||
|
|
// prepares to return function/file/line information.
|
||
|
|
// Do not change the slice until you are done with the Frames.
|
||
|
|
func CallersFrames(callers []uintptr) *Frames {
|
||
|
|
panic("todo: runtime.CallersFrames")
|
||
|
|
}
|
||
|
|
|
||
|
|
// A Func represents a Go function in the running binary.
|
||
|
|
type Func struct {
|
||
|
|
opaque struct{} // unexported field to disallow conversions
|
||
|
|
}
|
||
|
|
|
||
|
|
// moduledata records information about the layout of the executable
|
||
|
|
// image. It is written by the linker. Any changes here must be
|
||
|
|
// matched changes to the code in cmd/link/internal/ld/symtab.go:symtab.
|
||
|
|
// moduledata is stored in statically allocated non-pointer memory;
|
||
|
|
// none of the pointers here are visible to the garbage collector.
|
||
|
|
type moduledata struct {
|
||
|
|
unused [8]byte
|
||
|
|
}
|
||
|
|
|
||
|
|
type funcInfo struct {
|
||
|
|
*_func
|
||
|
|
datap *moduledata
|
||
|
|
}
|