#include <pconn.h>

Collaboration diagram for PconnPool:

Public Member Functions
	PconnPool (const char *aDescription, const CbcPointer< PeerPoolMgr > &aMgr)

	~PconnPool ()

void	moduleInit ()

void	push (const Comm::ConnectionPointer &serverConn, const char *domain)

Comm::ConnectionPointer	pop (const Comm::ConnectionPointer &dest, const char *domain, bool keepOpen)

void	count (int uses)

void	dump (std::ostream &) const

void	unlinkList (IdleConnList *list)

void	noteUses (int uses)

void	closeN (int n)
	closes any n connections, regardless of their destination

int	count () const

void	noteConnectionAdded ()

void	noteConnectionRemoved ()

void	notifyManager (const char *reason)

Private Member Functions
Comm::ConnectionPointer	popStored (const Comm::ConnectionPointer &dest, const char *domain, const bool keepOpen)

void	dumpHist (std::ostream &) const

void	dumpHash (std::ostream &) const

Static Private Member Functions
static const char *	key (const Comm::ConnectionPointer &destLink, const char *domain)

Private Attributes
int	hist [PCONN_HIST_SZ]

hash_table *	table

const char *	descr

CbcPointer< PeerPoolMgr >	mgr
	optional pool manager (for notifications)

int	theCount
	the number of pooled connections

Detailed Description

Manages idle persistent connections to a caller-defined set of servers (e.g., all HTTP servers). Uses a collection of IdleConnLists internally to list the individual open connections to each server. Controls lists existence and limits the total number of idle connections across the collection.

Definition at line 115 of file pconn.h.

Constructor & Destructor Documentation

◆ PconnPool()

PconnPool::PconnPool	(	const char *	aDescription,
		const CbcPointer< PeerPoolMgr > &	aMgr
	)

Definition at line 406 of file pconn.cc.

References PconnModule::add(), PconnModule::GetInstance(), hash_create(), hash_string, hist, PCONN_HIST_SZ, and table.

◆ ~PconnPool()

PconnPool::~PconnPool ( )

Definition at line 426 of file pconn.cc.

References DeleteIdleConnList(), descr, PconnModule::GetInstance(), hashFreeItems(), hashFreeMemory(), PconnModule::remove(), and table.

Member Function Documentation

◆ closeN()

void PconnPool::closeN ( int n )

Definition at line 530 of file pconn.cc.

References closeN(), count(), hash_first(), hash_next(), Must, and table.

Referenced by closeN(), and PeerPoolMgr::closeOldConnections().

◆ count() [1/2]

int PconnPool::count ( ) const

inline

Definition at line 144 of file pconn.h.

References theCount.

Referenced by closeN().

◆ count() [2/2]

void PconnPool::count ( int uses )

Referenced by PeerPoolMgr::checkpoint(), and peerHasConnAvailable().

◆ dump()

void PconnPool::dump ( std::ostream & yaml ) const

Definition at line 397 of file pconn.cc.

References descr, dumpHash(), and dumpHist().

◆ dumpHash()

void PconnPool::dumpHash ( std::ostream & yaml ) const

private

Definition at line 383 of file pconn.cc.

References IdleConnList::count(), hash_first(), hash_next(), and table.

Referenced by dump().

◆ dumpHist()

void PconnPool::dumpHist ( std::ostream & yaml ) const

private

Definition at line 367 of file pconn.cc.

References hist, and PCONN_HIST_SZ.

Referenced by dump().

◆ key()

const char * PconnPool::key	(	const Comm::ConnectionPointer &	destLink,
		const char *	domain
	)

staticprivate

Definition at line 347 of file pconn.cc.

References debugs, Comm::Connection::getPeer(), LOCAL_ARRAY, Comm::Connection::remote, SQUIDHOSTNAMELEN, and Ip::Address::toUrl().

Referenced by popStored(), and push().

◆ moduleInit()

void PconnPool::moduleInit ( )

◆ noteConnectionAdded()

void PconnPool::noteConnectionAdded ( )

inline

Definition at line 145 of file pconn.h.

References theCount.

Referenced by IdleConnList::push().

◆ noteConnectionRemoved()

void PconnPool::noteConnectionRemoved ( )

inline

Definition at line 146 of file pconn.h.

References assert, and theCount.

Referenced by IdleConnList::closeN(), and IdleConnList::removeAt().

◆ noteUses()

void PconnPool::noteUses ( int uses )

Definition at line 559 of file pconn.cc.

References hist, and PCONN_HIST_SZ.

Referenced by FwdState::closePendingConnection(), FwdState::closeServerConnection(), Http::Tunneler::countFailingConnection(), Security::PeerConnector::countFailingConnection(), and FwdState::serverClosed().

◆ notifyManager()

void PconnPool::notifyManager ( const char * reason )

Definition at line 523 of file pconn.cc.

References PeerPoolMgr::Checkpoint(), mgr, and CbcPointer< Cbc >::valid().

Referenced by IdleConnList::findAndClose(), popStored(), and push().

◆ pop()

Comm::ConnectionPointer PconnPool::pop	(	const Comm::ConnectionPointer &	dest,
		const char *	domain,
		bool	keepOpen
	)

Returns either a pointer to a popped connection to dest or nil. Closes the connection before returning its pointer unless keepOpen. For connection going to a cache_peer, supports standby connection pools.

A caller with a non-retriable transaction should set keepOpen to false and call pop() anyway, even though the caller does not want a pconn. This forces us to close an available persistent connection, avoiding creating a growing number of open connections when many transactions create (and push) persistent connections but are not retriable and, hence, do not need to pop a connection.

Definition at line 472 of file pconn.cc.

References Comm::Connection::getPeer(), and popStored().

Referenced by HappyConnOpener::reuseOldConnection().