]>
Commit | Line | Data |
---|---|---|
3849db25 | 1 | # $Id: INSTALL.quagga.txt,v 1.9 2005/04/02 17:13:33 paul Exp $ |
8bed780b | 2 | |
9104f569 | 3 | -------------------------------------------------------------------------- |
3764c0c0 | 4 | Building and Installing Quagga from releases or snapshots: |
9104f569 | 5 | |
6 | The 'INSTALL' file contains generic instructions on how to use 'configure' | |
7 | scripts. | |
8 | ||
8686fc74 | 9 | Quagga requires a C compiler supporting the C99 standard. |
10 | ||
3764c0c0 | 11 | Quagga can be compiled with either BSD make or GNU make. |
12 | GNU make 3.80 is known to work. | |
13 | The following system makes are known to work | |
14 | NetBSD 1.6.2 | |
15 | NetBSD 2.0 | |
16 | ||
9104f569 | 17 | For further Quagga specific information on 'configure' and build-time |
18 | configuration of the software, please read the Quagga info documentation, | |
19 | (doc/quagga.info). To read the info page included with the Quagga sources | |
20 | without first installing Quagga: | |
21 | ||
22 | cd doc/ | |
23 | pinfo -r quagga.info | |
24 | ||
25 | Assuming you have the user-friendly 'pinfo' info browser installed. | |
26 | ||
27 | You can also the standard GNU 'info' browser, if you prefer this browser you | |
28 | have no doubt already spent a lot of time reading its documentation and dont | |
29 | need to be told how to specify an info file by filename. ;) | |
30 | ||
31 | The Quagga website should also have recent versions of documentation | |
32 | available online. | |
33 | ||
34 | -------------------------------------------------------------------------- | |
35 | Building Quagga from CVS checkouts: | |
36 | ||
37 | In order to build from CVS, you will need recent versions of several GNU | |
3764c0c0 | 38 | tools, particularly autoconf, automake, libtool and texinfo. Note that the |
8bed780b | 39 | CVS snapshots on the Quagga website do not require these tools; everything |
3764c0c0 | 40 | is already setup ready to run 'configure'. If you have trouble building |
9104f569 | 41 | from CVS checkout it is recommended that you try a CVS snapshot instead. |
42 | ||
3764c0c0 | 43 | If you are building from plain CVS checkouts, the versions which |
44 | should work at least with: | |
9104f569 | 45 | |
46 | automake: 1.8.5 | |
47 | autoconf: 2.59 | |
48 | libtool: 1.5.6 | |
3764c0c0 | 49 | texinfo: 4.7 |
50 | ||
38c2cfee | 51 | Texinfo is not actually required since quagga.info is checked in. |
52 | When texinfo 4.7 is widespread, it will be removed and texinfo will | |
53 | become required again. (4.7 has figure support, needed for the route | |
54 | server docs, which is why 4.6 doesn't work.) | |
55 | ||
3849db25 | 56 | In order to create PostScript or PDF versions of the Texinfo documentation, |
57 | you will need the convert utility, from the ImageMagick toolset installed, | |
58 | and epstopdf from the TeTeX suite. | |
59 | ||
3764c0c0 | 60 | To create the required autotools files (Makefile.in, configure, etc.), |
61 | run either the 'update-autotools' script provided, or else the | |
cbf566e6 | 62 | 'autoreconf -i' command supplied with your autoconf package. After this |
3764c0c0 | 63 | you may run configure. GNU texinfo is required in order to build |
64 | doc/quagga.info, which is not supplied in CVS, but is supplied in the | |
65 | CVS snapshots on the Quagga website. quagga.info is created via | |
66 | makeinfo during the build. | |
9104f569 | 67 | |
68 | Please refer to "Building and Installing Quagga" above for further | |
69 | instructions. | |
8bed780b | 70 | |
71 | -------------------------------------------------------------------------- | |
72 | Notes on required versions: | |
73 | ||
74 | The general goal is to use a modern baseline of tools, while not | |
75 | imposing pain on those tracking stable distributions. The notes below | |
76 | explain what versions are present in various environments. | |
77 | ||
8bed780b | 78 | NetBSD 1.6.2 and 2.0 provide texinfo 4.6. |
38c2cfee | 79 | NetBSD pkgsrc provides automake 1.9.1 autoconf 2.59 libtool 1.5.6 |
80 | NetBSD pgksrc provides texinfo 4.7 (devel/gtexinfo) | |
81 | ||
9c3f5e6b | 82 | OpenBSD 3.6 provides texinfo 4.2. |
83 | OpenBSD [3.6] ports provides automake 1.4-p6 autoconf 2.5.9 libtool 1.5.8 | |
38c2cfee | 84 | |
9104f569 | 85 | -------------------------------------------------------------------------- |