|
Check-in Number:
|
1287 | |
| Date: |
2001-Nov-09 13:45:37 (local)
2001-Nov-09 12:45:37 (UTC) |
| User: | rse |
| Branch: | |
| Comment: |
first cut for an L2 summary |
| Tickets: |
|
| Inspections: |
|
| Files: |
|
ossp-pkg/l2/README 1.4 -> 1.5
--- README 2001/09/13 14:22:02 1.4
+++ README 2001/11/09 12:45:37 1.5
@@ -9,7 +9,26 @@
ABSTRACT
- The L2 library is [...]
+ 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 convinience reasons, 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
|
|
ossp-pkg/l2/l2.pod 1.7 -> 1.8
--- l2.pod 2001/09/20 16:26:56 1.7
+++ l2.pod 2001/11/09 12:45:37 1.8
@@ -43,7 +43,26 @@
=head1 DESCRIPTION
-The B<L2> library is...
+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 convinience reasons, 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.
=head1 FUNCTIONS
|
|
