diff options
| author | Alan Donovan <adonovan@google.com> | 2016-03-16 12:57:17 -0400 |
|---|---|---|
| committer | Alan Donovan <adonovan@google.com> | 2016-03-16 17:02:50 +0000 |
| commit | ed73efbb746c9ca361071bdd0cd825b2b9724ec9 (patch) | |
| tree | 9054be38c0c5cdb82d521b84c1fa10e6432e6b96 /src/runtime | |
| parent | 9f301643bd3111f6a4e64b6fa400fa329ccb5a83 (diff) | |
| download | go-ed73efbb746c9ca361071bdd0cd825b2b9724ec9.tar.xz | |
runtime/debug: clarify WriteHeapDump STW behavior
Change-Id: I049d2596fe8ce0e93391599f5c224779fd8e316f
Reviewed-on: https://go-review.googlesource.com/20761
Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
Diffstat (limited to 'src/runtime')
| -rw-r--r-- | src/runtime/debug/garbage.go | 6 |
1 files changed, 6 insertions, 0 deletions
diff --git a/src/runtime/debug/garbage.go b/src/runtime/debug/garbage.go index 4d3ca79a81..8144497177 100644 --- a/src/runtime/debug/garbage.go +++ b/src/runtime/debug/garbage.go @@ -155,6 +155,12 @@ func SetPanicOnFault(enabled bool) bool { // WriteHeapDump writes a description of the heap and the objects in // it to the given file descriptor. +// +// WriteHeapDump suspends the execution of all goroutines until the heap +// dump is completely written. Thus, the file descriptor must not be +// connected to a pipe or socket whose other end is in the same Go +// process; instead, use a temporary file or network socket. +// // The heap dump format is defined at https://golang.org/s/go15heapdump. func WriteHeapDump(fd uintptr) |