Blame lib/fpucw.h

Packit Service a2489d
/* Manipulating the FPU control word.  -*- coding: utf-8 -*-
Packit Service a2489d
   Copyright (C) 2007-2018 Free Software Foundation, Inc.
Packit Service a2489d
   Written by Bruno Haible <bruno@clisp.org>, 2007.
Packit Service a2489d
Packit Service a2489d
   This program is free software: you can redistribute it and/or modify
Packit Service a2489d
   it under the terms of the GNU General Public License as published by
Packit Service a2489d
   the Free Software Foundation; either version 3 of the License, or
Packit Service a2489d
   (at your option) any later version.
Packit Service a2489d
Packit Service a2489d
   This program is distributed in the hope that it will be useful,
Packit Service a2489d
   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit Service a2489d
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit Service a2489d
   GNU General Public License for more details.
Packit Service a2489d
Packit Service a2489d
   You should have received a copy of the GNU General Public License
Packit Service a2489d
   along with this program.  If not, see <https://www.gnu.org/licenses/>.  */
Packit Service a2489d
Packit Service a2489d
#ifndef _FPUCW_H
Packit Service a2489d
#define _FPUCW_H
Packit Service a2489d
Packit Service a2489d
/* The i386 floating point hardware (the 387 compatible FPU, not the modern
Packit Service a2489d
   SSE/SSE2 hardware) has a controllable rounding precision.  It is specified
Packit Service a2489d
   through the 'PC' bits in the FPU control word ('fctrl' register).  (See
Packit Service a2489d
   the GNU libc i386 <fpu_control.h> header for details.)
Packit Service a2489d
Packit Service a2489d
   On some platforms, such as Linux or Solaris, the default precision setting
Packit Service a2489d
   is set to "extended precision".  This means that 'long double' instructions
Packit Service a2489d
   operate correctly, but 'double' computations often produce slightly
Packit Service a2489d
   different results as on strictly IEEE 754 conforming systems.
Packit Service a2489d
Packit Service a2489d
   On some platforms, such as NetBSD, the default precision is set to
Packit Service a2489d
   "double precision".  This means that 'long double' instructions will operate
Packit Service a2489d
   only as 'double', i.e. lead to wrong results.  Similarly on FreeBSD 6.4, at
Packit Service a2489d
   least for the division of 'long double' numbers.
Packit Service a2489d
Packit Service a2489d
   The FPU control word is under control of the application, i.e. it is
Packit Service a2489d
   not required to be set either way by the ABI.  (In fact, the i386 ABI
Packit Service a2489d
   https://www.linux-mips.org/pub/linux/mips/doc/ABI/abi386-4.pdf page 3-12 = page 38
Packit Service a2489d
   is not clear about it.  But in any case, gcc treats the control word
Packit Service a2489d
   like a "preserved" register: it emits code that assumes that the control
Packit Service a2489d
   word is preserved across calls, and it restores the control word at the
Packit Service a2489d
   end of functions that modify it.)
Packit Service a2489d
Packit Service a2489d
   See Vincent Lefèvre's page https://www.vinc17.net/research/extended.en.html
Packit Service a2489d
   for a good explanation.
Packit Service a2489d
   See http://www.uwsg.iu.edu/hypermail/linux/kernel/0103.0/0453.html for
Packit Service a2489d
   some argumentation which setting should be the default.  */
Packit Service a2489d
Packit Service a2489d
/* This header file provides the following facilities:
Packit Service a2489d
     fpucw_t                        integral type holding the value of 'fctrl'
Packit Service a2489d
     FPU_PC_MASK                    bit mask denoting the precision control
Packit Service a2489d
     FPU_PC_DOUBLE                  precision control for 53 bits mantissa
Packit Service a2489d
     FPU_PC_EXTENDED                precision control for 64 bits mantissa
Packit Service a2489d
     GET_FPUCW ()                   yields the current FPU control word
Packit Service a2489d
     SET_FPUCW (word)               sets the FPU control word
Packit Service a2489d
     DECL_LONG_DOUBLE_ROUNDING      variable declaration for
Packit Service a2489d
                                    BEGIN/END_LONG_DOUBLE_ROUNDING
Packit Service a2489d
     BEGIN_LONG_DOUBLE_ROUNDING ()  starts a sequence of instructions with
Packit Service a2489d
                                    'long double' safe operation precision
Packit Service a2489d
     END_LONG_DOUBLE_ROUNDING ()    ends a sequence of instructions with
Packit Service a2489d
                                    'long double' safe operation precision
Packit Service a2489d
 */
Packit Service a2489d
Packit Service a2489d
/* Inline assembler like this works only with GNU C.  */
Packit Service a2489d
#if (defined __i386__ || defined __x86_64__) && defined __GNUC__
Packit Service a2489d
Packit Service a2489d
typedef unsigned short fpucw_t; /* glibc calls this fpu_control_t */
Packit Service a2489d
Packit Service a2489d
# define FPU_PC_MASK 0x0300
Packit Service a2489d
# define FPU_PC_DOUBLE 0x200    /* glibc calls this _FPU_DOUBLE */
Packit Service a2489d
# define FPU_PC_EXTENDED 0x300  /* glibc calls this _FPU_EXTENDED */
Packit Service a2489d
Packit Service a2489d
# define GET_FPUCW() \
Packit Service a2489d
  ({ fpucw_t _cw;                                               \
Packit Service a2489d
     __asm__ __volatile__ ("fnstcw %0" : "=m" (*&_cw));         \
Packit Service a2489d
     _cw;                                                       \
Packit Service a2489d
   })
Packit Service a2489d
# define SET_FPUCW(word) \
Packit Service a2489d
  (void)({ fpucw_t _ncw = (word);                               \
Packit Service a2489d
           __asm__ __volatile__ ("fldcw %0" : : "m" (*&_ncw));  \
Packit Service a2489d
         })
Packit Service a2489d
Packit Service a2489d
# define DECL_LONG_DOUBLE_ROUNDING \
Packit Service a2489d
  fpucw_t oldcw;
Packit Service a2489d
# define BEGIN_LONG_DOUBLE_ROUNDING() \
Packit Service a2489d
  (void)(oldcw = GET_FPUCW (),                                  \
Packit Service a2489d
         SET_FPUCW ((oldcw & ~FPU_PC_MASK) | FPU_PC_EXTENDED))
Packit Service a2489d
# define END_LONG_DOUBLE_ROUNDING() \
Packit Service a2489d
  SET_FPUCW (oldcw)
Packit Service a2489d
Packit Service a2489d
#else
Packit Service a2489d
Packit Service a2489d
typedef unsigned int fpucw_t;
Packit Service a2489d
Packit Service a2489d
# define FPU_PC_MASK 0
Packit Service a2489d
# define FPU_PC_DOUBLE 0
Packit Service a2489d
# define FPU_PC_EXTENDED 0
Packit Service a2489d
Packit Service a2489d
# define GET_FPUCW() 0
Packit Service a2489d
# define SET_FPUCW(word) (void)(word)
Packit Service a2489d
Packit Service a2489d
# define DECL_LONG_DOUBLE_ROUNDING
Packit Service a2489d
# define BEGIN_LONG_DOUBLE_ROUNDING()
Packit Service a2489d
# define END_LONG_DOUBLE_ROUNDING()
Packit Service a2489d
Packit Service a2489d
#endif
Packit Service a2489d
Packit Service a2489d
#endif /* _FPUCW_H */