Difference between revisions of "Configuration Options"

From reSIProcate
Jump to: navigation, search
Line 12: Line 12:
  
 
       --with-toolchain="..."
 
       --with-toolchain="..."
         Which toolchain do you want to use? (Now "gnu")
+
         Which toolchain do you want to use?
 
         Valid values are: [gnu, intel, sunpro, msgnu, gnu-cross]
 
         Valid values are: [gnu, intel, sunpro, msgnu, gnu-cross]
  
 
       --with-cross-platform="..."
 
       --with-cross-platform="..."
         What is the name your toolchain uses for the cross platform? (Now "arm-unknown-linux-gnu")
+
         What is the name your toolchain uses for the cross platform?
  
 
       --with-cross-tool-prefix="..."
 
       --with-cross-tool-prefix="..."
         What is the prefix for the cross-compiler binaries? (Now "arm-unknown-linux-gnu")
+
         What is the prefix for the cross-compiler binaries?
  
 
       --with-cross-compiler-dir="..."
 
       --with-cross-compiler-dir="..."
         Where is your cross compiler installed? (Now "/opt/crosstool/current/arm-unknown-linux-gnu/bin/")
+
         Where is your cross compiler installed?
  
 
       --with-compile-type="..."
 
       --with-compile-type="..."
         What compile profile will you use? (Now "debug")
+
         What compile profile will you use?
 
         Valid values are: [debug, nodebug, opt, gopt, prof, small]
 
         Valid values are: [debug, nodebug, opt, gopt, prof, small]
  
 
       --enable-shared-libs
 
       --enable-shared-libs
 
       --disable-shared-libs
 
       --disable-shared-libs
         Should the resip libraries be built shared? (Now disabled)
+
         Should the resip libraries be built shared?
  
 
       --enable-distcc
 
       --enable-distcc
 
       --disable-distcc
 
       --disable-distcc
         Will you be using distcc? (Now disabled)
+
         Will you be using distcc?
  
 
       --enable-ccache
 
       --enable-ccache
 
       --disable-ccache
 
       --disable-ccache
         Will you be using ccache? (Now disabled)
+
         Will you be using ccache?
  
 
       --enable-repro
 
       --enable-repro
 
       --disable-repro
 
       --disable-repro
         Build the Repro proxy server? (Now enabled)
+
         Build the Repro proxy server?
  
 
       --repro-db="..."
 
       --repro-db="..."
         Which database should be used with Repro? (Now "berkeley-db4")
+
         Which database should be used with Repro?
 
         Valid values are: [berkeley-db4]
 
         Valid values are: [berkeley-db4]
  
 
       --db4-headers="..."
 
       --db4-headers="..."
         Where is db_cxx.h? (Now "/opt/local/include/db42")
+
         Where is db_cxx.h?
  
 
       --enable-radius
 
       --enable-radius
 
       --disable-radius
 
       --disable-radius
         Build the RADIUS authentication module? (requires radiusclient-ng) (Now disabled)
+
         Build the RADIUS authentication module? (requires radiusclient-ng)
  
 
       --enable-tfm
 
       --enable-tfm
 
       --disable-tfm
 
       --disable-tfm
         Build the TFM test framework? (Now disabled)
+
         Build the TFM test framework?
  
 
       --enable-recon
 
       --enable-recon
 
       --disable-recon
 
       --disable-recon
         Build the reCon Conversation Manager? (requires dtls-srtp patched OpenSSL) (Now disabled)
+
         Build the reCon Conversation Manager? (requires dtls-srtp patched OpenSSL)
  
 
       --enable-return-client
 
       --enable-return-client
 
       --disable-return-client
 
       --disable-return-client
         Build the reTurn client? (Now disabled)
+
         Build the reTurn client?
  
 
       --enable-return-server
 
       --enable-return-server
 
       --disable-return-server
 
       --disable-return-server
         Build the reTurn server? (Now disabled)
+
         Build the reTurn server?
  
 
       --boost-headers="..."
 
       --boost-headers="..."
         Where is boost/config.hpp? (Now "/opt/local/include")
+
         Where is boost/config.hpp?
  
 
       --enable-sipx-installed
 
       --enable-sipx-installed
 
       --disable-sipx-installed
 
       --disable-sipx-installed
         Are the sipX libraries and headers installed? (Now disabled)
+
         Are the sipX libraries and headers installed?
  
 
       --libsipx-lib="..."
 
       --libsipx-lib="..."
         Where is the common root of the sipX libraries? (Now "../sipXtapi")
+
         Where is the common root of the sipX libraries?
  
 
       --sipx-libdir="..."
 
       --sipx-libdir="..."
         Where are the sipX libraries installed? (Now "/usr/local/lib")
+
         Where are the sipX libraries installed?
  
 
       --sipx-incdir="..."
 
       --sipx-incdir="..."
         Where are the sipX header files installed? (Now "/usr/local/include")
+
         Where are the sipX header files installed?
  
 
       --enable-ssl
 
       --enable-ssl
 
       --disable-ssl
 
       --disable-ssl
         Include SIP over TLS, SMIME or Identity header support? (Requires OpenSSL) (Now enabled)
+
         Include SIP over TLS, SMIME or Identity header support? (Requires OpenSSL)
  
 
       --enable-dtls
 
       --enable-dtls
 
       --disable-dtls
 
       --disable-dtls
         Do you want to include SIP over DTLS support? (Requires OpenSSL 0.9.8+) (Now disabled)
+
         Do you want to include SIP over DTLS support? (Requires OpenSSL 0.9.8+)
  
 
       --with-ssl-location="..."
 
       --with-ssl-location="..."
         Where is OpenSSL? (leave blank to use installed copy) (Now "")
+
         Where is OpenSSL? (leave blank to use installed copy)
  
 
       --enable-curl
 
       --enable-curl
 
       --disable-curl
 
       --disable-curl
         Should DUM use curl to retreive identity information? (Now disabled)
+
         Should DUM use curl to retreive identity information?
  
 
       --enable-google-malloc
 
       --enable-google-malloc
 
       --disable-google-malloc
 
       --disable-google-malloc
         Use the Google malloc() implementation? (Now disabled)
+
         Use the Google malloc() implementation?
  
 
       --enable-google-cpuperf
 
       --enable-google-cpuperf
 
       --disable-google-cpuperf
 
       --disable-google-cpuperf
         Use Google cpuperf? (Now disabled)
+
         Use Google cpuperf?
  
 
       --enable-ipv6
 
       --enable-ipv6
 
       --disable-ipv6
 
       --disable-ipv6
         Compile in IPv6 support? (Now disabled)
+
         Compile in IPv6 support?
  
 
       --enable-popt
 
       --enable-popt
 
       --disable-popt
 
       --disable-popt
         Use popt to read commandline options? (Now enabled)
+
         Use popt to read commandline options?
  
 
       --popt-headers="..."
 
       --popt-headers="..."
         Where is popt.h? (Now "/usr/include")
+
         Where is popt.h?
  
 
       --popt-lib="..."
 
       --popt-lib="..."
         Where is libpopt? (Now "/usr/lib")
+
         Where is libpopt?
  
 
       --enable-resip-fixed-point
 
       --enable-resip-fixed-point
 
       --disable-resip-fixed-point
 
       --disable-resip-fixed-point
         Compile with no floating point functions? (Now disabled)
+
         Compile with no floating point functions?
  
 
       --enable-pedantic-stack
 
       --enable-pedantic-stack
 
       --disable-pedantic-stack
 
       --disable-pedantic-stack
         Force stack to fully parse every message it receives? (Now disabled)
+
         Force stack to fully parse every message it receives?
  
 
       --prefix="..."
 
       --prefix="..."
         Where should the libraries be installed? (Now "/usr/local")
+
         Where should the libraries be installed?
  
 
       --with-resolver="..."
 
       --with-resolver="..."
         Which DNS resolution library do you want to use? (Now "resip-ares")
+
         Which DNS resolution library do you want to use?
 
         Valid values are: [resip-ares, c-ares]
 
         Valid values are: [resip-ares, c-ares]
  
 
       --ares-prefix="..."
 
       --ares-prefix="..."
         Where should ares be installed? (Now "/usr/local")
+
         Where should ares be installed?
  
 
       --cares-headers="..."
 
       --cares-headers="..."
         If using c-ares, the directory containing its headers. (Now "")
+
         If using c-ares, the directory containing its headers.
  
 
       --cares-libs="..."
 
       --cares-libs="..."
         If using c-ares, the directory containing its libraries. (Now "")
+
         If using c-ares, the directory containing its libraries.

Revision as of 23:35, 26 November 2008

Because the resiprocate project does not use GNU autotools, it has its own configuration system that can be used to select various options within the project, as well as what parts of the project are built. By default, if you just type 'make', the configuration script is invoked by the makesystem, and some (mostly) sane defaults are chosen for you.

However, if you want to take advantage of the advanced, new, and/or experimental features available within resiprocate, you really want to take advantage of the configuration system. Currently, you have three options:

  • ./configure - Invoke the configuration system in a text questionnaire mode. This can be tedious, but should work under all terminal environments.
  • ./configure -m - Invoke the configuration system in a (somewhat experimental) text-based menu mode. This is much easier to use, but requires a vt100-compatible that is tall enough to accommodate all the configuration options.
  • ./configure -y - Invoke the configuration system in a non-interactive mode. Configuration options will be set to defaults if they don't yet exist, and then any configuration-changing commandline switches will be applied. If the system is already configured, no options will be changed except as specified by commandline switches.

Note that the defaults chosen for some options vary from platform to platform, and even according to what is installed on the system when configuration is invoked.

The various options currently available in the configuration system are:

     --with-toolchain="..."
       Which toolchain do you want to use?
       Valid values are: [gnu, intel, sunpro, msgnu, gnu-cross]
     --with-cross-platform="..."
       What is the name your toolchain uses for the cross platform?
     --with-cross-tool-prefix="..."
       What is the prefix for the cross-compiler binaries?
     --with-cross-compiler-dir="..."
       Where is your cross compiler installed?
     --with-compile-type="..."
       What compile profile will you use?
       Valid values are: [debug, nodebug, opt, gopt, prof, small]
     --enable-shared-libs
     --disable-shared-libs
       Should the resip libraries be built shared?
     --enable-distcc
     --disable-distcc
       Will you be using distcc?
     --enable-ccache
     --disable-ccache
       Will you be using ccache?
     --enable-repro
     --disable-repro
       Build the Repro proxy server?
     --repro-db="..."
       Which database should be used with Repro?
       Valid values are: [berkeley-db4]
     --db4-headers="..."
       Where is db_cxx.h?
     --enable-radius
     --disable-radius
       Build the RADIUS authentication module? (requires radiusclient-ng)
     --enable-tfm
     --disable-tfm
       Build the TFM test framework?
     --enable-recon
     --disable-recon
       Build the reCon Conversation Manager? (requires dtls-srtp patched OpenSSL)
     --enable-return-client
     --disable-return-client
       Build the reTurn client?
     --enable-return-server
     --disable-return-server
       Build the reTurn server?
     --boost-headers="..."
       Where is boost/config.hpp?
     --enable-sipx-installed
     --disable-sipx-installed
       Are the sipX libraries and headers installed?
     --libsipx-lib="..."
       Where is the common root of the sipX libraries?
     --sipx-libdir="..."
       Where are the sipX libraries installed?
     --sipx-incdir="..."
       Where are the sipX header files installed?
     --enable-ssl
     --disable-ssl
       Include SIP over TLS, SMIME or Identity header support? (Requires OpenSSL)
     --enable-dtls
     --disable-dtls
       Do you want to include SIP over DTLS support? (Requires OpenSSL 0.9.8+)
     --with-ssl-location="..."
       Where is OpenSSL? (leave blank to use installed copy)
     --enable-curl
     --disable-curl
       Should DUM use curl to retreive identity information?
     --enable-google-malloc
     --disable-google-malloc
       Use the Google malloc() implementation?
     --enable-google-cpuperf
     --disable-google-cpuperf
       Use Google cpuperf?
     --enable-ipv6
     --disable-ipv6
       Compile in IPv6 support?
     --enable-popt
     --disable-popt
       Use popt to read commandline options?
     --popt-headers="..."
       Where is popt.h?
     --popt-lib="..."
       Where is libpopt?
     --enable-resip-fixed-point
     --disable-resip-fixed-point
       Compile with no floating point functions?
     --enable-pedantic-stack
     --disable-pedantic-stack
       Force stack to fully parse every message it receives?
     --prefix="..."
       Where should the libraries be installed?
     --with-resolver="..."
       Which DNS resolution library do you want to use?
       Valid values are: [resip-ares, c-ares]
     --ares-prefix="..."
       Where should ares be installed?
     --cares-headers="..."
       If using c-ares, the directory containing its headers.
     --cares-libs="..."
       If using c-ares, the directory containing its libraries.