x86: document certain command line options as "dangerous"

Errata BT36, BT41, and BT230 mean that gas may, when using one ofthese
options, produce code that causes #UD on (at least) SandyBridge systems.

diff --git a/gas/ChangeLog b/gas/ChangeLog
index d2175b6336451e627fb472fdd3c1c9adfa22d349..b76ae780e6a3430d25a75f34bd7f1a7df749fe64 100644 (file)
--- a/gas/ChangeLog
+++ b/gas/ChangeLog
@@ -1,3 +1,8 @@
+2019-06-25  Jan Beulich  <jbeulich@suse.com>
+
+       * doc/c-i386.texi: Mark -mavxscalar= and -mvexwig as dangrous to
+       use.
+
 2019-06-25  Jan Beulich  <jbeulich@suse.com>
 
        * tc-i386.c (process_suffix): Use is_any_vex_encoding().

diff --git a/gas/doc/c-i386.texi b/gas/doc/c-i386.texi
index 9d821ae8e70c3cfb3d0e879f67552efbf913a284..908c6ca8c6f6613a275c3b1d6fc51dfc1ed098c5 100644 (file)
--- a/gas/doc/c-i386.texi
+++ b/gas/doc/c-i386.texi
@@ -303,6 +303,9 @@ AVX instructions with 128bit vector length, which is the default.
 @option{-mavxscalar=@var{256}} will encode scalar AVX instructions
 with 256bit vector length.
 
+WARNING: Don't use this for production code - due to CPU errata the
+resulting code may not work on certain models.
+
 @cindex @samp{-mvexwig=} option, i386
 @cindex @samp{-mvexwig=} option, x86-64
 @item -mvexwig=@var{0}
@@ -313,6 +316,9 @@ instructions with vex.w = 0, which is the default.
 @option{-mvexwig=@var{1}} will encode WIG EVEX instructions with
 vex.w = 1.
 
+WARNING: Don't use this for production code - due to CPU errata the
+resulting code may not work on certain models.
+
 @cindex @samp{-mevexlig=} option, i386
 @cindex @samp{-mevexlig=} option, x86-64
 @item -mevexlig=@var{128}