INSTALL.quagga.txt

   1 # $Id: INSTALL.quagga.txt,v 1.9 2005/04/02 17:13:33 paul Exp $
   2
   3 --------------------------------------------------------------------------
   4 Building and Installing Quagga from releases or snapshots:
   5
   6 The 'INSTALL' file contains generic instructions on how to use 'configure'
   7 scripts.
   8
   9 Quagga requires a C compiler supporting the C99 standard.
  10
  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
  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
  38 tools, particularly autoconf, automake, libtool and texinfo.  Note that the
  39 CVS snapshots on the Quagga website do not require these tools; everything
  40 is already setup ready to run 'configure'.  If you have trouble building
  41 from CVS checkout it is recommended that you try a CVS snapshot instead.
  42
  43 If you are building from plain CVS checkouts, the versions which
  44 should work at least with:
  45
  46         automake:       1.8.5
  47         autoconf:       2.59
  48         libtool:        1.5.6
  49         texinfo:        4.7
  50
  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
  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
  60 To create the required autotools files (Makefile.in, configure, etc.),
  61 run either the 'update-autotools' script provided, or else the
  62 'autoreconf -i' command supplied with your autoconf package.  After this
  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.
  67
  68 Please refer to "Building and Installing Quagga" above for further
  69 instructions.
  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
  78 NetBSD 1.6.2 and 2.0 provide texinfo 4.6.
  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
  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
  84
  85 --------------------------------------------------------------------------