This module provides an interface to the Unix syslog library
routines. Refer to the Unix manual pages for a detailed description
of the syslog facility.
Send the string message to the system logger. A trailing
newline is added if necessary. Each message is tagged with a priority
composed of a facility and a level. The optional
priority argument, which defaults to LOG_INFO,
determines the message priority. If the facility is not encoded in
priority using logical-or (LOG_INFO | LOG_USER), the
value given in the openlog() call is used.
Logging options other than the defaults can be set by explicitly
opening the log file with openlog() prior to calling
syslog(). The defaults are (usually) ident =
'syslog', logopt = 0, facility =
LOG_USER. The ident argument is a string which is
prepended to every message. The optional logopt argument is a
bit field - see below for possible values to combine. The optional
facility argument sets the default facility for messages which
do not have a facility explicitly encoded.
Set the priority mask to maskpri and return the
previous mask value. Calls to syslog() with a priority
level not set in maskpri are ignored. The default is to log all
priorities. The function LOG_MASK(pri) calculates the
mask for the individual priority pri. The function
LOG_UPTO(pri) calculates the mask for all priorities up
to and including pri.
