From: Vinay Sajip <vinay_sajip@yahoo.co.uk>
Date: Thu, 23 Sep 2010 20:31:24 +0000 (+0000)
Subject: Updated SysLogHandler documentation.
X-Git-Tag: v3.2a3~154
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=972412d168e69d28088e7ddffced34fcd94944e4;p=thirdparty%2FPython%2Fcpython.git

Updated SysLogHandler documentation.
---

diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 43dacaf515b4..feb3e8746763 100644
--- a/Doc/library/logging.rst
+++ b/Doc/library/logging.rst
@@ -2410,6 +2410,15 @@ supports sending logging messages to a remote or local Unix syslog.
    opens a UDP socket. To open a TCP socket (for use with the newer syslog
    daemons such as rsyslog), specify a value of :const:`socket.SOCK_STREAM`.
 
+   Note that if your server is not listening on UDP port 514,
+   :class:`SysLogHandler` may appear not to work. In that case, check what
+   address you should be using for a domain socket - it's system dependent.
+   For example, on Linux it's usually "/dev/log" but on OS/X it's
+   "/var/run/syslog". You'll need to check your platform and use the
+   appropriate address (you may need to do this check at runtime if your
+   application needs to run on several platforms). On Windows, you pretty
+   much have to use the UDP option.
+
    .. versionchanged:: 3.2
       *socktype* was added.