<html xmlns:v="urn:schemas-microsoft-com:vml" xmlns:o="urn:schemas-microsoft-com:office:office" xmlns:w="urn:schemas-microsoft-com:office:word" xmlns:dt="uuid:C2F41010-65B3-11d1-A29F-00AA00C14882" xmlns:m="http://schemas.microsoft.com/office/2004/12/omml" xmlns="http://www.w3.org/TR/REC-html40">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=us-ascii">
<meta name="Generator" content="Microsoft Word 15 (filtered medium)">
<style><!--
/* Font Definitions */
@font-face
{font-family:"Cambria Math";
panose-1:2 4 5 3 5 4 6 3 2 4;}
@font-face
{font-family:Calibri;
panose-1:2 15 5 2 2 2 4 3 2 4;}
/* Style Definitions */
p.MsoNormal, li.MsoNormal, div.MsoNormal
{margin:0in;
margin-bottom:.0001pt;
font-size:11.0pt;
font-family:"Calibri",sans-serif;}
a:link, span.MsoHyperlink
{mso-style-priority:99;
color:#0563C1;
text-decoration:underline;}
a:visited, span.MsoHyperlinkFollowed
{mso-style-priority:99;
color:#954F72;
text-decoration:underline;}
span.EmailStyle17
{mso-style-type:personal-compose;
font-family:"Calibri",sans-serif;
color:windowtext;}
.MsoChpDefault
{mso-style-type:export-only;
font-family:"Calibri",sans-serif;}
@page WordSection1
{size:8.5in 11.0in;
margin:1.0in 1.0in 1.0in 1.0in;}
div.WordSection1
{page:WordSection1;}
--></style><!--[if gte mso 9]><xml>
<o:shapedefaults v:ext="edit" spidmax="1026" />
</xml><![endif]--><!--[if gte mso 9]><xml>
<o:shapelayout v:ext="edit">
<o:idmap v:ext="edit" data="1" />
</o:shapelayout></xml><![endif]-->
</head>
<body lang="EN-US" link="#0563C1" vlink="#954F72">
<div class="WordSection1">
<p class="MsoNormal">Hi all,<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I’m trying to put together a set of rules for how the various floating point semantic modes should be handled in clang. A lot of this information will be relevant to other front ends, but the details are necessarily bound to a front end
implementation so I’m framing the discussion here in terms of clang. Other front ends can choose to follow clang or not. The existence of this set of semantics is an LLVM property that applies to all front ends, but the front ends will have to do something
to initialize them.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I will eventually do something to convert this into an RST document and find a home for it in the clang documentation, but I’d like to start by getting input on whether everyone agrees with my judgment on how these things should work and
whether I’ve missed anything.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Here’s what I’ve got.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">FP semantic modes<o:p></o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">except_behavior { ignore, strict, may_trap }<o:p></o:p></p>
<p class="MsoNormal">fenv_access { on, off }<o:p></o:p></p>
<p class="MsoNormal">rounding_mode { dynamic, tonearest, downward, upward, towardzero }<o:p></o:p></p>
<p class="MsoNormal">contract { on, off, fast }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp_math { IEEE, PreserveSign, PositiveZero }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp32_math { IEEE, PreserveSign, PositiveZero }<o:p></o:p></p>
<p class="MsoNormal">support_math_errno { on, off }<o:p></o:p></p>
<p class="MsoNormal">no_honor_nans { on, off }<o:p></o:p></p>
<p class="MsoNormal">no_honor_infinities { on, off }<o:p></o:p></p>
<p class="MsoNormal">no_signed_zeros { on, off }<o:p></o:p></p>
<p class="MsoNormal">allow_reciprocal { on, off }<o:p></o:p></p>
<p class="MsoNormal">allow_approximate_fns { on, off }<o:p></o:p></p>
<p class="MsoNormal">allow_reassociation { on, off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">---------------------<o:p></o:p></p>
<p class="MsoNormal">Dependencies<o:p></o:p></p>
<p class="MsoNormal">---------------------<o:p></o:p></p>
<p class="MsoNormal">rounding_mode must be "tonearest" if fenv_access is "off" -- It is the user's responsibility to make sure the dynamic rounding mode is not left in another state.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">if except_behavior is not "ignore", allow_reciprocal, allow_approximate_fns and allow_reassociation must be "off".<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">FP models<o:p></o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">-----------------------<o:p></o:p></p>
<p class="MsoNormal">precise (default)<o:p></o:p></p>
<p class="MsoNormal">-----------------------<o:p></o:p></p>
<p class="MsoNormal">except_behavior { ignore }<o:p></o:p></p>
<p class="MsoNormal">fenv_access { off }<o:p></o:p></p>
<p class="MsoNormal">rounding_mode { tonearest }<o:p></o:p></p>
<p class="MsoNormal">contract { on }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp32_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal">support_math_errno { on }<o:p></o:p></p>
<p class="MsoNormal">no_honor_nans { off }<o:p></o:p></p>
<p class="MsoNormal">no_honor_infinities { off }<o:p></o:p></p>
<p class="MsoNormal">no_signed_zeros { off }<o:p></o:p></p>
<p class="MsoNormal">allow_reciprocal { off }<o:p></o:p></p>
<p class="MsoNormal">allow_approximate_fns { off }<o:p></o:p></p>
<p class="MsoNormal">allow_reassociation { off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">------------------<o:p></o:p></p>
<p class="MsoNormal">strict<o:p></o:p></p>
<p class="MsoNormal">------------------<o:p></o:p></p>
<p class="MsoNormal">except_behavior { strict }<o:p></o:p></p>
<p class="MsoNormal">fenv_access { on }<o:p></o:p></p>
<p class="MsoNormal">rounding_mode { dynamic }<o:p></o:p></p>
<p class="MsoNormal">contract { off }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp32_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal">support_math_errno { on }<o:p></o:p></p>
<p class="MsoNormal">no_honor_nans { off }<o:p></o:p></p>
<p class="MsoNormal">no_honor_infinities { off }<o:p></o:p></p>
<p class="MsoNormal">no_signed_zeros { off }<o:p></o:p></p>
<p class="MsoNormal">allow_reciprocal { off }<o:p></o:p></p>
<p class="MsoNormal">allow_approximate_fns { off }<o:p></o:p></p>
<p class="MsoNormal">allow_reassociation { off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">------------------<o:p></o:p></p>
<p class="MsoNormal">fast<o:p></o:p></p>
<p class="MsoNormal">------------------<o:p></o:p></p>
<p class="MsoNormal">except_behavior { ignore }<o:p></o:p></p>
<p class="MsoNormal">fenv_access { off }<o:p></o:p></p>
<p class="MsoNormal">rounding_mode { tonearest }<o:p></o:p></p>
<p class="MsoNormal">contract { fast }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp_math { PreserveSign }<o:p></o:p></p>
<p class="MsoNormal">denormal_fp32_math { PreserveSign }<o:p></o:p></p>
<p class="MsoNormal">support_math_errno { off }<o:p></o:p></p>
<p class="MsoNormal">no_honor_nans { on }<o:p></o:p></p>
<p class="MsoNormal">no_honor_infinities { on }<o:p></o:p></p>
<p class="MsoNormal">no_signed_zeros { on }<o:p></o:p></p>
<p class="MsoNormal">allow_reciprocal { on }<o:p></o:p></p>
<p class="MsoNormal">allow_approximate_fns { on }<o:p></o:p></p>
<p class="MsoNormal">allow_reassociation { on }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">Command-line options<o:p></o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">-ffp-model={precise|strict|fast}<o:p></o:p></p>
<p class="MsoNormal"> Sets all semantic modes as described above.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-ffast-math<o:p></o:p></p>
<p class="MsoNormal"> Equivalent to -ffp-model=fast. (I'm not sure that's currently true.)<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-f[no-]math-errno<o:p></o:p></p>
<p class="MsoNormal">-ffp-contract={on|off|fast}<o:p></o:p></p>
<p class="MsoNormal">-f[no-]honor-infinities<o:p></o:p></p>
<p class="MsoNormal">-f[no-]honor-nans<o:p></o:p></p>
<p class="MsoNormal">-f[no-]associative-math<o:p></o:p></p>
<p class="MsoNormal">-f[no-]reciprocal-math<o:p></o:p></p>
<p class="MsoNormal">-f[no-]signed-zeros<o:p></o:p></p>
<p class="MsoNormal">-f[no-]trapping-math<o:p></o:p></p>
<p class="MsoNormal">-f[no-]rounding-math<o:p></o:p></p>
<p class="MsoNormal">-fdenormal-fp-math={ieee, preservesign, positivezero}<o:p></o:p></p>
<p class="MsoNormal">-fdenormal-fp-math-fp32={ieee, preservesign, positivezero}<o:p></o:p></p>
<p class="MsoNormal">-ffp-exception-behavior={ignore,maytrap,strict}<o:p></o:p></p>
<p class="MsoNormal"> Each of these has a 1-to-1 correspondance to an FP semantic mode.<o:p></o:p></p>
<p class="MsoNormal"> (I think several of these should set "except_behavior" to "ignore".)<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-f[no-]finite-math-only<o:p></o:p></p>
<p class="MsoNormal"> Controls no_honor_nans and no_honor_infinities.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-f[no-]unsafe-math-optimizations<o:p></o:p></p>
<p class="MsoNormal"> Turns no_signed_zeros, allow_reciprocal, allow_approximate_fns, and allow_reassociation on or off.<o:p></o:p></p>
<p class="MsoNormal"> Also, sets except_behavior to "on" for -funsafe-math-optimizations.<o:p></o:p></p>
<p class="MsoNormal"> (Currently, -fno-]unsafe-math-optimizations clears except_behavior, but I regard this as a bug.)<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">All command line options will override any previous values of all settings they control with options taking effect in a left-to-right manner.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">pragmas<o:p></o:p></p>
<p class="MsoNormal">======================<o:p></o:p></p>
<p class="MsoNormal">STDC FENV_ACCESS {ON|OFF}<o:p></o:p></p>
<p class="MsoNormal"> Patch in progress. I think ON should force the following:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"> except_behavior { strict }<o:p></o:p></p>
<p class="MsoNormal"> fenv_access { on }<o:p></o:p></p>
<p class="MsoNormal"> rounding_mode { dynamic }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp32_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> no_signed_zeros { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reciprocal { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_approximate_fns { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reassociation { off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"> And OFF should set fenv_access to off, except_behavior to ignore, and rounding_mode to tonearest. Other modes should be reset to their command line defined settings.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"> I don't think this pragma should have any effect on contract, support_math_errno, no_honor_nans, or no_honor_infinities.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">STDC FP_CONTRACT {ON|OFF|DEFAULT}<o:p></o:p></p>
<p class="MsoNormal"> This pragma controls the contract FP semantic mode. No other FP semantic modes are effected.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">float_control ({precise|except}, {on|off}[, push])<o:p></o:p></p>
<p class="MsoNormal">float_control (pop)<o:p></o:p></p>
<p class="MsoNormal"> Patch in progress. These are tricky.<o:p></o:p></p>
<p class="MsoNormal"> I think they should have the following effects:<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">float_control (precise, on[, push])<o:p></o:p></p>
<p class="MsoNormal"> contract { on }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp32_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> no_signed_zeros { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reciprocal { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_approximate_fns { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reassociation { off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">float_control (precise, off[, push])<o:p></o:p></p>
<p class="MsoNormal"> contract { fast }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp_math { preservesign }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp32_math { preservesign }<o:p></o:p></p>
<p class="MsoNormal"> no_signed_zeros { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_reciprocal { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_approximate_fns { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_reassociation { on }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Note, this is less than what the -ffp-model=precise control does. Should this override support_math_errno, no_honor_nans, or no_honor_infinities?<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">float_control (except, on[, push])<o:p></o:p></p>
<p class="MsoNormal"> except_behavior { strict }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">float_control (except, off[, push])<o:p></o:p></p>
<p class="MsoNormal"> except_behavior { ignore }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The MSVC documentation says you can only use the float_control pragma to turn exception semantics on when precise semantics are enabled. For us, this would mean:<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp32_math { IEEE }<o:p></o:p></p>
<p class="MsoNormal"> no_signed_zeros { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reciprocal { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_approximate_fns { off }<o:p></o:p></p>
<p class="MsoNormal"> allow_reassociation { off }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The MSVC documentation also says you can't use the float_control pragma to turn excpetion semantics off when precise semantics are enabled, and you can't use the float_control pragma to turn precise off when fenv_access is on.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">I believe we should follow the MSVC restrictions.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">=========================<o:p></o:p></p>
<p class="MsoNormal">Code-visible identifiers<o:p></o:p></p>
<p class="MsoNormal">=========================<o:p></o:p></p>
<p class="MsoNormal">__FAST_MATH__<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">This symbol will only be defined if and only if all of the following are set (before pragmas are applied):<o:p></o:p></p>
<p class="MsoNormal"> except_behavior { ignore }<o:p></o:p></p>
<p class="MsoNormal"> fenv_access { off }<o:p></o:p></p>
<p class="MsoNormal"> rounding_mode { tonearest }<o:p></o:p></p>
<p class="MsoNormal"> contract { fast }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp_math { PreserveSign }<o:p></o:p></p>
<p class="MsoNormal"> denormal_fp32_math { PreserveSign }<o:p></o:p></p>
<p class="MsoNormal"> support_math_errno { off }<o:p></o:p></p>
<p class="MsoNormal"> no_honor_nans { on }<o:p></o:p></p>
<p class="MsoNormal"> no_honor_infinities { on }<o:p></o:p></p>
<p class="MsoNormal"> no_signed_zeros { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_reciprocal { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_approximate_fns { on }<o:p></o:p></p>
<p class="MsoNormal"> allow_reassociation { on }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">__FINITE_MATH_ONLY__<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">This symbol will only be defined if and only if all of the following are set (before pragmas are applied):<o:p></o:p></p>
<p class="MsoNormal"> no_honor_nans { on }<o:p></o:p></p>
<p class="MsoNormal"> no_honor_infinities { on }<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">FLT_ROUNDS<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Should be set to -1 (indeterminable) if rounding_mode() is dynamic or 1 (tonearest) if rounding_mode is tonearest. There are values for other rounding modes, but clang offers no way to set those rounding modes.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">FLT_EVAL_METHOD<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Should be set to -1 if any of allow_reciprocal, allow_approximate_fns, or allow_reassociation is set. Should any other flags also make this -1? Otherwise, the setting is target-defined.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">math_errhandling<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">The MATH_ERRNO bit will be set or cleared based on the setting of support_math_errno. Should MATH_ERREXCEPT be set or cleared based on except_behavior?<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">Thanks in advance for any opinions and suggestions.<o:p></o:p></p>
<p class="MsoNormal"><o:p> </o:p></p>
<p class="MsoNormal">-Andy<o:p></o:p></p>
</div>
</body>
</html>