Public Types | Public Member Functions | Static Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | Private Member Functions | Private Attributes | List of all members
Client Class Referenceabstract

#include <Client.h>

Inheritance diagram for Client:
Inheritance graph
[legend]
Collaboration diagram for Client:
Collaboration graph
[legend]

Public Types

typedef CbcPointer< AsyncJob > Pointer
 
typedef CbcPointer< BodyProducer > Pointer
 
typedef CbcPointer< BodyConsumer > Pointer
 

Public Member Functions

 Client (FwdState *)
 
virtual ~Client ()
 
virtual const
Comm::ConnectionPointer & 		dataConnection () const =0
 
virtual void noteMoreBodyDataAvailable (BodyPipe::Pointer)
 
virtual void noteBodyProductionEnded (BodyPipe::Pointer)
 
virtual void noteBodyProducerAborted (BodyPipe::Pointer)
 
virtual void maybeReadVirginBody ()=0
 read response data from the network More...
 
virtual void abortAll (const char *reason)=0
 abnormal transaction termination; reason is for debugging only More...
 
virtual bool abortOnData (const char *reason)
 
virtual HttpRequestPointer originalRequest ()
 a hack to reach HttpStateData::orignal_request More...
 
virtual void noteAdaptationAnswer (const Adaptation::Answer &answer)
 
virtual void noteAdaptationAclCheckDone (Adaptation::ServiceGroupPointer group)
 
virtual void noteMoreBodySpaceAvailable (BodyPipe::Pointer)
 
virtual void noteBodyConsumerAborted (BodyPipe::Pointer)
 
virtual bool getMoreRequestBody (MemBuf &buf)
 either fill buf with available [encoded] request body bytes or return false More...
 
virtual void processReplyBody ()=0
 
virtual void swanSong ()
 
virtual bool doneAll () const
 whether positive goal has been reached More...
 
void serverComplete ()
 
bool canBeCalled (AsyncCall &call) const
 whether we can be called More...
 
void callStart (AsyncCall &call)
 
virtual void callEnd ()
 called right after the called job method More...
 
virtual void callException (const std::exception &e)
 called when the job throws during an async call More...
 
virtual void * toCbdata ()=0
 

Static Public Member Functions

static Pointer Start (AsyncJob *job)
 starts a freshly created job (i.e., makes the job asynchronous) More...
 

Public Attributes

StoreEntry * entry = nullptr
 
FwdState::Pointer fwd
 
HttpRequestPointer request
 

Protected Member Functions

virtual void haveParsedReplyHeaders ()
 called when we have final (possibly adapted) reply headers; kids extend More...
 
virtual void completeForwarding ()
 
bool startRequestBodyFlow ()
 
void handleMoreRequestBodyAvailable ()
 
void handleRequestBodyProductionEnded ()
 
virtual void handleRequestBodyProducerAborted ()=0
 
void sendMoreRequestBody ()
 
virtual void sentRequestBody (const CommIoCbParams &io)=0
 
virtual void doneSendingRequestBody ()=0
 
virtual void closeServer ()=0
 
virtual bool doneWithServer () const =0
 
virtual bool mayReadVirginReplyBody () const =0
 whether we may receive more virgin response body bytes More...
 
bool abortOnBadEntry (const char *abortReason)
 Entry-dependent callbacks use this check to quit if the entry went bad. More...
 
bool blockCaching ()
 whether to prevent caching of an otherwise cachable response More...
 
void startAdaptation (const Adaptation::ServiceGroupPointer &group, HttpRequest *cause)
 Initiate an asynchronous adaptation transaction which will call us back. More...
 
void adaptVirginReplyBody (const char *buf, ssize_t len)
 
void cleanAdaptation ()
 
virtual bool doneWithAdaptation () const
 
void handleMoreAdaptedBodyAvailable ()
 
void handleAdaptedBodyProductionEnded ()
 
void handleAdaptedBodyProducerAborted ()
 
void handleAdaptedHeader (Http::Message *msg)
 
void handleAdaptationCompleted ()
 
void handleAdaptationBlocked (const Adaptation::Answer &answer)
 
void handleAdaptationAborted (bool bypassable=false)
 
bool handledEarlyAdaptationAbort ()
 
void resumeBodyStorage ()
 called by StoreEntry when it has more buffer space available More...
 
void endAdaptedBodyConsumption ()
 called when the entire adapted response body is consumed More...
 
const HttpReply * virginReply () const
 
HttpReply * virginReply ()
 
HttpReply * setVirginReply (HttpReply *r)
 
HttpReply * finalReply ()
 
HttpReply * setFinalReply (HttpReply *r)
 
void adaptOrFinalizeReply ()
 
void addVirginReplyBody (const char *buf, ssize_t len)
 
void storeReplyBody (const char *buf, ssize_t len)
 
size_t replyBodySpace (const MemBuf &readBuf, const size_t minSpace) const
 
size_t calcBufferSpaceToReserve (const size_t space, const size_t wantSpace) const
 determine how much space the buffer needs to reserve More...
 
void adjustBodyBytesRead (const int64_t delta)
 initializes bodyBytesRead stats if needed and applies delta More...
 
CbcPointer< Initiate > initiateAdaptation (Initiate *x)
 < starts freshly created initiate and returns a safe pointer to it More...
 
void clearAdaptation (CbcPointer< Initiate > &x)
 clears the pointer (does not call announceInitiatorAbort) More...
 
void announceInitiatorAbort (CbcPointer< Initiate > &x)
 inform the transaction about abnormal termination and clear the pointer More...
 
bool initiated (const CbcPointer< AsyncJob > &job) const
 Must(initiated(initiate)) instead of Must(initiate.set()), for clarity. More...
 
void deleteThis (const char *aReason)
 
void mustStop (const char *aReason)
 
bool done () const
 the job is destroyed in callEnd() when done() More...
 
virtual void start ()
 called by AsyncStart; do not call directly More...
 
virtual const char * status () const
 internal cleanup; do not call directly More...
 
void stopProducingFor (RefCount< BodyPipe > &, bool atEof)
 
void stopConsumingFrom (RefCount< BodyPipe > &)
 

Protected Attributes

int64_t currentOffset = 0
 
MemBuf * responseBodyBuffer = nullptr
 
BodyPipe::Pointer requestBodySource
 
AsyncCall::Pointer requestSender
 
BodyPipe::Pointer virginBodyDestination
 
CbcPointer< Adaptation::Initiate > adaptedHeadSource
 
BodyPipe::Pointer adaptedBodySource
 
bool adaptationAccessCheckPending = false
 
bool startedAdaptation = false
 
bool receivedWholeRequestBody = false
 handleRequestBodyProductionEnded called More...
 
const char * doneWithFwd = nullptr
 
const char * stopReason
 reason for forcing done() to be true More...
 
const char * typeName
 kid (leaf) class name, for debugging More...
 
AsyncCall::Pointer inCall
 the asynchronous call being handled, if any More...
 
const InstanceId< AsyncJob > id
 job identifier More...
 

Private Member Functions

void serverComplete2 ()
 
void sendBodyIsTooLargeError ()
 
void maybePurgeOthers ()
 

Private Attributes

bool completed = false
 
HttpReply * theVirginReply = nullptr
 
HttpReply * theFinalReply = nullptr
 

Detailed Description

Client is a common base for classes such as HttpStateData and FtpStateData. All such classes must be able to consume request bodies from a BodyPipe or ICAP producer, adapt virgin responses using ICAP, and provide a consumer with responses.

Definition at line 29 of file Client.h.

Member Typedef Documentation

typedef CbcPointer<BodyProducer> BodyProducer::Pointer
inherited

Definition at line 25 of file BodyPipe.h.

typedef CbcPointer<AsyncJob> AsyncJob::Pointer
inherited

Definition at line 34 of file AsyncJob.h.

typedef CbcPointer<BodyConsumer> BodyConsumer::Pointer
inherited

Definition at line 45 of file BodyPipe.h.

Constructor & Destructor Documentation

Client::Client ( FwdState *  theFwdState)

Definition at line 39 of file Client.cc.

References FwdState::entry, entry, fwd, and StoreEntry::lock().

Client::~Client ( )
virtual

Reimplemented in Ftp::Client.

Definition at line 48 of file Client.cc.

References adaptedBodySource, assert, entry, HTTPMSGUNLOCK(), NULL, requestBodySource, responseBodyBuffer, theFinalReply, theVirginReply, StoreEntry::unlock(), and virginBodyDestination.

Member Function Documentation

virtual void Client::abortAll ( const char *  reason)
pure virtual

Implemented in Ftp::Client, and HttpStateData.

Referenced by abortOnData(), handleAdaptationAborted(), handleAdaptationBlocked(), and handledEarlyAdaptationAbort().

bool Client::abortOnBadEntry ( const char *  abortReason)
protected

Definition at line 234 of file Client.cc.

References abortOnData(), debugs, entry, HERE(), and StoreEntry::isAccepting().

Referenced by handleAdaptationAborted(), handleAdaptationBlocked(), handleAdaptedBodyProducerAborted(), handleAdaptedBodyProductionEnded(), handleAdaptedHeader(), handleMoreAdaptedBodyAvailable(), noteAdaptationAclCheckDone(), and resumeBodyStorage().

bool Client::abortOnData ( const char *  reason)
virtual

abnormal data transfer termination

Return values
truethe transaction will be terminated (abortAll called)
falsethe transaction will survive

Reimplemented in Ftp::Relay.

Definition at line 287 of file Client.cc.

References abortAll().

Referenced by abortOnBadEntry(), handleAdaptationBlocked(), sendBodyIsTooLargeError(), and sentRequestBody().

void Client::adaptOrFinalizeReply ( )
protected

Definition at line 944 of file Client.cc.

References adaptationAccessCheckPending, FwdState::al, debugs, fwd, HERE(), Adaptation::methodRespmod, originalRequest(), Adaptation::pointPreCache, setFinalReply(), Adaptation::AccessCheck::Start(), and virginReply().

Referenced by HttpStateData::processReply().

void Client::adaptVirginReplyBody ( const char *  buf,
ssize_t  len 
)
protected

Definition at line 594 of file Client.cc.

References MemBuf::append(), assert, MemBuf::consume(), MemBuf::content(), MemBuf::contentSize(), debugs, HERE(), MemBuf::init(), NULL, BodyPipe::putMoreData(), responseBodyBuffer, startedAdaptation, and virginBodyDestination.

Referenced by addVirginReplyBody().

void Client::addVirginReplyBody ( const char *  buf,
ssize_t  len 
)
protected

Definition at line 977 of file Client.cc.

References adaptationAccessCheckPending, adaptVirginReplyBody(), adjustBodyBytesRead(), assert, startedAdaptation, and storeReplyBody().

Referenced by HttpStateData::decodeAndWriteReplyBody(), noteMoreBodySpaceAvailable(), and HttpStateData::writeReplyBody().

void Client::adjustBodyBytesRead ( const int64_t  delta)
protected

Definition at line 962 of file Client.cc.

References HierarchyLogEntry::bodyBytesRead, HttpRequest::hier, Must, and originalRequest().

Referenced by addVirginReplyBody().

void Adaptation::Initiator::announceInitiatorAbort ( CbcPointer< Initiate > &  x)
protectedinherited

Definition at line 38 of file Initiator.cc.

References CallJobHere.

Referenced by cleanAdaptation(), and ClientHttpRequest::~ClientHttpRequest().

bool Client::blockCaching ( )
protected

Definition at line 518 of file Client.cc.

References SquidConfig::accessList, allow_t::allowed(), Config, debugs, entry, ACLChecklist::fastCheck(), StoreEntry::getReply(), HTTPMSGLOCK(), originalRequest(), ACLFilledChecklist::reply, and SquidConfig::storeMiss.

Referenced by setFinalReply().

size_t Client::calcBufferSpaceToReserve ( const size_t  space,
const size_t  wantSpace 
) const
protected

Definition at line 1002 of file Client.cc.

References BodyPipe::buf(), debugs, SBuf::maxSize, min(), NULL, MemBuf::potentialSpaceSize(), responseBodyBuffer, and virginBodyDestination.

Referenced by HttpStateData::maybeMakeSpaceAvailable().

void AsyncJob::callEnd ( )
virtualinherited

called right after the called job method

Reimplemented in Adaptation::Icap::Xaction.

Definition at line 136 of file AsyncJob.cc.

References AsyncCall::debugLevel, debugs, AsyncCall::debugSection, AsyncJob::done(), HERE(), AsyncJob::inCall, NULL, AsyncJob::status(), AsyncJob::swanSong(), and AsyncJob::typeName.

Referenced by Adaptation::Icap::Xaction::callEnd(), and AsyncJob::deleteThis().

void AsyncJob::callException ( const std::exception &  e)
virtualinherited

Reimplemented in ClientHttpRequest, Adaptation::Icap::ModXact, Adaptation::Icap::Xaction, Adaptation::Icap::ServiceRep, Ftp::Server, Ipc::Forwarder, and Ipc::Inquirer.

Definition at line 127 of file AsyncJob.cc.

References cbdataReferenceValid(), debugs, Must, AsyncJob::mustStop(), and CbdataParent::toCbdata().

Referenced by Ipc::Inquirer::callException(), Ipc::Forwarder::callException(), Ftp::Server::callException(), and Adaptation::Icap::Xaction::callException().

void AsyncJob::callStart ( AsyncCall &  call)
inherited

called just before the called method

Definition at line 114 of file AsyncJob.cc.

References cbdataReferenceValid(), AsyncCall::debugLevel, debugs, AsyncCall::debugSection, AsyncJob::inCall, Must, AsyncJob::status(), CbdataParent::toCbdata(), and AsyncJob::typeName.

bool AsyncJob::canBeCalled ( AsyncCall &  call) const
inherited

Definition at line 101 of file AsyncJob.cc.

References AsyncCall::cancel(), debugs, HERE(), AsyncJob::inCall, and NULL.

void Client::cleanAdaptation ( )
protected

Definition at line 569 of file Client.cc.

References adaptationAccessCheckPending, adaptedBodySource, adaptedHeadSource, Adaptation::Initiator::announceInitiatorAbort(), assert, debugs, doneWithAdaptation(), HERE(), NULL, BodyConsumer::stopConsumingFrom(), BodyProducer::stopProducingFor(), and virginBodyDestination.

Referenced by handleAdaptationCompleted(), and swanSong().

void Adaptation::Initiator::clearAdaptation ( CbcPointer< Initiate > &  x)
protectedinherited

Definition at line 32 of file Initiator.cc.

References CbcPointer< Cbc >::clear().

Referenced by ClientHttpRequest::handleAdaptedHeader(), noteAdaptationAnswer(), and ClientHttpRequest::noteAdaptationAnswer().

virtual void Client::closeServer ( )
protectedpure virtual

Use this to end communication with the server. The call cancels our closure handler and tells FwdState to forget about the connection.

Implemented in Ftp::Client, and HttpStateData.

Referenced by handleAdaptationCompleted(), serverComplete(), and swanSong().

void Client::completeForwarding ( )
protectedvirtual

default calls fwd->complete()

Reimplemented in Ftp::Gateway, and Ftp::Relay.

Definition at line 206 of file Client.cc.

References assert, FwdState::complete(), debugs, doneWithFwd, fwd, HERE(), and NULL.

Referenced by Ftp::Relay::completeForwarding(), Ftp::Gateway::completeForwarding(), handleAdaptationCompleted(), and serverComplete2().

virtual const Comm::ConnectionPointer& Client::dataConnection ( ) const
pure virtual
Returns
primary or "request data connection"

Implemented in Ftp::Client, and HttpStateData.

Referenced by sendMoreRequestBody().

void AsyncJob::deleteThis ( const char *  aReason)
protectedinherited

Definition at line 49 of file AsyncJob.cc.

References asyncCall(), AsyncJob::callEnd(), debugs, AsyncJob::inCall, JobMemFun(), Must, NULL, AsyncJob::stopReason, and AsyncJob::typeName.

Referenced by ConnStateData::connStateClosed().

bool AsyncJob::done ( ) const
protectedinherited

Definition at line 90 of file AsyncJob.cc.

References AsyncJob::doneAll(), NULL, and AsyncJob::stopReason.

Referenced by AsyncJob::callEnd(), and Downloader::downloadFinished().

bool Client::doneAll ( ) const
virtual

Reimplemented from AsyncJob.

Definition at line 193 of file Client.cc.

References AsyncJob::doneAll(), doneWithAdaptation(), and doneWithServer().

void Client::doneSendingRequestBody ( )
protectedpure virtual

Implemented in Ftp::Client, and HttpStateData.

Definition at line 316 of file Client.cc.

References assert, debugs, HERE(), NULL, requestBodySource, and BodyConsumer::stopConsumingFrom().

Referenced by HttpStateData::doneSendingRequestBody(), Ftp::Client::doneSendingRequestBody(), handleRequestBodyProductionEnded(), and sentRequestBody().

bool Client::doneWithAdaptation ( ) const
protectedvirtual

did we end ICAP communication?

Definition at line 586 of file Client.cc.

References adaptationAccessCheckPending, adaptedBodySource, adaptedHeadSource, and virginBodyDestination.

Referenced by cleanAdaptation(), doneAll(), handleAdaptedHeader(), noteBodyConsumerAborted(), and serverComplete2().

virtual bool Client::doneWithServer ( ) const
protectedpure virtual

did we end communication?

Implemented in Ftp::Client, and HttpStateData.

Referenced by doneAll(), serverComplete(), and swanSong().

void Client::endAdaptedBodyConsumption ( )
protected

Definition at line 791 of file Client.cc.

References adaptedBodySource, handleAdaptationCompleted(), and BodyConsumer::stopConsumingFrom().

Referenced by handleAdaptedBodyProductionEnded(), and resumeBodyStorage().

HttpReply * Client::finalReply ( )
protected

Definition at line 128 of file Client.cc.

References assert, and theFinalReply.

Referenced by HttpStateData::haveParsedReplyHeaders(), and HttpStateData::reusableReply().

bool Client::getMoreRequestBody ( MemBuf &  buf)
virtual

Reimplemented in HttpStateData.

Definition at line 414 of file Client.cc.

References BodyPipe::getMoreData(), Must, NULL, and requestBodySource.

Referenced by HttpStateData::getMoreRequestBody(), and sendMoreRequestBody().

void Client::handleAdaptationAborted ( bool  bypassable = false)
protected

Definition at line 839 of file Client.cc.

References abortAll(), abortOnBadEntry(), debugs, entry, handledEarlyAdaptationAbort(), HERE(), and StoreEntry::isEmpty().

Referenced by noteAdaptationAnswer().

void Client::handleAdaptationBlocked ( const Adaptation::Answer &  answer)
protected

Definition at line 875 of file Client.cc.

References abortAll(), abortOnBadEntry(), abortOnData(), aclGetDenyInfoPage(), Config, debugs, SquidConfig::denyInfoList, HttpRequest::detailError(), ErrorState::detailError(), FwdState::dontRetry(), entry, ERR_ACCESS_DENIED, ERR_DETAIL_RESPMOD_BLOCK_EARLY, ERR_DETAIL_RESPMOD_BLOCK_LATE, ERR_ICAP_FAILURE, ERR_NONE, FwdState::fail(), fwd, RefCount< C >::getRaw(), HERE(), StoreEntry::isEmpty(), request, Adaptation::Answer::ruleId, Http::scForbidden, and String::termedBuf().

Referenced by noteAdaptationAnswer().

void Client::handleAdaptationCompleted ( )
protected

Definition at line 820 of file Client.cc.

References cleanAdaptation(), closeServer(), completeForwarding(), debugs, HERE(), and mayReadVirginReplyBody().

Referenced by endAdaptedBodyConsumption(), handleAdaptedBodyProducerAborted(), handleAdaptedHeader(), and noteBodyConsumerAborted().

void Client::handleAdaptedBodyProducerAborted ( )
protected

Definition at line 798 of file Client.cc.

References abortOnBadEntry(), adaptedBodySource, debugs, entry, BodyPipe::exhausted(), handleAdaptationCompleted(), handledEarlyAdaptationAbort(), StoreEntry::lengthWentBad(), Must, and BodyConsumer::stopConsumingFrom().

Referenced by noteBodyProducerAborted().

void Client::handleAdaptedBodyProductionEnded ( )
protected

Definition at line 779 of file Client.cc.

References abortOnBadEntry(), adaptedBodySource, endAdaptedBodyConsumption(), BodyPipe::exhausted(), and NULL.

Referenced by noteBodyProductionEnded().

void Client::handleAdaptedHeader ( Http::Message *  msg)
protected

Definition at line 682 of file Client.cc.

References abortOnBadEntry(), adaptedBodySource, assert, Http::Message::body_pipe, debugs, doneWithAdaptation(), BodyPipe::expectNoConsumption(), handleAdaptationCompleted(), HERE(), NULL, BodyPipe::setConsumerIfNotLate(), and setFinalReply().

Referenced by noteAdaptationAnswer().

bool Client::handledEarlyAdaptationAbort ( )
protected

If the store entry is still empty, fully handles adaptation abort, returning true. Otherwise just updates the request error detail and returns false.

Definition at line 855 of file Client.cc.

References abortAll(), debugs, HttpRequest::detailError(), ErrorState::detailError(), FwdState::dontRetry(), entry, ERR_DETAIL_ICAP_RESPMOD_EARLY, ERR_DETAIL_ICAP_RESPMOD_LATE, ERR_ICAP_FAILURE, FwdState::fail(), fwd, RefCount< C >::getRaw(), StoreEntry::isEmpty(), request, and Http::scInternalServerError.

Referenced by handleAdaptationAborted(), and handleAdaptedBodyProducerAborted().

void Client::handleMoreAdaptedBodyAvailable ( )
protected

Definition at line 732 of file Client.cc.

References abortOnBadEntry(), adaptedBodySource, assert, asyncCall(), BodyPipe::buf(), StoreEntry::bytesWanted(), BodyPipe::consumedSize(), MemBuf::contentSize(), currentOffset, debugs, StoreEntry::deferProducer(), entry, HERE(), StoreIOBuffer::length, resumeBodyStorage(), and StoreEntry::write().

Referenced by noteMoreBodyDataAvailable(), and resumeBodyStorage().

void Client::handleMoreRequestBodyAvailable ( )
protected

Definition at line 295 of file Client.cc.

References debugs, HERE(), requestSender, and sendMoreRequestBody().

Referenced by noteMoreBodyDataAvailable().

void Client::handleRequestBodyProducerAborted ( )
protectedpure virtual

Implemented in Ftp::Gateway, HttpStateData, and Ftp::Relay.

Definition at line 327 of file Client.cc.

References debugs, FwdState::dontRetry(), fwd, HERE(), NULL, requestBodySource, requestSender, and BodyConsumer::stopConsumingFrom().

Referenced by Ftp::Relay::handleRequestBodyProducerAborted(), HttpStateData::handleRequestBodyProducerAborted(), Ftp::Gateway::handleRequestBodyProducerAborted(), and noteBodyProducerAborted().

void Client::handleRequestBodyProductionEnded ( )
protected

Definition at line 305 of file Client.cc.

References debugs, doneSendingRequestBody(), HERE(), receivedWholeRequestBody, and requestSender.

Referenced by noteBodyProductionEnded().

void Client::haveParsedReplyHeaders ( )
protectedvirtual

called when got final headers

Reimplemented in Ftp::Gateway, and HttpStateData.

Definition at line 506 of file Client.cc.

References HttpReply::contentRange(), currentOffset, maybePurgeOthers(), Must, HttpHdrRangeSpec::offset, HttpHdrContRange::spec, and theFinalReply.

Referenced by HttpStateData::haveParsedReplyHeaders(), Ftp::Gateway::haveParsedReplyHeaders(), and setFinalReply().

CbcPointer< Adaptation::Initiate > Adaptation::Initiator::initiateAdaptation ( Initiate *  x)
protectedinherited

Definition at line 23 of file Initiator.cc.

References i, Adaptation::Initiate::initiator(), and Ident::Start().

Referenced by startAdaptation(), and ClientHttpRequest::startAdaptation().

bool Adaptation::Initiator::initiated ( const CbcPointer< AsyncJob > &  job) const
inlineprotectedinherited

Definition at line 52 of file Initiator.h.

References CbcPointer< Cbc >::set().

Referenced by startAdaptation(), and ClientHttpRequest::startAdaptation().

void Client::maybePurgeOthers ( )
private

Definition at line 485 of file Client.cc.

References SBuf::c_str(), Http::CONTENT_LOCATION, debugs, HttpRequest::effectiveRequestUri(), RefCount< C >::getRaw(), Http::LOCATION, HttpRequest::method, purgeEntriesByHeader(), purgeEntriesByUrl(), HttpRequestMethod::purgesOthers(), request, HttpReply::sline, Http::StatusLine::status(), and theFinalReply.

Referenced by haveParsedReplyHeaders().

virtual void Client::maybeReadVirginBody ( )
pure virtual

Implemented in Ftp::Client, and HttpStateData.

Referenced by noteMoreBodySpaceAvailable().

virtual bool Client::mayReadVirginReplyBody ( ) const
protectedpure virtual

Implemented in Ftp::Gateway, HttpStateData, and Ftp::Relay.

Referenced by handleAdaptationCompleted().

void AsyncJob::mustStop ( const char *  aReason)
protectedinherited

Definition at line 69 of file AsyncJob.cc.

References debugs, AsyncJob::inCall, Must, NULL, AsyncJob::stopReason, and AsyncJob::typeName.

Referenced by HttpStateData::abortAll(), AsyncJob::callException(), HttpStateData::continueAfterParsingHeader(), HttpStateData::handleMoreRequestBodyAvailable(), HttpStateData::httpStateConnClosed(), HttpStateData::httpTimeout(), Comm::ConnOpener::noteAbort(), ConnStateData::proxyProtocolError(), HttpStateData::readReply(), HttpStateData::start(), and HttpStateData::wroteLast().

void Client::noteAdaptationAclCheckDone ( Adaptation::ServiceGroupPointer  group)
virtual

AccessCheck calls this back with a possibly nil service group to signal whether adaptation is needed and where it should start.

Reimplemented from Adaptation::Initiator.

Definition at line 905 of file Client.cc.

References abortOnBadEntry(), adaptationAccessCheckPending, debugs, HERE(), originalRequest(), processReplyBody(), request, sendBodyIsTooLargeError(), setFinalReply(), startAdaptation(), and virginReply().

void Client::noteAdaptationAnswer ( const Adaptation::Answer &  answer)
virtual

called with the initial adaptation decision (adapt, block, error); virgin and/or adapted body transmission may continue after this

Implements Adaptation::Initiator.

Definition at line 662 of file Client.cc.

References adaptedHeadSource, Adaptation::Answer::akBlock, Adaptation::Answer::akError, Adaptation::Answer::akForward, Adaptation::Initiator::clearAdaptation(), Adaptation::Answer::final, RefCount< C >::getRaw(), handleAdaptationAborted(), handleAdaptationBlocked(), handleAdaptedHeader(), Adaptation::Answer::kind, and Adaptation::Answer::message.

void Client::noteBodyConsumerAborted ( BodyPipe::Pointer  )
virtual

Implements BodyProducer.

Definition at line 650 of file Client.cc.

References doneWithAdaptation(), handleAdaptationCompleted(), BodyProducer::stopProducingFor(), and virginBodyDestination.

void Client::noteBodyProducerAborted ( BodyPipe::Pointer  bp)
virtual

Implements BodyConsumer.

Definition at line 274 of file Client.cc.

References adaptedBodySource, handleAdaptedBodyProducerAborted(), handleRequestBodyProducerAborted(), and requestBodySource.

void Client::noteBodyProductionEnded ( BodyPipe::Pointer  bp)
virtual

Implements BodyConsumer.

Definition at line 260 of file Client.cc.

References adaptedBodySource, handleAdaptedBodyProductionEnded(), handleRequestBodyProductionEnded(), and requestBodySource.

void Client::noteMoreBodyDataAvailable ( BodyPipe::Pointer  bp)
virtual

Implements BodyConsumer.

Definition at line 246 of file Client.cc.

References adaptedBodySource, handleMoreAdaptedBodyAvailable(), handleMoreRequestBodyAvailable(), and requestBodySource.

void Client::noteMoreBodySpaceAvailable ( BodyPipe::Pointer  )
virtual

Implements BodyProducer.

Definition at line 636 of file Client.cc.

References addVirginReplyBody(), completed, maybeReadVirginBody(), NULL, responseBodyBuffer, and serverComplete2().

HttpRequestPointer Client::originalRequest ( )
virtual

Definition at line 535 of file Client.cc.

References request.

Referenced by adaptOrFinalizeReply(), adjustBodyBytesRead(), blockCaching(), HttpStateData::finishingBrokenPost(), HttpStateData::handle1xx(), noteAdaptationAclCheckDone(), serverComplete(), and startRequestBodyFlow().

virtual void Client::processReplyBody ( )
pure virtual

Implemented in Ftp::Gateway, HttpStateData, and Ftp::Relay.

Referenced by noteAdaptationAclCheckDone().

size_t Client::replyBodySpace ( const MemBuf &  readBuf,
const size_t  minSpace 
) const
protected
Deprecated:
use SBuf I/O API and calcBufferSpaceToReserve() instead

Definition at line 1037 of file Client.cc.

References BodyPipe::buf(), debugs, min(), NULL, MemBuf::potentialSpaceSize(), responseBodyBuffer, MemBuf::spaceSize(), and virginBodyDestination.

void Client::resumeBodyStorage ( )
protected

Definition at line 716 of file Client.cc.

References abortOnBadEntry(), adaptedBodySource, endAdaptedBodyConsumption(), BodyPipe::exhausted(), handleMoreAdaptedBodyAvailable(), and NULL.

Referenced by handleMoreAdaptedBodyAvailable().

void Client::sendBodyIsTooLargeError ( )
private

Definition at line 933 of file Client.cc.

References abortOnData(), FwdState::dontRetry(), ERR_TOO_BIG, FwdState::fail(), fwd, RefCount< C >::getRaw(), request, and Http::scForbidden.

Referenced by noteAdaptationAclCheckDone().

void Client::sendMoreRequestBody ( )
protected

Definition at line 388 of file Client.cc.

References assert, buf, conn, MemBuf::contentSize(), dataConnection(), debugs, getMoreRequestBody(), HERE(), Comm::IsConnOpen(), JobCallback, NULL, requestBodySource, requestSender, sentRequestBody(), and Comm::Write().

Referenced by handleMoreRequestBodyAvailable(), and sentRequestBody().

void Client::sentRequestBody ( const CommIoCbParams &  io)
protectedpure virtual

Implemented in Ftp::Client, and HttpStateData.

Definition at line 340 of file Client.cc.

References abortOnData(), StatCounters::all, DBG_IMPORTANT, debugs, doneSendingRequestBody(), EBIT_TEST, entry, ENTRY_ABORTED, Comm::ERR_CLOSING, ERR_WRITE_ERROR, BodyPipe::exhausted(), FwdState::fail(), CommCommonCbParams::fd, fd_bytes(), FD_WRITE, CommCommonCbParams::flag, StoreEntry::flags, fwd, HERE(), HttpRequest::hier, HierarchyLogEntry::notePeerWrite(), NULL, receivedWholeRequestBody, FwdState::request, request, requestBodySource, requestSender, Http::scBadGateway, sendMoreRequestBody(), StatCounters::server, CommIoCbParams::size, statCounter, CommCommonCbParams::xerrno, ErrorState::xerrno, and xstrerr().

Referenced by sendMoreRequestBody(), HttpStateData::sentRequestBody(), and Ftp::Client::sentRequestBody().

void Client::serverComplete ( )

call when no server communication is expected

Definition at line 156 of file Client.cc.

References assert, closeServer(), completed, debugs, doneWithServer(), HERE(), HttpRequest::hier, NULL, originalRequest(), requestBodySource, responseBodyBuffer, serverComplete2(), BodyConsumer::stopConsumingFrom(), and HierarchyLogEntry::stopPeerClock().

Referenced by ftpReadQuit(), HttpStateData::processReplyBody(), and Ftp::Relay::serverComplete().

void Client::serverComplete2 ( )
private

Continuation of serverComplete

Definition at line 178 of file Client.cc.

References completeForwarding(), debugs, doneWithAdaptation(), HERE(), NULL, BodyProducer::stopProducingFor(), and virginBodyDestination.

Referenced by noteMoreBodySpaceAvailable(), and serverComplete().

HttpReply * Client::setFinalReply ( HttpReply *  r)
protected

Definition at line 135 of file Client.cc.

References assert, blockCaching(), debugs, EBIT_TEST, entry, StoreEntry::flags, haveParsedReplyHeaders(), HERE(), HTTPMSGLOCK(), StoreEntry::release(), RELEASE_REQUEST, StoreEntry::replaceHttpReply(), StoreEntry::startWriting(), and theFinalReply.

Referenced by adaptOrFinalizeReply(), handleAdaptedHeader(), and noteAdaptationAclCheckDone().

HttpReply * Client::setVirginReply ( HttpReply *  r)
protected

Definition at line 117 of file Client.cc.

References assert, debugs, HERE(), HTTPMSGLOCK(), and theVirginReply.

Referenced by HttpStateData::processReplyHeader().

AsyncJob::Pointer AsyncJob::Start ( AsyncJob *  job)
staticinherited

Definition at line 23 of file AsyncJob.cc.

References CallJobHere, and AsyncJob::start().

Referenced by Ftp::Server::AcceptCtrlConnection(), Ftp::Server::checkDataConnPre(), clientListenerConnectionOpened(), Ftp::Client::connectDataChannel(), FwdState::connectDone(), FwdState::connectStart(), TunnelStateData::connectToPeer(), Adaptation::Icap::Xaction::dnsLookupDone(), Log::TcpLogger::doConnect(), Ipc::Coordinator::handleCacheMgrRequest(), PeerPoolMgr::handleOpenedConnection(), Ipc::Coordinator::handleSnmpRequest(), httpAccept(), httpsAccept(), httpStart(), idnsInitVC(), Ftp::Gateway::listenForDataChannel(), Ftp::Server::listenForDataConnection(), Adaptation::Icap::Xaction::noteCommConnected(), Log::TcpLogger::Open(), PeerPoolMgr::openNewConnection(), peerProbeConnect(), Rock::SwapDir::rebuild(), Mgr::FunAction::respond(), Mgr::InfoAction::respond(), Ipc::SendMessage(), Mgr::Inquirer::sendResponse(), snmpConstructReponse(), SquidMain(), Ident::Start(), Adaptation::AccessCheck::Start(), CacheManager::Start(), Security::PeerConnector::startCertDownloading(), TunnelStateData::startConnecting(), Ftp::StartGateway(), Ftp::StartRelay(), PeerPoolMgrsRr::syncConfig(), and Rock::SwapDir::updateHeaders().

void AsyncJob::start ( )
protectedvirtualinherited

Reimplemented in ConnStateData, Adaptation::Icap::ModXact, Ftp::Client, Ftp::Gateway, Ftp::Server, HttpStateData, Security::PeerConnector, Adaptation::Ecap::XactionRep, Ipc::UdsSender, Adaptation::AccessCheck, Adaptation::Icap::Launcher, Downloader, Adaptation::Icap::Xaction, Ftp::Relay, Log::TcpLogger, Adaptation::Iterator, Comm::TcpAcceptor, Ipc::Coordinator, Ipc::Forwarder, Comm::ConnOpener, Ipc::Inquirer, Http::One::Server, Rock::HeaderUpdater, Mgr::StoreToCommWriter, Rock::Rebuild, Mgr::Inquirer, PeerPoolMgr, Server, Snmp::Inquirer, Ipc::Strand, Adaptation::Icap::OptXact, Ipc::Port, Mgr::ActionWriter, and Mgr::Filler.

Definition at line 43 of file AsyncJob.cc.

Referenced by Ipc::Port::start(), PeerPoolMgr::start(), AsyncJob::Start(), Adaptation::Iterator::start(), Adaptation::Icap::Xaction::start(), Adaptation::Icap::Launcher::start(), Adaptation::AccessCheck::start(), Ipc::UdsSender::start(), Security::PeerConnector::start(), and ConnStateData::start().

void Client::startAdaptation ( const Adaptation::ServiceGroupPointer &  group,
HttpRequest *  cause 
)
protected

Definition at line 543 of file Client.cc.

References adaptedHeadSource, FwdState::al, assert, Http::Message::body_pipe, debugs, HttpReply::expectingBody(), fwd, HERE(), Adaptation::Initiator::initiateAdaptation(), Adaptation::Initiator::initiated(), HttpRequest::method, Must, BodyPipe::setBodySize(), size, startedAdaptation, virginBodyDestination, and virginReply().

Referenced by noteAdaptationAclCheckDone().

bool Client::startRequestBodyFlow ( )
protected

Definition at line 215 of file Client.cc.

References assert, Http::Message::body_pipe, debugs, HERE(), NULL, originalRequest(), requestBodySource, BodyPipe::setConsumerIfNotLate(), and BodyPipe::status().

Referenced by HttpStateData::sendRequest().

const char * AsyncJob::status ( ) const
protectedvirtualinherited

for debugging, starts with space

Reimplemented in Adaptation::Icap::ServiceRep, Adaptation::Icap::Xaction, Security::PeerConnector, Adaptation::Ecap::XactionRep, Adaptation::Initiate, Comm::TcpAcceptor, and Ipc::Inquirer.

Definition at line 159 of file AsyncJob.cc.

References MemBuf::append(), Packable::appendf(), buf, MemBuf::content(), NULL, MemBuf::reset(), AsyncJob::stopReason, and MemBuf::terminate().

Referenced by AsyncJob::callEnd(), AsyncJob::callStart(), Comm::TcpAcceptor::status(), and Adaptation::Initiate::status().

void BodyConsumer::stopConsumingFrom ( RefCount< BodyPipe > &  p)
protectedinherited

Definition at line 118 of file BodyPipe.cc.

References assert, BodyPipe::clearConsumer(), debugs, and NULL.

Referenced by cleanAdaptation(), doneSendingRequestBody(), endAdaptedBodyConsumption(), ClientHttpRequest::endRequestSatisfaction(), handleAdaptedBodyProducerAborted(), handleRequestBodyProducerAborted(), BodySink::noteBodyProducerAborted(), ClientHttpRequest::noteBodyProducerAborted(), BodySink::noteBodyProductionEnded(), serverComplete(), swanSong(), and ClientHttpRequest::~ClientHttpRequest().

void BodyProducer::stopProducingFor ( RefCount< BodyPipe > &  p,
bool  atEof 
)
protectedinherited

Definition at line 107 of file BodyPipe.cc.

References assert, BodyPipe::clearProducer(), debugs, and NULL.

Referenced by cleanAdaptation(), ConnStateData::finishDechunkingRequest(), noteBodyConsumerAborted(), serverComplete2(), and ConnStateData::~ConnStateData().

void Client::storeReplyBody ( const char *  buf,
ssize_t  len 
)
protected

Definition at line 993 of file Client.cc.

References currentOffset, entry, len, and StoreEntry::write().

Referenced by addVirginReplyBody().

void Client::swanSong ( )
virtual

Reimplemented from AsyncJob.

Reimplemented in Ftp::Relay.

Definition at line 69 of file Client.cc.

References adaptedBodySource, assert, cleanAdaptation(), closeServer(), doneWithFwd, doneWithServer(), fwd, FwdState::handleUnregisteredServerEnd(), NULL, requestBodySource, BodyConsumer::stopConsumingFrom(), AsyncJob::swanSong(), and virginBodyDestination.

Referenced by Ftp::Relay::swanSong().

virtual void* CbdataParent::toCbdata ( )
pure virtualinherited

Implemented in ClientHttpRequest, HttpStateData, and BodySink.

Referenced by AsyncJob::callException(), and AsyncJob::callStart().

const HttpReply * Client::virginReply ( ) const
protected

Definition at line 110 of file Client.cc.

References assert, and theVirginReply.

Referenced by adaptOrFinalizeReply(), HttpStateData::continueAfterParsingHeader(), HttpStateData::handleMoreRequestBodyAvailable(), noteAdaptationAclCheckDone(), HttpStateData::persistentConnStatus(), startAdaptation(), HttpStateData::statusIfComplete(), and HttpStateData::truncateVirginBody().

HttpReply * Client::virginReply ( )
protected

Definition at line 103 of file Client.cc.

References assert, and theVirginReply.

Member Data Documentation

bool Client::adaptationAccessCheckPending = false
protected

Definition at line 177 of file Client.h.

Referenced by adaptOrFinalizeReply(), addVirginReplyBody(), cleanAdaptation(), doneWithAdaptation(), noteAdaptationAclCheckDone(), and HttpStateData::processReplyBody().

BodyPipe::Pointer Client::adaptedBodySource
protected

to consume adated response body

Definition at line 175 of file Client.h.

Referenced by cleanAdaptation(), doneWithAdaptation(), endAdaptedBodyConsumption(), handleAdaptedBodyProducerAborted(), handleAdaptedBodyProductionEnded(), handleAdaptedHeader(), handleMoreAdaptedBodyAvailable(), noteBodyProducerAborted(), noteBodyProductionEnded(), noteMoreBodyDataAvailable(), resumeBodyStorage(), swanSong(), and ~Client().

CbcPointer<Adaptation::Initiate> Client::adaptedHeadSource
protected

to get adapted response headers

Definition at line 174 of file Client.h.

Referenced by cleanAdaptation(), doneWithAdaptation(), noteAdaptationAnswer(), and startAdaptation().

bool Client::completed = false
private

serverComplete() has been called

Definition at line 86 of file Client.h.

Referenced by noteMoreBodySpaceAvailable(), and serverComplete().

int64_t Client::currentOffset = 0
protected

Our current offset in the StoreEntry

Definition at line 160 of file Client.h.

Referenced by Ftp::Gateway::getCurrentOffset(), handleMoreAdaptedBodyAvailable(), haveParsedReplyHeaders(), Ftp::Gateway::setCurrentOffset(), and storeReplyBody().

const char* Client::doneWithFwd = nullptr
protected

whether we should not be talking to FwdState; XXX: clear fwd instead points to a string literal which is used only for debugging

Definition at line 184 of file Client.h.

Referenced by completeForwarding(), HttpStateData::httpStateConnClosed(), and swanSong().

StoreEntry* Client::entry = nullptr

Definition at line 164 of file Client.h.

Referenced by abortOnBadEntry(), blockCaching(), HttpStateData::buildRequestPrefix(), Client(), HttpStateData::continueAfterParsingHeader(), ftpFail(), ftpSendReply(), ftpWriteTransferDone(), Ftp::Gateway::Gateway(), handleAdaptationAborted(), handleAdaptationBlocked(), handleAdaptedBodyProducerAborted(), handledEarlyAdaptationAbort(), handleMoreAdaptedBodyAvailable(), HttpStateData::handleMoreRequestBodyAvailable(), HttpStateData::handleRequestBodyProducerAborted(), HttpStateData::haveParsedReplyHeaders(), HttpStateData::HttpStateData(), HttpStateData::httpTimeout(), HttpStateData::keepaliveAccounting(), HttpStateData::peerSupportsConnectionPinning(), HttpStateData::processReplyBody(), HttpStateData::processReplyHeader(), HttpStateData::processSurrogateControl(), HttpStateData::readReply(), Ftp::Relay::Relay(), HttpStateData::reusableReply(), sentRequestBody(), setFinalReply(), HttpStateData::statusIfComplete(), storeReplyBody(), HttpStateData::wroteLast(), and ~Client().

FwdState::Pointer Client::fwd

Definition at line 165 of file Client.h.

Referenced by adaptOrFinalizeReply(), HttpStateData::buildRequestPrefix(), Client(), HttpStateData::closeServer(), completeForwarding(), HttpStateData::continueAfterParsingHeader(), HttpStateData::finishingBrokenPost(), ftpFail(), HttpStateData::handle1xx(), handleAdaptationBlocked(), handledEarlyAdaptationAbort(), handleRequestBodyProducerAborted(), HttpStateData::handleRequestBodyProducerAborted(), HttpStateData::haveParsedReplyHeaders(), HttpStateData::HttpStateData(), HttpStateData::httpTimeout(), HttpStateData::processReplyBody(), HttpStateData::readReply(), sendBodyIsTooLargeError(), sentRequestBody(), startAdaptation(), swanSong(), and HttpStateData::wroteLast().

const InstanceId<AsyncJob> AsyncJob::id
protectedinherited

Definition at line 72 of file AsyncJob.h.

AsyncCall::Pointer AsyncJob::inCall
protectedinherited

Definition at line 71 of file AsyncJob.h.

Referenced by AsyncJob::callEnd(), AsyncJob::callStart(), AsyncJob::canBeCalled(), AsyncJob::deleteThis(), and AsyncJob::mustStop().

bool Client::receivedWholeRequestBody = false
protected

Definition at line 180 of file Client.h.

Referenced by HttpStateData::finishingChunkedRequest(), HttpStateData::getMoreRequestBody(), handleRequestBodyProductionEnded(), and sentRequestBody().

HttpRequestPointer Client::request

Definition at line 166 of file Client.h.

Referenced by HttpStateData::buildRequestPrefix(), HttpStateData::checkDateSkew(), HttpStateData::continueAfterParsingHeader(), ftpFail(), ftpReadType(), ftpSendPassive(), ftpSendReply(), ftpSendStor(), ftpSendType(), ftpSendUser(), ftpTrySlashHack(), Ftp::Gateway::Gateway(), HttpStateData::handle1xx(), handleAdaptationBlocked(), handledEarlyAdaptationAbort(), HttpStateData::handleMoreRequestBodyAvailable(), HttpStateData::haveParsedReplyHeaders(), HttpStateData::HttpStateData(), HttpStateData::keepaliveAccounting(), maybePurgeOthers(), noteAdaptationAclCheckDone(), originalRequest(), HttpStateData::peerSupportsConnectionPinning(), HttpStateData::persistentConnStatus(), HttpStateData::processReplyBody(), HttpStateData::processReplyHeader(), HttpStateData::processSurrogateControl(), HttpStateData::readReply(), HttpStateData::reusableReply(), sendBodyIsTooLargeError(), HttpStateData::sendRequest(), sentRequestBody(), HttpStateData::statusIfComplete(), HttpStateData::truncateVirginBody(), and HttpStateData::wroteLast().

BodyPipe::Pointer Client::requestBodySource
protected

to consume request body

Definition at line 169 of file Client.h.

Referenced by doneSendingRequestBody(), getMoreRequestBody(), HttpStateData::getMoreRequestBody(), HttpStateData::handleMoreRequestBodyAvailable(), handleRequestBodyProducerAborted(), noteBodyProducerAborted(), noteBodyProductionEnded(), noteMoreBodyDataAvailable(), sendMoreRequestBody(), HttpStateData::sendRequest(), sentRequestBody(), serverComplete(), startRequestBodyFlow(), swanSong(), and ~Client().

AsyncCall::Pointer Client::requestSender
protected

set if we are expecting Comm::Write to call us back

Definition at line 170 of file Client.h.

Referenced by HttpStateData::finishingBrokenPost(), HttpStateData::finishingChunkedRequest(), handleMoreRequestBodyAvailable(), handleRequestBodyProducerAborted(), handleRequestBodyProductionEnded(), sendMoreRequestBody(), HttpStateData::sendRequest(), and sentRequestBody().

MemBuf* Client::responseBodyBuffer = nullptr
protected

Data temporarily buffered for ICAP

Definition at line 161 of file Client.h.

Referenced by adaptVirginReplyBody(), calcBufferSpaceToReserve(), noteMoreBodySpaceAvailable(), replyBodySpace(), serverComplete(), and ~Client().

bool Client::startedAdaptation = false
protected

Definition at line 178 of file Client.h.

Referenced by adaptVirginReplyBody(), addVirginReplyBody(), and startAdaptation().

const char* AsyncJob::stopReason
protectedinherited

Definition at line 69 of file AsyncJob.h.

Referenced by AsyncJob::deleteThis(), AsyncJob::done(), AsyncJob::mustStop(), and AsyncJob::status().

HttpReply* Client::theFinalReply = nullptr
private

adapted reply from ICAP or virgin reply

Definition at line 191 of file Client.h.

Referenced by finalReply(), haveParsedReplyHeaders(), maybePurgeOthers(), setFinalReply(), and ~Client().

HttpReply* Client::theVirginReply = nullptr
private

reply received from the origin server

Definition at line 190 of file Client.h.

Referenced by setVirginReply(), virginReply(), and ~Client().

const char* AsyncJob::typeName
protectedinherited

Definition at line 70 of file AsyncJob.h.

Referenced by AsyncJob::AsyncJob(), AsyncJob::callEnd(), AsyncJob::callStart(), AsyncJob::deleteThis(), AsyncJob::mustStop(), Adaptation::Icap::Xaction::Xaction(), and AsyncJob::~AsyncJob().

BodyPipe::Pointer Client::virginBodyDestination
protected

to provide virgin response body

Definition at line 173 of file Client.h.

Referenced by adaptVirginReplyBody(), calcBufferSpaceToReserve(), cleanAdaptation(), doneWithAdaptation(), noteBodyConsumerAborted(), replyBodySpace(), serverComplete2(), startAdaptation(), swanSong(), and ~Client().

The documentation for this class was generated from the following files:

 

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors