| ~~ 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: |
| |
| +------------+ |
| sudo apt-get install libapr1.0-dev libaprutil1.0-dev |
| cd apache-log4cxx-0.10.0 |
| ./autoconf.sh |
| ./configure |
| make |
| make check |
| sudo make install |
| +------------+ |
| |
| |
| * 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, APR-Util and iODBC are preinstalled in Mac OS/X 10.5 and later. |
| |
| ** Cygwin: |
| |
| Install sed which is required by 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 |
| ./autogen.sh |
| ./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 {{{http://issues.apache.org/jira/browse/LOGCXX-244}LOGCXX-244}}. |