doc: document GODEBUG options to disable use of instruction set extensions

Fixes #27218

Change-Id: I4eb8e8f2486b20fe0ed6e3e2c6ec521c9e8c0032
Reviewed-on: https://go-review.googlesource.com/c/149579
Reviewed-by: Austin Clements <austin@google.com>

diff --git a/doc/diagnostics.html b/doc/diagnostics.html
index 0a7847744b6e5801464040e9b24fa1a726dda711..478611c15c0f6f1a1f8d1e25e6a98869a785fd09 100644 (file)
--- a/doc/diagnostics.html
+++ b/doc/diagnostics.html
@@ -456,3 +456,15 @@ each collection, summarizing the amount of memory collected
 and the length of the pause.</li>
 <li>GODEBUG=schedtrace=X prints scheduling events every X milliseconds.</li>
 </ul>
+
+<p>The GODEBUG environmental variable can be used to disable use of
+instruction set extensions in the standard library and runtime.</p>
+
+<ul>
+<li>GODEBUG=cpu.all=off disables the use of all optional
+instruction set extensions.</li>
+<li>GODEBUG=cpu.<em>extension</em>=off disables use of instructions from the
+specified instruction set extension.<br>
+<em>extension</em> is the lower case name for the instruction set extension
+such as <em>sse41</em> or <em>avx</em>.</li>
+</ul>