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