aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAlan Donovan <adonovan@google.com>2023-12-07 18:02:40 -0500
committerGopher Robot <gobot@golang.org>2024-01-31 16:50:42 +0000
commit1bb947b2eb62f54dd7ff621f7e1c768c00edd1a7 (patch)
tree58f821389f1a025f8106b05856b942aa2fc4fa94 /doc
parent13766fe7d89c44bb45cfb33591b137553bda7c7d (diff)
downloadgo-1bb947b2eb62f54dd7ff621f7e1c768c00edd1a7.tar.gz
go-1bb947b2eb62f54dd7ff621f7e1c768c00edd1a7.zip
runtime/debug: SetCrashOutput sets the FD for fatal panics
This feature makes it possible to record unhandled panics in any goroutine through a watchdog process (e.g. the same application forked+exec'd as a child in a special mode) that can process the panic report, for example by sending it to a crash-reporting system such as Go telemetry or Sentry. Fixes #42888 Change-Id: I5aa7be8f726bbc70fc650540bd1a14ab60c62ecb Reviewed-on: https://go-review.googlesource.com/c/go/+/547978 Reviewed-by: Michael Pratt <mpratt@google.com> LUCI-TryBot-Result: Go LUCI <golang-scoped@luci-project-accounts.iam.gserviceaccount.com> Auto-Submit: Alan Donovan <adonovan@google.com> Reviewed-by: Russ Cox <rsc@golang.org>
Diffstat (limited to 'doc')
-rw-r--r--doc/next/6-stdlib/99-minor/runtime/debug/42888.md8
1 files changed, 8 insertions, 0 deletions
diff --git a/doc/next/6-stdlib/99-minor/runtime/debug/42888.md b/doc/next/6-stdlib/99-minor/runtime/debug/42888.md
new file mode 100644
index 0000000000..d75c86900f
--- /dev/null
+++ b/doc/next/6-stdlib/99-minor/runtime/debug/42888.md
@@ -0,0 +1,8 @@
+
+The [`debug.SetCrashOutput`](/runtime#SetCrashOutput) function allows
+the user to specify an alternate file to which the runtime should
+write its fatal crash report
+([#42888](https://github.com/golang/go/issues/42888)).
+It may be used to construct an automated reporting mechanism for all
+unexpected crashes, not just those in goroutines that explicitly use
+`recover`.