#use wml::ossp area=pkg:lib subarea=l2

<title>OSSP l2</title>

<h1>Flexible Logging</h1>

<h2>Abstract</h2>

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.

<p>
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.

<p>
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.

<h2>Authors</h2>

<pkg_author name="Ralf S. Engelschall" mail="rse@engelschall.com">
<pkg_author name="Thomas Lotterer" mail="thomas@lotterer.net">
<pkg_author name="Michael Schloh v. Bennewitz" mail="michael.schloh@cw.com">

<h2>Status</h2>

<pkg_status
    name="l2" assign="rse"
    stable="none"    stable_date="none"
    unstable="0.9.13" unstable_date="08-Jun-2007"
	done=95>

<h2>Source</h2>

<pkg_files 
    cvs=$(CVS_ROOT_URL)/pkg/lib/l2/
    url=$(FTP_ROOT_URL)/pkg/lib/l2/
    directory=$(FTP_ROOT_DIR)/pkg/lib/l2/
    files="l2-*.tar.gz" 
	stable="none" unstable="l2-0.9.13.tar.gz">
	
<h2>Donation</h2>

<pkg_donation name="l2" return="$(BASE_URL)/pkg/lib/l2/">