Difference between revisions of "Build System"

Revision as of 17:52, 20 September 2008

For Users

Unix

 ./configure [options, see "configure --help" for a list]
 make
 make test
 su
 make install

The same procedure applies to builds with Cygwin on Windows.
See README.* for important notes for particular platforms.

Windows

There are several ways to build on Windows:

• MS Visual C++
• MinGW / MSYS
• Cygwin (see "Unix" above)

See Build_System/Windows for the status of compiling with the various Windows environments.

See Build_System/Windows_features for a comparison of the features implemented in each of the Windows build environments.

See README.win32 for further details.

For Coders

Tool Versions

Trunk uses autoconf 2.61 (soon: 2.62) while the others use 2.59. Make sure you use the right one when applying changes!
Trunk and 5.4.2+ ship with libtool 1.5.26 (5.4/5.4.1 shipped with 1.5.24), the older branches use libtool 1.5.22.

Files

• configure: auto-generated by autoconf from configure.in (branches) or configure.ac and configure.d/* (trunk)
• configure.in (5.4.x and earlier) or configure.ac and configure.d/* (trunk): major source file to implement configure magic. Run autoconf and autoheader after any change. New definitions may need to be copied to win32/net-snmp/net-snmp-config.h[.in].
• acconfig.h: autoconf variable definitions, descriptions and default values. Deprecated (for new definitions) in favor of AC_DEFINE() in configure.in / configure.d/*. Run autoheader after any change. New definitions may need to be copied to win32/net-snmp/net-snmp-config.h[.in].
• acinclude.m4: Net-SNMP specific autoconf macros. Run autoconf after any change.
• include/net-snmp/net-snmp-config.h: auto-generated by autoheader from configure.in/configure.ac and acconfig.h
• ltmain.sh: copied from libtool (created/updated by libtoolize --copy --force)
• aclocal.m4: contains libtool.m4 copied from libtool (created/updated by aclocal)
• config.guess: platform detection shell script (created/updated by libtoolize --copy --force; from GNU config project)
• win32/net-snmp/net-snmp-config.h.in: used by win32/Configure to create win32/net-snmp/net-snmp-config.h
• win32/net-snmp/net-snmp-config.h: definitions for Win32 (non-Cygwin) builds
• win32/lib*/lib*.def: public/exported symbols/functions from Net-SNMP libraries for Win32 builds. If you introduce new public functions, please also add them here!
• Makefile.in (also in most sub-directories): source for Makefile (the latter being generated by configure by substituting autoconf definitions and concatenating with Makefile.top and Makefile.rules)
• net-snmp-config.in: source for net-snmp-config (the latter being generated by configure)
• sedscript.in: source for sedscript (the latter being generated by configure)