| Introduction |
| ============ |
| Log4cxx is a port to C++ of the log4j project. |
| The goal is have the same functionnalities and interfaces of log4j. |
| |
| Features |
| ======== |
| It's a flexible and highly configurable logging framework |
| Main features : |
| - Configurable logging destinations (appenders) |
| - Configurable logging format (layouts) |
| - Categorized logging statements through a hierarchy (loggers) |
| - Advanced filtering (filters) |
| - Thread safe library |
| - UTF-16 Unicode support |
| |
| * Appenders: |
| AsyncAppender, ConsoleAppender, DailyRollingFileAppender, FileAppender, |
| NTEventLogAppender, ODBCAppender, RollingFileAppender, SMTPAppender, |
| SocketAppender, SocketHubAappender, SyslogAppender, TelnetAppender, |
| XMLSocketAppender |
| |
| * Layouts: |
| HTMLLayout, PatternLayout, SimpleLayout, TTCCLayout, XMLLayout |
| |
| * Filters: |
| DenyAllFilter, LevelMatchFilter, LevelRangeFilter, StringMatchFilter |
| |
| * Configurators: |
| BasicConfigurator, DOMConfigurator, PropertyConfigurator |
| |
| * Java like objects with dynamic cast and instanciation. Custom objects can |
| be configured through the DOMConfigurator and PropertyConfigurator classes |
| |
| Supported OS |
| ============ |
| * Linux (tested on Linux Mandrake 10.0) |
| * FreeBSD |
| * Windows (MSVC 6.0, MSVC 7.1 or Cygwin) |
| * Other POSIX OS should be supported but were not tested |
| |
| Installation |
| ============ |
| ./autogen.sh |
| ./configure |
| make |
| make check |
| make install |
| |
| See INSTALL file for further details. |
| |
| Visual Studio .Net 2003 and Visual Studio 6.0 considerations |
| ============================================================ |
| For projects linking with log4cxx static library, the macro LOG4CXX_STATIC must |
| be defined (tab C++, textbox Preprocessor in the project properties) and |
| "log4cxxs.lib" must be passed to the linker (tab Link,textbox Object/Library |
| Modules in the project settings). |
| |
| For projects linking with log4cxx dynamic library (dll), "log4cxx.lib" must be |
| passed to the linker (tab Link,textbox Object/Library Modules in the project |
| settings). |
| |
| Unitary Tests |
| ============= |
| You will need to install |
| * cppunit (http://cppunit.sourceforge.net/) |
| * boost regex (http://www.boost.org/) |
| |
| Unix : run "make check" |
| Windows : run msvc/tests/runtests.bat |
| |
| Performance Tests |
| ================= |
| Just run performance/logging.sh. |
| The result are expressed in micro-seconds. |
| |
| Links |
| ===== |
| http://logging.apache.org/log4cxx |
| Log4cxx project page |
| |
| http://logging.apache.org/log4j |
| Log4j project page |
| |
| Contacts |
| ======== |
| See AUTHORS file |
| |
| License |
| ======= |
| This library is licensed under the Apache Public License. Please read the |
| included license.apl for details. |
| |
| |