117 lines
3.1 KiB

25 years ago
25 years ago
25 years ago
25 years ago
25 years ago
25 years ago
25 years ago
  1. Prerequisites.
  2. =============
  3. ANSI-compliant C++ compiler. GNU C++ compiler (version >= 3.4) is recommend.
  4. Non-GNU compilers might not work at the moment.
  5. GNU multiprecision library (http://gmplib.org), version > 4.0 (older 3.x
  6. versions might work too).
  7. [Optional] To build CLN documentation texinfo and TeX are necessary.
  8. If you install CLN from git, you also need
  9. git itself (http://git.or.cz), version >= 1.5.0
  10. GNU autoconf (http://www.gnu.org/software/autoconf), version >= 2.59
  11. GNU libtool (http://www.gnu.org/software/libtool), version >= 1.5
  12. GNU automake (http://www.gnu.org/software/automake), version >= 1.8
  13. Installation from a source .tar.bz2 distribution.
  14. ================================================
  15. $ ./configure
  16. $ make
  17. $ make check
  18. [ become root if necessary ]
  19. # make install
  20. To build the manual in PDF, HTML, or PostScript formats, use one of
  21. $ make pdf
  22. $ make html
  23. $ make ps
  24. To compile and run CLN's test suite and check whether the library was
  25. compiled correctly you can use
  26. $ make check
  27. The "configure" script can be given a number of options to enable and
  28. disable various features. Most useful ones are:
  29. --prefix=DIR
  30. Install CLN into the directory DIR (default: /usr/local).
  31. --with-gmp
  32. Use GNU multiprecision library (default: yes, if available)
  33. --disable-static
  34. Don't build static version of CLN library. This option is useful if
  35. want to reduce the build time (and you don't need the static library).
  36. For a complete list, run:
  37. $ ./configure --help
  38. Installation from git.
  39. =====================
  40. 1. Download the code.
  41. Initial download:
  42. $ git clone git://ffmssmsc.jinr.ru:443/varg/cln.git cln
  43. Later on you can update your copy with
  44. $ git pull
  45. 2. Make sure all required software is installed. This is *really*
  46. important step. If some package is missing, the `configure' script might
  47. be misgenerated,
  48. 3. Run
  49. $ autoreconf -iv
  50. to generate the `configure' script, and proceed in a standard way, i.e.
  51. $ ./configure
  52. $ make
  53. [become root if necessary]
  54. # make install
  55. CLN is known to work with:
  56. =========================
  57. - Linux/x86, gcc-3.x, gcc-4.[0-2].x
  58. - Linux/x86_64, gcc-3.[3-4], gcc-4.[0-2].x, gcc-4.3.0
  59. - Linux/ia64, gcc-3.[2-4], gcc-4.[0-2].x
  60. - Linux/arm, gcc-3.[0-3] (*), gcc-4.[0-2].x (*)
  61. - Linux/mips, gcc-3.3, gcc-4.[0-2].x
  62. - Linux/sparc, gcc-3.[1-3], gcc-4.[0-2].x
  63. - Linux/alpha, gcc-3.[0-3], gcc-4.[0-2].x
  64. - Linux/powerpc, gcc-3.[0-3], gcc-4.[0-2].x
  65. - Linux/hppa, gcc-4.2.x (*)
  66. - Solaris 2.4 (sparc), gcc-3.[1-3], gcc-4.[0-2].x (*)
  67. - OSF/1 V4.0 (alpha), gcc-3.1
  68. - Irix 6.5, gcc-3.0
  69. - OS X Leopard (x86), gcc 4.0.1
  70. (*) On these platforms, problems with the assembler routines have been
  71. reported. It may be best to add "-DNO_ASM" to CPPFLAGS before
  72. configuring.
  73. Using gcc-4.2, the "make" step takes about 15 minutes, on an x86_64 / 2 GHz.
  74. If you use g++ from gcc-3.0.4 or older on Sparc, add either "-O", "-O1" or
  75. "-O2 -fno-schedule-insns" to the CXXFLAGS. With full "-O2", g++ miscompiles
  76. the division routines. Do not use gcc-3.0 on Sparc for compiling CLN, it
  77. won't work at all.
  78. More detailed installation instructions can be found in the documentation,
  79. in the doc/ directory.