Unix syslog 庫例程 · Python3.7.3官方文檔簡體中文

### 導航 - [索引](../genindex.xhtml "總目錄") - [模塊](../py-modindex.xhtml "Python 模塊索引") | - [下一頁](superseded.xhtml "被取代的模塊") | - [上一頁](nis.xhtml "nis --- Interface to Sun's NIS (Yellow Pages)") | - ![](https://box.kancloud.cn/a721fc7ec672275e257bbbfde49a4d4e_16x16.png) - [Python](https://www.python.org/) ? - zh\_CN 3.7.3 [文檔](../index.xhtml) ? - [Python 標準庫](index.xhtml) ? - [Unix 專有服務](unix.xhtml) ? - $('.inline-search').show(0); | # Unix syslog 庫例程 - - - - - - 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. This module wraps the system `syslog` family of routines. A pure Python library that can speak to a syslog server is available in the [`logging.handlers`](logging.handlers.xhtml#module-logging.handlers "logging.handlers: Handlers for the logging module.") module as `SysLogHandler`. The module defines the following functions: `syslog.``syslog`(*message*)`syslog.``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 `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()`](#syslog.openlog "syslog.openlog") call is used. If [`openlog()`](#syslog.openlog "syslog.openlog") has not been called prior to the call to [`syslog()`](#module-syslog "syslog: An interface to the Unix syslog library routines. (Unix)"), `openlog()` will be called with no arguments. `syslog.``openlog`(\[*ident*\[, *logoption*\[, *facility*\]\]\])Logging options of subsequent [`syslog()`](#module-syslog "syslog: An interface to the Unix syslog library routines. (Unix)") calls can be set by calling [`openlog()`](#syslog.openlog "syslog.openlog"). [`syslog()`](#module-syslog "syslog: An interface to the Unix syslog library routines. (Unix)") will call [`openlog()`](#syslog.openlog "syslog.openlog") with no arguments if the log is not currently open. The optional *ident* keyword argument is a string which is prepended to every message, and defaults to `sys.argv[0]` with leading path components stripped. The optional *logoption* keyword argument (default is 0) is a bit field -- see below for possible values to combine. The optional *facility*keyword argument (default is `LOG_USER`) sets the default facility for messages which do not have a facility explicitly encoded. 在 3.2 版更改: In previous versions, keyword arguments were not allowed, and *ident* was required. The default for *ident* was dependent on the system libraries, and often was `python` instead of the name of the Python program file. `syslog.``closelog`()Reset the syslog module values and call the system library `closelog()`. This causes the module to behave as it does when initially imported. For example, [`openlog()`](#syslog.openlog "syslog.openlog") will be called on the first [`syslog()`](#module-syslog "syslog: An interface to the Unix syslog library routines. (Unix)") call (if [`openlog()`](#syslog.openlog "syslog.openlog") hasn't already been called), and *ident* and other [`openlog()`](#syslog.openlog "syslog.openlog") parameters are reset to defaults. `syslog.``setlogmask`(*maskpri*)Set the priority mask to *maskpri* and return the previous mask value. Calls to [`syslog()`](#module-syslog "syslog: An interface to the Unix syslog library routines. (Unix)") 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):`LOG_EMERG`, `LOG_ALERT`, `LOG_CRIT`, `LOG_ERR`, `LOG_WARNING`, `LOG_NOTICE`, `LOG_INFO`, `LOG_DEBUG`. Facilities:`LOG_KERN`, `LOG_USER`, `LOG_MAIL`, `LOG_DAEMON`, `LOG_AUTH`, `LOG_LPR`, `LOG_NEWS`, `LOG_UUCP`, `LOG_CRON`, `LOG_SYSLOG`, `LOG_LOCAL0` to `LOG_LOCAL7`, and, if defined in `<syslog.h>`, `LOG_AUTHPRIV`. Log options:`LOG_PID`, `LOG_CONS`, `LOG_NDELAY`, and, if defined in `<syslog.h>`, `LOG_ODELAY`, `LOG_NOWAIT`, and `LOG_PERROR`. ## 示例 ### Simple example A simple set of examples: ``` import syslog syslog.syslog('Processing started') if error: syslog.syslog(syslog.LOG_ERR, 'Processing started') ``` An example of setting some log options, these would include the process ID in logged messages, and write the messages to the destination facility used for mail logging: ``` syslog.openlog(logoption=syslog.LOG_PID, facility=syslog.LOG_MAIL) syslog.syslog('E-mail processing initiated...') ``` ### 導航 - [索引](../genindex.xhtml "總目錄") - [模塊](../py-modindex.xhtml "Python 模塊索引") | - [下一頁](superseded.xhtml "被取代的模塊") | - [上一頁](nis.xhtml "nis --- Interface to Sun's NIS (Yellow Pages)") | - ![](https://box.kancloud.cn/a721fc7ec672275e257bbbfde49a4d4e_16x16.png) - [Python](https://www.python.org/) ? - zh\_CN 3.7.3 [文檔](../index.xhtml) ? - [Python 標準庫](index.xhtml) ? - [Unix 專有服務](unix.xhtml) ? - $('.inline-search').show(0); | ? [版權所有](../copyright.xhtml) 2001-2019, Python Software Foundation. Python 軟件基金會是一個非盈利組織。 [請捐助。](https://www.python.org/psf/donations/) 最后更新于 5月 21, 2019. [發現了問題](../bugs.xhtml)？使用[Sphinx](http://sphinx.pocoo.org/)1.8.4 創建。