perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/api/Apache RequestRec.pod
Date Tue, 02 Mar 2004 03:47:24 GMT
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: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message