Coordinates shared activities of Strands (Squid processes or threads) More...

#include <Coordinator.h>

Inheritance diagram for Ipc::Coordinator:

[legend]

Collaboration diagram for Ipc::Coordinator:

[legend]

Public Types
typedef CbcPointer< AsyncJob >	Pointer

Public Member Functions
	Coordinator ()

void	broadcastSignal (int sig) const
	send sig to registered strands More...

const StrandCoords &	strands () const
	currently registered strands More...

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 Coordinator *	Instance ()

static String	MakeAddr (const char *proccessLabel, int id)
	calculates IPC message address for strand id of processLabel type More...

static String	CoordinatorAddr ()
	get the IPC message address for coordinator process More...

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

Public Attributes
struct sockaddr_un	address
	UDS address from path; treat as read-only. More...

Protected Member Functions
virtual void	start ()
	called by AsyncStart; do not call directly More...

virtual void	receive (const TypedMsgHdr &message)

StrandCoord *	findStrand (int kidId)
	registered strand or NULL More...

void	registerStrand (const StrandCoord &)
	adds or updates existing More...

void	handleRegistrationRequest (const StrandMessage &)
	register,ACK More...

void	notifySearcher (const StrandSearchRequest &request, const StrandCoord &)
	answer the waiting search request More...

void	handleSearchRequest (const StrandSearchRequest &request)
	answers or queues the request if the answer is not yet known More...

void	handleSharedListenRequest (const SharedListenRequest &request)
	returns cached socket or calls openListenSocket() More...

void	handleCacheMgrRequest (const Mgr::Request &request)

void	handleCacheMgrResponse (const Mgr::Response &response)

void	handleSnmpRequest (const Snmp::Request &request)

void	handleSnmpResponse (const Snmp::Response &response)

Comm::ConnectionPointer	openListenSocket (const SharedListenRequest &request, int &errNo)
	calls comm_open_listener() More...

virtual bool	doneAll () const
	whether positive goal has been reached More...

void	doListen ()
	read the next incoming message More...

virtual void	timedout ()
	called after setTimeout() if timed out More...

Comm::ConnectionPointer &	conn ()
	creates if needed and returns raw UDS socket descriptor More...

void	setTimeout (int seconds, const char *handlerName)
	call timedout() if no UDS messages in a given number of seconds More...

void	clearTimeout ()
	remove previously set timeout, if any More...

void	setOptions (int newOptions)
	changes socket options 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	swanSong ()

virtual const char *	status () const
	internal cleanup; do not call directly More...

Protected Attributes
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 Types
typedef std::list< StrandSearchRequest >	Searchers
	search requests More...

typedef std::map< OpenListenerParams, Comm::ConnectionPointer >	Listeners
	params:connection map More...

Private Member Functions
	CBDATA_CLASS (Coordinator)

	Coordinator (const Coordinator &)

Coordinator &	operator= (const Coordinator &)

void	noteRead (const CommIoCbParams &params)

void	receiveOrIgnore (const TypedMsgHdr &)
	receive() but ignore any errors More...

void	noteTimeout (const CommTimeoutCbParams &p)
	Comm timeout callback; calls timedout() More...

Private Attributes
StrandCoords	strands_
	registered processes and threads More...

Searchers	searchers
	yet unanswered search requests in arrival order More...

Listeners	listeners
	cached comm_open_listener() results More...

TypedMsgHdr	buf
	msghdr struct filled by Comm More...

int	options
	UDS options. More...

Comm::ConnectionPointer	conn_
	UDS descriptor. More...

Static Private Attributes
static Coordinator *	TheInstance = NULL
	the only class instance in existence More...

Detailed Description

Definition at line 30 of file Coordinator.h.

Member Typedef Documentation

◆ Listeners

typedef std::map<OpenListenerParams, Comm::ConnectionPointer> Ipc::Coordinator::Listeners

private

Definition at line 74 of file Coordinator.h.

◆ Pointer

typedef CbcPointer<AsyncJob> AsyncJob::Pointer

inherited

Definition at line 34 of file AsyncJob.h.

◆ Searchers

typedef std::list<StrandSearchRequest> Ipc::Coordinator::Searchers

private

Definition at line 71 of file Coordinator.h.

Constructor & Destructor Documentation

◆ Coordinator() [1/2]

Ipc::Coordinator::Coordinator ( )

Definition at line 34 of file Coordinator.cc.

◆ Coordinator() [2/2]

Ipc::Coordinator::Coordinator ( const Coordinator & )

private

Member Function Documentation

◆ broadcastSignal()

void Ipc::Coordinator::broadcastSignal ( int sig ) const

Definition at line 281 of file Coordinator.cc.

References debugs, and HERE().

◆ callEnd()

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().

◆ callException()

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

virtualinherited

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

Definition at line 127 of file AsyncJob.cc.

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

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

◆ callStart()

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.

◆ canBeCalled()

bool AsyncJob::canBeCalled ( AsyncCall & call ) const

inherited

Definition at line 101 of file AsyncJob.cc.

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

◆ CBDATA_CLASS()

Ipc::Coordinator::CBDATA_CLASS ( Coordinator )

private

◆ clearTimeout()

void Ipc::UdsOp::clearTimeout ( )

protectedinherited

Definition at line 62 of file UdsOp.cc.

References commUnsetConnTimeout(), and conn.

◆ conn()

Comm::ConnectionPointer & Ipc::UdsOp::conn ( )

protectedinherited

Definition at line 41 of file UdsOp.cc.

References COMM_DOBIND, comm_open_uds(), Comm::IsConnOpen(), Must, and NULL.

◆ CoordinatorAddr()

String Ipc::Port::CoordinatorAddr ( )

staticinherited

Definition at line 65 of file Port.cc.

References String::append(), SBuf::c_str(), channelPathPfx, coordinatorAddrLabel, service_name, and String::size().

Referenced by Ipc::StrandMessage::NotifyCoordinator(), IpcIoFile::open(), Mgr::Action::sendResponse(), Snmp::SendResponse(), SendSharedListenRequest(), and Ipc::Forwarder::start().

◆ deleteThis()

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().

◆ doListen()

void Ipc::Port::doListen ( )

protectedinherited

Definition at line 37 of file Port.cc.

References buf, comm_read(), conn, debugs, HERE(), JobCallback, and Ipc::Port::noteRead().

◆ done()

bool AsyncJob::done ( ) const

protectedinherited

Definition at line 90 of file AsyncJob.cc.

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

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

◆ doneAll()

bool Ipc::Port::doneAll ( ) const

protectedvirtualinherited

Reimplemented from AsyncJob.

Definition at line 47 of file Port.cc.

◆ findStrand()

Ipc::StrandCoord * Ipc::Coordinator::findStrand ( int kidId )

protected

Definition at line 44 of file Coordinator.cc.

References NULL.

◆ handleCacheMgrRequest()

void Ipc::Coordinator::handleCacheMgrRequest ( const Mgr::Request & request )

protected

Definition at line 167 of file Coordinator.cc.

References action(), CacheManager::createRequestedAction(), DBG_IMPORTANT, debugs, _request::fd, CacheManager::GetInstance(), HERE(), Mgr::Response::pack(), request(), Ipc::SendMessage(), AsyncJob::Start(), and Ipc::strandAddrLabel.

◆ handleCacheMgrResponse()

void Ipc::Coordinator::handleCacheMgrResponse ( const Mgr::Response & response )

protected

Definition at line 193 of file Coordinator.cc.

References Ipc::Inquirer::HandleRemoteAck().

◆ handleRegistrationRequest()

void Ipc::Coordinator::handleRegistrationRequest ( const StrandMessage & msg )

protected

Definition at line 136 of file Coordinator.cc.

References Ipc::StrandCoord::kidId, Ipc::mtStrandRegistered, Ipc::StrandMessage::pack(), Ipc::SendMessage(), Ipc::StrandMessage::strand, and Ipc::strandAddrLabel.

◆ handleSearchRequest()

void Ipc::Coordinator::handleSearchRequest ( const StrandSearchRequest & request )

protected

Definition at line 199 of file Coordinator.cc.

References debugs, HERE(), NULL, and request().

◆ handleSharedListenRequest()

void Ipc::Coordinator::handleSharedListenRequest ( const SharedListenRequest & request )

protected

Definition at line 147 of file Coordinator.cc.

References debugs, Comm::Connection::fd, HERE(), Ipc::SharedListenResponse::pack(), request(), Ipc::SendMessage(), and Ipc::strandAddrLabel.

◆ handleSnmpRequest()

void Ipc::Coordinator::handleSnmpRequest ( const Snmp::Request & request )

protected

Definition at line 233 of file Coordinator.cc.

References debugs, HERE(), Snmp::Response::pack(), request(), Ipc::SendMessage(), AsyncJob::Start(), and Ipc::strandAddrLabel.

◆ handleSnmpResponse()

void Ipc::Coordinator::handleSnmpResponse ( const Snmp::Response & response )

protected

Definition at line 246 of file Coordinator.cc.

References debugs, Ipc::Inquirer::HandleRemoteAck(), and HERE().

◆ Instance()

Ipc::Coordinator * Ipc::Coordinator::Instance ( )

static

Definition at line 291 of file Coordinator.cc.

Referenced by SquidMain().

◆ MakeAddr()

String Ipc::Port::MakeAddr	(	const char *	proccessLabel,
		int	id
	)

staticinherited

Definition at line 52 of file Port.cc.

References String::append(), assert, SBuf::c_str(), channelPathPfx, service_name, and xitoa().

Referenced by Ipc::Inquirer::inquire(), IpcIoFile::Notify(), and CollapsedForwarding::Notify().

◆ mustStop()

void AsyncJob::mustStop ( const char * aReason )

protectedinherited

◆ noteRead()

void Ipc::Port::noteRead ( const CommIoCbParams & params )

privateinherited

Definition at line 96 of file Port.cc.

References assert, CommIoCbParams::buf, buf, CommCommonCbParams::conn, debugs, CommCommonCbParams::flag, HERE(), and Comm::OK.

Referenced by Ipc::Port::doListen().

◆ noteTimeout()

void Ipc::UdsOp::noteTimeout ( const CommTimeoutCbParams & p )

privateinherited

Definition at line 67 of file UdsOp.cc.

Referenced by Ipc::UdsOp::setTimeout().

◆ notifySearcher()

void Ipc::Coordinator::notifySearcher	(	const StrandSearchRequest &	request,
		const StrandCoord &	strand
	)

protected

Definition at line 220 of file Coordinator.cc.

References debugs, HERE(), Ipc::StrandCoord::kidId, Ipc::mtStrandReady, Ipc::StrandMessage::pack(), request(), Ipc::SendMessage(), and Ipc::strandAddrLabel.

◆ openListenSocket()

Comm::ConnectionPointer Ipc::Coordinator::openListenSocket	(	const SharedListenRequest &	request,
		int &	errNo
	)

protected

Definition at line 254 of file Coordinator.cc.

References Ipc::OpenListenerParams::addr, comm_open_listener(), debugs, enter_suid(), Ipc::FdNote(), Ipc::OpenListenerParams::fdNote, Comm::Connection::flags, Ipc::OpenListenerParams::flags, HERE(), Comm::IsConnOpen(), leave_suid(), Comm::Connection::local, Ipc::OpenListenerParams::proto, request(), and Ipc::OpenListenerParams::sock_type.

◆ operator=()

Coordinator& Ipc::Coordinator::operator= ( const Coordinator & )

private

◆ receive()

void Ipc::Coordinator::receive ( const TypedMsgHdr & message )

protectedvirtual

handle IPC message just read kids must call parent method when they do not recognize the message type

Implements Ipc::Port.

Definition at line 79 of file Coordinator.cc.

References debugs, HERE(), Ipc::Mine(), Ipc::mtCacheMgrRequest, Ipc::mtCacheMgrResponse, Ipc::mtFindStrand, Ipc::mtRegisterStrand, Ipc::mtSharedListenRequest, Ipc::mtSnmpRequest, Ipc::mtSnmpResponse, Ipc::TypedMsgHdr::rawType(), Ipc::Port::receive(), Ipc::StrandSearchRequest::requestorId, and Ipc::StrandSearchRequest::tag.

◆ receiveOrIgnore()

void Ipc::Port::receiveOrIgnore ( const TypedMsgHdr & message )

privateinherited

Definition at line 85 of file Port.cc.

References CurrentException(), DBG_IMPORTANT, debugs, Debug::Extra(), and Ipc::TypedMsgHdr::rawType().

◆ registerStrand()

void Ipc::Coordinator::registerStrand ( const StrandCoord & strand )

protected

Definition at line 54 of file Coordinator.cc.

References debugs, HERE(), Ipc::StrandCoord::kidId, String::size(), and Ipc::StrandCoord::tag.

◆ setOptions()

void Ipc::UdsOp::setOptions ( int newOptions )

protectedinherited

Definition at line 35 of file UdsOp.cc.

Referenced by Ipc::Port::Port().

◆ setTimeout()

void Ipc::UdsOp::setTimeout	(	int	seconds,
		const char *	handlerName
	)

protectedinherited

Definition at line 54 of file UdsOp.cc.

References asyncCall(), commSetConnTimeout(), conn, handler, and Ipc::UdsOp::noteTimeout().

◆ start()

void Ipc::Coordinator::start ( )

protectedvirtual

Implements Ipc::Port.

Definition at line 39 of file Coordinator.cc.

References Ipc::Port::start().

◆ Start()

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::connectStart(), Adaptation::Icap::Xaction::dnsLookupDone(), Log::TcpLogger::doConnect(), FwdState::establishTunnelThruProxy(), TunnelStateData::establishTunnelThruProxy(), handleCacheMgrRequest(), PeerPoolMgr::handleOpenedConnection(), handleSnmpRequest(), httpAccept(), httpsAccept(), httpStart(), idnsInitVC(), Ftp::Gateway::listenForDataChannel(), Ftp::Server::listenForDataConnection(), Adaptation::Icap::Xaction::noteCommConnected(), Log::TcpLogger::Open(), HappyConnOpener::openFreshConnection(), PeerPoolMgr::openNewConnection(), peerProbeConnect(), Mgr::FunAction::respond(), Mgr::InfoAction::respond(), FwdState::secureConnectionToPeer(), TunnelStateData::secureConnectionToPeer(), Ipc::SendMessage(), Mgr::Inquirer::sendResponse(), snmpConstructReponse(), SquidMain(), CacheManager::start(), Ident::Start(), Adaptation::AccessCheck::Start(), Rock::Rebuild::Start(), Security::PeerConnector::startCertDownloading(), TunnelStateData::startConnecting(), Ftp::StartGateway(), Ftp::StartRelay(), PeerPoolMgrsRr::syncConfig(), and Rock::SwapDir::updateHeaders().

◆ status()

const char * AsyncJob::status ( ) const

protectedvirtualinherited

for debugging, starts with space

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

Definition at line 159 of file AsyncJob.cc.

References buf, NULL, and AsyncJob::stopReason.

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

◆ strands()

const Ipc::StrandCoords & Ipc::Coordinator::strands ( ) const

Definition at line 302 of file Coordinator.cc.

◆ swanSong()

virtual void AsyncJob::swanSong ( )

inlineprotectedvirtualinherited

Reimplemented in HappyConnOpener, Rock::Rebuild, Rock::HeaderUpdater, Snmp::Forwarder, Server, Security::PeerConnector, PeerPoolMgr, Mgr::StoreToCommWriter, Mgr::Forwarder, Mgr::Filler, Log::TcpLogger, Ipc::UdsSender, Ipc::Inquirer, Ipc::Forwarder, Downloader, Comm::TcpAcceptor, Comm::ConnOpener, Http::Tunneler, Ftp::Relay, Client, ConnStateData, Adaptation::Iterator, Adaptation::Initiate, Adaptation::Icap::Xaction, Adaptation::Icap::OptXact, Adaptation::Icap::ModXactLauncher, Adaptation::Icap::ModXact, Adaptation::Icap::Launcher, and Adaptation::Ecap::XactionRep.

Definition at line 54 of file AsyncJob.h.

Referenced by AsyncJob::callEnd(), Client::swanSong(), Http::Tunneler::swanSong(), Comm::ConnOpener::swanSong(), Comm::TcpAcceptor::swanSong(), Ipc::UdsSender::swanSong(), Log::TcpLogger::swanSong(), PeerPoolMgr::swanSong(), Security::PeerConnector::swanSong(), Server::swanSong(), Rock::HeaderUpdater::swanSong(), and HappyConnOpener::swanSong().

◆ timedout()

virtual void Ipc::UdsOp::timedout ( )

inlineprotectedvirtualinherited

Reimplemented in Ipc::UdsSender, and Ipc::Strand.

Definition at line 40 of file UdsOp.h.

◆ toCbdata()

virtual void* CbdataParent::toCbdata ( )

pure virtualinherited

Implemented in HttpStateData, ClientHttpRequest, and BodySink.

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

Member Data Documentation

◆ address

struct sockaddr_un Ipc::UdsOp::address

inherited

Definition at line 34 of file UdsOp.h.

Referenced by Ipc::UdsSender::UdsSender().

◆ buf

TypedMsgHdr Ipc::Port::buf

privateinherited

Definition at line 47 of file Port.h.

◆ conn_

Comm::ConnectionPointer Ipc::UdsOp::conn_

privateinherited

Definition at line 56 of file UdsOp.h.

◆ id

const InstanceId<AsyncJob> AsyncJob::id

protectedinherited

Definition at line 72 of file AsyncJob.h.

◆ inCall

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().

◆ listeners

Listeners Ipc::Coordinator::listeners

private

Definition at line 75 of file Coordinator.h.

◆ options

int Ipc::UdsOp::options

privateinherited

Definition at line 55 of file UdsOp.h.

◆ searchers

Searchers Ipc::Coordinator::searchers

private

Definition at line 72 of file Coordinator.h.

◆ stopReason

const char* AsyncJob::stopReason

protectedinherited

Definition at line 69 of file AsyncJob.h.

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

◆ strands_

StrandCoords Ipc::Coordinator::strands_

private

Definition at line 69 of file Coordinator.h.

◆ TheInstance

Ipc::Coordinator * Ipc::Coordinator::TheInstance = NULL

staticprivate

Definition at line 77 of file Coordinator.h.

◆ typeName

const char* AsyncJob::typeName

protectedinherited

Definition at line 70 of file AsyncJob.h.

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

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

src/ipc/Coordinator.h
src/ipc/Coordinator.cc

squid-cache.org

Optimising Web Delivery

Public Types

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Types

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ Listeners

◆ Pointer

◆ Searchers

Constructor & Destructor Documentation

◆ Coordinator() [1/2]

◆ Coordinator() [2/2]

Member Function Documentation

◆ broadcastSignal()

◆ callEnd()

◆ callException()

◆ callStart()

◆ canBeCalled()

◆ CBDATA_CLASS()

◆ clearTimeout()

◆ conn()

◆ CoordinatorAddr()

◆ deleteThis()

◆ doListen()

◆ done()

◆ doneAll()

◆ findStrand()

◆ handleCacheMgrRequest()

◆ handleCacheMgrResponse()

◆ handleRegistrationRequest()

◆ handleSearchRequest()

◆ handleSharedListenRequest()

◆ handleSnmpRequest()

◆ handleSnmpResponse()

◆ Instance()

◆ MakeAddr()

◆ mustStop()

◆ noteRead()

◆ noteTimeout()

◆ notifySearcher()

◆ openListenSocket()

◆ operator=()

◆ receive()

◆ receiveOrIgnore()

◆ registerStrand()

◆ setOptions()

◆ setTimeout()

◆ start()

◆ Start()

◆ status()

◆ strands()

◆ swanSong()

◆ timedout()

◆ toCbdata()

Member Data Documentation

◆ address

◆ buf

◆ conn_

◆ id

◆ inCall

◆ listeners

◆ options

◆ searchers

◆ stopReason

◆ strands_

◆ TheInstance

◆ typeName

Introduction

Documentation

Support

Miscellaneous

Web Site Translations