ossp-pkg/l2/README
_ ___ ____ ____ ____ _ ____
|_|_ _ / _ \/ ___/ ___|| _ \ | |___ \
_|_||_| | | | \___ \___ \| |_) | | | __) |
|_||_|_| | |_| |___) |__) | __/ | |/ __/
|_|_|_| \___/|____/____/|_| |_|_____|
OSSP l2 -- Flexible Logging
Version 0.9.13 (08-Jun-2007)
ABSTRACT
OSSP l2 is a C library providing a very flexible and sophisticated
Unix logging facility. It is based on the model of arbitrary number of
channels, stacked together in a top-down data flow tree structure with
filtering channels in internal nodes and output channels on the leave
nodes.
Channel trees can be either constructed manually through lower-level
API functions or all at once with a single API function controlled by
a compact syntactical description of the channel tree. For generating
log messages a printf-style formatting engine is provided which can be
extended through callback functions. The data flow inside the channel
tree is controlled by (eight fixed and nine custom) logging message
severity levels which are assigned to each individual channel.
Channels are implemented by channel handlers which can be even
customer supplied for creating own channels which seamlessly integrate
into the framework. For convenience reasons, OSSP l2 already ships
with pre-implemented filtering (noop, filter, prefix, buffer) and
output (null, fd, file, pipe, socket, syslog, smtp) channels which
already cover mostly all use cases of logging.
COPYRIGHT AND LICENSE
Copyright (c) 2001-2005 Cable & Wireless <http://www.cw.com/>
Copyright (c) 2001-2005 The OSSP Project <http://www.ossp.org/>
Copyright (c) 2001-2005 Ralf S. Engelschall <rse@engelschall.com>
This file is part of OSSP l2, a flexible logging library which
can be found at http://www.ossp.org/pkg/lib/l2/.
Permission to use, copy, modify, and distribute this software for
any purpose with or without fee is hereby granted, provided that
the above copyright notice and this permission notice appear in all
copies.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND ANY EXPRESSED OR IMPLIED
WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
IN NO EVENT SHALL THE AUTHORS AND COPYRIGHT HOLDERS AND THEIR
CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
SUCH DAMAGE.
HOME AND DOCUMENTATION
The documentation and latest release can be found on
o http://www.ossp.org/pkg/lib/l2/
o ftp://ftp.ossp.org/pkg/lib/l2/
