stas 2004/03/01 19:47:24
Modified: src/docs/2.0/api/Apache RequestRec.pod
Log:
- polish the assbackwards entry
- add warnings about keepalive connections
Revision Changes Path
1.11 +26 -5 modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod
Index: RequestRec.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/RequestRec.pod,v
retrieving revision 1.10
retrieving revision 1.11
diff -u -u -r1.10 -r1.11
--- RequestRec.pod 26 Feb 2004 21:12:28 -0000 1.10
+++ RequestRec.pod 2 Mar 2004 03:47:23 -0000 1.11
@@ -238,23 +238,44 @@
=head2 C<assbackwards>
-META: Autogenerated - needs to be reviewed/completed
-
-HTTP/0.9, "simple" request (e.g. GET /foo\n w/no headers)
+When set to a true value, Apache won't send any HTTP response headers
+allowing you to send any headers.
$status = $r->assbackwards($newval);
+ $status = $r->assbackwards();
=over 4
=item arg1: C<$r>
(C<L<Apache::RequestRec|docs::2.0::api::Apache::RequestRec>>)
-=item arg2: C<$newval> (integer)
+=item arg2 opt: C<$newval> (integer)
+
+assign a new state.
=item ret: C<$status> (integer)
-=back
+current state.
+=item since: 1.99_10
+
+=back
+If you send your own set of headers, which includes the C<Keep-Alive>
+HTTP response header, you must make sure to increment the number of
+requests served over this connection (which is normally done by the
+core connection output filter C<ap_http_header_filter>, but skipped
+when C<assbackwards> is enabled).
+
+ $r->connection->keepalives($r->connection->keepalives + 1);
+
+otherwise code relying on the value of
+C<L<$r-E<gt>connection-E<gt>keepalives|docs::2.0::api::Apache::Connection/C_keepalives_>>
+may malfunction. For example, this counter is used to tell when a new
+request is coming in over the same connection to a filter that wants
+to parse only HTTP headers (like
+C<Apache::Filter::HTTPHeadersFixup>). Of course you will need to set
+C<L<$r-E<gt>connection-E<gt>keepalive(1)|docs::2.0::api::Apache::Connection/C_keepalive_>>)
+as well.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
