#include <helper.h>

Inheritance diagram for statefulhelper:
Collaboration diagram for statefulhelper:

Public Member Functions

void * operator new (size_t size)
 
void operator delete (void *address)
 
void * toCbdata () noexcept
 
 statefulhelper (const char *name)
 
 ~statefulhelper ()
 
Helper::XactionnextRequest ()
 
bool trySubmit (const char *buf, HLPCB *callback, void *data)
 If possible, submit request. Otherwise, either kill Squid or return false. More...
 
void submitRequest (Helper::Xaction *r)
 
void packStatsInto (Packable *p, const char *label=NULL) const
 Dump some stats about the helper state to a Packable object. More...
 
bool willOverload () const
 

Public Attributes

wordlistcmdline
 
dlink_list servers
 
std::queue< Helper::Xaction * > queue
 
const char * id_name
 
Helper::ChildConfig childs
 Configuration settings for number running. More...
 
int ipc_type
 
Ip::Address addr
 
unsigned int droppedRequests
 requests not sent during helper overload More...
 
time_t overloadStart
 when the helper became overloaded (zero if it is not) More...
 
time_t last_queue_warn
 
time_t last_restart
 
time_t timeout
 Requests timeout. More...
 
bool retryTimedOut
 Whether the timed-out requests must retried. More...
 
bool retryBrokenHelper
 Whether the requests must retried on BH replies. More...
 
SBuf onTimedOutResponse
 The response to use when helper response timedout. More...
 
char eom
 The char which marks the end of (response) message, normally '
'. More...
 
struct helper::_stats stats
 

Protected Member Functions

bool queueFull () const
 whether queuing an additional request would overload the helper More...
 
bool overloaded () const
 
void syncQueueStats ()
 synchronizes queue-dependent measurements with the current queue state More...
 
bool prepSubmit ()
 
void submit (const char *buf, HLPCB *callback, void *data)
 dispatches or enqueues a helper requests; does not enforce queue limits More...
 

Private Member Functions

void submit (const char *buf, HLPCB *callback, void *data, helper_stateful_server *lastserver)
 
bool trySubmit (const char *buf, HLPCB *callback, void *data, helper_stateful_server *lastserver)
 If possible, submit request. Otherwise, either kill Squid or return false. More...
 

Static Private Attributes

static cbdata_type CBDATA_statefulhelper = CBDATA_UNKNOWN
 

Friends

void helperStatefulSubmit (statefulhelper *hlp, const char *buf, HLPCB *callback, void *data, helper_stateful_server *lastserver)
 lastserver = "server last used as part of a reserved request sequence" More...
 

Detailed Description

Definition at line 132 of file helper.h.

Constructor & Destructor Documentation

statefulhelper::statefulhelper ( const char *  name)
inline

Definition at line 137 of file helper.h.

statefulhelper::~statefulhelper ( )
inline

Definition at line 138 of file helper.h.

Member Function Documentation

Helper::Xaction * helper::nextRequest ( )
inherited
Returns
next request in the queue, or nil.

Definition at line 1217 of file helper.cc.

References helper::queue, helper::_stats::queue_size, and helper::stats.

Referenced by helperKickQueue(), and helperStatefulKickQueue().

void statefulhelper::operator delete ( void *  address)
inline

Definition at line 134 of file helper.h.

void* statefulhelper::operator new ( size_t  size)
inline

Definition at line 134 of file helper.h.

bool helper::overloaded ( ) const
protectedinherited
bool helper::prepSubmit ( )
protectedinherited

prepares the helper for request submission returns true if and only if the submission should proceed may kill Squid if the helper remains overloaded for too long

Definition at line 443 of file helper.cc.

References Helper::ChildConfig::actDie, helper::childs, DBG_IMPORTANT, debugs, helper::droppedRequests, fatalf(), helper::id_name, Helper::ChildConfig::onPersistentOverload, helper::overloaded(), helper::overloadStart, squid_curtime, and helper::syncQueueStats().

Referenced by helper::trySubmit(), and trySubmit().

bool helper::queueFull ( ) const
protectedinherited
void helper::submit ( const char *  buf,
HLPCB callback,
void *  data 
)
protectedinherited

Definition at line 481 of file helper.cc.

References DBG_DATA, debugs, and helper::submitRequest().

Referenced by helper::trySubmit().

void helper::submitRequest ( Helper::Xaction r)
inherited

Submits a request to the helper or add it to the queue if none of the servers is available.

Definition at line 370 of file helper.cc.

References Enqueue(), GetFirstAvailable(), helperDispatch(), and helper::syncQueueStats().

Referenced by helper_server::checkForTimedOutRequests(), helperReturnBuffer(), and helper::submit().

void helper::syncQueueStats ( )
protectedinherited
void* statefulhelper::toCbdata ( )
inlinenoexcept

Definition at line 134 of file helper.h.

bool helper::trySubmit ( const char *  buf,
HLPCB callback,
void *  data 
)
inherited

Definition at line 470 of file helper.cc.

References helper::prepSubmit(), and helper::submit().

Referenced by helperSubmit(), and ExternalACLLookup::Start().

bool statefulhelper::trySubmit ( const char *  buf,
HLPCB callback,
void *  data,
helper_stateful_server lastserver 
)
private

Definition at line 498 of file helper.cc.

References helper::prepSubmit(), and submit().

Referenced by helperStatefulSubmit().

bool helper::willOverload ( ) const
inherited

whether the helper will be in "overloaded" state after one more request already overloaded helpers return true

Definition at line 611 of file helper.cc.

References helper::childs, GetFirstAvailable(), Helper::ChildConfig::needNew(), and helper::queueFull().

Referenced by aclMatchExternal(), redirectStart(), and storeIdStart().

Friends And Related Function Documentation

void helperStatefulSubmit ( statefulhelper hlp,
const char *  buf,
HLPCB callback,
void *  data,
helper_stateful_server lastserver 
)
friend

Definition at line 490 of file helper.cc.

Member Data Documentation

Ip::Address helper::addr
inherited

Definition at line 104 of file helper.h.

Referenced by helperOpenServers(), and helperStatefulOpenServers().

cbdata_type statefulhelper::CBDATA_statefulhelper = CBDATA_UNKNOWN
staticprivate

Definition at line 134 of file helper.h.

wordlist* helper::cmdline
inherited
unsigned int helper::droppedRequests
inherited

Definition at line 105 of file helper.h.

Referenced by helper::prepSubmit(), and helper::syncQueueStats().

char helper::eom
inherited

Definition at line 113 of file helper.h.

Referenced by helperHandleRead(), and helperStatefulHandleRead().

int helper::ipc_type
inherited

Definition at line 103 of file helper.h.

Referenced by helperOpenServers(), helperStatefulOpenServers(), and redirectInit().

time_t helper::last_queue_warn
inherited

Definition at line 107 of file helper.h.

Referenced by Enqueue(), and StatefulEnqueue().

time_t helper::last_restart
inherited
SBuf helper::onTimedOutResponse
inherited

Definition at line 112 of file helper.h.

Referenced by helper_server::checkForTimedOutRequests(), and redirectInit().

time_t helper::overloadStart
inherited

Definition at line 106 of file helper.h.

Referenced by helper::prepSubmit(), and helper::syncQueueStats().

std::queue<Helper::Xaction *> helper::queue
inherited

Definition at line 100 of file helper.h.

Referenced by Enqueue(), helper::nextRequest(), StatefulEnqueue(), and helper::~helper().

bool helper::retryBrokenHelper
inherited

Definition at line 111 of file helper.h.

Referenced by redirectInit().

bool helper::retryTimedOut
inherited

Definition at line 110 of file helper.h.

Referenced by helperReturnBuffer(), redirectInit(), and helper_server::requestTimeout().

time_t helper::timeout
inherited

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

 

Introduction

Documentation

Support

Miscellaneous

Web Site Translations

Mirrors