diff options
author | Brian Curtin <brian@python.org> | 2011-06-13 21:10:32 (GMT) |
---|---|---|
committer | Brian Curtin <brian@python.org> | 2011-06-13 21:10:32 (GMT) |
commit | a87d586fd6c4a5dfe4ea89fda288ae8eb66b0134 (patch) | |
tree | 420fe483c679d2225cc8bd82eefaecf783999268 /Doc/library/logging.handlers.rst | |
parent | d25aef55c8b0025dd2ee7de11b526f34ceed6b66 (diff) | |
parent | cdc751720ee7a13ac163da1eedf3a513386c98d4 (diff) | |
download | cpython-a87d586fd6c4a5dfe4ea89fda288ae8eb66b0134.zip cpython-a87d586fd6c4a5dfe4ea89fda288ae8eb66b0134.tar.gz cpython-a87d586fd6c4a5dfe4ea89fda288ae8eb66b0134.tar.bz2 |
branch merge?
Diffstat (limited to 'Doc/library/logging.handlers.rst')
-rw-r--r-- | Doc/library/logging.handlers.rst | 15 |
1 files changed, 15 insertions, 0 deletions
diff --git a/Doc/library/logging.handlers.rst b/Doc/library/logging.handlers.rst index eda9302..378c071 100644 --- a/Doc/library/logging.handlers.rst +++ b/Doc/library/logging.handlers.rst @@ -436,6 +436,21 @@ supports sending logging messages to a remote or local Unix syslog. The record is formatted, and then sent to the syslog server. If exception information is present, it is *not* sent to the server. + .. versionchanged:: 3.2.1 + (See: :issue:`12168`.) In earlier versions, the message sent to the + syslog daemons was always terminated with a NUL byte, because early + versions of these daemons expected a NUL terminated message - even + though it's not in the relevant specification (RF 5424). More recent + versions of these daemons don't expect the NUL byte but strip it off + if it's there, and even more recent daemons (which adhere more closely + to RFC 5424) pass the NUL byte on as part of the message. + + To enable easier handling of syslog messages in the face of all these + differing daemon behaviours, the appending of the NUL byte has been + made configurable, through the use of a class-level attribute, + ``append_nul``. This defaults to ``True`` (preserving the existing + behaviour) but can be set to ``False`` on a ``SysLogHandler`` instance + in order for that instance to *not* append the NUL terminator. .. method:: encodePriority(facility, priority) |