#include <pconn.h>

Collaboration diagram for PconnPool:

[legend]

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	dumpHist (StoreEntry *e) const

void	dumpHash (StoreEntry *e) const

void	unlinkList (IdleConnList *list)

void	noteUses (int uses)

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

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)

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

int	theCount
	the number of pooled connections More...

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 112 of file pconn.h.

Constructor & Destructor Documentation

◆ PconnPool()

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

Definition at line 383 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 403 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 507 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 142 of file pconn.h.

References theCount.

Referenced by closeN().

◆ count() [2/2]

void PconnPool::count ( int uses )

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

◆ dumpHash()

void PconnPool::dumpHash ( StoreEntry * e ) const

Definition at line 369 of file pconn.cc.

References hash_first(), hash_next(), storeAppendPrintf(), and table.

◆ dumpHist()

void PconnPool::dumpHist ( StoreEntry * e ) const

Definition at line 351 of file pconn.cc.

References descr, hist, PCONN_HIST_SZ, and storeAppendPrintf().

◆ key()

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

staticprivate

Definition at line 331 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 143 of file pconn.h.

References theCount.

Referenced by IdleConnList::push().

◆ noteConnectionRemoved()

void PconnPool::noteConnectionRemoved ( )

inline

Definition at line 144 of file pconn.h.

References assert, and theCount.

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

◆ noteUses()

void PconnPool::noteUses ( int uses )

Definition at line 536 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 500 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 449 of file pconn.cc.

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

Referenced by HappyConnOpener::reuseOldConnection().