5 * AUTHOR: Duane Wessels
7 * SQUID Web Proxy Cache http://www.squid-cache.org/
8 * ----------------------------------------------------------
10 * Squid is the result of efforts by numerous individuals from
11 * the Internet community; see the CONTRIBUTORS file for full
12 * details. Many organizations have provided support for Squid's
13 * development; see the SPONSORS file for full details. Squid is
14 * Copyrighted (C) 2001 by the Regents of the University of
15 * California; see the COPYRIGHT file for full details. Squid
16 * incorporates software developed and/or copyrighted by other
17 * sources; see the CREDITS file for full details.
19 * This program is free software; you can redistribute it and/or modify
20 * it under the terms of the GNU General Public License as published by
21 * the Free Software Foundation; either version 2 of the License, or
22 * (at your option) any later version.
24 * This program is distributed in the hope that it will be useful,
25 * but WITHOUT ANY WARRANTY; without even the implied warranty of
26 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27 * GNU General Public License for more details.
29 * You should have received a copy of the GNU General Public License
30 * along with this program; if not, write to the Free Software
31 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
36 #include "base/TextException.h"
37 #include "comm/Connection.h"
38 #include "comm/forward.h"
41 //#include "fde.h" /* for fd_table[fd].closing */
42 #include "HttpRequest.h"
43 #include "HttpReply.h"
44 #include "errorpage.h"
45 #include "SquidTime.h"
48 #include "adaptation/AccessCheck.h"
49 #include "adaptation/Iterator.h"
52 // implemented in client_side_reply.cc until sides have a common parent
53 extern void purgeEntriesByUrl(HttpRequest
* req
, const char *url
);
56 ServerStateData::ServerStateData(FwdState
*theFwdState
): AsyncJob("ServerStateData"),
59 adaptedHeadSource(NULL
),
60 adaptationAccessCheckPending(false),
61 startedAdaptation(false),
63 receivedWholeRequestBody(false)
70 request
= HTTPMSGLOCK(fwd
->request
);
73 ServerStateData::~ServerStateData()
75 // paranoid: check that swanSong has been called
76 assert(!requestBodySource
);
78 assert(!virginBodyDestination
);
79 assert(!adaptedBodySource
);
84 HTTPMSGUNLOCK(request
);
85 HTTPMSGUNLOCK(theVirginReply
);
86 HTTPMSGUNLOCK(theFinalReply
);
88 fwd
= NULL
; // refcounted
90 if (responseBodyBuffer
!= NULL
) {
91 delete responseBodyBuffer
;
92 responseBodyBuffer
= NULL
;
97 ServerStateData::swanSong()
99 // get rid of our piping obligations
100 if (requestBodySource
!= NULL
)
101 stopConsumingFrom(requestBodySource
);
107 BodyConsumer::swanSong();
109 Initiator::swanSong();
110 BodyProducer::swanSong();
113 // paranoid: check that swanSong has been called
114 // extra paranoid: yeah, I really mean it. they MUST pass here.
115 assert(!requestBodySource
);
117 assert(!virginBodyDestination
);
118 assert(!adaptedBodySource
);
124 ServerStateData::virginReply()
126 assert(theVirginReply
);
127 return theVirginReply
;
131 ServerStateData::virginReply() const
133 assert(theVirginReply
);
134 return theVirginReply
;
138 ServerStateData::setVirginReply(HttpReply
*rep
)
140 debugs(11,5, HERE
<< this << " setting virgin reply to " << rep
);
141 assert(!theVirginReply
);
143 theVirginReply
= HTTPMSGLOCK(rep
);
144 return theVirginReply
;
148 ServerStateData::finalReply()
150 assert(theFinalReply
);
151 return theFinalReply
;
155 ServerStateData::setFinalReply(HttpReply
*rep
)
157 debugs(11,5, HERE
<< this << " setting final reply to " << rep
);
159 assert(!theFinalReply
);
161 theFinalReply
= HTTPMSGLOCK(rep
);
163 entry
->replaceHttpReply(theFinalReply
);
164 haveParsedReplyHeaders();
166 return theFinalReply
;
169 // called when no more server communication is expected; may quit
171 ServerStateData::serverComplete()
173 debugs(11,5,HERE
<< "serverComplete " << this);
175 if (!doneWithServer()) {
177 assert(doneWithServer());
182 HttpRequest
*r
= originalRequest();
183 r
->hier
.total_response_time
= r
->hier
.first_conn_start
.tv_sec
?
184 tvSubMsec(r
->hier
.first_conn_start
, current_time
) : -1;
186 if (requestBodySource
!= NULL
)
187 stopConsumingFrom(requestBodySource
);
189 if (responseBodyBuffer
!= NULL
)
196 ServerStateData::serverComplete2()
198 debugs(11,5,HERE
<< "serverComplete2 " << this);
201 if (virginBodyDestination
!= NULL
)
202 stopProducingFor(virginBodyDestination
, true);
204 if (!doneWithAdaptation())
208 completeForwarding();
212 // When we are done talking to the primary server, we may be still talking
213 // to the ICAP service. And vice versa. Here, we quit only if we are done
215 void ServerStateData::quitIfAllDone()
218 if (!doneWithAdaptation()) {
219 debugs(11,5, HERE
<< "transaction not done: still talking to ICAP");
224 if (!doneWithServer()) {
225 debugs(11,5, HERE
<< "transaction not done: still talking to server");
229 debugs(11,3, HERE
<< "transaction done");
231 deleteThis("ServerStateData::quitIfAllDone");
234 // FTP side overloads this to work around multiple calls to fwd->complete
236 ServerStateData::completeForwarding()
238 debugs(11,5, HERE
<< "completing forwarding for " << fwd
);
243 // Register to receive request body
244 bool ServerStateData::startRequestBodyFlow()
246 HttpRequest
*r
= originalRequest();
247 assert(r
->body_pipe
!= NULL
);
248 requestBodySource
= r
->body_pipe
;
249 if (requestBodySource
->setConsumerIfNotLate(this)) {
250 debugs(11,3, HERE
<< "expecting request body from " <<
251 requestBodySource
->status());
255 debugs(11,3, HERE
<< "aborting on partially consumed request body: " <<
256 requestBodySource
->status());
257 requestBodySource
= NULL
;
261 // Entry-dependent callbacks use this check to quit if the entry went bad
263 ServerStateData::abortOnBadEntry(const char *abortReason
)
265 if (entry
->isAccepting())
268 debugs(11,5, HERE
<< "entry is not Accepting!");
269 abortTransaction(abortReason
);
273 // more request or adapted response body is available
275 ServerStateData::noteMoreBodyDataAvailable(BodyPipe::Pointer bp
)
278 if (adaptedBodySource
== bp
) {
279 handleMoreAdaptedBodyAvailable();
283 handleMoreRequestBodyAvailable();
286 // the entire request or adapted response body was provided, successfully
288 ServerStateData::noteBodyProductionEnded(BodyPipe::Pointer bp
)
291 if (adaptedBodySource
== bp
) {
292 handleAdaptedBodyProductionEnded();
296 handleRequestBodyProductionEnded();
299 // premature end of the request or adapted response body production
301 ServerStateData::noteBodyProducerAborted(BodyPipe::Pointer bp
)
304 if (adaptedBodySource
== bp
) {
305 handleAdaptedBodyProducerAborted();
309 handleRequestBodyProducerAborted();
313 // more origin request body data is available
315 ServerStateData::handleMoreRequestBodyAvailable()
318 sendMoreRequestBody();
320 debugs(9,3, HERE
<< "waiting for request body write to complete");
323 // there will be no more handleMoreRequestBodyAvailable calls
325 ServerStateData::handleRequestBodyProductionEnded()
327 receivedWholeRequestBody
= true;
329 doneSendingRequestBody();
331 debugs(9,3, HERE
<< "waiting for request body write to complete");
334 // called when we are done sending request body; kids extend this
336 ServerStateData::doneSendingRequestBody()
338 debugs(9,3, HERE
<< "done sending request body");
339 assert(requestBodySource
!= NULL
);
340 stopConsumingFrom(requestBodySource
);
345 // called when body producers aborts; kids extend this
347 ServerStateData::handleRequestBodyProducerAborted()
349 if (requestSender
!= NULL
)
350 debugs(9,3, HERE
<< "fyi: request body aborted while we were sending");
352 fwd
->dontRetry(true); // the problem is not with the server
353 stopConsumingFrom(requestBodySource
); // requestSender, if any, will notice
358 // called when we wrote request headers(!) or a part of the body
360 ServerStateData::sentRequestBody(const CommIoCbParams
&io
)
362 debugs(11, 5, "sentRequestBody: FD " << io
.fd
<< ": size " << io
.size
<< ": errflag " << io
.flag
<< ".");
363 debugs(32,3,HERE
<< "sentRequestBody called");
365 requestSender
= NULL
;
368 fd_bytes(io
.fd
, io
.size
, FD_WRITE
);
369 kb_incr(&statCounter
.server
.all
.kbytes_out
, io
.size
);
370 // kids should increment their counters
373 if (io
.flag
== COMM_ERR_CLOSING
)
376 if (!requestBodySource
) {
377 debugs(9,3, HERE
<< "detected while-we-were-sending abort");
378 return; // do nothing;
382 debugs(11, 1, "sentRequestBody error: FD " << io
.fd
<< ": " << xstrerr(errno
));
384 err
= errorCon(ERR_WRITE_ERROR
, HTTP_BAD_GATEWAY
, fwd
->request
);
387 abortTransaction("I/O error while sending request body");
391 if (EBIT_TEST(entry
->flags
, ENTRY_ABORTED
)) {
392 abortTransaction("store entry aborted while sending request body");
396 if (!requestBodySource
->exhausted())
397 sendMoreRequestBody();
398 else if (receivedWholeRequestBody
)
399 doneSendingRequestBody();
401 debugs(9,3, HERE
<< "waiting for body production end or abort");
405 ServerStateData::sendMoreRequestBody()
407 assert(requestBodySource
!= NULL
);
408 assert(!requestSender
);
410 const Comm::ConnectionPointer conn
= dataDescriptor();
412 if (!Comm::IsConnOpen(conn
)) {
413 debugs(9,3, HERE
<< "cannot send request body to closing " << conn
);
414 return; // wait for the kid's close handler; TODO: assert(closer);
418 if (getMoreRequestBody(buf
) && buf
.contentSize() > 0) {
419 debugs(9,3, HERE
<< "will write " << buf
.contentSize() << " request body bytes");
420 typedef CommCbMemFunT
<ServerStateData
, CommIoCbParams
> Dialer
;
421 requestSender
= JobCallback(93,3, Dialer
, this, ServerStateData::sentRequestBody
);
422 comm_write_mbuf(conn
, &buf
, requestSender
);
424 debugs(9,3, HERE
<< "will wait for more request body bytes or eof");
425 requestSender
= NULL
;
429 /// either fill buf with available [encoded] request body bytes or return false
431 ServerStateData::getMoreRequestBody(MemBuf
&buf
)
433 // default implementation does not encode request body content
434 Must(requestBodySource
!= NULL
);
435 return requestBodySource
->getMoreData(buf
);
438 // Compares hosts in urls, returns false if different, no sheme, or no host.
440 sameUrlHosts(const char *url1
, const char *url2
)
442 // XXX: Want urlHostname() here, but it uses static storage and copying
443 const char *host1
= strchr(url1
, ':');
444 const char *host2
= strchr(url2
, ':');
446 if (host1
&& host2
) {
447 // skip scheme slashes
451 } while (*host1
== '/' && *host2
== '/');
454 return false; // no host
456 // increment while the same until we reach the end of the URL/host
457 while (*host1
&& *host1
!= '/' && *host1
== *host2
) {
461 return *host1
== *host2
;
464 return false; // no URL scheme
467 // purges entries that match the value of a given HTTP [response] header
469 purgeEntriesByHeader(HttpRequest
*req
, const char *reqUrl
, HttpMsg
*rep
, http_hdr_type hdr
)
471 const char *hdrUrl
, *absUrl
;
474 hdrUrl
= rep
->header
.getStr(hdr
);
475 if (hdrUrl
== NULL
) {
480 * If the URL is relative, make it absolute so we can find it.
481 * If it's absolute, make sure the host parts match to avoid DOS attacks
482 * as per RFC 2616 13.10.
484 if (urlIsRelative(hdrUrl
)) {
485 absUrl
= urlMakeAbsolute(req
, hdrUrl
);
486 if (absUrl
!= NULL
) {
489 } else if (!sameUrlHosts(reqUrl
, hdrUrl
)) {
493 purgeEntriesByUrl(req
, hdrUrl
);
495 if (absUrl
!= NULL
) {
500 // some HTTP methods should purge matching cache entries
502 ServerStateData::maybePurgeOthers()
504 // only some HTTP methods should purge matching cache entries
505 if (!request
->method
.purgesOthers())
508 // and probably only if the response was successful
509 if (theFinalReply
->sline
.status
>= 400)
512 // XXX: should we use originalRequest() here?
513 const char *reqUrl
= urlCanonical(request
);
514 debugs(88, 5, "maybe purging due to " << RequestMethodStr(request
->method
) << ' ' << reqUrl
);
515 purgeEntriesByUrl(request
, reqUrl
);
516 purgeEntriesByHeader(request
, reqUrl
, theFinalReply
, HDR_LOCATION
);
517 purgeEntriesByHeader(request
, reqUrl
, theFinalReply
, HDR_CONTENT_LOCATION
);
520 // called (usually by kids) when we have final (possibly adapted) reply headers
522 ServerStateData::haveParsedReplyHeaders()
529 ServerStateData::originalRequest()
535 /// Initiate an asynchronous adaptation transaction which will call us back.
537 ServerStateData::startAdaptation(const Adaptation::ServiceGroupPointer
&group
, HttpRequest
*cause
)
539 debugs(11, 5, "ServerStateData::startAdaptation() called");
540 // check whether we should be sending a body as well
541 // start body pipe to feed ICAP transaction if needed
542 assert(!virginBodyDestination
);
543 HttpReply
*vrep
= virginReply();
544 assert(!vrep
->body_pipe
);
546 if (vrep
->expectingBody(cause
->method
, size
) && size
) {
547 virginBodyDestination
= new BodyPipe(this);
548 vrep
->body_pipe
= virginBodyDestination
;
549 debugs(93, 6, HERE
<< "will send virgin reply body to " <<
550 virginBodyDestination
<< "; size: " << size
);
552 virginBodyDestination
->setBodySize(size
);
555 adaptedHeadSource
= initiateAdaptation(
556 new Adaptation::Iterator(vrep
, cause
, group
));
557 startedAdaptation
= initiated(adaptedHeadSource
);
558 Must(startedAdaptation
);
561 // properly cleans up ICAP-related state
562 // may be called multiple times
563 void ServerStateData::cleanAdaptation()
565 debugs(11,5, HERE
<< "cleaning ICAP; ACL: " << adaptationAccessCheckPending
);
567 if (virginBodyDestination
!= NULL
)
568 stopProducingFor(virginBodyDestination
, false);
570 announceInitiatorAbort(adaptedHeadSource
);
572 if (adaptedBodySource
!= NULL
)
573 stopConsumingFrom(adaptedBodySource
);
575 if (!adaptationAccessCheckPending
) // we cannot cancel a pending callback
576 assert(doneWithAdaptation()); // make sure the two methods are in sync
580 ServerStateData::doneWithAdaptation() const
582 return !adaptationAccessCheckPending
&&
583 !virginBodyDestination
&& !adaptedHeadSource
&& !adaptedBodySource
;
586 // sends virgin reply body to ICAP, buffering excesses if needed
588 ServerStateData::adaptVirginReplyBody(const char *data
, ssize_t len
)
590 assert(startedAdaptation
);
592 if (!virginBodyDestination
) {
593 debugs(11,3, HERE
<< "ICAP does not want more virgin body");
597 // grow overflow area if already overflowed
598 if (responseBodyBuffer
) {
599 responseBodyBuffer
->append(data
, len
);
600 data
= responseBodyBuffer
->content();
601 len
= responseBodyBuffer
->contentSize();
604 const ssize_t putSize
= virginBodyDestination
->putMoreData(data
, len
);
608 // if we had overflow area, shrink it as necessary
609 if (responseBodyBuffer
) {
610 if (putSize
== responseBodyBuffer
->contentSize()) {
611 delete responseBodyBuffer
;
612 responseBodyBuffer
= NULL
;
614 responseBodyBuffer
->consume(putSize
);
619 // if we did not have an overflow area, create it as needed
621 assert(!responseBodyBuffer
);
622 responseBodyBuffer
= new MemBuf
;
623 responseBodyBuffer
->init(4096, SQUID_TCP_SO_RCVBUF
* 10);
624 responseBodyBuffer
->append(data
, len
);
628 // can supply more virgin response body data
630 ServerStateData::noteMoreBodySpaceAvailable(BodyPipe::Pointer
)
632 if (responseBodyBuffer
) {
633 addVirginReplyBody(NULL
, 0); // kick the buffered fragment alive again
634 if (completed
&& !responseBodyBuffer
) {
639 maybeReadVirginBody();
642 // the consumer of our virgin response body aborted
644 ServerStateData::noteBodyConsumerAborted(BodyPipe::Pointer
)
646 stopProducingFor(virginBodyDestination
, false);
648 // do not force closeServer here in case we need to bypass AdaptationQueryAbort
650 if (doneWithAdaptation()) // we may still be receiving adapted response
651 handleAdaptationCompleted();
654 // received adapted response headers (body may follow)
656 ServerStateData::noteAdaptationAnswer(HttpMsg
*msg
)
658 clearAdaptation(adaptedHeadSource
); // we do not expect more messages
660 if (abortOnBadEntry("entry went bad while waiting for adapted headers"))
663 HttpReply
*rep
= dynamic_cast<HttpReply
*>(msg
);
665 debugs(11,5, HERE
<< this << " setting adapted reply to " << rep
);
668 assert(!adaptedBodySource
);
669 if (rep
->body_pipe
!= NULL
) {
670 // subscribe to receive adapted body
671 adaptedBodySource
= rep
->body_pipe
;
672 // assume that ICAP does not auto-consume on failures
673 assert(adaptedBodySource
->setConsumerIfNotLate(this));
676 if (doneWithAdaptation()) // we may still be sending virgin response
677 handleAdaptationCompleted();
681 // will not receive adapted response headers (and, hence, body)
683 ServerStateData::noteAdaptationQueryAbort(bool final
)
685 clearAdaptation(adaptedHeadSource
);
686 handleAdaptationAborted(!final
);
689 // more adapted response body is available
691 ServerStateData::handleMoreAdaptedBodyAvailable()
693 const size_t contentSize
= adaptedBodySource
->buf().contentSize();
695 debugs(11,5, HERE
<< "consuming " << contentSize
<< " bytes of adapted " <<
696 "response body at offset " << adaptedBodySource
->consumedSize());
698 if (abortOnBadEntry("entry refuses adapted body"))
702 BodyPipeCheckout
bpc(*adaptedBodySource
);
703 const StoreIOBuffer
ioBuf(&bpc
.buf
, currentOffset
);
704 currentOffset
+= bpc
.buf
.size
;
706 bpc
.buf
.consume(contentSize
);
710 // the entire adapted response body was produced, successfully
712 ServerStateData::handleAdaptedBodyProductionEnded()
714 stopConsumingFrom(adaptedBodySource
);
716 if (abortOnBadEntry("entry went bad while waiting for adapted body eof"))
719 handleAdaptationCompleted();
722 // premature end of the adapted response body
723 void ServerStateData::handleAdaptedBodyProducerAborted()
725 stopConsumingFrom(adaptedBodySource
);
726 handleAdaptationAborted();
729 // common part of noteAdaptationAnswer and handleAdaptedBodyProductionEnded
731 ServerStateData::handleAdaptationCompleted()
733 debugs(11,5, HERE
<< "handleAdaptationCompleted");
736 // We stop reading origin response because we have no place to put it and
737 // cannot use it. If some origin servers do not like that or if we want to
738 // reuse more pconns, we can add code to discard unneeded origin responses.
739 if (!doneWithServer()) {
740 debugs(11,3, HERE
<< "closing origin conn due to ICAP completion");
744 completeForwarding();
749 // common part of noteAdaptation*Aborted and noteBodyConsumerAborted methods
751 ServerStateData::handleAdaptationAborted(bool bypassable
)
753 debugs(11,5, HERE
<< "handleAdaptationAborted; bypassable: " << bypassable
<<
754 ", entry empty: " << entry
->isEmpty());
756 if (abortOnBadEntry("entry went bad while ICAP aborted"))
759 // TODO: bypass if possible
761 if (entry
->isEmpty()) {
762 debugs(11,9, HERE
<< "creating ICAP error entry after ICAP failure");
763 ErrorState
*err
= errorCon(ERR_ICAP_FAILURE
, HTTP_INTERNAL_SERVER_ERROR
, request
);
766 fwd
->dontRetry(true);
769 abortTransaction("ICAP failure");
773 ServerStateData::adaptationAclCheckDone(Adaptation::ServiceGroupPointer group
)
775 adaptationAccessCheckPending
= false;
777 if (abortOnBadEntry("entry went bad while waiting for ICAP ACL check"))
780 // TODO: Should nonICAP and postICAP path check this on the server-side?
781 // That check now only happens on client-side, in processReplyAccess().
782 if (virginReply()->expectedBodyTooLarge(*request
)) {
783 sendBodyIsTooLargeError();
786 // TODO: Should we check receivedBodyTooLarge on the server-side as well?
789 debugs(11,3, HERE
<< "no adapation needed");
790 setFinalReply(virginReply());
795 startAdaptation(group
, originalRequest());
800 ServerStateData::adaptationAclCheckDoneWrapper(Adaptation::ServiceGroupPointer group
, void *data
)
802 ServerStateData
*state
= (ServerStateData
*)data
;
803 state
->adaptationAclCheckDone(group
);
808 ServerStateData::sendBodyIsTooLargeError()
810 ErrorState
*err
= errorCon(ERR_TOO_BIG
, HTTP_FORBIDDEN
, request
);
813 fwd
->dontRetry(true);
814 abortTransaction("Virgin body too large.");
817 // TODO: when HttpStateData sends all errors to ICAP,
818 // we should be able to move this at the end of setVirginReply().
820 ServerStateData::adaptOrFinalizeReply()
823 // TODO: merge with client side and return void to hide the on/off logic?
824 // The callback can be called with a NULL service if adaptation is off.
825 adaptationAccessCheckPending
= Adaptation::AccessCheck::Start(
826 Adaptation::methodRespmod
, Adaptation::pointPreCache
,
827 request
, virginReply(), adaptationAclCheckDoneWrapper
, this);
828 debugs(11,5, HERE
<< "adaptationAccessCheckPending=" << adaptationAccessCheckPending
);
829 if (adaptationAccessCheckPending
)
833 setFinalReply(virginReply());
836 /// initializes bodyBytesRead stats if needed and applies delta
838 ServerStateData::adjustBodyBytesRead(const int64_t delta
)
840 int64_t &bodyBytesRead
= originalRequest()->hier
.bodyBytesRead
;
842 // if we got here, do not log a dash even if we got nothing from the server
843 if (bodyBytesRead
< 0)
846 bodyBytesRead
+= delta
; // supports negative and zero deltas
848 // check for overflows ("infinite" response?) and undeflows (a bug)
849 Must(bodyBytesRead
>= 0);
853 ServerStateData::addVirginReplyBody(const char *data
, ssize_t len
)
855 adjustBodyBytesRead(len
);
858 assert(!adaptationAccessCheckPending
); // or would need to buffer while waiting
859 if (startedAdaptation
) {
860 adaptVirginReplyBody(data
, len
);
864 storeReplyBody(data
, len
);
867 // writes virgin or adapted reply body to store
869 ServerStateData::storeReplyBody(const char *data
, ssize_t len
)
871 // write even if len is zero to push headers towards the client side
872 entry
->write (StoreIOBuffer(len
, currentOffset
, (char*)data
));
874 currentOffset
+= len
;
877 size_t ServerStateData::replyBodySpace(const MemBuf
&readBuf
,
878 const size_t minSpace
) const
880 size_t space
= readBuf
.spaceSize(); // available space w/o heroic measures
881 if (space
< minSpace
) {
882 const size_t maxSpace
= readBuf
.potentialSpaceSize(); // absolute best
883 space
= min(minSpace
, maxSpace
); // do not promise more than asked
887 if (responseBodyBuffer
) {
888 return 0; // Stop reading if already overflowed waiting for ICAP to catch up
891 if (virginBodyDestination
!= NULL
) {
893 * BodyPipe buffer has a finite size limit. We
894 * should not read more data from the network than will fit
895 * into the pipe buffer or we _lose_ what did not fit if
896 * the response ends sooner that BodyPipe frees up space:
897 * There is no code to keep pumping data into the pipe once
898 * response ends and serverComplete() is called.
900 * If the pipe is totally full, don't register the read handler.
901 * The BodyPipe will call our noteMoreBodySpaceAvailable() method
902 * when it has free space again.
904 size_t adaptation_space
=
905 virginBodyDestination
->buf().potentialSpaceSize();
907 debugs(11,9, "ServerStateData may read up to min(" <<
908 adaptation_space
<< ", " << space
<< ") bytes");
910 if (adaptation_space
< space
)
911 space
= adaptation_space
;