2 Installing MPC

To build MPC, you first have to install GNU MP (version 4.3.2 or higher) and GNU MPFR (version 2.4.2 or higher) on your computer. You need a C compiler, preferably GCC, but any reasonable compiler should work. And you need a standard Unix ‘make’ program, plus some other standard Unix utility programs.

Here are the steps needed to install the library on Unix systems:

1. ‘tar xzf mpc-0.9.tar.gz’
2. ‘cd mpc-0.9’
3. ‘./configure’

   if GMP and MPFR are installed into standard directories, that is, directories that are searched by default by the compiler and the linking tools.

   ‘./configure --with-gmp=<gmp_install_dir>’

   is used to indicate a different location where GMP is installed. Alternatively, you can specify directly GMP include and GMP lib directories with ‘./configure --with-gmp-lib=<gmp_lib_dir> --with-gmp-include=<gmp_include_dir>’.

   ‘./configure --with-mpfr=<mpfr_install_dir>’

   is used to indicate a different location where MPFR is installed. Alternatively, you can specify directly MPFR include and MPFR lib directories with ‘./configure --with-mpf-lib=<mpfr_lib_dir> --with-mpfr-include=<mpfr_include_dir>’.

   Another useful parameter is ‘--prefix’, which can be used to specify an alternative installation location instead of ‘/usr/local’; see ‘make install’ below.

   If for debugging purposes you wish to log calls to MPC functions from within your code, add the parameter ‘--enable-logging’. In your code, replace the inclusion of ‘mpc.h’ by ‘mpc-log.h’ and link the executable dynamically. Then all calls to functions with only complex arguments are printed to ‘stderr’ in the following form: First, the function name is given, followed by its type such as ‘c_cc’, meaning that the function has one complex result (one ‘c’ in front of the ‘_’), computed from two complex arguments (two ‘c’ after the ‘_’). Then, the precisions of the real and the imaginary part of the first result is given, followed by the second one and so on. Finally, for each argument, the precisions of its real and imaginary part are specified and the argument itself is printed in hexadecimal via the function mpc_out_str (see String and Stream Input and Output).

   Use ‘./configure --help’ for an exhaustive list of parameters.

4. ‘make’

   This compiles MPC in the working directory.

5. ‘make check’

   This will make sure MPC was built correctly.

   If you get error messages, please report them to ‘mpc-discuss@lists.gforge.inria.fr’ (See section Reporting Bugs, for information on what to include in useful bug reports).

6. ‘make install’

   This will copy the file ‘mpc.h’ to the directory ‘/usr/local/include’, the file ‘libmpc.a’ to the directory ‘/usr/local/lib’, and the file ‘mpc.info’ to the directory ‘/usr/local/share/info’ (or if you passed the ‘--prefix’ option to ‘configure’, using the prefix directory given as argument to ‘--prefix’ instead of ‘/usr/local’). Note: you need write permissions on these directories.

This document was generated on November 27, 2011 using texi2html 5.0.