summaryrefslogtreecommitdiffstats
path: root/Doc/library/logging.rst
diff options
context:
space:
mode:
authorVinay Sajip <vinay_sajip@yahoo.co.uk>2010-09-23 20:31:24 (GMT)
committerVinay Sajip <vinay_sajip@yahoo.co.uk>2010-09-23 20:31:24 (GMT)
commit972412d168e69d28088e7ddffced34fcd94944e4 (patch)
treecdb4d5314f54fe9aaf083a04281c1279850275e7 /Doc/library/logging.rst
parent605c29303133987a5a97f3ceb4a369e9771676b0 (diff)
downloadcpython-972412d168e69d28088e7ddffced34fcd94944e4.zip
cpython-972412d168e69d28088e7ddffced34fcd94944e4.tar.gz
cpython-972412d168e69d28088e7ddffced34fcd94944e4.tar.bz2
Updated SysLogHandler documentation.
Diffstat (limited to 'Doc/library/logging.rst')
-rw-r--r--Doc/library/logging.rst9
1 files changed, 9 insertions, 0 deletions
diff --git a/Doc/library/logging.rst b/Doc/library/logging.rst
index 43dacaf..feb3e87 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.