Module Name: src
Committed By: tls
Date: Tue Jul 14 21:37:50 UTC 2009
Modified Files:
src/share/man/man9: accf_http.9
Log Message:
Clarify accf_http manual page per wiz's request.
To generate a diff of this commit:
cvs rdiff -u -r1.4 -r1.5 src/share/man/man9/accf_http.9
Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.
Modified files:
Index: src/share/man/man9/accf_http.9
diff -u src/share/man/man9/accf_http.9:1.4 src/share/man/man9/accf_http.9:1.5
--- src/share/man/man9/accf_http.9:1.4 Mon Mar 9 19:24:32 2009
+++ src/share/man/man9/accf_http.9 Tue Jul 14 21:37:50 2009
@@ -39,16 +39,25 @@
.Fn accept
to receive incoming HTTP connections.
.Pp
-It prevents the application from receiving the connected descriptor via
-.Fn accept
-until either a full HTTP/1.0 or HTTP/1.1 HEAD or GET request has
+Once installed on a listening socket, this filter is activated when a
+connection becomes ready to receive data (at which point
+.Xr accept 2
+would usually return the connected descriptor to the application). The
+filter prevents the descriptor from being returned immediately to the
+application via
+.Xr accept 2 .
+The descriptor is made available to the application via
+.Xr accept 2
+only when
+one of the following conditions is met:
+.Bl -enum
+.It
+A complete, syntactically valid HTTP/1.0 or HTTP/1.1 HEAD or GET request has
been buffered by the kernel.
-.Pp
-If something other than a HTTP/1.0 or
-HTTP/1.1 HEAD or GET request is received the kernel will
-allow the application to receive the connection descriptor
-via
-.Fn accept .
+.It
+The data buffered by the kernel cannot be part of a complete, syntactically
+valid HTTP 1.0 or HTTP/1.1 HEAD or GET request.
+.El
.Pp
The utility of
.Nm
