diff --git a/Doc/lib.tex b/Doc/lib.tex index f8c67161987..049b0cec1c0 100644 --- a/Doc/lib.tex +++ b/Doc/lib.tex @@ -120,6 +120,7 @@ to Python and how to embed it in other applications. \input{libtermios} \input{libfcntl} \input{libposixfile} +\input{libsyslog} \input{libpdb} % The Python Debugger diff --git a/Doc/lib/lib.tex b/Doc/lib/lib.tex index f8c67161987..049b0cec1c0 100644 --- a/Doc/lib/lib.tex +++ b/Doc/lib/lib.tex @@ -120,6 +120,7 @@ to Python and how to embed it in other applications. \input{libtermios} \input{libfcntl} \input{libposixfile} +\input{libsyslog} \input{libpdb} % The Python Debugger diff --git a/Doc/lib/libsyslog.tex b/Doc/lib/libsyslog.tex new file mode 100644 index 00000000000..5b4fdded4bc --- /dev/null +++ b/Doc/lib/libsyslog.tex @@ -0,0 +1,67 @@ +\section{Built-in Module \sectcode{syslog}} +\bimodindex{syslog} + +This module provides an interface to the Unix \code{syslog} library +routines. Refer to the \UNIX{} manual pages for a detailed description +of the \code{syslog} facility. + +The module defines the following functions: + +\begin{funcdesc}{syslog}{\optional{priority\,} message} +Send the string \var{message} to the system logger. +A trailing newline is added if necessary. +Each message is tagged with a priority composed of a \var{facility} and +a \var{level}. +The optional \var{priority} argument, which defaults to +\code{(LOG_USER | LOG_INFO)}, determines the message priority. +\end{funcdesc} + +\begin{funcdesc}{openlog}{ident\, \optional{logopt\, \optional{facility}}} +Logging options other than the defaults can be set by explicitly opening +the log file with \code{openlog()} prior to calling \code{syslog()}. +The defaults are (usually) \var{ident} = \samp{syslog}, \var{logopt} = 0, +\var{facility} = \code{LOG_USER}. +The \var{ident} argument is a string which is prepended to every message. +The optional \var{logopt} argument is a bit field - see below for possible +values to combine. +The optional \var{facility} argument sets the default facility for messages +which do not have a facility explicitly encoded. +\end{funcdesc} + +\begin{funcdesc}{closelog}{} +Close the log file. +\end{funcdesc} + +\begin{funcdesc}{setlogmask}{maskpri} +This function set the priority mask to \var{maskpri} and returns the +previous mask value. +Calls to \code{syslog} with a priority level not set in \var{maskpri} +are ignored. +The default is to log all priorities. +The function \code{LOG_MASK(\var{pri})} calculates the mask for the +individual priority \var{pri}. +The function \code{LOG_UPTO(\var{pri})} calculates the mask for all priorities +up to and including \var{pri}. +\end{funcdesc} + +The module defines the following constants: + +\begin{description} + +\item[Priority levels (high to low):] + +\code{LOG_EMERG}, \code{LOG_ALERT}, \code{LOG_CRIT}, \code{LOG_ERR}, +\code{LOG_WARNING}, \code{LOG_NOTICE}, \code{LOG_INFO}, \code{LOG_DEBUG}. + +\item[Facilities:] + +\code{LOG_KERN}, \code{LOG_USER}, \code{LOG_MAIL}, \code{LOG_DAEMON}, +\code{LOG_AUTH}, \code{LOG_LPR}, \code{LOG_NEWS}, \code{LOG_UUCP}, +\code{LOG_CRON} and \code{LOG_LOCAL0} to \code{LOG_LOCAL7}. + +\item[Log options:] + +\code{LOG_PID}, \code{LOG_CONS}, \code{LOG_NDELAY}, \code{LOG_NOWAIT} +and \code{LOG_PERROR} if defined in \file{syslog.h}. + +\end{description} diff --git a/Doc/libsyslog.tex b/Doc/libsyslog.tex new file mode 100644 index 00000000000..5b4fdded4bc --- /dev/null +++ b/Doc/libsyslog.tex @@ -0,0 +1,67 @@ +\section{Built-in Module \sectcode{syslog}} +\bimodindex{syslog} + +This module provides an interface to the Unix \code{syslog} library +routines. Refer to the \UNIX{} manual pages for a detailed description +of the \code{syslog} facility. + +The module defines the following functions: + +\begin{funcdesc}{syslog}{\optional{priority\,} message} +Send the string \var{message} to the system logger. +A trailing newline is added if necessary. +Each message is tagged with a priority composed of a \var{facility} and +a \var{level}. +The optional \var{priority} argument, which defaults to +\code{(LOG_USER | LOG_INFO)}, determines the message priority. +\end{funcdesc} + +\begin{funcdesc}{openlog}{ident\, \optional{logopt\, \optional{facility}}} +Logging options other than the defaults can be set by explicitly opening +the log file with \code{openlog()} prior to calling \code{syslog()}. +The defaults are (usually) \var{ident} = \samp{syslog}, \var{logopt} = 0, +\var{facility} = \code{LOG_USER}. +The \var{ident} argument is a string which is prepended to every message. +The optional \var{logopt} argument is a bit field - see below for possible +values to combine. +The optional \var{facility} argument sets the default facility for messages +which do not have a facility explicitly encoded. +\end{funcdesc} + +\begin{funcdesc}{closelog}{} +Close the log file. +\end{funcdesc} + +\begin{funcdesc}{setlogmask}{maskpri} +This function set the priority mask to \var{maskpri} and returns the +previous mask value. +Calls to \code{syslog} with a priority level not set in \var{maskpri} +are ignored. +The default is to log all priorities. +The function \code{LOG_MASK(\var{pri})} calculates the mask for the +individual priority \var{pri}. +The function \code{LOG_UPTO(\var{pri})} calculates the mask for all priorities +up to and including \var{pri}. +\end{funcdesc} + +The module defines the following constants: + +\begin{description} + +\item[Priority levels (high to low):] + +\code{LOG_EMERG}, \code{LOG_ALERT}, \code{LOG_CRIT}, \code{LOG_ERR}, +\code{LOG_WARNING}, \code{LOG_NOTICE}, \code{LOG_INFO}, \code{LOG_DEBUG}. + +\item[Facilities:] + +\code{LOG_KERN}, \code{LOG_USER}, \code{LOG_MAIL}, \code{LOG_DAEMON}, +\code{LOG_AUTH}, \code{LOG_LPR}, \code{LOG_NEWS}, \code{LOG_UUCP}, +\code{LOG_CRON} and \code{LOG_LOCAL0} to \code{LOG_LOCAL7}. + +\item[Log options:] + +\code{LOG_PID}, \code{LOG_CONS}, \code{LOG_NDELAY}, \code{LOG_NOWAIT} +and \code{LOG_PERROR} if defined in \file{syslog.h}. + +\end{description}