runtime

Documentation

Index

• Constants
• func Caller(skip int) (pc uintptr, file string, line int, ok bool)
• func GOROOT() string
• func SetFinalizer(obj any, finalizer any)
• type Frame
• type Frames
  • func CallersFrames(callers []uintptr) *Frames
  • func (ci *Frames) Next() (frame Frame, more bool)
• type Func

Constants

const GOARCH = `amd64`

const GOOS = `linux`

const Is386 = 0

const IsAix = 0

const IsAmd64 = 1

const IsAmd64p32 = 0

const IsAndroid = 0

const IsArm = 0

const IsArm64 = 0

const IsArm64be = 0

const IsArmbe = 0

const IsDarwin = 0

const IsDragonfly = 0

const IsFreebsd = 0

const IsHurd = 0

const IsIllumos = 0

const IsIos = 0

const IsJs = 0

const IsLinux = 1

const IsLoong64 = 0

const IsMips = 0

const IsMips64 = 0

const IsMips64le = 0

const IsMips64p32 = 0

const IsMips64p32le = 0

const IsMipsle = 0

const IsNacl = 0

const IsNetbsd = 0

const IsOpenbsd = 0

const IsPlan9 = 0

const IsPpc = 0

const IsPpc64 = 0

const IsPpc64le = 0

const IsRiscv = 0

const IsRiscv64 = 0

const IsS390 = 0

const IsS390x = 0

const IsSolaris = 0

const IsSparc = 0

const IsSparc64 = 0

const IsWasip1 = 0

const IsWasm = 0

const IsWindows = 0

const IsZos = 0

Functions

func Caller

func Caller(skip int) (pc uintptr, file string, line int, ok bool)

func GOROOT

func GOROOT() string

GOROOT returns the root of the Go tree. It uses the GOROOT environment variable, if set at process start, or else the root used during the Go build.

func SetFinalizer

func SetFinalizer(obj any, finalizer any)

Types

type 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

	// Entry point program counter for the function; may be zero
	// if not known. If Func is not nil then Entry ==
	// Func.Entry().
	Entry uintptr
	// contains filtered or unexported fields
}

Frame is the information returned by Frames for each call frame.

type Frames

type Frames struct {
	// contains filtered or unexported fields
}

Frames may be used to get function/file/line information for a slice of PC values returned by Callers.

func CallersFrames

func CallersFrames(callers []uintptr) *Frames

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 (*Frames) Next

func (ci *Frames) Next() (frame Frame, more bool)

type Func

type Func struct {
	// contains filtered or unexported fields
}

A Func represents a Go function in the running binary.