_        ___  ____ ____  ____    _ ____
  |_|_ _   / _ \/ ___/ ___||  _ \  | |___ \
  _|_||_| | | | \___ \___ \| |_) | | | __) |
 |_||_|_| | |_| |___) |__) |  __/  | |/ __/
  |_|_|_|  \___/|____/____/|_|     |_|_____|

  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/