Home

[ Home ] [ Project Status ] [ API Documentation ] [ Code Examples ]

Welcome to the log4cplus project!

If you are looking for sample code to show you have to use log4cplus, go here.

Summary

The purpose of this project is to port the excellent Log for Java (log4j) logging library to C++.

This project is now in "Production" status.

Please feel free to contact me if you have any questions or if you would like to help the project: wilx@users.sourceforge.net.

If you want to get help with log4cplus use or compilation or if you have any other problem with it, please use the tracker or the log4cplus-devel mailing list. For bug reporting instructions see Bug Reporting Instructions down below.

Release Schedule

This is the current road map:

Release Date Additional Functionality Status

1.1.0 September 2012 AsyncAppender, simple C interface for interoperability with C, inter–process file locking to file appenders to allow logging into a single log file from multiple processes, Mapped Diagnostic Context (MDC), alternative thread identification (%T) converter to pattern layout, function name converter (%M), wchar_t ↔ char conversion implementations based on standard C locale functions and based on iconv(), DeviceAppender to allow use of Boost.IOStream's Sink as appender, LOG4CPLUS_*_FMT() macros to allow printf-like formatted output where it is possible (requires variadic macros support). 75 % complete

1.0.4.1 April 2012 Bug fixing release. RC1

1.0.4 ~~October 2010~~
January 2011 Released

1.0.3 ~~February 2009~~
March 2009
Win32DebugAppender
Released

Release	Date	Additional Functionality	Status
1.1.0	September 2012	`AsyncAppender`, simple C interface for interoperability with C, inter–process file locking to file appenders to allow logging into a single log file from multiple processes, Mapped Diagnostic Context (MDC), alternative thread identification (`%T`) converter to pattern layout, function name converter (`%M`), `wchar_t` ↔ `char` conversion implementations based on standard C locale functions and based on `iconv()`, DeviceAppender to allow use of Boost.IOStream's Sink as appender, `LOG4CPLUS_*_FMT()` macros to allow printf-like formatted output where it is possible (requires variadic macros support).	75 % complete
1.0.4.1	April 2012	Bug fixing release.	RC1
1.0.4	~~October 2010~~ January 2011		Released
1.0.3	~~February 2009~~ March 2009	Win32DebugAppender	Released

News

Request For Feedback
wilx — 2012-05-16
I have only recently realized that log4cplus is being used wider than I thought. The most important (in my eyes) piece of software that I have recently discovered using log4cplus is BIND 10. This led me to realization that I need more information about log4cplus' users and uses. Thus I would like to ask you for feedback about log4cplus. Feel free to post answers to following questions to mailing list or privately to myself:

What version of log4cplus are you using in what product/library of your own?

What led you to choose log4cplus over other competing (log4cpp, log4cxx, Pantheios, etc.) libraries?

What do you miss in log4cplus?

More comments?

log4cplus 1.0.4.1-RC2
wilx — 2012-05-15
The log4cplus 1.0.4.1-RC2 has been released. This is a bug fix release.

log4cplus 1.1.0-RC5
wilx — 2012-05-15
The log4cplus 1.1.0-RC5 has been released. This is branch 1.1.x release with small amount of changes relative to 1.1.0-RC4.

log4cplus 1.1.0-RC4
wilx — 2012-04-29
The log4cplus 1.1.0-RC4 has been released. This is branch 1.1.x release.

log4cplus 1.1.0-RC3
wilx — 2012-04-14
The log4cplus 1.1.0-RC3 has been released. This is branch 1.1.x release.

log4cplus 1.1.0-RC2
wilx — 2012-03-19
The log4cplus 1.1.0-RC2 has been released. This is trunk development release.

log4cplus 1.1.0-RC1
wilx — 2012-03-11
The log4cplus 1.1.0-RC1 has been released. This is trunk development release.

log4cplus 1.0.4.1-RC1
wilx — 2012-02-27
The log4cplus 1.0.4.1-RC1 has been released. This is a bug fix release.

log4cplus 1.0.4
wilx — 2011-01-16
The log4cplus 1.0.4 has been released. This is a bug fix release. See release notes for full list of changes since 1.0.3.

log4cplus 1.0.4-RC11
wilx — 2010-10-24
The log4cplus 1.0.4-RC11 has been released. This is a bug fix release. See release notes for details.

log4cplus 1.0.4-RC2
wilx — 2009-08-16
The log4cplus 1.0.4-RC2 has been released. This is a bug fix release. See release notes for details.

log4cplus 1.0.3
wilx — 2009-03-28 15:15
The log4cplus 1.0.3 has been released. Many bugs have been fixed in this release. See the list of closed bugs in project's bug tracker and change log for details.

log4cplus 1.0.3-RC8
wilx — 2009-02-18 18:35
The 1.0.3-RC8 is the last release candidate before the real 1.0.3 release. ~~The 1.0.3 release will be the last release from the 1.0.x series.~~

log4cplus 1.0.2
tcsmith — 2004-02-10 08:15
log4cplus is a simple to use C++ logging API providing thread-safe, flexible, and arbitrarily granular control over log management and configuration. It is modeled after the Java log4j API.

This is a "bug fix" release. No significant functionality has been added.

[News archive]

Bug Reporting Instructions

For successful resolution of reported bugs, it is necessary to provide enough information:

log4cplus:
- exact release version or Bazaar branch and revision
- build system that you are building log4cplus with (Autotools, Visual Studio solution, CMake)
- Autotools – provide configure script parameters and environment variables, attach generated config.log and defines.hxx files
- CMake – build configuration (Release, Debug, RelWithDebInfo) and non–default CMAKE_* variables values
- Visual Studio – project configuration (Release, Release_Unicode, Debug, Debug_Unicode)
- target OS and CPU
log4cplus client application:
- shared library log4cplus or as static library log4cplus
- library file you are linking your application with – log4cplus.lib, log4cplusUSD.lib, liblog4cplus.dll.a, etc., on Windows
- your application is using Unicode/wchar_t or not
- any error messages
- stack trace
- log4cplus properties/configuration file
- self–contained test case