Skip to content

Commit 3b8b550

Browse files
prattmicgopherbot
authored andcommitted
doc: document runtimecontentionstacks
For #57071. Change-Id: Ic1645af57aa589917c67154a5e4ad0b4edd7ba90 Reviewed-on: https://go-review.googlesource.com/c/go/+/547058 Reviewed-by: Michael Knyszek <mknyszek@google.com> Reviewed-by: Rhys Hiltner <rhys@justin.tv> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Michael Pratt <mpratt@google.com>
1 parent e9eb2be commit 3b8b550

File tree

1 file changed

+7
-0
lines changed

1 file changed

+7
-0
lines changed

doc/godebug.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -178,6 +178,13 @@ should adjust their Linux configuration according to the recommendations in the
178178
[GC guide](/doc/gc-guide#Linux_transparent_huge_pages), or switch to a Linux
179179
distribution that disables transparent huge pages altogether.
180180

181+
Go 1.22 added contention on runtime-internal locks to the [`mutex`
182+
profile](/pkg/runtime/pprof#Profile). Contention on these locks is always
183+
reported at `runtime._LostContendedRuntimeLock`. Complete stack traces of
184+
runtime locks can be enabled with the [`runtimecontentionstacks`
185+
setting](/pkg/runtime#hdr-Environment_Variable). These stack traces have
186+
non-standard semantics, see setting documentation for details.
187+
181188
### Go 1.21
182189

183190
Go 1.21 made it a run-time error to call `panic` with a nil interface value,

0 commit comments

Comments
 (0)