| Brian Waters | 13d9601 | 2017-12-08 16:53:31 -0600 | [diff] [blame] | 1 | This package uses CMake (cmake.org) as building system. You'll need the cmake tool in order |
| 2 | to generate the Makefiles for your platform. You can also select which extensions must be built |
| 3 | with cmake. After the initial cmake configuration, you will need several tools such as make, a |
| 4 | C compiler (tested mostly with gcc), flex (> 2.5.4), bison, ... |
| 5 | |
| 6 | You may retrieve the source package in several ways: |
| 7 | - as a pre-packaged version for your platform. Check the website for supported platforms. |
| 8 | - as a tarball containing the source. |
| 9 | - directly from the repository using Mercurial tool: |
| 10 | hg clone http://www.freediameter.net/hg/freeDiameter |
| 11 | In order to update later: |
| 12 | hg pull -u |
| 13 | |
| 14 | Building in a separate directory is recommended: |
| 15 | # mkdir build |
| 16 | # cd build |
| 17 | # cmake ../ |
| 18 | # make |
| 19 | |
| 20 | You can pass options to instruct cmake about which components to compile on the command-line. |
| 21 | You can also use a CMake front-end (for example ccmake or cmake-gui). |
| 22 | If your cmake installation is recent, the edit_cache target is a good help as well: |
| 23 | # mkdir build |
| 24 | # cd build |
| 25 | # cmake ../ |
| 26 | # make help |
| 27 | # make edit_cache |
| 28 | # make |
| 29 | |
| 30 | You can disable the unit tests by doing: |
| 31 | # cmake -DBUILD_TESTING:BOOL=OFF ../ |
| 32 | # make |
| 33 | |
| 34 | When the tests are enabled, you can run them with: |
| 35 | # make test |
| 36 | |
| 37 | See the INSTALL.* files for additional platform-specific information. |
| 38 | Note that the most up-to-date INSTALL file is the Ubuntu one. You may want to read there |
| 39 | in addition to your own platform file. |