Index: ossp-pkg/l2/l2.pod RCS File: /v/ossp/cvs/ossp-pkg/l2/l2.pod,v rcsdiff -q -kk '-r1.5' '-r1.6' -u '/v/ossp/cvs/ossp-pkg/l2/l2.pod,v' 2>/dev/null --- l2.pod 2001/09/14 13:26:16 1.5 +++ l2.pod 2001/09/14 19:22:38 1.6 @@ -51,9 +51,60 @@ =head1 AVAILABLE CHANNEL HANDLERS +=head2 Syslog Output Channel Handler (l2_handler_syslog) + +The Syslog output channel handler C sends the +incoming message either via syslog(3) to a local syslogd(8) or via BSD +Syslog protocol to a remote Syslog service. It conforms to RFC 3164 (The +BSD syslog Protocol; C. Lonvick; August 2001). + +It provides the following channel parameters: + +=over 4 + +=item B (optional, C) + +Sets the location of the target Syslog service. Possible values +are C (the default) or C. If C is used, the +parameters C has to be set, too. + +=item B (optional, C) + +Host name or IP address of the remote Syslog service. +No default exists, user has to provide value. + +=item B (optional, C) + +Port number of the remote SMTP service. +Default is C<514>. + +=item B (optional, C) + +The name of the local host, I any domain appended. + +=item B (optional, C) + +The Syslog facility used for all messages. It has to be one of the +following: C, C, C, C, C, C, +C, C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C. + +=item B (I, C) + +Arbitrary string identifying the program. +There is no default, user has to provide value. + +=item B (optional, C) + +Boolean flag whether to add the Process ID (pid) +to the B tag in messages. Default is C<0>. + +=back + =head2 SMTP Output Channel Handler (l2_handler_smtp) -The SMTP output channel handler C sends the incoming +The SMTP output channel handler C sends the incoming message via Simple Mail Transfer Protocol (SMTP) as an Email to a remote mail service. It conforms to RFC 2821 (Simple Mail Transfer Protocol; J. Klensin; April 2001) and RFC 2822 (Internet Message Format; P. Resnick;