From: Martin Möhrmann <moehrmann@google.com>
Date: Wed, 14 Nov 2018 22:13:28 +0000 (+0100)
Subject: doc: document GODEBUG options to disable use of instruction set extensions
X-Git-Tag: go1.12beta1~15
X-Git-Url: http://www.git.cypherpunks.su/?a=commitdiff_plain;h=9a258f308689d2f1cb13f286baf745aad5fa991b;p=gostls13.git

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 0a7847744b..478611c15c 100644
--- 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>