diff options
Diffstat (limited to 'ACE-configuration.txt')
| -rw-r--r-- | ACE-configuration.txt | 179 |
1 files changed, 0 insertions, 179 deletions
diff --git a/ACE-configuration.txt b/ACE-configuration.txt deleted file mode 100644 index cb68fad0edc..00000000000 --- a/ACE-configuration.txt +++ /dev/null @@ -1,179 +0,0 @@ -* $Id$ * - -================================================================ -Configuring ACE Using the `configure' Script -================================================================ - -QuickStart ----------- -Since autoconf support in ACE is still under development, to enable -support for autoconf in ACE, run the script `bootstrap' in the `bin' -directory found in the top-level ACE source directory from the -top-level source directory. For example, the following set of -commands will set up ACE's autoconf support, and cause ACE to be -configured and built: - - - bin/bootstrap - mkdir objdir - cd objdir - ../configure --enable-maintainer-mode. - make - -Note that this bootstrapping procedure requires that GNU Autoconf (>= -2.13), GNU Automake (>= 1.4) and GNU libtool (>= 1.3.3) are installed -and available in your path in order for the procedure to be -successful. Once autoconf support in ACE is fully integrated, these -requirements will not be necessary. You will be able to simply run -the configure script without any options. - -Description ------------ -To help speed development, the work being done by the ACE -Configuration Project is being slowly introduced into the official ACE -distribution. Some of the functionality in the work created by the -ACE Configuration Project has been removed so that ACE may be built in -the usual fashion. Once the ACE Configuration Project work stabilizes -on more platforms that removed functionality may be added to ACE. - -Currently the configure script contains most of the tests that are -necessary to properly configure ACE on most platforms. However, there -are still some autoconf tests that are missing. As such, you may -encounter and most likely will have compilation problems. Please -report any problems to the contacts listed at the end of this -document. - -The `configure' script that is currently being used has been modified -from the ACE Configuration Project's `configure' script to prevent -makefiles from being automatically generated since there are still -some issues that must be addressed before automatically generated -makefiles are incorporated into the official ACE distribution. - -A listing of available configure script options can be shown by -entering: - - ./configure --help - -at the command line. The output should look something like the -following: - - -Usage: configure [options] [host] -Options: [defaults in brackets after descriptions] -Configuration: - --cache-file=FILE cache test results in FILE - --help print this message - --no-create do not create output files - --quiet, --silent do not print `checking...' messages - --version print the version of autoconf that created configure -Directory and file names: - --prefix=PREFIX install architecture-independent files in PREFIX - [/usr/local] - --exec-prefix=EPREFIX install architecture-dependent files in EPREFIX - [same as prefix] - --bindir=DIR user executables in DIR [EPREFIX/bin] - --sbindir=DIR system admin executables in DIR [EPREFIX/sbin] - --libexecdir=DIR program executables in DIR [EPREFIX/libexec] - --datadir=DIR read-only architecture-independent data in DIR - [PREFIX/share] - --sysconfdir=DIR read-only single-machine data in DIR [PREFIX/etc] - --sharedstatedir=DIR modifiable architecture-independent data in DIR - [PREFIX/com] - --localstatedir=DIR modifiable single-machine data in DIR [PREFIX/var] - --libdir=DIR object code libraries in DIR [EPREFIX/lib] - --includedir=DIR C header files in DIR [PREFIX/include] - --oldincludedir=DIR C header files for non-gcc in DIR [/usr/include] - --infodir=DIR info documentation in DIR [PREFIX/info] - --mandir=DIR man documentation in DIR [PREFIX/man] - --srcdir=DIR find the sources in DIR [configure dir or ..] - --program-prefix=PREFIX prepend PREFIX to installed program names - --program-suffix=SUFFIX append SUFFIX to installed program names - --program-transform-name=PROGRAM - run sed PROGRAM on installed program names -Host type: - --build=BUILD configure for building on BUILD [BUILD=HOST] - --host=HOST configure for HOST [guessed] - --target=TARGET configure for TARGET [TARGET=HOST] -Features and packages: - --disable-FEATURE do not include FEATURE (same as --enable-FEATURE=no) - --enable-FEATURE[=ARG] include FEATURE [ARG=yes] - --with-PACKAGE[=ARG] use PACKAGE [ARG=yes] - --without-PACKAGE do not use PACKAGE (same as --with-PACKAGE=no) - --x-includes=DIR X include files are in DIR - --x-libraries=DIR X library files are in DIR ---enable and --with options recognized: - --enable-static[=PKGS] build static libraries [default=no] - --enable-shared[=PKGS] build shared libraries [default=yes] - --with-gnu-ld assume the C compiler uses GNU ld [default=no] - --disable-libtool-lock force libtool not to do file locking - --enable-debug enable debugging [default=yes] - --enable-exceptions enable C++ exception handling [default=yes] - --enable-fast enable -fast flag, e.g. Sun C++ [default=no] - --enable-inline enable code inlining [default=yes] - --enable-log-msg-prop enable threads inheriting - ACE_Log_Msg properties from parent - thread [default=yes] - --enable-logging enable ACE logging macros [default=yes] - --enable-malloc-stats enable malloc statistics - collection [default=no] - --enable-optimize enable additional optimizations [default=yes] - --enable-probe enable ACE_Timeprobes [default=no] - --enable-profile enable profiling [default=no] - --enable-purify Purify all executables [default=no] - --enable-quantify Quantify all executables [default=no] - --enable-reentrant enable reentrant functions [default=yes] - --enable-repo use GNU template repository - GNU C++ with repo patches and - EGCS only [default=no] - --enable-rtti enable run-time type - identification - *Currently only for Sun C++ [default=no] - --enable-static-obj-mgr enable static Object_Manager [default=yes] - --enable-threads enable thread support [default=yes] - --enable-verb-not-sup enable verbose ENOTSUP reports [default=no] - --enable-trace enable ACE tracing [default=no] - --enable-xt-reactor build support for the XtReactor [default=no] - --with-x use the X Window System - --with-gperf compile the gperf program [default=yes] - --with-orbix[=DIR] compile ACE with Orbix [default=no] - --with-tli-device[=DEV] device for TCP on TLI [default=/dev/tcp] - -To enable debugging and disable code inlining, for example, just enter the -following on the command line: - - ./configure --enable-debug --disable-inline - -This will generate a configuration header file `ace/config.h' to be used when -compiling ACE that will enable ACE debugging macros and disable code inlining -during compilation of ACE. - -Once the `ace/config.h' header has been created you will have to select a -platform macros file. Please read the ACE installation documents for more -information about this. - ----------------------------------------------------------------- -Caveats ----------------------------------------------------------------- -Much of the power of the `configure' script will not be useful until the -automatically generated makefiles are enabled in ACE. Configuration options -such as "--prefix" will not be useful for this reason. - -The `configure' script will check for libraries that contain certain functions. -If it finds a library that isn't listed in your platform_macros.GNU file you -will have to add that library to the list of libraries to link against. - ----------------------------------------------------------------- -Contacts ----------------------------------------------------------------- -If you do have problems please e-mail the ACE Configuration Project maintainer -at: - - Ossama Othman <othman@cs.wustl.edu> - -or send mail to the ACE mailing list. - -For more information take at a look at the ACE Configuration Project web page -at: - - http://www.cs.wustl.edu/~othman/aceconf - |