| ~~ Licensed to the Apache Software Foundation (ASF) under one or more |
| ~~ contributor license agreements. See the NOTICE file distributed with |
| ~~ this work for additional information regarding copyright ownership. |
| ~~ The ASF licenses this file to You under the Apache License, Version 2.0 |
| ~~ (the "License"); you may not use this file except in compliance with |
| ~~ the License. You may obtain a copy of the License at |
| ~~ |
| ~~ http://www.apache.org/licenses/LICENSE-2.0 |
| ~~ |
| ~~ Unless required by applicable law or agreed to in writing, software |
| ~~ distributed under the License is distributed on an "AS IS" BASIS, |
| ~~ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. |
| ~~ See the License for the specific language governing permissions and |
| ~~ limitations under the License. |
| ------ |
| Building Apache log4cxx with autotools |
| ------ |
| ------ |
| ------ |
| |
| Building Apache log4cxx with autotools |
| |
| * Quick start: |
| |
| Make sure autoconf 2.50+, libtool, g++ and make are available, install or |
| build apr 1.x, apr-util 1.x, gzip and zip. |
| |
| +------------+ |
| $ apt-get install build-essential automake libtool libapr1-dev libaprutil1-dev gzip zip |
| $ cd apache-log4cxx-x.x.x |
| $[./autogen.sh] |
| $ ./configure |
| $ make |
| $ make check |
| $ sudo make install |
| +------------+ |
| |
| Those lines in brackets are only necessary if you directly build from source. |
| |
| * configure options |
| |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-apr | path to non-default location for APR. | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-apr-util | path to non-default location for APR-Util. | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --enable-wchar_t | Enable wchar_t API methods, choice of yes (default), no. | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --enable-unichar | Enable UniChar API methods, choice of yes, no (default). | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --enable-cfstring | Enable CFString API methods, requires Mac OS/X CoreFoundation, choice of yes, no (default). | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-logchar | Interal character representation, choice of utf-8 (default), wchar_t , unichar. | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-charset | Exteral character encoding, choice of utf-8, iso-8859-1, usascii, ebcdic, auto (default). | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-SMTP | SMTP implementation for SMTPAppender, choice of libesmtp, no (default). | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | --with-ODBC | OBDC implementation for ODBCAppender, choice of unixODBC, iODBC, Microsoft, no (default). | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| | -help | Display help showing all options and exit. | |
| *-------------------+---------------------------------------------------------------------------------------------+ |
| |
| SMTP and ODBC options can depend on libraries that |
| that have different licenses. |
| You should review the corresponding licenses and understand |
| the implications before redistribution. |
| |
| * Platform specific notes: |
| |
| ** Mac OS/X: |
| |
| APR and APR-Util are provided by the platform in Mac OS/X 10.5 and iODBC in 10.4. |
| |
| ** Debian: |
| |
| APR, APR-Util, gzip and zip may be installed by: |
| |
| +----+ |
| $ sudo apt-get install libapr1-dev libaprutil1-dev gzip zip |
| +----+ |
| |
| ** FreeBSD: |
| |
| APR, APR-Util, gzip and zip may be installed from the ports collection by: |
| |
| +----+ |
| # cd /usr/ports/archivers/zip |
| # make |
| # make install |
| # cd /usr/ports/archivers/gzip |
| # make |
| # make install |
| # cd /usr/ports/devel/apr |
| # make |
| # make install |
| +----+ |
| |
| ** Cygwin: |
| |
| Install zip (used by RollingFileAppender) and sed (used to normalize |
| output files for comparison in the unit tests). The prepackaged |
| APR currently available from Cygwin has APR_HAS_THREADS == 0. |
| Some appenders will not be available and some may operate |
| with reduced functionality. There have been reports of |
| building APR on Cygwin with threads enabled. |
| |
| ** MinGW: |
| |
| Recent APR 1.2.x releases fail ./configure with a error |
| of "decision on anonymous shared memory failed". That issue |
| has been fixed in the current APR SVN HEAD. The follow |
| sequence worked with MSYS (with Python on Path): |
| |
| +----+ |
| $ cd expat-2.0.1 |
| $ ./configure |
| $ make install |
| $ cd .. |
| $ svn co https://svn.apache.org/repos/asf/apr/apr/trunk apr |
| $ cd apr |
| $ ./buildconf.sh |
| $ ./configure |
| $ make install |
| $ cd .. |
| $ svn co \ |
| https://svn.apache.org/repos/asf/apr/apr-util/trunk \ |
| apr-util |
| $ cd apr-util |
| $ ./buildconf.sh |
| $ ./configure --with-apr=/usr/local --with-expat=/usr/local |
| $ make install |
| $ cd ../apache-log4cxx-0.10.0 |
| $ ./configure --with-apr=/usr/local \ |
| --with-apr-util=/usr/local --with-logchar=wchar_t |
| $ make install |
| +----+ |
| |
| Running "make check" was observed to fail with unexpected exceptions |
| in streamtestcase and datetimedateformattestcase. |
| See {{{https://issues.apache.org/jira/browse/LOGCXX-244}LOGCXX-244}}. |