=head1	NAME

dkslsupp - Syslog support

=head1	SYNOPSIS

  #include <dkslsupp.h>

  int dkslsupp_get_code(char *str);

=head1	DESCRIPTION

The dkslsupp_get_code() function converts the syslog description
string I<str> into an appropriate numeric value.

The description string consists of feature an priority, separated
by a dot (i.e. "auth.notice").

The following features can be used:

=over 2

=item	* auth

messages related to use authentication

=item	* authpriv

=item	* cron

messages generated by unattended scheduled jobs

=item	* daemon

generated by daemons and services

=item	* ftp

generated by the FTP service

=item	* kern

generated by the OS kernel

=item	* lpr

generated by t he print system

=item	* mail

generated by the mail transport system

=item	* news

generated by the NNTP service

=item	* syslog

generated by the syslog service

=item	* user

generated by programs run from normal users

=item	* uucp

generated by the UUCP service

=item	* local0 .... local7

site specific messages

=back

The following priority keywords can be used:

=over 2

=item	* emerg

The system is unusable.

=item	* alert

An action must be taken immediately.

=item	* crit

A critical error occured.

=item	* err

An error occured.

=item	* warning

A warning condition occured.

=item	* notice

Notification about a normal but significant condition.

=item	* info

An informational message.

=item	* debug

A message usefull for debugging.

=back

=head1	RETURN VALUE

A nonzero value is returned on success, 0 on error.

=head1	AUTHOR

Dirk Krause

=head1	COPYRIGHT AND LICENSE

Copyright (c) 2001-2008, Dirk Krause
All rights reserved.

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

 * Redistributions of source code must retain the above
   copyright notice, this list of conditions and the
   following disclaimer.

 * Redistributions in binary form must reproduce the above
   copyright notice, this list of conditions and the following
   disclaimer in the documentation and/or other materials
   provided with the distribution.

 * Neither the name of the Dirk Krause nor the names of
   contributors may be used to endorse or promote products
   derived from this software without specific prior written
   permission.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
ANY EXPRESS 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 COPYRIGHT OWNER OR 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.
