]> Cypherpunks.ru repositories - gostls13.git/blobdiff - src/runtime/pprof/runtime.go
runtime: add available godoc link
[gostls13.git] / src / runtime / pprof / runtime.go
index e6aace83e26cfe49ef386ea161b829a9fd0630ed..8d37c7d3add14631ad1f35e2a2050ca11378bf91 100644 (file)
@@ -6,9 +6,23 @@ package pprof
 
 import (
        "context"
+       "runtime"
        "unsafe"
 )
 
+// runtime_FrameStartLine is defined in runtime/symtab.go.
+//
+//go:noescape
+func runtime_FrameStartLine(f *runtime.Frame) int
+
+// runtime_FrameSymbolName is defined in runtime/symtab.go.
+//
+//go:noescape
+func runtime_FrameSymbolName(f *runtime.Frame) string
+
+// runtime_expandFinalInlineFrame is defined in runtime/symtab.go.
+func runtime_expandFinalInlineFrame(stk []uintptr) []uintptr
+
 // runtime_setProfLabel is defined in runtime/proflabel.go.
 func runtime_setProfLabel(labels unsafe.Pointer)
 
@@ -16,7 +30,8 @@ func runtime_setProfLabel(labels unsafe.Pointer)
 func runtime_getProfLabel() unsafe.Pointer
 
 // SetGoroutineLabels sets the current goroutine's labels to match ctx.
-// This is a lower-level API than Do, which should be used instead when possible.
+// A new goroutine inherits the labels of the goroutine that created it.
+// This is a lower-level API than [Do], which should be used instead when possible.
 func SetGoroutineLabels(ctx context.Context) {
        ctxLabels, _ := ctx.Value(labelContextKey{}).(*labelMap)
        runtime_setProfLabel(unsafe.Pointer(ctxLabels))
@@ -24,6 +39,7 @@ func SetGoroutineLabels(ctx context.Context) {
 
 // Do calls f with a copy of the parent context with the
 // given labels added to the parent's label map.
+// Goroutines spawned while executing f will inherit the augmented label-set.
 // Each key/value pair in labels is inserted into the label map in the
 // order provided, overriding any previous value for the same key.
 // The augmented label map will be set for the duration of the call to f