mirror of
https://github.com/python/cpython.git
synced 2025-10-31 13:41:24 +00:00
b044b2a701
svn+ssh://svn.python.org/python/branches/py3k ................ r74821 | georg.brandl | 2009-09-16 11:42:19 +0200 (Mi, 16 Sep 2009) | 1 line #6885: run python 3 as python3. ................ r74828 | georg.brandl | 2009-09-16 16:23:20 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans. ................ r74829 | georg.brandl | 2009-09-16 16:24:29 +0200 (Mi, 16 Sep 2009) | 1 line Small PEP8 correction. ................ r74830 | georg.brandl | 2009-09-16 16:36:22 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans. ................ r74831 | georg.brandl | 2009-09-16 17:54:04 +0200 (Mi, 16 Sep 2009) | 1 line Use true booleans and PEP8 for argdefaults. ................ r74833 | georg.brandl | 2009-09-16 17:58:14 +0200 (Mi, 16 Sep 2009) | 1 line Last round of adapting style of documenting argument default values. ................ r74835 | georg.brandl | 2009-09-16 18:00:31 +0200 (Mi, 16 Sep 2009) | 33 lines Merged revisions 74817-74820,74822-74824 via svnmerge from svn+ssh://pythondev@svn.python.org/python/trunk ........ r74817 | georg.brandl | 2009-09-16 11:05:11 +0200 (Mi, 16 Sep 2009) | 1 line Make deprecation notices as visible as warnings are right now. ........ r74818 | georg.brandl | 2009-09-16 11:23:04 +0200 (Mi, 16 Sep 2009) | 1 line #6880: add reference to classes section in exceptions section, which comes earlier. ........ r74819 | georg.brandl | 2009-09-16 11:24:57 +0200 (Mi, 16 Sep 2009) | 1 line #6876: fix base class constructor invocation in example. ........ r74820 | georg.brandl | 2009-09-16 11:30:48 +0200 (Mi, 16 Sep 2009) | 1 line #6891: comment out dead link to Unicode article. ........ r74822 | georg.brandl | 2009-09-16 12:12:06 +0200 (Mi, 16 Sep 2009) | 1 line #5621: refactor description of how class/instance attributes interact on a.x=a.x+1 or augassign. ........ r74823 | georg.brandl | 2009-09-16 15:06:22 +0200 (Mi, 16 Sep 2009) | 1 line Remove strange trailing commas. ........ r74824 | georg.brandl | 2009-09-16 15:11:06 +0200 (Mi, 16 Sep 2009) | 1 line #6892: fix optparse example involving help option. ........ ................
65 lines
2.5 KiB
ReStructuredText
65 lines
2.5 KiB
ReStructuredText
:mod:`syslog` --- Unix syslog library routines
|
|
==============================================
|
|
|
|
.. module:: syslog
|
|
:platform: Unix
|
|
:synopsis: An interface to the Unix syslog library routines.
|
|
|
|
|
|
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.
|
|
|
|
The module defines the following functions:
|
|
|
|
|
|
.. function:: syslog([priority,] message)
|
|
|
|
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
|
|
:const:`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 :func:`openlog` call is used.
|
|
|
|
|
|
.. function:: openlog(ident[, logopt[, facility]])
|
|
|
|
Logging options other than the defaults can be set by explicitly opening the log
|
|
file with :func:`openlog` prior to calling :func:`syslog`. The defaults are
|
|
(usually) *ident* = ``'syslog'``, *logopt* = ``0``, *facility* =
|
|
:const:`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.
|
|
|
|
|
|
.. function:: closelog()
|
|
|
|
Close the log file.
|
|
|
|
|
|
.. function:: setlogmask(maskpri)
|
|
|
|
Set the priority mask to *maskpri* and return the previous mask value. Calls to
|
|
:func:`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*.
|
|
|
|
The module defines the following constants:
|
|
|
|
Priority levels (high to low):
|
|
:const:`LOG_EMERG`, :const:`LOG_ALERT`, :const:`LOG_CRIT`, :const:`LOG_ERR`,
|
|
:const:`LOG_WARNING`, :const:`LOG_NOTICE`, :const:`LOG_INFO`,
|
|
:const:`LOG_DEBUG`.
|
|
|
|
Facilities:
|
|
:const:`LOG_KERN`, :const:`LOG_USER`, :const:`LOG_MAIL`, :const:`LOG_DAEMON`,
|
|
:const:`LOG_AUTH`, :const:`LOG_LPR`, :const:`LOG_NEWS`, :const:`LOG_UUCP`,
|
|
:const:`LOG_CRON` and :const:`LOG_LOCAL0` to :const:`LOG_LOCAL7`.
|
|
|
|
Log options:
|
|
:const:`LOG_PID`, :const:`LOG_CONS`, :const:`LOG_NDELAY`, :const:`LOG_NOWAIT`
|
|
and :const:`LOG_PERROR` if defined in ``<syslog.h>``.
|
|
|