#include <CapturingStoreEntry.h>

Inheritance diagram for CapturingStoreEntry:

Collaboration diagram for CapturingStoreEntry:

Public Member Functions
	CapturingStoreEntry ()

void	buffer () override

void	flush () override

void	append (char const *buf, int len) override
	Appends a c-string to existing packed data. More...

bool	checkDeferRead (int fd) const

const char *	getMD5Text () const

MemObject &	mem ()

const MemObject &	mem () const

const HttpReply *	hasFreshestReply () const

bool	hasParsedReplyHeader () const
	whether this entry has access to [deserialized] [HTTP] response headers More...

void	write (StoreIOBuffer)

bool	isEmpty () const

bool	isAccepting () const

size_t	bytesWanted (Range< size_t > const aRange, bool ignoreDelayPool=false) const

void	completeSuccessfully (const char *whyWeAreSureWeStoredTheWholeReply)

void	completeTruncated (const char *whyWeConsiderTheReplyTruncated)

void	complete ()

store_client_t	storeClientType () const

const char *	getSerialisedMetaData (size_t &length) const

void	storeErrorResponse (HttpReply *reply)
	Store a prepared error response. MemObject locks the reply object. More...

void	replaceHttpReply (const HttpReplyPointer &, const bool andStartWriting=true)

void	startWriting ()

bool	mayStartSwapOut ()
	whether we may start writing to disk (now or in the future) More...

void	trimMemory (const bool preserveSwappable)

void	memOutDecision (const bool willCacheInRam)

void	swapOutDecision (const MemObject::SwapOut::Decision &decision)

void	storeWriterDone ()
	called when a store writer ends its work (successfully or not) More...

void	abort ()

bool	makePublic (const KeyScope keyScope=ksDefault)

void	makePrivate (const bool shareable)

void	clearPrivate ()

bool	setPublicKey (const KeyScope keyScope=ksDefault)

void	clearPublicKeyScope ()

const cache_key *	publicKey () const

void	setPrivateKey (const bool shareable, const bool permanent)

void	expireNow ()

void	releaseRequest (const bool shareable=false)

void	negativeCache ()

bool	cacheNegatively ()

void	invokeHandlers ()

void	cacheInMemory ()
	start or continue storing in memory cache More...

void	swapOut ()

bool	swappingOut () const
	whether we are in the process of writing this entry to disk More...

bool	swappedOut () const
	whether the entire entry is now on disk (possibly marked for deletion) More...

bool	swapoutFailed () const
	whether we failed to write this entry to disk More...

void	swapOutFileClose (int how)

const char *	url () const

bool	checkCachable ()

int	checkNegativeHit () const

int	locked () const

int	validToSend () const

bool	memoryCachable ()
	checkCachable() and can be cached in memory More...

void	createMemObject ()

void	createMemObject (const char storeId, const char logUri, const HttpRequestMethod &aMethod)
	initialize mem_obj with URIs/method; assert if mem_obj already exists More...

void	ensureMemObject (const char storeId, const char logUri, const HttpRequestMethod &aMethod)
	initialize mem_obj (if needed) and set URIs/method (if missing) More...

void	dump (int debug_lvl) const

void	hashDelete ()

void	hashInsert (const cache_key *)

void	registerAbortCallback (const AsyncCall::Pointer &)
	notify the StoreEntry writer of a 3rd-party initiated StoreEntry abort More...

void	reset ()

void	setMemStatus (mem_status_t)

bool	timestampsSet ()

void	unregisterAbortCallback (const char *reason)

void	destroyMemObject ()

int	checkTooSmall ()

void	setNoDelay (bool const)

void	lastModified (const time_t when)

time_t	lastModified () const

const char *	describeTimestamps () const

bool	modifiedSince (const time_t ims, const int imslen=-1) const

bool	hasIfMatchEtag (const HttpRequest &request) const
	has ETag matching at least one of the If-Match etags More...

bool	hasIfNoneMatchEtag (const HttpRequest &request) const
	has ETag matching at least one of the If-None-Match etags More...

bool	hasEtag (ETag &etag) const
	whether this entry has an ETag; if yes, puts ETag value into parameter More...

bool	updateOnNotModified (const StoreEntry &e304)

Store::Disk &	disk () const
	the disk this entry is [being] cached on; asserts for entries w/o a disk More...

bool	hasDisk (const sdirno dirn=-1, const sfileno filen=-1) const

void	attachToDisk (const sdirno, const sfileno, const swap_status_t)

void	detachFromDisk ()

bool	hasTransients () const
	whether there is a corresponding locked transients table entry More...

bool	hasMemStore () const
	whether there is a corresponding locked shared memory table entry More...

bool	hittingRequiresCollapsing () const
	whether this entry can feed collapsed requests and only them More...

void	setCollapsingRequirement (const bool required)
	allow or forbid collapsed requests feeding More...

void *	operator new (size_t byteCount)

void	operator delete (void *address)

int64_t	objectLen () const

int64_t	contentLen () const

void	lock (const char *context)

int	unlock (const char *context)

int	locks () const
	returns a local concurrent use counter, for debugging More...

void	touch ()
	update last reference timestamp and related Store metadata More...

void	release (const bool shareable=false)

void	abandon (const char *context)

bool	mayStartHitting () const

void	deferProducer (const AsyncCall::Pointer &producer)
	call back producer when more buffer space is available More...

void	kickProducer ()
	calls back producer registered with deferProducer More...

void	vappendf (const char *, va_list) override

void	appendf (const char *fmt,...) PRINTF_FORMAT_ARG2
	Append operation with printf-style arguments. More...

Static Public Member Functions
static size_t	inUseCount ()

Public Attributes
String	_appended_text

int	_buffer_calls

int	_flush_calls

MemObject *	mem_obj

RemovalPolicyNode	repl

time_t	timestamp

time_t	lastref

time_t	expires

uint64_t	swap_file_sz

uint16_t	refcount

uint16_t	flags

sfileno	swap_filen:25
	unique ID inside a cache_dir for swapped out entries; -1 for others More...

sdirno	swap_dirn:7

mem_status_t	mem_status:3

ping_status_t	ping_status:3

store_status_t	store_status:3

swap_status_t	swap_status:3

void *	key

hash_link *	next

Protected Types
typedef Store::EntryGuard	EntryGuard

Protected Member Functions
void	storeWritingCheckpoint ()

void	checkDisk () const
	does nothing except throwing if disk-associated data members are inconsistent More...

Private Member Functions
	MEMPROXY_CLASS (CapturingStoreEntry)

void	doAbandon (const char *context)

bool	checkTooBig () const

void	forcePublicKey (const cache_key *newkey)

StoreEntry *	adjustVary ()

const cache_key *	calcPublicKey (const KeyScope keyScope)

void	lengthWentBad (const char *reason)
	flags [truncated or too big] entry with ENTRY_BAD_LENGTH and releases it More...

bool	validLength () const

bool	hasOneOfEtags (const String &reqETags, const bool allowWeakMatch) const
	whether at least one of the request ETags matches entity ETag More...

Private Attributes
time_t	lastModified_
	received Last-Modified value or -1; use lastModified() More...

unsigned short	lock_count

bool	shareableWhenPrivate

AsyncCall::Pointer	deferredProducer
	producer callback registered with deferProducer More...

Static Private Attributes
static Mem::Allocator *	pool = nullptr

Detailed Description

Definition at line 16 of file CapturingStoreEntry.h.

Member Typedef Documentation

◆ EntryGuard

typedef Store::EntryGuard StoreEntry::EntryGuard

protectedinherited

Definition at line 302 of file Store.h.

Constructor & Destructor Documentation

◆ CapturingStoreEntry()

CapturingStoreEntry::CapturingStoreEntry ( )

inline

Definition at line 21 of file CapturingStoreEntry.h.

Member Function Documentation

◆ abandon()

void StoreEntry::abandon ( const char * context )

inlineinherited

One of the three methods to get rid of an unlocked StoreEntry object. May destroy this object if it is unlocked; does nothing otherwise. Unlike release(), may not trigger eviction of underlying store entries, but, unlike destroyStoreEntry(), does honor an earlier release request.

Definition at line 280 of file Store.h.

References StoreEntry::doAbandon(), and StoreEntry::locked().

Referenced by StoreEntry::unlock().

◆ abort()

void StoreEntry::abort ( )

inherited

◆ adjustVary()

StoreEntry * StoreEntry::adjustVary ( )

privateinherited

Updates mem_obj->request->vary_headers to reflect the current Vary. The vary_headers field is used to calculate the Vary marker key. Releases the old Vary marker with an outdated key (if any).

Returns: new (locked) Vary marker StoreEntry or, if none was needed, nil

Exceptions

std::exception on failures

Definition at line 665 of file store.cc.

References assert, SBuf::clear(), SBuf::cmp(), StoreEntry::completeSuccessfully(), HttpRequest::flags, MemObject::freshestReply(), RefCount< C >::getRaw(), Http::HDR_X_ACCELERATOR_VARY, Http::Message::header, httpMakeVaryMark(), SBuf::isEmpty(), MemObject::logUri(), StoreEntry::makePublic(), StoreEntry::mem_obj, HttpRequest::method, MemObject::method, HttpHeader::putStr(), StoreEntry::replaceHttpReply(), MemObject::request, Http::scOkay, HttpReply::setHeaders(), squid_curtime, StoreEntry::startWriting(), storeCreateEntry(), storeGetPublic(), MemObject::storeId(), TexcHere, StoreEntry::timestampsSet(), StoreEntry::unlock(), Http::VARY, HttpRequest::vary_headers, and MemObject::vary_headers.

Referenced by StoreEntry::setPublicKey().

◆ append()

void CapturingStoreEntry::append	(	char const *	buf,
		int	size
	)

inlineoverridevirtual

Reimplemented from StoreEntry.

Definition at line 35 of file CapturingStoreEntry.h.

References _appended_text, and String::append().

◆ appendf()

void Packable::appendf	(	const char *	fmt,
			...
	)

inlineinherited

Definition at line 61 of file Packable.h.

References Packable::vappendf().

◆ attachToDisk()

void StoreEntry::attachToDisk	(	const sdirno	dirn,
		const sfileno	fno,
		const swap_status_t	status
	)

inherited

Makes hasDisk(dirn, filn) true. The caller should have locked the corresponding disk store entry for reading or writing.

Definition at line 1940 of file store.cc.

References asHex(), StoreEntry::checkDisk(), debugs, StoreEntry::getMD5Text(), StoreEntry::swap_dirn, StoreEntry::swap_filen, StoreEntry::swap_status, and swapStatusStr.

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), Rock::SwapDir::anchorEntry(), and storeSwapOutStart().

◆ buffer()

void CapturingStoreEntry::buffer ( )

inlineoverridevirtual

disable sending content to the clients.

This just sets DELAY_SENDING.

Reimplemented from StoreEntry.

Definition at line 27 of file CapturingStoreEntry.h.

References _buffer_calls.

◆ bytesWanted()

size_t StoreEntry::bytesWanted	(	Range< size_t > const	aRange,
		bool	ignoreDelayPool = `false`
	)		const

inherited

Definition at line 213 of file store.cc.

References Range< C, S >::end, StoreEntry::mem_obj, MemObject::mostBytesWanted(), and MemObject::readAheadPolicyCanRead().

Referenced by StoreEntry::checkDeferRead(), Client::handleMoreAdaptedBodyAvailable(), ClientHttpRequest::noteMoreBodyDataAvailable(), and HttpStateData::readReply().

◆ cacheInMemory()

void StoreEntry::cacheInMemory ( )

inherited

◆ cacheNegatively()

bool StoreEntry::cacheNegatively ( )

inherited

Definition at line 188 of file store.cc.

References StoreEntry::makePublic(), and StoreEntry::negativeCache().

Referenced by HttpStateData::haveParsedReplyHeaders().

◆ calcPublicKey()

const cache_key * StoreEntry::calcPublicKey ( const KeyScope keyScope )

privateinherited

Calculates correct public key for feeding forcePublicKey(). Assumes adjustVary() has been called for this entry already.

Definition at line 652 of file store.cc.

References assert, RefCount< C >::getRaw(), StoreEntry::mem_obj, MemObject::method, MemObject::request, MemObject::storeId(), storeKeyPublic(), and storeKeyPublicByRequest().

Referenced by StoreEntry::clearPublicKeyScope(), and StoreEntry::setPublicKey().

◆ checkCachable()

bool StoreEntry::checkCachable ( )

inherited

Satisfies cachability requirements shared among disk and RAM caches. Encapsulates common checks of mayStartSwapOut() and memoryCachable(). TODO: Rename and make private so only those two methods can call this.

Definition at line 929 of file store.cc.

Referenced by StoreEntry::mayStartSwapOut(), StoreEntry::memoryCachable(), and storeSwapOutFileClosed().

◆ checkDeferRead()

bool StoreEntry::checkDeferRead ( int fd ) const

inherited

Definition at line 244 of file store.cc.

References StoreEntry::bytesWanted(), and INT_MAX.

Referenced by statObjects(), and StoreEntry::swapOut().

◆ checkDisk()

void StoreEntry::checkDisk ( ) const

protectedinherited

Definition at line 1961 of file store.cc.

References SquidConfig::cacheSwap, Config, CurrentException(), DBG_IMPORTANT, debugs, EBIT_TEST, StoreEntry::flags, Must, Store::DiskConfig::n_configured, RELEASE_REQUEST, StoreEntry::swap_dirn, StoreEntry::swap_filen, StoreEntry::swap_status, SWAPOUT_NONE, StoreEntry::swapoutFailed(), StoreEntry::swappedOut(), and StoreEntry::swappingOut().

Referenced by StoreEntry::attachToDisk(), and StoreEntry::hasDisk().

◆ checkNegativeHit()

int StoreEntry::checkNegativeHit ( ) const

inherited

Definition at line 1300 of file store.cc.

References EBIT_TEST, ENTRY_NEGCACHED, StoreEntry::expires, StoreEntry::flags, squid_curtime, STORE_OK, and StoreEntry::store_status.

Referenced by clientReplyContext::cacheHit().

◆ checkTooBig()

bool StoreEntry::checkTooBig ( ) const

privateinherited

Definition at line 918 of file store.cc.

References MemObject::baseReply(), Http::Message::content_length, MemObject::endOffset(), StoreEntry::mem_obj, and store_maxobjsize.

Referenced by StoreEntry::checkCachable().

◆ checkTooSmall()

int StoreEntry::checkTooSmall ( )

inherited

Definition at line 901 of file store.cc.

References MemObject::baseReply(), Config, Http::Message::content_length, EBIT_TEST, ENTRY_SPECIAL, StoreEntry::flags, StoreEntry::mem(), StoreEntry::mem_obj, SquidConfig::minObjectSize, MemObject::object_sz, SquidConfig::Store, STORE_OK, and StoreEntry::store_status.

Referenced by StoreEntry::checkCachable().

◆ clearPrivate()

void StoreEntry::clearPrivate ( )

inherited

A low-level method just resetting "private key" flags. To avoid key inconsistency please use forcePublicKey() or similar instead.

Definition at line 180 of file store.cc.

References assert, EBIT_CLR, EBIT_TEST, StoreEntry::flags, KEY_PRIVATE, RELEASE_REQUEST, and StoreEntry::shareableWhenPrivate.

Referenced by StoreEntry::forcePublicKey().

◆ clearPublicKeyScope()

void StoreEntry::clearPublicKeyScope ( )

inherited

Resets existing public key to a public key with default scope, releasing the old default-scope entry (if any). Does nothing if the existing public key already has default scope.

Definition at line 609 of file store.cc.

References StoreEntry::calcPublicKey(), EBIT_TEST, StoreEntry::flags, StoreEntry::forcePublicKey(), hash_link::key, KEY_PRIVATE, ksDefault, and storeKeyHashCmp.

Referenced by clientReplyContext::sendClientUpstreamResponse().

◆ complete()

void StoreEntry::complete ( )

inherited

Deprecated:: use either completeSuccessfully() or completeTruncated() instead

Definition at line 1031 of file store.cc.

References assert, current_time, debugs, EBIT_CLR, EBIT_TEST, MemObject::endOffset(), ENTRY_ABORTED, ENTRY_BAD_LENGTH, ENTRY_FWD_HDR_WAIT, StoreEntry::flags, StoreEntry::getMD5Text(), HttpRequest::hier, StoreEntry::invokeHandlers(), StoreEntry::lengthWentBad(), StoreEntry::mem_obj, StoreEntry::mem_status, MemObject::nclients, NOT_IN_MEMORY, MemObject::object_sz, MemObject::request, HierarchyLogEntry::store_complete_stop, STORE_OK, STORE_PENDING, StoreEntry::store_status, and StoreEntry::validLength().

Referenced by TestRock::addEntry(), StoreEntry::completeSuccessfully(), StoreEntry::completeTruncated(), Mgr::Action::fillEntry(), ClientHttpRequest::handleAdaptedHeader(), internalStart(), MimeIcon::load(), netdbBinaryExchange(), clientReplyContext::processMiss(), clientReplyContext::purgeDoPurge(), clientReplyContext::sendNotModified(), CacheManager::start(), statObjects(), storeDigestRewriteFinish(), TestUfs::testUfsSearch(), clientReplyContext::traceReply(), and urnHandleReply().

◆ completeSuccessfully()

void StoreEntry::completeSuccessfully ( const char * whyWeAreSureWeStoredTheWholeReply )

inherited

Signals that the entire response has been stored and no more append() calls should be expected; cf. completeTruncated().

Definition at line 1017 of file store.cc.

References StoreEntry::complete(), and debugs.

Referenced by StoreEntry::adjustVary(), FwdState::completed(), ClientHttpRequest::endRequestSatisfaction(), and StoreEntry::storeErrorResponse().

◆ completeTruncated()

void StoreEntry::completeTruncated ( const char * whyWeConsiderTheReplyTruncated )

inherited

Signals that a partial response (if any) has been stored but no more append() calls should be expected; cf. completeSuccessfully().

Definition at line 1024 of file store.cc.

References StoreEntry::complete(), and StoreEntry::lengthWentBad().

Referenced by FwdState::completed(), and ClientHttpRequest::endRequestSatisfaction().

◆ contentLen()

int64_t StoreEntry::contentLen ( ) const

inlineinherited

Definition at line 254 of file Store.h.

References MemObject::baseReply(), Http::Message::hdr_sz, StoreEntry::mem(), and StoreEntry::objectLen().

Referenced by ClientHttpRequest::logRequest(), store_client::moreToRead(), and storeLog().

◆ createMemObject() [1/2]

void StoreEntry::createMemObject ( )

inherited

initialize mem_obj; assert if mem_obj already exists avoid this method in favor of createMemObject(trio)!

Definition at line 1575 of file store.cc.

References assert, and StoreEntry::mem_obj.

Referenced by Rock::SwapDir::get(), MemStore::get(), Transients::get(), storeCreatePureEntry(), TestStoreHashIndex::testMaxSize(), TestStoreController::testMaxSize(), TestCacheManager::testRegister(), TestStoreController::testStats(), and TestStoreHashIndex::testStats().

◆ createMemObject() [2/2]

void StoreEntry::createMemObject	(	const char *	storeId,
		const char *	logUri,
		const HttpRequestMethod &	aMethod
	)

inherited

Definition at line 1582 of file store.cc.

References assert, StoreEntry::ensureMemObject(), and StoreEntry::mem_obj.

◆ deferProducer()

void StoreEntry::deferProducer ( const AsyncCall::Pointer & producer )

inherited

Definition at line 366 of file store.cc.

References debugs, and StoreEntry::deferredProducer.

Referenced by Client::handleMoreAdaptedBodyAvailable(), and ClientHttpRequest::noteMoreBodyDataAvailable().

◆ describeTimestamps()

const char * StoreEntry::describeTimestamps ( ) const

inherited

Returns: a formatted string with entry's timestamps

Definition at line 2000 of file store.cc.

References StoreEntry::expires, StoreEntry::lastModified_, StoreEntry::lastref, LOCAL_ARRAY, and StoreEntry::timestamp.

Referenced by statStoreEntry(), and StoreEntry::timestampsSet().

◆ destroyMemObject()

void StoreEntry::destroyMemObject ( )

inherited

Definition at line 386 of file store.cc.

References debugs, StoreEntry::hasMemStore(), StoreEntry::hasTransients(), StoreEntry::mem_obj, Store::Controller::memoryDisconnect(), NOT_IN_MEMORY, Store::Root(), StoreEntry::setMemStatus(), and Store::Controller::transientsDisconnect().

Referenced by destroyStoreEntry(), MemStore::evictCached(), and Store::Controller::memoryEvictCached().

◆ detachFromDisk()

void StoreEntry::detachFromDisk ( )

inherited

Makes hasDisk() false. The caller should have unlocked the corresponding disk store entry.

Definition at line 1953 of file store.cc.

References StoreEntry::swap_dirn, StoreEntry::swap_filen, StoreEntry::swap_status, and SWAPOUT_NONE.

Referenced by Rock::SwapDir::disconnect(), and Fs::Ufs::UFSSwapDir::evictCached().

◆ disk()

Store::Disk & StoreEntry::disk ( ) const

inherited

Definition at line 1920 of file store.cc.

References assert, StoreEntry::hasDisk(), INDEXSD, and StoreEntry::swap_dirn.

Referenced by Store::Disks::dereference(), destroyStoreEntry(), Store::Disks::evictCached(), Store::Disks::reference(), storeCleanup(), storeDirSwapLog(), storeOpen(), storeSwapOutFileClosed(), Store::Disks::updateAnchored(), and Store::Disks::updateHeaders().

◆ doAbandon()

void StoreEntry::doAbandon ( const char * context )

privateinherited

keep the unlocked StoreEntry object in the local store_table (if needed) or delete it (otherwise)

Definition at line 486 of file store.cc.

References assert, debugs, EBIT_TEST, StoreEntry::flags, Store::Controller::handleIdleEntry(), StoreEntry::locked(), StoreEntry::release(), RELEASE_REQUEST, Store::Root(), STORE_PENDING, StoreEntry::store_status, and storePendingNClients().

Referenced by StoreEntry::abandon().

◆ dump()

void StoreEntry::dump ( int debug_lvl ) const

inherited

◆ ensureMemObject()

void StoreEntry::ensureMemObject	(	const char *	storeId,
		const char *	logUri,
		const HttpRequestMethod &	aMethod
	)

inherited

Definition at line 1589 of file store.cc.

References StoreEntry::mem_obj, and MemObject::setUris().

Referenced by StoreEntry::createMemObject(), clientReplyContext::doGetMoreData(), peerDigestRequest(), and clientReplyContext::processExpired().

◆ expireNow()

void StoreEntry::expireNow ( )

inherited

Definition at line 773 of file store.cc.

References debugs, StoreEntry::expires, StoreEntry::getMD5Text(), and squid_curtime.

◆ flush()

void CapturingStoreEntry::flush ( )

inlineoverridevirtual

flush any buffered content.

This just clears DELAY_SENDING and Invokes the handlers to begin sending anything that may be buffered.

Reimplemented from StoreEntry.

Definition at line 31 of file CapturingStoreEntry.h.

References _flush_calls.

◆ forcePublicKey()

void StoreEntry::forcePublicKey ( const cache_key * newkey )

privateinherited

Unconditionally sets public key for this store entry. Releases the old entry with the same public key (if any).

Definition at line 626 of file store.cc.

References assert, StoreEntry::clearPrivate(), debugs, StoreEntry::hasDisk(), hash_lookup(), StoreEntry::hashDelete(), StoreEntry::hashInsert(), MemObject::hasUris(), hash_link::key, StoreEntry::mem_obj, store_table, storeDirSwapLog(), storeKeyText(), and SWAP_LOG_ADD.

Referenced by StoreEntry::clearPublicKeyScope(), and StoreEntry::setPublicKey().

◆ getMD5Text()

const char * StoreEntry::getMD5Text ( ) const

inherited

Definition at line 207 of file store.cc.

References hash_link::key, and storeKeyText().

Referenced by StoreEntry::abort(), StoreEntry::attachToDisk(), Store::CheckSwapMetaKey(), StoreEntry::complete(), store_client::copy(), StoreEntry::dump(), StoreEntry::expireNow(), HeapKeyGen_StoreEntry_GDSF(), HeapKeyGen_StoreEntry_LFUDA(), HeapKeyGen_StoreEntry_LRU(), StoreEntry::invokeHandlers(), StoreEntry::lock(), neighborsUdpPing(), HttpStateData::processReplyHeader(), ClientHttpRequest::rangeBoundaryStr(), StoreEntry::release(), StoreEntry::setMemStatus(), statClientRequests(), statStoreEntry(), storeClientCopy2(), storeDigestAdd(), storeDigestAddable(), storeDigestDel(), storeDigestRewriteStart(), storeDirSwapLog(), storeLog(), storeSwapInStart(), storeUnregister(), StoreEntry::swapOutFileClose(), StoreEntry::unlock(), StoreEntry::validLength(), and StoreEntry::write().

◆ getSerialisedMetaData()

const char * StoreEntry::getSerialisedMetaData ( size_t & length ) const

inherited

Returns: a malloc()ed buffer containing a length-long packed swap header

Definition at line 1750 of file store.cc.

References Store::PackSwapMeta().

Referenced by storeSwapOutStart().

◆ hasDisk()

bool StoreEntry::hasDisk	(	const sdirno	dirn = `-1`,
		const sfileno	filen = `-1`
	)		const

inherited

whether one of this StoreEntry owners has locked the corresponding disk entry (at the specified disk entry coordinates, if any)

Definition at line 1929 of file store.cc.

References StoreEntry::checkDisk(), Must, StoreEntry::swap_dirn, and StoreEntry::swap_filen.

Referenced by MemStore::anchorEntry(), Store::Disks::anchorToCache(), Rock::SwapDir::anchorToCache(), Store::Controller::anchorToCache(), Store::Disk::canLog(), StoreEntry::checkCachable(), Store::Controller::dereferenceIdle(), destroyStoreEntry(), Rock::SwapDir::disconnect(), StoreEntry::disk(), Store::Disks::evictCached(), Rock::SwapDir::evictCached(), Fs::Ufs::UFSSwapDir::evictCached(), StoreEntry::forcePublicKey(), StoreEntry::mayStartSwapOut(), store_client::moreToRead(), neighborsUdpPing(), Rock::SwapDir::openStoreIO(), Store::Controller::referenceBusy(), StoreEntry::release(), Fs::Ufs::UFSSwapDir::replacementRemove(), store_client::store_client(), storeCleanup(), storeDirSwapLog(), storeSwapInStart(), storeSwapOutStart(), StoreEntry::swapOut(), Store::Controller::syncCollapsed(), Store::Disks::updateAnchored(), Rock::SwapDir::updateAnchored(), and StoreEntry::validToSend().

◆ hasEtag()

bool StoreEntry::hasEtag ( ETag & etag ) const

inherited

Definition at line 1862 of file store.cc.

References Http::ETAG, StoreEntry::hasFreshestReply(), and ETag::str.

Referenced by clientReplyContext::processExpired().

◆ hasFreshestReply()

const HttpReply* StoreEntry::hasFreshestReply ( ) const

inlineinherited

Return values

*	the address of freshest reply (if mem_obj exists)
nullptr	when mem_obj does not exist

See also: MemObject::freshestReply()

Definition at line 53 of file Store.h.

References MemObject::freshestReply(), and StoreEntry::mem_obj.

Referenced by StoreEntry::hasEtag(), and refreshCheck().

◆ hashDelete()

void StoreEntry::hashDelete ( )

inherited

Definition at line 433 of file store.cc.

References hash_remove_link(), hash_link::key, store_table, and storeKeyFree().

Referenced by destroyStoreEntry(), StoreEntry::forcePublicKey(), and StoreEntry::setPrivateKey().

◆ hashInsert()

void StoreEntry::hashInsert ( const cache_key * someKey )

inherited

Definition at line 424 of file store.cc.

References assert, debugs, hash_join(), hash_link::key, store_table, storeKeyDup(), and storeKeyText().

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), Store::Controller::addReading(), StoreEntry::forcePublicKey(), and StoreEntry::setPrivateKey().

◆ hasIfMatchEtag()

bool StoreEntry::hasIfMatchEtag ( const HttpRequest & request ) const

inherited

Definition at line 1873 of file store.cc.

References HttpHeader::getList(), StoreEntry::hasOneOfEtags(), Http::Message::header, and Http::IF_MATCH.

Referenced by clientReplyContext::processConditional().

◆ hasIfNoneMatchEtag()

bool StoreEntry::hasIfNoneMatchEtag ( const HttpRequest & request ) const

inherited

Definition at line 1880 of file store.cc.

References HttpRequest::flags, HttpHeader::getList(), StoreEntry::hasOneOfEtags(), Http::Message::header, Http::IF_NONE_MATCH, RequestFlags::isRanged, HttpRequest::method, Http::METHOD_GET, and Http::METHOD_HEAD.

Referenced by clientReplyContext::processConditional().

◆ hasMemStore()

bool StoreEntry::hasMemStore ( ) const

inlineinherited

Definition at line 212 of file Store.h.

References MemObject::MemCache::index, StoreEntry::mem_obj, and MemObject::memCache.

Referenced by MemStore::anchorToCache(), Store::Controller::anchorToCache(), StoreEntry::destroyMemObject(), MemStore::disconnect(), MemStore::evictCached(), operator<<(), Store::Controller::syncCollapsed(), and MemStore::updateAnchored().

◆ hasOneOfEtags()

bool StoreEntry::hasOneOfEtags	(	const String &	reqETags,
		const bool	allowWeakMatch
	)		const

privateinherited

Definition at line 1891 of file store.cc.

References String::append(), Http::ETAG, etagIsStrongEqual(), etagIsWeakEqual(), etagParseInit(), MemObject::freshestReply(), HttpHeader::getETag(), Http::Message::header, StoreEntry::mem(), strListGetItem(), strListIsMember(), and String::termedBuf().

Referenced by StoreEntry::hasIfMatchEtag(), and StoreEntry::hasIfNoneMatchEtag().

◆ hasParsedReplyHeader()

bool StoreEntry::hasParsedReplyHeader ( ) const

inherited

Definition at line 231 of file store.cc.

References MemObject::baseReply(), debugs, StoreEntry::mem_obj, and Http::Message::psParsed.

Referenced by MemStore::copyFromShm(), store_client::handleBodyFromDisk(), and clientReplyContext::storeNotOKTransferDone().

◆ hasTransients()

bool StoreEntry::hasTransients ( ) const

inlineinherited

◆ hittingRequiresCollapsing()

bool StoreEntry::hittingRequiresCollapsing ( ) const

inlineinherited

Definition at line 215 of file Store.h.

References EBIT_TEST, ENTRY_REQUIRES_COLLAPSING, and StoreEntry::flags.

Referenced by Store::Controller::allowCollapsing(), Store::Controller::allowSharing(), Store::Controller::checkFoundCandidate(), ICPState::confirmAndPrepHit(), Store::Controller::dereferenceIdle(), Ipc::StoreMapAnchor::exportInto(), StoreEntry::setCollapsingRequirement(), and StoreClient::startCollapsingOn().

◆ inUseCount()

size_t StoreEntry::inUseCount ( )

staticinherited

Definition at line 199 of file store.cc.

References Mem::Allocator::getInUseCount(), and StoreEntry::pool.

Referenced by Store::Controller::getStats(), Store::Controller::stat(), and storeDigestCalcCap().

◆ invokeHandlers()

void StoreEntry::invokeHandlers ( )

inherited

Definition at line 838 of file store_client.cc.

References MemObject::clients, CodeContext::Current(), debugs, DELAY_SENDING, EBIT_TEST, ENTRY_FWD_HDR_WAIT, StoreEntry::flags, StoreEntry::getMD5Text(), dlink_list::head, StoreEntry::mem_obj, MemObject::nclients, node::next, CodeContext::Reset(), sc, storeClientCopy2(), and StoreEntry::swapOut().

Referenced by StoreEntry::abort(), StoreEntry::complete(), StoreEntry::flush(), Store::Controller::syncCollapsed(), and StoreEntry::write().

◆ isAccepting()

bool StoreEntry::isAccepting ( ) const

inherited

Definition at line 1988 of file store.cc.

References EBIT_TEST, ENTRY_ABORTED, StoreEntry::flags, STORE_PENDING, and StoreEntry::store_status.

Referenced by Client::abortOnBadEntry(), Store::Controller::checkFoundCandidate(), HttpStateData::processReplyBody(), WhoisState::readReply(), and urnHandleReply().

◆ isEmpty()

bool StoreEntry::isEmpty ( ) const

inlineinherited

Check if the Store entry is empty

Return values

true	Store contains 0 bytes of data.
false	Store contains 1 or more bytes of data.
false	Store contains negative content !!!!!!

Definition at line 65 of file Store.h.

References MemObject::endOffset(), and StoreEntry::mem().

Referenced by FwdState::checkRetry(), FwdState::completed(), Ssl::ServerBump::connectedOk(), errorAppendEntry(), Client::handleAdaptationAborted(), Client::handleAdaptationBlocked(), ClientHttpRequest::handleAdaptationFailure(), Client::handledEarlyAdaptationAbort(), HttpStateData::handleRequestBodyProducerAborted(), FwdState::retryOrBail(), ConnStateData::serveDelayedError(), StoreEntry::startWriting(), and StoreEntry::storeClientType().

◆ kickProducer()

void StoreEntry::kickProducer ( )

inherited

Definition at line 376 of file store.cc.

References StoreEntry::deferredProducer, and ScheduleCallHere.

Referenced by store_client::copy(), and storeUnregister().

◆ lastModified() [1/2]

time_t StoreEntry::lastModified ( ) const

inlineinherited

Returns: entry's 'effective' modification time

Definition at line 177 of file Store.h.

References StoreEntry::lastModified_, and StoreEntry::timestamp.

Referenced by StoreEntry::modifiedSince(), and StoreEntry::timestampsSet().

◆ lastModified() [2/2]

void StoreEntry::lastModified ( const time_t when )

inlineinherited

Definition at line 175 of file Store.h.

References StoreEntry::lastModified_.

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), clientReplyContext::cacheHit(), Ipc::StoreMapAnchor::exportInto(), htcpTstReply(), Fs::Ufs::UFSSwapDir::logEntry(), peerDigestFetchSetStats(), peerDigestRequest(), clientReplyContext::processExpired(), Fs::Ufs::RebuildState::rebuildFromDirectory(), refreshIsCachable(), refreshStaleness(), Ipc::StoreMapAnchor::set(), Store::UnpackIndexSwapMeta(), and UFSCleanLog::write().

◆ lengthWentBad()

void StoreEntry::lengthWentBad ( const char * reason )

privateinherited

Definition at line 1009 of file store.cc.

References debugs, EBIT_SET, ENTRY_BAD_LENGTH, StoreEntry::flags, and StoreEntry::releaseRequest().

Referenced by StoreEntry::complete(), and StoreEntry::completeTruncated().

◆ lock()

void StoreEntry::lock ( const char * context )

inherited

claim shared ownership of this entry (for use in a given context) matching lock() and unlock() contexts eases leak triage but is optional

Definition at line 445 of file store.cc.

References debugs, StoreEntry::getMD5Text(), and StoreEntry::lock_count.

Referenced by StoreEntry::abort(), Client::Client(), store_client::copy(), clientReplyContext::doGetMoreData(), clientReplyContext::forgetHit(), Mgr::Forwarder::Forwarder(), FwdState::FwdState(), heap_purgeNext(), Rock::IoState::IoState(), MimeIcon::load(), ClientHttpRequest::loggingEntry(), peerDigestRequest(), clientReplyContext::processExpired(), StoreEntry::release(), Ssl::ServerBump::ServerBump(), clientReplyContext::setReplyToStoreEntry(), UrnState::start(), statObjectsStart(), store_client::store_client(), storeCreateEntry(), StoreEntry::storeErrorResponse(), Ipc::StoreMapUpdate::StoreMapUpdate(), storeSwapOutStart(), storeUnregister(), TestPackableStream::testGetStream(), and whoisStart().

◆ locked()

int StoreEntry::locked ( ) const

inlineinherited

◆ locks()

int StoreEntry::locks ( ) const

inlineinherited

Definition at line 265 of file Store.h.

References StoreEntry::lock_count.

Referenced by operator<<(), and statStoreEntry().

◆ makePrivate()

void StoreEntry::makePrivate ( const bool shareable )

inherited

Definition at line 174 of file store.cc.

References StoreEntry::releaseRequest().

Referenced by HttpStateData::haveParsedReplyHeaders(), HttpStateData::processSurrogateControl(), and WhoisState::readReply().

◆ makePublic()

bool StoreEntry::makePublic ( const KeyScope keyScope = ksDefault )

inherited

Definition at line 167 of file store.cc.

References EBIT_TEST, StoreEntry::flags, RELEASE_REQUEST, and StoreEntry::setPublicKey().

Referenced by StoreEntry::adjustVary(), Store::Controller::allowCollapsing(), StoreEntry::cacheNegatively(), HttpStateData::haveParsedReplyHeaders(), Ftp::Gateway::haveParsedReplyHeaders(), and WhoisState::readReply().

◆ mayStartHitting()

bool StoreEntry::mayStartHitting ( ) const

inlineinherited

May the caller commit to treating this [previously locked] entry as a cache hit?

Definition at line 284 of file Store.h.

References EBIT_TEST, StoreEntry::flags, KEY_PRIVATE, and StoreEntry::shareableWhenPrivate.

Referenced by clientReplyContext::cacheHit(), and clientReplyContext::handleIMSReply().

◆ mayStartSwapOut()

bool StoreEntry::mayStartSwapOut ( )

inherited

◆ mem() [1/2]

MemObject& StoreEntry::mem ( )

inlineinherited

Definition at line 47 of file Store.h.

References assert, and StoreEntry::mem_obj.

Referenced by TestRock::addEntry(), MemStore::anchorToCache(), Store::Controller::anchorToCache(), asHandleReply(), Client::blockCaching(), clientReplyContext::blockedHit(), store_client::canReadFromMemory(), Store::CheckSwapMetaUrl(), StoreEntry::checkTooSmall(), clientReplyContext::cloneReply(), FwdState::complete(), StoreEntry::contentLen(), MemStore::copyFromShm(), TestRock::createEntry(), Client::delayRead(), store_client::finishCallback(), clientReplyContext::handleIMSReply(), StoreEntry::hasOneOfEtags(), StoreEntry::isEmpty(), netdbExchangeHandleReply(), store_client::nextHttpReadOffset(), StoreEntry::objectLen(), Store::PackFields(), peerDigestFetchReply(), HttpStateData::peerSupportsConnectionPinning(), clientReplyContext::processConditional(), store_client::readBody(), FwdState::reforward(), clientReplyContext::replyStatus(), StoreEntry::reset(), store_client::sendingHttpHeaders(), clientReplyContext::sendNotModified(), clientReplyContext::storeOKTransferDone(), TestUfs::testUfsSearch(), StoreEntry::timestampsSet(), store_client::tryParsingHttpHeaders(), Store::UnpackHitSwapMeta(), Store::UnpackNewSwapMetaVaryHeaders(), MemStore::updateHeadersOrThrow(), urnHandleReply(), and varyEvaluateMatch().

◆ mem() [2/2]

const MemObject& StoreEntry::mem ( ) const

inlineinherited

Definition at line 48 of file Store.h.

References assert, and StoreEntry::mem_obj.

◆ memoryCachable()

bool StoreEntry::memoryCachable ( )

inherited

Definition at line 1276 of file store.cc.

References StoreEntry::checkCachable(), Config, MemObject::data_hdr, MemObject::inmem_lo, StoreEntry::mem_obj, SquidConfig::memory_cache_first, SquidConfig::onoff, StoreEntry::refcount, shutting_down, mem_hdr::size(), and StoreEntry::swappedOut().

Referenced by Store::Controller::keepForLocalMemoryCache(), and MemStore::shouldCache().

◆ memOutDecision()

void StoreEntry::memOutDecision ( const bool willCacheInRam )

inherited

Definition at line 1791 of file store.cc.

References assert, MemObject::MemCache::io, Store::ioDone, StoreEntry::mem_obj, MemObject::memCache, and StoreEntry::storeWritingCheckpoint().

Referenced by MemStore::startCaching(), and MemStore::write().

◆ MEMPROXY_CLASS()

CapturingStoreEntry::MEMPROXY_CLASS ( CapturingStoreEntry )

private

◆ modifiedSince()

bool StoreEntry::modifiedSince	(	const time_t	ims,
		const int	imslen = `-1`
	)		const

inherited

Definition at line 1836 of file store.cc.

References assert, debugs, StoreEntry::lastModified(), and StoreEntry::url().

Referenced by clientIfRangeMatch(), clientReplyContext::handleIMSReply(), and clientReplyContext::processConditional().

◆ negativeCache()

void StoreEntry::negativeCache ( )

inherited

Set object for negative caching. Preserves any expiry information given by the server. In absence of proper expiry info it will set to expire immediately, or with HTTP-violations enabled the configured negative-TTL is observed

Definition at line 1321 of file store.cc.

References Config, debugs, EBIT_SET, ENTRY_NEGCACHED, StoreEntry::expires, StoreEntry::flags, SquidConfig::negativeTtl, and squid_curtime.

Referenced by StoreEntry::abort(), StoreEntry::cacheNegatively(), and StoreEntry::storeErrorResponse().

◆ objectLen()

int64_t StoreEntry::objectLen ( ) const

inlineinherited

Definition at line 253 of file Store.h.

References StoreEntry::mem(), and MemObject::object_sz.

Referenced by StoreEntry::contentLen(), store_client::doCopy(), store_client::maybeWriteFromDiskToMemory(), store_client::moreToRead(), clientReplyContext::storeOKTransferDone(), storeSwapOutFileClosed(), StoreEntry::validLength(), and Http::Stream::writeComplete().

◆ operator delete()

void StoreEntry::operator delete ( void * address )

inherited

Definition at line 161 of file store.cc.

◆ operator new()

void * StoreEntry::operator new ( size_t byteCount )

inherited

Definition at line 149 of file store.cc.

References assert, and memPoolCreate.

◆ publicKey()

const cache_key* StoreEntry::publicKey ( ) const

inlineinherited

Returns: public key (if the entry has it) or nil (otherwise)

Definition at line 112 of file Store.h.

References EBIT_TEST, StoreEntry::flags, hash_link::key, and KEY_PRIVATE.

Referenced by Store::Disks::evictCached(), Rock::SwapDir::evictCached(), MemStore::evictCached(), and Rock::SwapDir::openStoreIO().

◆ registerAbortCallback()

void StoreEntry::registerAbortCallback ( const AsyncCall::Pointer & handler )

inherited

Definition at line 1481 of file store.cc.

References MemObject::abortCallback, assert, and StoreEntry::mem_obj.

Referenced by Ftp::Relay::Relay(), and FwdState::start().

◆ release()

void StoreEntry::release ( const bool shareable = false )

inherited

One of the three methods to get rid of an unlocked StoreEntry object. Removes all unlocked (and marks for eventual removal all locked) Store entries, including attached and unattached entries that have our key. Also destroys us if we are unlocked or makes us private otherwise.

Definition at line 1146 of file store.cc.

References debugs, destroyStoreEntry(), Store::Controller::evictCached(), StoreEntry::getMD5Text(), StoreEntry::hasDisk(), LateReleaseStack, StoreEntry::lock(), StoreEntry::locked(), StoreEntry::releaseRequest(), Store::Root(), Store::Controller::store_dirs_rebuilding, STORE_LOG_RELEASE, and storeLog().

Referenced by StoreEntry::doAbandon(), Store::Controller::handleIdleEntry(), clientReplyContext::handleIMSReply(), Ftp::Gateway::haveParsedReplyHeaders(), httpMaybeRemovePublic(), Fs::Ufs::UFSSwapDir::maintain(), clientReplyContext::purgeEntry(), Client::setFinalReply(), Store::Controller::syncCollapsed(), and TestRock::testRockSwapOut().

◆ releaseRequest()

void StoreEntry::releaseRequest ( const bool shareable = false )

inherited

Makes the StoreEntry private and marks the corresponding entry for eventual removal from the Store.

Definition at line 458 of file store.cc.

References debugs, EBIT_TEST, StoreEntry::flags, RELEASE_REQUEST, StoreEntry::setPrivateKey(), and StoreEntry::shareableWhenPrivate.

Referenced by StoreEntry::abort(), StoreEntry::checkCachable(), htcpClrStoreEntry(), HttpStateData::HttpStateData(), StoreEntry::lengthWentBad(), StoreEntry::makePrivate(), Store::EntryGuard::onException(), peerDigestFetchReply(), clientReplyContext::processMiss(), Ftp::Relay::Relay(), StoreEntry::release(), StoreEntry::storeErrorResponse(), storeSwapOutFileClosed(), clientReplyContext::traceReply(), and DigestFetchState::~DigestFetchState().

◆ replaceHttpReply()

void StoreEntry::replaceHttpReply	(	const HttpReplyPointer &	rep,
		const bool	andStartWriting = `true`
	)

inherited

◆ reset()

void StoreEntry::reset ( )

inherited

Definition at line 1621 of file store.cc.

References debugs, StoreEntry::expires, StoreEntry::lastModified_, StoreEntry::mem(), MemObject::reset(), StoreEntry::timestamp, and StoreEntry::url().

Referenced by FwdState::complete(), and HttpStateData::continueAfterParsingHeader().

◆ setCollapsingRequirement()

void StoreEntry::setCollapsingRequirement ( const bool required )

inherited

Definition at line 2012 of file store.cc.

References debugs, EBIT_CLR, EBIT_SET, ENTRY_REQUIRES_COLLAPSING, StoreEntry::flags, and StoreEntry::hittingRequiresCollapsing().

Referenced by Store::Controller::allowCollapsing(), Store::Controller::anchorToCache(), StoreEntry::startWriting(), and Store::Controller::syncCollapsed().

◆ setMemStatus()

void StoreEntry::setMemStatus ( mem_status_t new_status )

inherited

Definition at line 1524 of file store.cc.

References RemovalPolicy::Add, assert, debugs, EBIT_TEST, MemStore::Enabled(), ENTRY_SPECIAL, StoreEntry::flags, StoreEntry::getMD5Text(), hot_obj_count, IN_MEMORY, MemObject::inmem_lo, StoreEntry::mem_obj, mem_policy, StoreEntry::mem_status, RemovalPolicy::Remove, and MemObject::repl.

Referenced by StoreEntry::abort(), Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), MemStore::anchorEntry(), MemStore::copyFromShm(), StoreEntry::destroyMemObject(), and Store::Controller::handleIdleEntry().

◆ setNoDelay()

void StoreEntry::setNoDelay ( bool const newValue )

inherited

Definition at line 250 of file store.cc.

References StoreEntry::mem_obj, and MemObject::setNoDelay().

Referenced by HttpStateData::HttpStateData().

◆ setPrivateKey()

void StoreEntry::setPrivateKey	(	const bool	shareable,
		const bool	permanent
	)

inherited

Either fills this entry with private key or changes the existing key from public to private.

Parameters

permanent whether this entry should be private forever.

Definition at line 548 of file store.cc.

References assert, debugs, EBIT_SET, EBIT_TEST, Store::Controller::evictCached(), StoreEntry::flags, getKeyCounter(), hash_lookup(), StoreEntry::hashDelete(), StoreEntry::hashInsert(), MemObject::hasUris(), MemObject::id, hash_link::key, KEY_PRIVATE, StoreEntry::mem_obj, RELEASE_REQUEST, Store::Root(), StoreEntry::shareableWhenPrivate, store_table, and storeKeyPrivate().

Referenced by StoreEntry::releaseRequest(), and storeCreateEntry().

◆ setPublicKey()

bool StoreEntry::setPublicKey ( const KeyScope keyScope = ksDefault )

inherited

Definition at line 575 of file store.cc.

References Store::Controller::addWriting(), StoreEntry::adjustVary(), assert, StoreEntry::calcPublicKey(), debugs, EBIT_TEST, StoreEntry::flags, StoreEntry::forcePublicKey(), hash_link::key, KEY_PRIVATE, StoreEntry::mem_obj, RELEASE_REQUEST, Store::Root(), and Store::EntryGuard::unlockAndReset().

Referenced by TestRock::createEntry(), MimeIcon::load(), StoreEntry::makePublic(), storeCreateEntry(), storeDigestRewriteResume(), and TestUfs::testUfsSearch().

◆ startWriting()

void StoreEntry::startWriting ( )

inherited

pack and write reply headers and, maybe, body

Definition at line 1721 of file store.cc.

References assert, MemObject::baseReply(), StoreEntry::buffer(), StoreEntry::flush(), StoreEntry::isEmpty(), MemObject::markEndOfReplyHeaders(), StoreEntry::mem_obj, StoreEntry::setCollapsingRequirement(), and MemObject::updatedReply().

Referenced by StoreEntry::adjustVary(), StoreEntry::replaceHttpReply(), and Client::setFinalReply().

◆ storeClientType()

store_client_t StoreEntry::storeClientType ( ) const

inherited

◆ storeErrorResponse()

void StoreEntry::storeErrorResponse ( HttpReply * reply )

inherited

Definition at line 1688 of file store.cc.

References StoreEntry::buffer(), StoreEntry::completeSuccessfully(), StoreEntry::flush(), StoreEntry::lock(), StoreEntry::negativeCache(), StoreEntry::releaseRequest(), StoreEntry::replaceHttpReply(), and StoreEntry::unlock().

Referenced by errorAppendEntry(), and clientReplyContext::setReplyToReply().

◆ storeWriterDone()

void StoreEntry::storeWriterDone ( )

inherited

Definition at line 1808 of file store.cc.

References StoreEntry::storeWritingCheckpoint().

Referenced by MemStore::completeWriting(), MemStore::disconnect(), Rock::SwapDir::disconnect(), and storeSwapOutFileClosed().

◆ storeWritingCheckpoint()

void StoreEntry::storeWritingCheckpoint ( )

protectedinherited

If needed, signal transient entry readers that no more cache changes are expected and, hence, they should switch to Plan B instead of getting stuck waiting for us to start or finish storing the entry.

Definition at line 1761 of file store.cc.

References assert, debugs, MemObject::SwapOut::decision, StoreEntry::hasTransients(), MemObject::MemCache::io, Store::ioDone, StoreEntry::mem_obj, MemObject::memCache, Store::Controller::noteStoppedSharedWriting(), Store::Root(), MemObject::swapout, StoreEntry::swappingOut(), MemObject::SwapOut::swImpossible, and MemObject::SwapOut::swStarted.

Referenced by StoreEntry::memOutDecision(), StoreEntry::storeWriterDone(), and StoreEntry::swapOutDecision().

◆ swapOut()

void StoreEntry::swapOut ( )

inherited

Definition at line 153 of file store_swapout.cc.

References StoreEntry::abort(), assert, MemObject::availableForSwapOut(), StoreEntry::checkDeferRead(), DBG_CRITICAL, debugs, MemObject::SwapOut::decision, doPages(), EBIT_TEST, MemObject::endOffset(), ENTRY_ABORTED, StoreEntry::flags, StoreEntry::hasDisk(), MemObject::inmem_lo, MemObject::lowestMemReaderOffset(), StoreEntry::mayStartSwapOut(), StoreEntry::mem_obj, Store::Controller::memoryOut(), MemObject::object_sz, MemObject::objectBytesOnDisk(), StoreIOState::offset(), MemObject::SwapOut::queue_offset, RELEASE_REQUEST, Store::Root(), MemObject::SwapOut::sio, SM_PAGE_SIZE, STORE_OK, STORE_PENDING, StoreEntry::store_status, storeSwapOutStart(), storeTooManyDiskFilesOpen(), MemObject::swapout, StoreEntry::swapOutFileClose(), StoreEntry::swappingOut(), MemObject::SwapOut::swPossible, StoreEntry::url(), and StoreIOState::wroteAll.

Referenced by TestRock::addEntry(), StoreEntry::invokeHandlers(), storeUnregister(), and TestUfs::testUfsSearch().

◆ swapOutDecision()

void StoreEntry::swapOutDecision ( const MemObject::SwapOut::Decision & decision )

inherited

Definition at line 1800 of file store.cc.

References assert, MemObject::SwapOut::decision, StoreEntry::mem_obj, StoreEntry::storeWritingCheckpoint(), and MemObject::swapout.

Referenced by StoreEntry::mayStartSwapOut(), and storeSwapOutStart().

◆ swapoutFailed()

bool StoreEntry::swapoutFailed ( ) const

inlineinherited

Definition at line 137 of file Store.h.

References StoreEntry::swap_status, and SWAPOUT_FAILED.

Referenced by StoreEntry::checkDisk(), store_client::store_client(), StoreEntry::storeClientType(), storeSwapInStart(), and storeUnregister().

◆ swapOutFileClose()

void StoreEntry::swapOutFileClose ( int how )

inherited

Definition at line 257 of file store_swapout.cc.

References assert, debugs, StoreEntry::getMD5Text(), RefCount< C >::getRaw(), StoreEntry::mem_obj, MemObject::SwapOut::sio, storeClose(), and MemObject::swapout.

Referenced by StoreEntry::abort(), and StoreEntry::swapOut().

◆ swappedOut()

bool StoreEntry::swappedOut ( ) const

inlineinherited

Definition at line 135 of file Store.h.

References StoreEntry::swap_status, and SWAPOUT_DONE.

Referenced by Store::Disk::canLog(), StoreEntry::checkDisk(), Fs::Ufs::UFSSwapDir::evictCached(), Store::Controller::handleIdleEntry(), StoreEntry::memoryCachable(), StoreEntry::storeClientType(), and storeUnregister().

◆ swappingOut()

bool StoreEntry::swappingOut ( ) const

inlineinherited

Definition at line 133 of file Store.h.

References StoreEntry::swap_status, and SWAPOUT_WRITING.

Referenced by StoreEntry::checkDisk(), doPages(), store_client::fileRead(), StoreEntry::mayStartSwapOut(), storeSwapOutFileClosed(), StoreEntry::storeWritingCheckpoint(), StoreEntry::swapOut(), and StoreEntry::validToSend().

◆ timestampsSet()

bool StoreEntry::timestampsSet ( )

inherited

◆ touch()

void StoreEntry::touch ( )

inherited

Definition at line 452 of file store.cc.

References StoreEntry::lastref, and squid_curtime.

◆ trimMemory()

void StoreEntry::trimMemory ( const bool preserveSwappable )

inherited

Definition at line 1814 of file store.cc.

References debugs, EBIT_TEST, ENTRY_SPECIAL, StoreEntry::flags, IN_MEMORY, MemObject::inmem_lo, StoreEntry::mem_obj, StoreEntry::mem_status, MemObject::trimSwappable(), and MemObject::trimUnSwappable().

Referenced by Store::Controller::memoryOut().

◆ unlock()

int StoreEntry::unlock ( const char * context )

inherited

disclaim shared ownership; may remove entry from store and delete it returns remaining lock level (zero for unlocked and possibly gone entry)

Definition at line 469 of file store.cc.

References StoreEntry::abandon(), assert, debugs, StoreEntry::getMD5Text(), and StoreEntry::lock_count.

Referenced by StoreEntry::abort(), StoreEntry::adjustVary(), store_client::copy(), ClientHttpRequest::doCallouts(), clientReplyContext::forgetHit(), heap_purgeDone(), ClientHttpRequest::loggingEntry(), Store::EntryGuard::onException(), peerCountMcastPeersAbort(), peerDigestFetchReply(), clientReplyContext::removeStoreReference(), statObjects(), storeDigestRewriteResume(), StoreEntry::storeErrorResponse(), storeLateRelease(), storeSwapOutFileClosed(), storeUnregister(), TestRock::testRockSwapOut(), TestUfs::testUfsSearch(), Store::EntryGuard::unlockAndReset(), whoisClose(), Client::~Client(), DigestFetchState::~DigestFetchState(), FwdState::~FwdState(), netdbExchangeState::~netdbExchangeState(), PeerSelector::~PeerSelector(), store_client::~store_client(), and UrnState::~UrnState().

◆ unregisterAbortCallback()

void StoreEntry::unregisterAbortCallback ( const char * reason )

inherited

Avoid notifying anybody about a 3rd-party initiated StoreEntry abort. Calling this method does not cancel the already queued notification. TODO: Refactor to represent the end of (shared) ownership by our writer.

Definition at line 1489 of file store.cc.

References MemObject::abortCallback, assert, AsyncCall::cancel(), and StoreEntry::mem_obj.

Referenced by FwdState::~FwdState().

◆ updateOnNotModified()

bool StoreEntry::updateOnNotModified ( const StoreEntry & e304 )

inherited

Updates easily-accessible non-Store-specific parts of the entry. Use Controller::updateOnNotModified() instead of this helper.

Returns: whether anything was actually updated

Definition at line 1452 of file store.cc.

References MemObject::appliedUpdates, assert, MemObject::baseReply(), Config, debugs, MemObject::freshestReply(), Here, SquidConfig::maxReplyHeaderSize, StoreEntry::mem_obj, HttpReply::recreateOnNotModified(), StoreEntry::timestampsSet(), ToSBuf(), and MemObject::updateReply().

Referenced by Store::Controller::updateOnNotModified().

◆ url()

const char * StoreEntry::url ( ) const

inherited

Definition at line 1566 of file store.cc.

References StoreEntry::mem_obj, and MemObject::storeId().

Referenced by FwdState::complete(), FwdState::connectStart(), HttpStateData::continueAfterParsingHeader(), FwdState::dispatch(), ftpSendReply(), FwdState::FwdState(), Ftp::Gateway::Gateway(), clientReplyContext::handleIMSReply(), HttpStateData::handleMoreRequestBodyAvailable(), FwdState::handleUnregisteredServerEnd(), htcpClrStoreEntry(), htcpQuery(), HttpStateData::httpBuildRequestHeader(), httpStart(), HttpStateData::httpTimeout(), HttpStateData::keepaliveAccounting(), StoreEntry::mayStartSwapOut(), StoreEntry::modifiedSince(), neighborsUdpPing(), Store::PackFields(), peerSelect(), peerSelectIcpPing(), clientReplyContext::purgeEntry(), WhoisState::readReply(), FwdState::reforward(), StoreEntry::replaceHttpReply(), StoreEntry::reset(), clientReplyContext::sendMoreData(), UrnState::start(), CacheManager::start(), FwdState::Start(), HttpStateData::statusIfComplete(), storeDigestDel(), storeSwapOutFileClosed(), storeSwapOutStart(), StoreEntry::swapOut(), FwdState::unregister(), PeerSelector::url(), urnHandleReply(), FwdState::useDestinations(), whoisTimeout(), netdbExchangeState::~netdbExchangeState(), and PeerSelector::~PeerSelector().

◆ validLength()

bool StoreEntry::validLength ( ) const

privateinherited

whether the base response has all the body bytes we expect

Returns: true for responses with unknown/unspecified body length; true for responses with the right number of accumulated body bytes

Definition at line 1204 of file store.cc.

References assert, MemObject::baseReply(), debugs, StoreEntry::getMD5Text(), StoreEntry::mem_obj, MemObject::method, Http::METHOD_HEAD, StoreEntry::objectLen(), Http::scNoContent, and Http::scNotModified.

Referenced by StoreEntry::complete().

◆ validToSend()

int StoreEntry::validToSend ( ) const

inherited

Definition at line 1347 of file store.cc.

References EBIT_TEST, ENTRY_ABORTED, ENTRY_NEGCACHED, StoreEntry::expires, StoreEntry::flags, StoreEntry::hasDisk(), MemObject::inmem_lo, StoreEntry::mem_obj, RELEASE_REQUEST, squid_curtime, and StoreEntry::swappingOut().

Referenced by ICPState::confirmAndPrepHit().

◆ vappendf()

void StoreEntry::vappendf	(	const char *	fmt,
		va_list	ap
	)

overridevirtualinherited

Append operation, with vsprintf(3)-style arguments.

Note: arguments may be evaluated more than once, be careful of side-effects

XXX: This method either should not exist or should not be virtual. Kids should not be forced to re-implement vappendf() logic. That logic should be implemented once, using other [Packable] APIs. Packable is not about providing a printf(3) service. Packable is about writing opaque data to various custom destinations.

Implements Packable.

Definition at line 821 of file store.cc.

References StoreEntry::append(), assert, fatal(), LOCAL_ARRAY, and xstrerr().

Referenced by storeAppendPrintf(), and storeAppendVPrintf().

◆ write()

void StoreEntry::write ( StoreIOBuffer writeBuffer )

inherited

Member Data Documentation

◆ _appended_text

String CapturingStoreEntry::_appended_text

Definition at line 23 of file CapturingStoreEntry.h.

Referenced by append(), and TestPackableStream::testGetStream().

◆ _buffer_calls

int CapturingStoreEntry::_buffer_calls

Definition at line 24 of file CapturingStoreEntry.h.

Referenced by buffer(), and TestPackableStream::testGetStream().

◆ _flush_calls

int CapturingStoreEntry::_flush_calls

Definition at line 25 of file CapturingStoreEntry.h.

Referenced by flush(), and TestPackableStream::testGetStream().

◆ deferredProducer

AsyncCall::Pointer StoreEntry::deferredProducer

privateinherited

Definition at line 331 of file Store.h.

Referenced by StoreEntry::deferProducer(), and StoreEntry::kickProducer().

◆ expires

◆ flags

uint16_t StoreEntry::flags

inherited

Definition at line 231 of file Store.h.

Referenced by StoreEntry::abort(), Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), Store::Controller::addWriting(), MemStore::anchorEntry(), Rock::SwapDir::anchorEntry(), asHandleReply(), StoreEntry::buffer(), clientReplyContext::buildReplyHeader(), clientReplyContext::cacheHit(), Store::Disk::canLog(), Store::Disk::canStore(), StoreEntry::checkCachable(), StoreEntry::checkDisk(), StoreEntry::checkNegativeHit(), CheckQuickAbortIsReasonable(), Store::CheckSwapMetaKey(), StoreEntry::checkTooSmall(), Store::Controller::checkTransients(), StoreEntry::clearPrivate(), StoreEntry::clearPublicKeyScope(), StoreEntry::complete(), FwdState::completed(), store_client::copy(), MemStore::copyToShm(), Store::Controller::dereferenceIdle(), FwdState::dispatch(), StoreEntry::doAbandon(), dummy_action(), errorAppendEntry(), clientReplyContext::errorInStream(), Store::Disks::evictCached(), Ipc::StoreMapAnchor::exportInto(), StoreEntry::flush(), Store::Controller::handleIdleEntry(), clientReplyContext::handleIMSReply(), Http::One::Server::handleReply(), HttpStateData::haveParsedReplyHeaders(), heap_add(), StoreEntry::hittingRequiresCollapsing(), httpMaybeRemovePublic(), StoreEntry::invokeHandlers(), StoreEntry::isAccepting(), StoreEntry::lengthWentBad(), MimeIcon::load(), Fs::Ufs::UFSSwapDir::logEntry(), StoreEntry::makePublic(), FwdState::markStoredReplyAsWhole(), StoreEntry::mayStartHitting(), StoreEntry::mayStartSwapOut(), StoreEntry::negativeCache(), neighborsHtcpReply(), neighborsUdpAck(), netdbExchangeHandleReply(), operator<<(), peerDigestFetchedEnough(), peerDigestRequest(), peerSelectIcpPing(), clientReplyContext::processExpired(), clientReplyContext::processMiss(), HttpStateData::processReply(), HttpStateData::processReplyBody(), StoreEntry::publicKey(), HttpStateData::readReply(), Fs::Ufs::RebuildState::rebuildFromDirectory(), Store::Controller::referenceBusy(), FwdState::reforward(), refreshCheck(), StoreEntry::releaseRequest(), clientReplyContext::replyStatus(), HttpStateData::reusableReply(), clientReplyContext::sendClientOldEntry(), clientReplyContext::sendClientUpstreamResponse(), Client::sentRequestBody(), Ipc::StoreMapAnchor::set(), StoreEntry::setCollapsingRequirement(), Client::setFinalReply(), StoreEntry::setMemStatus(), StoreEntry::setPrivateKey(), StoreEntry::setPublicKey(), MemStore::shouldCache(), statObjects(), storeCleanup(), StoreEntry::storeClientType(), storeCreatePureEntry(), storeDigestAddable(), storeDigestDel(), storeDigestRewriteResume(), storeDirSwapLog(), storeEntryFlags(), storeRebuildParseEntry(), storeSwapInStart(), StoreEntry::swapOut(), Store::Controller::syncCollapsed(), TestCacheManager::testRegister(), StoreEntry::trimMemory(), Store::UnpackIndexSwapMeta(), Store::Controller::updateOnNotModified(), urnHandleReply(), StoreEntry::validToSend(), UFSCleanLog::write(), and StoreEntry::write().

◆ key

void* hash_link::key

inherited

Definition at line 19 of file hash.h.

Referenced by ACLExternal::aclMatchExternal(), MemStore::anchorToCache(), Rock::SwapDir::anchorToCache(), Store::CheckSwapMetaKey(), StoreEntry::clearPublicKeyScope(), ClientInfo::ClientInfo(), Rock::SwapDir::createStoreIO(), CommQuotaQueue::dequeue(), destroyStoreEntry(), CommQuotaQueue::enqueue(), external_acl_cache_add(), StoreEntry::forcePublicKey(), fqdncache_entry::fqdncache_entry(), fqdncacheAddEntry(), fqdncacheParse(), StoreEntry::getMD5Text(), hash_join(), hash_remove_link(), StoreEntry::hashDelete(), StoreEntry::hashInsert(), hashKeyStr(), Rock::SwapDir::hasReadableEntry(), htcpQuery(), IdleConnList::IdleConnList(), idnsStartQuery(), ipcache_entry::ipcache_entry(), ipcacheAddEntry(), ipcacheRelease(), Fs::Ufs::UFSSwapDir::logEntry(), Store::Controller::markedForDeletionAndAbandoned(), my_free(), ipcache_entry::name(), neighborsUdpPing(), net_db_name::net_db_name(), netdbHashInsert(), Ipc::StoreMap::openForUpdating(), Store::PackFields(), peerCountMcastPeersCreateAndSend(), StoreEntry::publicKey(), read_passwd_file(), Ipc::StoreMapAnchor::set(), StoreEntry::setPrivateKey(), StoreEntry::setPublicKey(), ClientInfo::setWriteLimiter(), MemStore::startCaching(), storeDigestAdd(), storeDigestDel(), storeKeyHashHash(), storeKeyText(), storeRebuildParseEntry(), Store::UnpackIndexSwapMeta(), WIN32_StoreKey(), wordlistAdd(), UFSCleanLog::write(), ClientInfo::~ClientInfo(), ExternalACLEntry::~ExternalACLEntry(), fqdncache_entry::~fqdncache_entry(), IdleConnList::~IdleConnList(), and net_db_name::~net_db_name().

◆ lastModified_

time_t StoreEntry::lastModified_

privateinherited

Definition at line 227 of file Store.h.

Referenced by StoreEntry::describeTimestamps(), StoreEntry::dump(), StoreEntry::lastModified(), StoreEntry::reset(), and StoreEntry::timestampsSet().

◆ lastref

time_t StoreEntry::lastref

inherited

Definition at line 224 of file Store.h.

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), StoreEntry::describeTimestamps(), StoreEntry::dump(), Ipc::StoreMapAnchor::exportInto(), HeapKeyGen_StoreEntry_GDSF(), HeapKeyGen_StoreEntry_LFUDA(), HeapKeyGen_StoreEntry_LRU(), Fs::Ufs::UFSSwapDir::logEntry(), lru_stats(), Fs::Ufs::RebuildState::rebuildFromDirectory(), Ipc::StoreMapAnchor::set(), storeCreatePureEntry(), StoreEntry::touch(), Store::UnpackIndexSwapMeta(), and UFSCleanLog::write().

◆ lock_count

unsigned short StoreEntry::lock_count

privateinherited

Definition at line 320 of file Store.h.

Referenced by StoreEntry::dump(), StoreEntry::lock(), StoreEntry::locked(), StoreEntry::locks(), and StoreEntry::unlock().

◆ mem_obj

MemObject* StoreEntry::mem_obj

inherited

Definition at line 220 of file Store.h.

Referenced by StoreEntry::abort(), Store::Disks::accumulateMore(), Transients::addEntry(), Transients::addReaderEntry(), Transients::addWriterEntry(), StoreEntry::adjustVary(), MemStore::anchorEntry(), StoreEntry::append(), CollapsedForwarding::Broadcast(), StoreEntry::bytesWanted(), clientReplyContext::cacheHit(), StoreEntry::calcPublicKey(), StoreEntry::checkCachable(), CheckQuickAbortIsReasonable(), StoreEntry::checkTooBig(), StoreEntry::checkTooSmall(), StoreEntry::complete(), FwdState::complete(), FwdState::completed(), MemStore::completeWriting(), Transients::completeWriting(), store_client::copy(), MemStore::copyFromShm(), MemStore::copyFromShmSlice(), MemStore::copyToShm(), MemStore::copyToShmSlice(), StoreEntry::createMemObject(), Store::Controller::dereferenceIdle(), StoreEntry::destroyMemObject(), MemStore::disconnect(), Rock::SwapDir::disconnect(), Transients::disconnect(), store_client::doCopy(), doPages(), StoreEntry::dump(), StoreEntry::ensureMemObject(), errorAppendEntry(), FwdState::establishTunnelThruProxy(), MemStore::evictCached(), Transients::evictCached(), store_client::fileRead(), Rock::SwapDir::finalizeSwapoutSuccess(), findPreviouslyCachedEntry(), StoreEntry::forcePublicKey(), Transients::get(), store_client::handleBodyFromDisk(), Store::Controller::handleIdleEntry(), StoreEntry::hasFreshestReply(), StoreEntry::hasMemStore(), StoreEntry::hasParsedReplyHeader(), StoreEntry::hasTransients(), Transients::hasWriter(), HttpStateData::haveParsedReplyHeaders(), heap_guessType(), HeapKeyGen_StoreEntry_GDSF(), HeapKeyGen_StoreEntry_LFUDA(), HeapKeyGen_StoreEntry_LRU(), httpMaybeRemovePublic(), StoreEntry::invokeHandlers(), Transients::isReader(), Transients::isWriter(), Store::Controller::keepForLocalMemoryCache(), MimeIcon::load(), store_client::maybeWriteFromDiskToMemory(), StoreEntry::mayStartSwapOut(), StoreEntry::mem(), StoreEntry::memoryCachable(), StoreEntry::memOutDecision(), Transients::monitorIo(), neighborsHtcpReply(), neighborsUdpAck(), neighborsUdpPing(), objectSizeForDirSelection(), operator<<(), peerCountHandleIcpReply(), peerCountMcastPeersAbort(), peerCountMcastPeersCreateAndSend(), peerDigestFetchReply(), peerDigestFetchSetStats(), peerDigestSwapInCBlock(), Transients::readers(), store_client::readFromMemory(), store_client::readHeader(), HttpStateData::readReply(), Store::Controller::referenceBusy(), FwdState::reforward(), refreshCheck(), refreshCheckDigest(), refreshIsCachable(), StoreEntry::registerAbortCallback(), repl_guessType(), StoreEntry::replaceHttpReply(), StoreEntry::setMemStatus(), StoreEntry::setNoDelay(), LruPolicyData::setPolicyNode(), HeapPolicyData::setPolicyNode(), StoreEntry::setPrivateKey(), StoreEntry::setPublicKey(), MemStore::shouldCache(), store_client::skipHttpHeadersFromDisk(), FwdState::Start(), MemStore::startCaching(), StoreEntry::startWriting(), statObjectsOpenfdFilter(), statObjectsVmFilter(), statStoreEntry(), Transients::status(), storeClientListAdd(), StoreEntry::storeClientType(), storeDigestRewriteFinish(), storeDigestRewriteStart(), storeLog(), clientReplyContext::storeNotOKTransferDone(), storePendingNClients(), storeSwapInStart(), storeSwapOutFileClosed(), storeSwapOutStart(), storeUnregister(), StoreEntry::storeWritingCheckpoint(), StoreEntry::swapOut(), StoreEntry::swapOutDecision(), StoreEntry::swapOutFileClose(), Store::Controller::syncCollapsed(), TestRock::testRockSwapOut(), StoreEntry::timestampsSet(), StoreEntry::trimMemory(), StoreEntry::unregisterAbortCallback(), MemStore::updateAnchored(), MemStore::updateHeaders(), Store::Controller::updateOnNotModified(), StoreEntry::updateOnNotModified(), StoreEntry::url(), StoreEntry::validLength(), StoreEntry::validToSend(), varyEvaluateMatch(), MemStore::write(), StoreEntry::write(), and HttpStateData::wroteLast().

◆ mem_status

mem_status_t StoreEntry::mem_status

inherited

Definition at line 239 of file Store.h.

Referenced by clientReplyContext::cacheHit(), StoreEntry::complete(), Store::Controller::dereferenceIdle(), describeStatuses(), StoreEntry::dump(), operator<<(), Store::Controller::referenceBusy(), StoreEntry::setMemStatus(), MemStore::shouldCache(), storeSwapInStart(), StoreEntry::trimMemory(), and Store::Controller::updateOnNotModified().

◆ next

hash_link* hash_link::next

inherited

Definition at line 20 of file hash.h.

Referenced by clientdbGC(), Store::LocalSearch::copyBucket(), StoreEntry::dump(), hash_join(), hash_lookup(), hash_next(), hash_remove_link(), IdleConnList::IdleConnList(), and lru_stats().

◆ ping_status

◆ pool

Mem::Allocator * StoreEntry::pool = nullptr

staticprivateinherited

Definition at line 318 of file Store.h.

Referenced by StoreEntry::inUseCount().

◆ refcount

uint16_t StoreEntry::refcount

inherited

Definition at line 230 of file Store.h.

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), StoreEntry::dump(), Ipc::StoreMapAnchor::exportInto(), HeapKeyGen_StoreEntry_GDSF(), HeapKeyGen_StoreEntry_LFUDA(), Fs::Ufs::UFSSwapDir::logEntry(), StoreEntry::memoryCachable(), Fs::Ufs::RebuildState::rebuildFromDirectory(), Ipc::StoreMapAnchor::set(), statStoreEntry(), store_client::store_client(), storeCreatePureEntry(), Store::UnpackIndexSwapMeta(), and UFSCleanLog::write().

◆ repl

RemovalPolicyNode StoreEntry::repl

inherited

Definition at line 221 of file Store.h.

Referenced by Fs::Ufs::UFSSwapDir::dereference(), Rock::SwapDir::dereference(), heap_guessType(), Rock::SwapDir::ignoreReferences(), Fs::Ufs::UFSSwapDir::reference(), Rock::SwapDir::reference(), repl_guessType(), Fs::Ufs::UFSSwapDir::replacementAdd(), Fs::Ufs::UFSSwapDir::replacementRemove(), LruPolicyData::setPolicyNode(), HeapPolicyData::setPolicyNode(), and Rock::SwapDir::trackReferences().

◆ shareableWhenPrivate

bool StoreEntry::shareableWhenPrivate

privateinherited

Nobody can find/lock KEY_PRIVATE entries, but some transactions (e.g., collapsed requests) find/lock a public entry before it becomes private. May such transactions start using the now-private entry they previously locked? This member should not affect transactions that already started reading from the entry.

Definition at line 327 of file Store.h.

Referenced by StoreEntry::clearPrivate(), StoreEntry::mayStartHitting(), operator<<(), StoreEntry::releaseRequest(), and StoreEntry::setPrivateKey().

◆ store_status

store_status_t StoreEntry::store_status

inherited

Definition at line 243 of file Store.h.

Referenced by StoreEntry::abort(), Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), MemStore::anchorEntry(), Rock::SwapDir::anchorEntry(), StoreEntry::append(), clientReplyContext::cacheHit(), StoreEntry::checkNegativeHit(), CheckQuickAbortIsReasonable(), FwdState::checkRetry(), StoreEntry::checkTooSmall(), clientReplyContext::checkTransferDone(), StoreEntry::complete(), FwdState::completed(), MemStore::copyFromShm(), describeStatuses(), StoreEntry::doAbandon(), store_client::doCopy(), doPages(), StoreEntry::dump(), errorAppendEntry(), HttpStateData::httpTimeout(), StoreEntry::isAccepting(), StoreEntry::mayStartSwapOut(), store_client::moreToRead(), operator<<(), FwdState::reforward(), StoreEntry::storeClientType(), storeCreatePureEntry(), storeUnregister(), StoreEntry::swapOut(), TestStoreController::testMaxSize(), TestStoreHashIndex::testMaxSize(), TestStoreController::testStats(), TestStoreHashIndex::testStats(), MemStore::write(), and StoreEntry::write().

◆ swap_dirn

◆ swap_file_sz

uint64_t StoreEntry::swap_file_sz

inherited

◆ swap_filen

sfileno StoreEntry::swap_filen

inherited

Definition at line 235 of file Store.h.

Referenced by Fs::Ufs::UFSSwapDir::addDiskRestore(), addedEntry(), StoreEntry::attachToDisk(), StoreEntry::checkDisk(), Fs::Ufs::UFSSwapDir::dereference(), Rock::SwapDir::dereference(), StoreEntry::detachFromDisk(), Rock::SwapDir::disconnect(), Fs::Ufs::UFSSwapDir::doubleCheck(), StoreEntry::dump(), Fs::Ufs::UFSSwapDir::dumpEntry(), Rock::SwapDir::evictCached(), Fs::Ufs::UFSSwapDir::evictCached(), StoreEntry::hasDisk(), Fs::Ufs::UFSSwapDir::logEntry(), Fs::Ufs::UFSStrategy::open(), Rock::SwapDir::openStoreIO(), operator<<(), Fs::Ufs::UFSSwapDir::reference(), Rock::SwapDir::reference(), statStoreEntry(), storeDirSwapLog(), storeLog(), storeSwapOutFileClosed(), storeSwapOutStart(), TestRock::testRockSwapOut(), TestUfs::testUfsSearch(), StoreIOState::touchingStoreEntry(), Fs::Ufs::UFSStoreState::UFSStoreState(), Rock::SwapDir::updateAnchored(), Rock::SwapDir::updateHeaders(), and UFSCleanLog::write().

◆ swap_status

swap_status_t StoreEntry::swap_status

inherited

Definition at line 245 of file Store.h.

Referenced by addedEntry(), StoreEntry::attachToDisk(), StoreEntry::checkDisk(), describeStatuses(), StoreEntry::detachFromDisk(), StoreEntry::dump(), operator<<(), StoreEntry::storeClientType(), storeSwapOutFileClosed(), storeSwapOutStart(), StoreEntry::swapoutFailed(), StoreEntry::swappedOut(), StoreEntry::swappingOut(), and TestRock::testRockSwapOut().

◆ timestamp

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

src/tests/CapturingStoreEntry.h

squid-cache.org

Optimising Web Delivery

Public Member Functions

Static Public Member Functions

Public Attributes

Protected Types

Protected Member Functions

Private Member Functions

Private Attributes

Static Private Attributes

Detailed Description

Member Typedef Documentation

◆ EntryGuard

Constructor & Destructor Documentation

◆ CapturingStoreEntry()

Member Function Documentation

◆ abandon()

◆ abort()

◆ adjustVary()

◆ append()

◆ appendf()

◆ attachToDisk()

◆ buffer()

◆ bytesWanted()

◆ cacheInMemory()

◆ cacheNegatively()

◆ calcPublicKey()

◆ checkCachable()

◆ checkDeferRead()

◆ checkDisk()

◆ checkNegativeHit()

◆ checkTooBig()

◆ checkTooSmall()

◆ clearPrivate()

◆ clearPublicKeyScope()

◆ complete()

◆ completeSuccessfully()

◆ completeTruncated()

◆ contentLen()

◆ createMemObject() [1/2]

◆ createMemObject() [2/2]

◆ deferProducer()

◆ describeTimestamps()

◆ destroyMemObject()

◆ detachFromDisk()

◆ disk()

◆ doAbandon()

◆ dump()

◆ ensureMemObject()

◆ expireNow()

◆ flush()

◆ forcePublicKey()

◆ getMD5Text()

◆ getSerialisedMetaData()

◆ hasDisk()

◆ hasEtag()

◆ hasFreshestReply()

◆ hashDelete()

◆ hashInsert()

◆ hasIfMatchEtag()

◆ hasIfNoneMatchEtag()

◆ hasMemStore()

◆ hasOneOfEtags()

◆ hasParsedReplyHeader()

◆ hasTransients()

◆ hittingRequiresCollapsing()

◆ inUseCount()

◆ invokeHandlers()

◆ isAccepting()

◆ isEmpty()

◆ kickProducer()

◆ lastModified() [1/2]

◆ lastModified() [2/2]

◆ lengthWentBad()

◆ lock()

◆ locked()

◆ locks()

◆ makePrivate()

◆ makePublic()

◆ mayStartHitting()