GETFCR(2) GETFCR(2)
NAME
getfcr, setfcr, getfsr, setfsr - control floating point
SYNOPSIS
#include <u.h>
#include <libc.h>
ulong getfcr(void)
void setfcr(ulong fcr)
ulong getfsr(void)
void setfsr(ulong fsr)
/* Alef only */
#include <arch.h>
#include <alef.h>
uint getfcr()
void setfcr(uint fcr)
uint getfsr()
void setfsr(uint fsr)
DESCRIPTION
These routines provide a fairly portable interface to con-
trol the rounding and exception characteristics of IEEE 754
floating point units. In effect, they define a pair of
pseudo-registers, the floating point control register, fcr,
which affects rounding, precision, and exceptions, and the
floating point status register, fsr, which holds the accrued
exception bits. Each register has a get routine to retrieve
its value, a set routine to modify it, and macros that iden-
tify its contents.
The fcr contains bits that, when set, enable exceptions:
FPINEX (enable inexact exceptions), FPOVFL (enable overflow
exceptions), FPUNFL (enable underflow exceptions), and
FPZDIV (enable zero divide exceptions). Rounding is con-
trolled by installing in fcr, under mask FPRMASK, one of the
values FPRNR (round to nearest), FPRZ (round towards zero),
FPRPINF (round towards positive infinity), and FPRNINF
(round towards negative infinity). Precision is controlled
by installing in fcr, under mask FPPMASK, one of the values
FPPEXT (extended precision), FPPSGL (single precision), and
FPPDBL (double precision).
Page 1 Plan 9 (printed 11/17/24)
GETFCR(2) GETFCR(2)
The fsr holds the accrued exception bits FPAINEX, FPAOVFL,
FPAUNFL, and FPAZDIV, corresponding to the fsr bits without
the A in the name.
Not all machines support all modes. If the corresponding
mask is zero, the machine does not support the rounding or
precision modes. On some machines it is not possible to
clear selective accrued exception bits; a setfsr clears them
all. The exception bits defined here work on all architec-
tures.
The default state of the floating point unit is fixed for a
given architecture but is undefined across Plan 9: the
default is to provide what the hardware does most effi-
ciently. Use these routines if you need guaranteed behav-
ior. Also, gradual underflow is not available on some
machines.
Alef
The specification for these routines is the same in Alef,
except that these functions (and only these functions) need
the machine-dependent include file
/$objtype/include/alef/arch.h.
EXAMPLE
To enable overflow traps and make sure registers are rounded
to double precision (for example on the MC68020, where the
internal registers are 80 bits long):
ulong fcr;
fcr = getfcr();
fcr |= FPOVFL;
fcr &= ~FPPMASK;
fcr |= FPPDBL;
setfcr(fcr);
SOURCE
/sys/src/libc/$objtype/getfcr.s
Page 2 Plan 9 (printed 11/17/24)