mirror of
https://github.com/golang/go
synced 2024-11-11 22:50:22 -07:00
doc: mention concurrent map write/iterate detector
Mention that the best-effort race detector on maps was upgraded to detect write/iterate races. Fixes #18137 Change-Id: Ib6e0adde47e965126771ea712386031a2a55eba3 Reviewed-on: https://go-review.googlesource.com/33768 Reviewed-by: Brad Fitzpatrick <bradfitz@golang.org>
This commit is contained in:
parent
6c7978fc89
commit
ac9962fb23
@ -442,6 +442,26 @@ version of gccgo.
|
||||
documentation</a> and its example for more details.
|
||||
</p>
|
||||
|
||||
<h3 id="mapiter">Concurrent Map Misuse</h3>
|
||||
|
||||
<p>
|
||||
In Go 1.6, the runtime
|
||||
<a href="/doc/go1.6#runtime">added lightweight,
|
||||
best-effort detection of concurrent misuse of maps</a>. This release
|
||||
improves that detector with support for detecting programs that
|
||||
concurrently write to and iterate over a map.
|
||||
</p>
|
||||
<p>
|
||||
As always, if one goroutine is writing to a map, no other goroutine should be
|
||||
reading (which includes iterating) or writing the map concurrently.
|
||||
If the runtime detects this condition, it prints a diagnosis and crashes the program.
|
||||
The best way to find out more about the problem is to run the program
|
||||
under the
|
||||
<a href="https://blog.golang.org/race-detector">race detector</a>,
|
||||
which will more reliably identify the race
|
||||
and give more detail.
|
||||
</p>
|
||||
|
||||
<h3 id="memstats">MemStats Documentation</h3>
|
||||
|
||||
<p> <!-- CL 28972 -->
|
||||
|
Loading…
Reference in New Issue
Block a user