MPFR version 2.2.1 (released on 29 November 2006)

MPFR 2.2.1 requires GMP 4.1.0 or higher. This is the latest version of the 2.2 branch, which is no longer supported (newly discovered bugs will probably never be fixed on this branch). Please upgrade to MPFR 2.3.0 (or higher, when new versions are released): latest MPFR release.

Download

The MPFR 2.2.1 source can be downloaded in the following archive formats:

• mpfr-2.2.1.tar.bz2 (tar/bzip2, 770 KB),
• mpfr-2.2.1.tar.gz (tar/gzip, 1020 KB),
• mpfr-2.2.1.zip (zip, 1.3 MB).
• Source RPM: mpfr-2.2.1-2.src.rpm (1.1 MB).

MPFR is also available via third-party packages and ports.

Documentation

• The reference manual: [html] [dvi] [ps] [pdf]
• Old MPFR 2.2.0 reference manual translated into Japanese: [html] [pdf] [sources]
  There is not much difference though.
• The MPFR FAQ (common to all MPFR versions).

Bugs

The bugs listed below have been fixed (latest update: 2007-02-17). The following instructions are for Linux and may be similar for other operating systems. You can apply the patches in several ways:

• Apply the cumulative patch on the 2.2.1 release or a partially patched version with the command

  patch -N -Z -p1 < path_to_patches_file

  from the build directory. The -N option allows the patch command to ignore patches already applied. The -Z option sets the modification time of the patched files from time stamps given in the patch file, thus avoiding the need of some development utilities (such as autoconf). Under Microsoft Windows, in addition to the above options, you may need the --binary option (this depends whether the end-of-lines have been converted when you downloaded the patch file). Also note that the --dry-run option does not work with this cumulative patch.
• Or apply the individual patches below.
• Or checkout the 2.2 branch from the Subversion repository, e.g. with the command

  svn co svn://scm.gforge.inria.fr/svn/mpfr/branches/2.2 mpfr-2.2

  In this case, as said on the Gforge page, you should read the README.dev file for details on how to build MPFR. Also note that the branch may contain additional minor fixes.

With the first two ways, a suffix is added to the version string, so that one can know what patches have been applied. For practical reasons, not all the files where the version appears are patched, but the updated version string is available with the MPFR_VERSION_STRING macro (header) and the mpfr_get_version function (library).

Note: These patches are in unified diff format and some vendors' patch commands cannot deal with them; in this case, please use GNU patch (it may already be installed on your system, e.g. as /usr/local/bin/patch or gpatch).

Fixed bugs:

1. Though documented in the MPFR manual, the mpfr_init_set_ld macro is missing. The mpfr_init_set_ld patch adds it to the mpfr.h file.
2. A test in tests/tget_f.c yields an integer overflow (the test fails when using gcc's -ftrapv option). This is fixed by the tests/tget_f.c patch.
3. Some cases of overflow and underflow are not correctly handled in the mpfr_set_si_2exp and mpfr_set_ui_2exp functions (wrong flags, and even an incorrect value in case of double rounding). In corner cases (emin ≥ 4 and some other constraints), the mpfr_set_si and mpfr_set_ui may set the underflow flag though an underflow did not occur. These problems are fixed by the mpfr_set_si/ui patch.
4. The mpfr_pow_si function does not behave correctly on some extreme cases. In particular, computing 2^LONG_MIN+1 with mpfr_pow_si can yield a NaN. For some input values, integer overflows may occur, but in practice, the results are correct as long as the implementation (C compiler) guarantees two's complement wrapping. These problems are fixed by the mpfr_pow_si patch. Moreover this patch avoids a bug in Sun's compiler for Solaris/x86 (with optimizations).
5. MPFR manual update: The default install directory for the info file has changed and this patch updates it in the manual, and it adds a new section Exceptions and the missing description of the mpfr_dim function (that was added to MPFR 2.0.1).

In addition to the bugs mentioned in the BUGS file:

• There are possible bugs with huge precisions (greater than 2³⁰) and with exponent ranges that do not allow to represent some numbers, such as 1 or 1/2.
• Some MPFR functions may fail if computations on the double floating-point type are carried out in a precision less than the IEEE-754 double precision. This can happen on x86 processors if the FPU is configured in single precision mode (though one should never do that).
• If you get the following error:

  Error in pow_si(x,x,-2) for x=2

  this may be a bug in your compiler, thus not an MPFR bug. Such a bug has been found in GCC preversions and in Sun's compiler for Solaris/x86 (when optimizations are enabled, which is the default when building MPFR). To avoid this compiler bug, please apply the above patches.
• Some error bounds are underestimated in the proof for various functions. In rare cases, this may lead to a slightly inaccurate result, but it is not known if such cases exist. This bug has been fixed in the trunk (10cc7034 (r4372)).
• The mpfr_fma function behaves incorrectly if the multiplication overflows or underflows (in the current exponent range).
• Some functions behave incorrectly (with a possible infinite loop) on tiny arguments, e.g. ±2^emin−1. This problem has been fixed in the trunk.
• Similarly, some functions behave incorrectly (with a possible infinite loop) on very large arguments, e.g. ±(2^emax − epsilon).
• Infinite loop in mpfr_gamma on some integers.
• With gcc, the mpfr_cmp_ui and mpfr_cmp_si macros used on NaN and the constant 0 can return an incorrect result and let the erange flag unset, because of a bug in a gcc-specific optimization.
• On some inputs, the mpfr_div function returns an incorrect value, which is not normalized (this can lead to an assertion failure, or perhaps even a memory corruption). This bug is fixed in the trunk. See the corresponding tests.
• The mpfr_div function returns an incorrectly rounded result in case of underflow or overflow when the quotient is negative and the rounding mode is either GMP_RNDD or GMP_RNDU.
• Assertion failure in mpfr_log on some data (see testcase). This is fixed in the trunk.
• Assertion failure in mpfr_asinh on some data (see testcase). This is fixed in the trunk.

Changes from version 2.2.0 to version 2.2.1

• Many bug fixes (see the MPFR 2.2.0 page for the list).
• Updated mpfr-longlong.h from the GMP 4.2 longlong.h file.
• Moved some internal declarations from mpfr.h to mpfr-impl.h.
• Use -search_paths_first on Darwin (Mac OS X) to fix linking behavior.
• Improved make check: much more complete generic tests.
• Improved INSTALL file and MPFR manual.
• The mpfr.info file is now installed in the share subdirectory (as required by the Filesystem Hierarchy Standard); see output of ./configure --help.

Platforms Known to Support MPFR

MPFR 2.2.1 has been successfully compiled and checked on the following platforms:

• alphaev56-dec-osf4.0f (Alpha, gcc 4.1.1),
• alphaev56-unknown-linux-gnu (Alpha, gcc 4.1.1),
• alphaev68-dec-osf5.1 (Alpha, gcc 3.2.1),
• alphaev68-dec-osf5.1b (Alpha, gcc 4.1.1),
• armv5tel-unknown-linux-gnu (XScale-PXA255, gcc 2.95.2),
• hppa2.0w-hp-hpux11.23 (PA-RISC 8900, HP cc),
• i386-pc-solaris2.9 (gcc 4.1.1),
• i386-suse-linux-gnu,
• i686-pc-linux-gnu (Dual Core AMD Opteron, gcc 3.3.5),
• i686-pc-linux-gnu (Intel Pentium D, gcc 4.1.2 prerelease),
• ia64-suse-linux-gnu,
• ia64-unknown-linux-gnu (Itanium, gcc 3.2.3 prerelease),
• ia64-unknown-linux-gnu (gcc 4.1.1),
• mips-sgi-irix6.5 (MIPSpro 7.3.1.3m),
• powerpc-apple-darwin8.8.0 (PowerPC G5, gcc 4.0.1),
• powerpc-unknown-linux-gnu (PowerPC G4, gcc 4.1.2 prerelease),
• powerpc64-unknown-linux-gnu (gcc 4.1.1),
• powerpc64-unknown-linux-gnu (POWER5, gcc 4.1.2 prerelease),
• ppc-suse-linux-gnu,
• ppc64-suse-linux-gnu,
• s390-suse-linux-gnu,
• s390x-suse-linux-gnu,
• sparc-sun-solaris2.7 (UltraSPARC-II, Sun WorkShop 6 2000/04/07 C 5.1),
• sparc-sun-solaris2.8 (gcc 4.1.1),
• sparc-sun-solaris2.10 (Sun C 5.8 Patch 121015-03 2006/10/18),
• x86_64-solaris2.10 (gcc 4.1.1),
• x86_64-suse-linux-gnu,
• x86_64-unknown-linux-gnu (AMD Opteron, gcc 4.1.1),
• Cygwin (Intel Celeron, gcc 3.4.2),
• MINGW32_NT-5.1 (Intel Pentium M, gcc 3.4.2).

Back to the MPFR page.