[CalendarServer-changes] [11469] CalendarServer/branches/users/glyph/hang-fix/twext/web2/metafd.py

[source_changes at macosforge.org]

Revision: 11469
          http://trac.calendarserver.org//changeset/11469
Author:   glyph at apple.com
Date:     2013-07-05 17:42:57 -0700 (Fri, 05 Jul 2013)
Log Message:
-----------
More documentation.

Modified Paths:
--------------
    CalendarServer/branches/users/glyph/hang-fix/twext/web2/metafd.py

Modified: CalendarServer/branches/users/glyph/hang-fix/twext/web2/metafd.py
===================================================================
--- CalendarServer/branches/users/glyph/hang-fix/twext/web2/metafd.py	2013-07-06 00:42:55 UTC (rev 11468)
+++ CalendarServer/branches/users/glyph/hang-fix/twext/web2/metafd.py	2013-07-06 00:42:57 UTC (rev 11469)
@@ -42,6 +42,8 @@
     Service which starts up an HTTP server that can report back to its parent
     process via L{InheritedPort}.
 
+    This is instantiated in the I{worker process}.
+
     @ivar site: a twext.web2 'site' object, i.e. a request factory
 
     @ivar fd: the file descriptor of a UNIX socket being used to receive
@@ -109,8 +111,12 @@
 class ReportingHTTPFactory(HTTPFactory):
     """
     An L{HTTPFactory} which reports its status to a
-    L{twext.internet.sendfdport.InheritedPort}.
+    L{InheritedPort<twext.internet.sendfdport.InheritedPort>}.
 
+    Since this is processing application-level bytes, it is of course
+    instantiated in the I{worker process}, as is
+    L{InheritedPort<twext.internet.sendfdport.InheritedPort>}.
+
     @ivar inheritedPort: an L{InheritedPort} to report status (the current
         number of outstanding connections) to.  Since this - the
         L{ReportingHTTPFactory} - needs to be instantiated to be passed to
@@ -268,6 +274,9 @@
     An L{InheritingProtocolFactory} that supports the implicit factory contract
     required by L{MaxAcceptTCPServer}/L{MaxAcceptTCPPort}.
 
+    Since L{InheritingProtocolFactory} is instantiated in the I{master
+    process}, so is L{LimitingInheritingProtocolFactory}.
+
     @ivar outstandingRequests: a read-only property for the number of currently
         active connections.
 
@@ -275,8 +284,8 @@
         single reactor loop iteration.
 
     @ivar maxRequests: The maximum number of concurrent connections to accept
-        at once - note that this is for the I{entire server}, whereas the
-        value in the configuration file is for only a single process.
+        at once - note that this is for the I{entire server}, whereas the value
+        in the configuration file is for only a single process.
     """
 
     def __init__(self, limiter, description):
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/calendarserver-changes/attachments/20130705/817c74cc/attachment-0001.html>