| 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, 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 |
| * FreeBSD |
| * Windows (MSVC 6.0 or Cygwin) |
| * Othe 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 considerations |
| ====================================== |
| By default, Visual .Net 2003 eliminates exports that are never referenced. |
| So all appenders and layouts are eliminated by the linker if they are not explicitly |
| referenced in a new project linking with the log4cxx static library |
| But theses functions have to be referenced for the needs of the PropertyConfigurator |
| and DOMConfigurator classes. |
| |
| So, in the new project, some of the properties need to be changed: |
| Linker -> Optimization -> References |
| Change from "Default" to "Keep Unreferenced Data (/OPT:NOREF)" |
| |
| This problem does not exist with dll version of the log4cxx library. |
| |
| 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://log4cxx.sourceforge.net |
| Log4cxx project page |
| |
| http://sourceforge.net/projects/log4cxx |
| Sourceforge page |
| |
| http://jakarta.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. |
| |
| |
