Annotation of embedaddon/quagga/INSTALL.quagga.txt, revision 1.1.1.2
1.1 misho 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
1.1.1.2 ! misho 19: such systems "-current" versions. Or, it might be that this list is
! 20: out of date and will be updated. (Note that considering it a bug is
1.1 misho 21: not a guarantee of support, merely "we agree that it is broken".)
22:
23: Dragonfly ?
1.1.1.2 ! misho 24: FreeBSD (stable branches currently supported, plus perhaps one)
1.1 misho 25: FreeBSD-current
26: Linux [kernel/distribution information needed]
27: NetBSD 4.x
1.1.1.2 ! misho 28: NetBSD 5.x
! 29: NetBSD 6.x
1.1 misho 30: NetBSD-current
31: OpenBSD ? [info needed on what should work]
1.1.1.2 ! misho 32: Solaris (modern/supported versions, including OpenSolaris forks)
1.1 misho 33:
1.1.1.2 ! misho 34: On BSD systems, installing libexecinfo is strongly recommended in order
! 35: to get backtrace support.
1.1 misho 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: --------------------------------------------------------------------------
1.1.1.2 ! misho 52: Building Quagga from git checkouts:
1.1 misho 53:
1.1.1.2 ! misho 54: In order to build from git, you will need recent versions of several GNU
1.1 misho 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:
1.1.1.2 ! misho 67: [TODO: this list is out of date as of 2013-07]
1.1 misho 68: automake: 1.9.6 (released 2005-07-10)
69: autoconf: 2.59 (2.60 on 2006-06-26 is too recent to require)
70: libtool: 1.5.22 (released 2005-12-18)
71: texinfo: 4.7 (released 2004-04-10; 4.8 is not yet common)
72: GNU AWK: 3.1.5 (released 2005-08-12)
73:
1.1.1.2 ! misho 74: For running tests, one also needs:
! 75:
! 76: DejaGnu:
! 77:
! 78: [TODO: texinfo 4.6 is now ancient and this should be revisited/fixed]
! 79: Because some systems provide texinfo 4.6 (4.7 is new), quagga.info is
1.1 misho 80: checked in so that texinfo will generally not be invoked. When
81: texinfo 4.7 is widespread, quagga.info will be removed from CVS and
82: texinfo will become required again. (4.7 has figure support, needed
83: for the route server docs, which is why 4.6 doesn't work.)
84:
85: In order to create PostScript or PDF versions of the Texinfo documentation,
86: you will need the convert utility, from the ImageMagick toolset installed,
87: and epstopdf from the TeTeX suite.
88:
89: To create the required autotools files (Makefile.in, configure, etc.),
90: run "./bootstrap.sh". After this you may run configure as for a
91: snapshot or release.
92:
93: Please refer to "Building and Installing Quagga" above for further
94: instructions.
95:
96: --------------------------------------------------------------------------
97: Notes on required versions:
98:
99: The general goal is to use a modern baseline of tools, while not
1.1.1.2 ! misho 100: imposing pain on those tracking supported (or almost supported) stable
! 101: distributions. The notes below explain what versions are present in
! 102: various environments.
1.1 misho 103:
1.1.1.2 ! misho 104: NetBSD 4 provides texinfo 4.7.
! 105: NetBSD 5 and 6 provides texinfo 4.8
1.1 misho 106:
107: Fedora Core ? provides autoconf 2.59.
108:
109: OpenBSD 3.6 provides texinfo 4.2.
110: OpenBSD [3.6] ports provides automake 1.4-p6 autoconf 2.5.9 libtool 1.5.8
111:
112: --------------------------------------------------------------------------
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to INSTALL.quagga.txt CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / quagga