Return to INSTALL.quagga.txt CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga

quagga

    1: --------------------------------------------------------------------------
    2: Building and Installing Quagga from releases or snapshots:
    3: 
    4: The 'INSTALL' file contains generic instructions on how to use 'configure'
    5: scripts.
    6: 
    7: Quagga requires a C compiler (and associated header files and
    8: libraries) supporting the C99 standard.
    9: 
   10: Quagga requires a reasonable make.  It is considered a bug if quagga
   11: does not compile with the system make on recent FreeBSD, NetBSD or
   12: OpenBSD, and a very serious bug if it does not compile with GNU make.
   13: 
   14: Quagga expects a POSIX.2 compliant system, more or less.  Clean
   15: workarounds for POSIX non-compliance are welcome.
   16: 
   17: It is considered a bug if Quagga fails to build and run on any of the
   18: following systems (where .x indicates the most recent release), or
   19: such systems "-current" versions.  (Note that considering it a bug is
   20: not a guarantee of support, merely "we agree that it is broken".)
   21: 
   22:   Dragonfly ?
   23:   FreeBSD 4.x	[In 2007, this is getting tenous.]
   24:   FreeBSD 5.x
   25:   FreeBSD 6.x
   26:   FreeBSD-current
   27:   Linux [kernel/distribution information needed]
   28:   NetBSD 2.x	[Note texinfo 4.6  in base system]
   29:   NetBSD 3.x
   30:   NetBSD 4.x
   31:   NetBSD-current
   32:   OpenBSD ? [info needed on what should work]
   33:   Solaris 9
   34:   Solaris 10
   35: 
   36: 
   37: For further Quagga specific information on 'configure' and build-time
   38: configuration of the software, please read the Quagga info
   39: documentation, (doc/quagga.info).  To read the info page included with
   40: the Quagga sources without first installing Quagga:
   41: 
   42:   cd doc
   43:   # one of the following, depending on your info viewer preferences
   44:   info quagga.info
   45:   pinfo -r quagga.info
   46:   emacs -eval '(info "quagga.info")'
   47: 
   48: The Quagga website (http://www.quagga.net) currently has the info
   49: files available in various formats.
   50: 
   51: --------------------------------------------------------------------------
   52: Building Quagga from CVS checkouts:
   53: 
   54: In order to build from CVS, you will need recent versions of several GNU
   55: tools, particularly autoconf, automake, libtool, GNU awk and texinfo.  Note
   56: that the CVS snapshots on the Quagga website should not require these tools;
   57: everything is already setup ready to run 'configure'.  If you have trouble
   58: building from CVS checkout it is recommended that you try a CVS snapshot
   59: instead.
   60: 
   61: We declare that the following versions should work for building from
   62: CVS checkouts.  Earlier versions may work, but failure to do so is not
   63: a bug.  Required versions can be moved earlier if no problems, or
   64: later after a judgement that a system without a higher version is
   65: deficient is made.
   66: 
   67: 	automake:	1.9.6 (released 2005-07-10)
   68: 	autoconf:	2.59 (2.60 on 2006-06-26 is too recent to require)
   69: 	libtool:	1.5.22 (released 2005-12-18)
   70: 	texinfo:	4.7 (released 2004-04-10; 4.8 is not yet common)
   71: 	GNU AWK:	3.1.5 (released 2005-08-12)
   72: 
   73: Becuase some systems provide texinfo 4.6 (4.7 is new), quagga.info is
   74: checked in so that texinfo will generally not be invoked.  When
   75: texinfo 4.7 is widespread, quagga.info will be removed from CVS and
   76: texinfo will become required again.  (4.7 has figure support, needed
   77: for the route server docs, which is why 4.6 doesn't work.)
   78: 
   79: In order to create PostScript or PDF versions of the Texinfo documentation,
   80: you will need the convert utility, from the ImageMagick toolset installed,
   81: and epstopdf from the TeTeX suite.
   82: 
   83: To create the required autotools files (Makefile.in, configure, etc.),
   84: run "./bootstrap.sh".  After this you may run configure as for a
   85: snapshot or release.
   86: 
   87: Please refer to "Building and Installing Quagga" above for further
   88: instructions.
   89: 
   90: --------------------------------------------------------------------------
   91: Notes on required versions:
   92: 
   93: The general goal is to use a modern baseline of tools, while not
   94: imposing pain on those tracking stable distributions.  The notes below
   95: explain what versions are present in various environments.
   96: 
   97: NetBSD 1.6 and 2 provide texinfo 4.6.  This is now considered old.
   98: NetBSD 3 and 4 provide texinfo 4.7.
   99: 
  100: Fedora Core ? provides autoconf 2.59.
  101: 
  102: OpenBSD 3.6 provides texinfo 4.2.
  103: OpenBSD [3.6] ports provides automake 1.4-p6 autoconf 2.5.9 libtool 1.5.8
  104: 
  105: --------------------------------------------------------------------------