From: W. Trevor King <wking@drexel.edu>
Date: Sat, 18 Feb 2012 19:31:42 +0000 (-0500)
Subject: Add socket.setdefaulttimeout example to Resolver doctest.
X-Git-Url: http://git.tremily.us/gitweb.cgi?a=commitdiff_plain;h=fa1898bc8b9bb5bcfed0ede086455c2089b5357a;p=apachelog.git

Add socket.setdefaulttimeout example to Resolver doctest.
---

diff --git a/apachelog/resolve.py b/apachelog/resolve.py
index db17f6b..9d8b66c 100644
--- a/apachelog/resolve.py
+++ b/apachelog/resolve.py
@@ -8,6 +8,12 @@ class Resolver (object):
     Maintains a class-level cache of resolved IPs to avoid repeated
     lookups on the same IP address.
 
+    Avoid hanging if we can't resolve a name.
+
+    >>> import socket
+    >>> if hasattr(_socket, 'setdefaulttimeout'):
+    >>>     socket.setdefaulttimeout(5)  # set 5 second timeout
+
     >>> r = Resolver()
     >>> r.resolve('198.41.0.4')
     'a.root-servers.net'