pdebug

package

v0.4.171 Latest Latest Go to latest Published: May 12, 2024 License: ISC Imports: 4 Imported by: 0

Details

Valid go.mod file

The Go module system was introduced in Go 1.11 and is the official dependency management solution for Go.
Redistributable license

Redistributable licenses place minimal restrictions on how software can be used, modified, and redistributed.
Tagged version

Modules with tagged versions give importers more predictable builds.
Stable version

When a project reaches major version v1 it is considered stable.
Learn more about best practices

Package pdebug provides a portable, parsed stack trace.

This section is empty.

This section is empty.

func NewStack(skipFrames int) (stack parl.Stack)

NewStack populates a Stack object with the current thread and its stack using debug.Stack

func ParseFirstLine(debugStack []byte) (ID parl.ThreadID, status parl.ThreadStatus, err error)

getID obtains gorutine ID, as of go1.18 a numeric string "1"…

type Stack struct{ pruntime.Stack }

- Go stack traces are created by runtime.NewStack and is a byte slice

func (s *Stack) Creator() (creator *pruntime.CodeLocation, creatorID parl.ThreadID, goRoutineRef string)

the code location of the go statement creating this thread

func (s *Stack) ID() (threadID parl.ThreadID)

thread ID 1… for the thread requesting the stack trace

ThreadID is comparable and has IsValid and String methods
ThreadID is typically an incremented 64-bit integer with main thread having ID 1

func (s *Stack) Status() (status parl.ThreadStatus)

a word indicating thread status, typically word “running”