#include <RockSwapDir.h>

Inheritance diagram for Rock::SwapDir:

[legend]

Collaboration diagram for Rock::SwapDir:

[legend]

Public Types
typedef RefCount< SwapDir >	Pointer

typedef Ipc::StoreMap	DirMap

Public Member Functions
	SwapDir ()

	~SwapDir () override

void	reconfigure () override

StoreEntry *	get (const cache_key *key) override

void	evictCached (StoreEntry &) override

void	evictIfFound (const cache_key *) override

void	disconnect (StoreEntry &e) override
	called when the entry is about to forget its association with cache_dir More...

uint64_t	currentSize () const override
	current size More...

uint64_t	currentCount () const override
	the total number of objects stored right now More...

bool	doReportStat () const override

void	finalizeSwapoutSuccess (const StoreEntry &) override
	finalize the successful swapout that has been already noticed by Store More...

void	finalizeSwapoutFailure (StoreEntry &) override
	abort the failed swapout that has been already noticed by Store More...

void	create () override
	create system resources needed for this store to operate in the future More...

void	parse (int index, char *path) override

bool	smpAware () const override
	whether this disk storage is capable of serving multiple workers More...

bool	hasReadableEntry (const StoreEntry &) const override
	whether this cache dir has an entry with `e.key` More...

SBuf	inodeMapPath () const

const char *	freeSlotsPath () const

int64_t	entryLimitAbsolute () const
	Core limit. More...

int64_t	entryLimitActual () const
	max number of possible entries in db More...

int64_t	slotLimitAbsolute () const
	Rock store implementation limit. More...

int64_t	slotLimitActual () const
	total number of slots in this db More...

bool	validSlotId (const SlotId slotId) const
	whether the given slot ID may point to a slot in this db More...

SlotId	reserveSlotForWriting ()
	finds and returns a free db slot to fill or throws More...

void	purgeSome ()
	purges one or more entries to make full() false and free some slots More...

int64_t	diskOffset (Ipc::Mem::PageId &pageId) const

int64_t	diskOffset (int filen) const

void	writeError (StoreIOState &sio)

void	noteFreeMapSlice (const Ipc::StoreMapSliceId fileno) override
	adjust slice-linked state before a locked Readable slice is erased More...

char const *	type () const

virtual bool	active () const

uint64_t	maxSize () const override

uint64_t	minSize () const override
	the minimum size the store will shrink to via normal housekeeping More...

int64_t	maxObjectSize () const override
	the maximum size of a storable object; -1 if unlimited More...

void	maxObjectSize (int64_t newMax)

void	getStats (StoreInfoStats &stats) const override
	collect statistics More...

void	stat (StoreEntry &) const override

int64_t	minObjectSize () const
	the size of the smallest entry this cache_dir can store More...

bool	objectSizeIsAcceptable (int64_t objSize) const

virtual void	dump (StoreEntry &) const

virtual bool	doubleCheck (StoreEntry &)

bool	canLog (StoreEntry const &e) const

virtual void	openLog ()

virtual void	closeLog ()

virtual void	logEntry (const StoreEntry &e, int op) const

virtual int	writeCleanStart ()

virtual void	writeCleanDone ()

virtual int	callback ()
	called once every main loop iteration; TODO: Move to UFS code. More...

virtual void	sync ()
	prepare for shutdown More...

virtual void	readCompleted (const char *buf, int len, int errflag, RefCount< ReadRequest >)=0

virtual void	writeCompleted (int errflag, size_t len, RefCount< WriteRequest >)=0

Public Attributes
uint64_t	slotSize
	all db slots are of this size More...

char *	path

int	index

int	disker
	disker kid id dedicated to this SwapDir or -1 More...

RemovalPolicy *	repl

int	removals

int	scanned

struct Store::Disk::Flags	flags

CleanLog *	cleanLog

struct {
int blksize

}	fs

Protected Member Functions
bool	anchorToCache (StoreEntry &) override

bool	updateAnchored (StoreEntry &) override

bool	needsDiskStrand () const override
	needs a dedicated kid process More...

void	init () override

ConfigOption *	getOptionTree () const override

bool	allowOptionReconfigure (const char *const option) const override

bool	canStore (const StoreEntry &e, int64_t diskSpaceNeeded, int &load) const override
	check whether we can store the entry; if we can, report current load More...

StoreIOState::Pointer	createStoreIO (StoreEntry &, StoreIOState::STIOCB , void ) override

StoreIOState::Pointer	openStoreIO (StoreEntry &, StoreIOState::STIOCB , void ) override

void	maintain () override
	purge while full(); it should be sufficient to purge just one More...

void	diskFull () override

void	reference (StoreEntry &e) override
	somebody needs this entry (many cache replacement policies need to know) More...

bool	dereference (StoreEntry &e) override

void	updateHeaders (StoreEntry *e) override
	make stored metadata and HTTP headers the same as in the given entry More...

bool	unlinkdUseful () const override
	whether SwapDir may benefit from unlinkd More...

void	statfs (StoreEntry &e) const override

void	ioCompletedNotification () override

void	closeCompleted () override

void	readCompleted (const char *buf, int len, int errflag, RefCount< ::ReadRequest >) override

void	writeCompleted (int errflag, size_t len, RefCount< ::WriteRequest >) override

void	parseSize (const bool reconfiguring)
	parses anonymous cache_dir size option More...

void	validateOptions ()
	warns of configuration problems; may quit More...

bool	parseTimeOption (char const option, const char value, int reconfiguring)
	parses time-specific options; mimics SwapDir::optionObjectSizeParse() More...

void	dumpTimeOption (StoreEntry *e) const
	reports time-specific options; mimics SwapDir::optionObjectSizeDump() More...

bool	parseRateOption (char const option, const char value, int reconfiguring)
	parses rate-specific options; mimics SwapDir::optionObjectSizeParse() More...

void	dumpRateOption (StoreEntry *e) const
	reports rate-specific options; mimics SwapDir::optionObjectSizeDump() More...

bool	parseSizeOption (char const option, const char value, int reconfiguring)
	parses size-specific options; mimics SwapDir::optionObjectSizeParse() More...

void	dumpSizeOption (StoreEntry *e) const
	reports size-specific options; mimics SwapDir::optionObjectSizeDump() More...

bool	full () const
	no more entries can be stored without purging More...

void	trackReferences (StoreEntry &e)
	add to replacement policy scope More...

void	ignoreReferences (StoreEntry &e)
	delete from repl policy scope More...

int64_t	diskOffsetLimit () const

void	updateHeadersOrThrow (Ipc::StoreMapUpdate &update)

StoreIOState::Pointer	createUpdateIO (const Ipc::StoreMapUpdate &, StoreIOState::STIOCB , void )

void	anchorEntry (StoreEntry &e, const sfileno filen, const Ipc::StoreMapAnchor &anchor)

void	parseOptions (int reconfiguring)

void	dumpOptions (StoreEntry *e) const

int64_t	sizeInBlocks (const int64_t size) const

Protected Attributes
const char *	filePath
	location of cache storage file inside path/ More...

DirMap *	map
	entry key/sfileno to MaxExtras/inode mapping More...

uint64_t	max_size
	maximum allocatable size of the storage area More...

int64_t	min_objsize
	minimum size of any object stored here (-1 for no limit) More...

int64_t	max_objsize
	maximum size of any object stored here (-1 for no limit) More...

Private Member Functions
void	createError (const char *const msg)

void	handleWriteCompletionSuccess (const WriteRequest &request)
	code shared by writeCompleted() success handling cases More...

void	handleWriteCompletionProblem (const int errflag, const WriteRequest &request)
	code shared by writeCompleted() error handling cases More...

bool	optionReadOnlyParse (char const option, const char value, int reconfiguring)

void	optionReadOnlyDump (StoreEntry *e) const

bool	optionObjectSizeParse (char const option, const char value, int reconfiguring)

void	optionObjectSizeDump (StoreEntry *e) const

Private Attributes
DiskIOStrategy *	io

RefCount< DiskFile >	theFile
	cache storage for this cache_dir More...

Ipc::Mem::Pointer< Ipc::Mem::PageStack >	freeSlots
	all unused slots More...

Ipc::Mem::PageId *	waitingForPage
	one-page cache for a "hot" free slot More...

DiskFile::Config	fileConfig
	file-level configuration options More...

char const *	theType

Static Private Attributes
static const int64_t	HeaderSize = 16*1024
	on-disk db header size More...

Friends
class	Rebuild

class	IoState

class	HeaderUpdater

Detailed Description

Definition at line 32 of file RockSwapDir.h.

Member Typedef Documentation

◆ DirMap

typedef Ipc::StoreMap Rock::SwapDir::DirMap

Definition at line 36 of file RockSwapDir.h.

◆ Pointer

typedef RefCount<SwapDir> Rock::SwapDir::Pointer

Definition at line 35 of file RockSwapDir.h.

Constructor & Destructor Documentation

◆ SwapDir()

Rock::SwapDir::SwapDir ( )

Definition at line 41 of file RockSwapDir.cc.

◆ ~SwapDir()

Rock::SwapDir::~SwapDir ( )

override

Definition at line 47 of file RockSwapDir.cc.

References safe_free.

Member Function Documentation

◆ active()

bool Store::Disk::active ( ) const

virtualinherited

may be used in this strand

Definition at line 236 of file Disk.cc.

References IamWorkerProcess(), and KidIdentifier.

Referenced by Store::Disks::anchorToCache(), and Store::Disk::doReportStat().

◆ allowOptionReconfigure()

bool Rock::SwapDir::allowOptionReconfigure ( const char *const option ) const

overrideprotectedvirtual

Reimplemented from Store::Disk.

Definition at line 388 of file RockSwapDir.cc.

References Store::Disk::allowOptionReconfigure().

◆ anchorEntry()

void Rock::SwapDir::anchorEntry	(	StoreEntry &	e,
		const sfileno	filen,
		const Ipc::StoreMapAnchor &	anchor
	)

protected

Definition at line 106 of file RockSwapDir.cc.

References StoreEntry::attachToDisk(), Ipc::StoreMapAnchor::complete(), EBIT_SET, ENTRY_VALIDATED, Ipc::StoreMapAnchor::exportInto(), StoreEntry::flags, PING_NONE, StoreEntry::ping_status, STORE_OK, STORE_PENDING, StoreEntry::store_status, SWAPOUT_DONE, and SWAPOUT_WRITING.

◆ anchorToCache()

bool Rock::SwapDir::anchorToCache ( StoreEntry & )

overrideprotectedvirtual

tie StoreEntry to this storage if this storage has a matching entry

Return values

true	if this storage has a matching entry

Reimplemented from Store::Controlled.

Definition at line 75 of file RockSwapDir.cc.

References Assure, StoreEntry::hasDisk(), and hash_link::key.

◆ callback()

virtual int Store::Storage::callback ( )

inlinevirtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir, Store::Controller, Store::Disks, and StoreControllerStub.

Definition at line 72 of file Storage.h.

◆ canLog()

bool Store::Disk::canLog ( StoreEntry const & e ) const

inherited

Definition at line 188 of file Disk.cc.

References EBIT_TEST, ENTRY_SPECIAL, StoreEntry::flags, StoreEntry::hasDisk(), KEY_PRIVATE, RELEASE_REQUEST, StoreEntry::swap_file_sz, and StoreEntry::swappedOut().

◆ canStore()

bool Rock::SwapDir::canStore	(	const StoreEntry &	e,
		int64_t	diskSpaceNeeded,
		int &	load
	)		const

overrideprotectedvirtual

Implements Store::Disk.

Definition at line 583 of file RockSwapDir.cc.

References Store::Disk::canStore(), debugs, Ipc::Mem::PageId::ioPage, Ipc::Mem::PageLevel(), and Ipc::Mem::PageLimit().

◆ closeCompleted()

void Rock::SwapDir::closeCompleted ( )

overrideprotectedvirtual

Implements IORequestor.

Definition at line 834 of file RockSwapDir.cc.

◆ closeLog()

void Store::Disk::closeLog ( )

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 215 of file Disk.cc.

Referenced by storeDirCloseSwapLogs().

◆ create()

void Rock::SwapDir::create ( )

overridevirtual

Implements Store::Storage.

Definition at line 211 of file RockSwapDir.cc.

References assert, DBG_IMPORTANT, debugs, IamDiskProcess(), Must, O_BINARY, and UsingSmp().

Referenced by TestRock::setUp().

◆ createError()

void Rock::SwapDir::createError ( const char *const msg )

private

Definition at line 271 of file RockSwapDir.cc.

References DBG_CRITICAL, debugs, fatal(), and xstrerr().

◆ createStoreIO()

StoreIOState::Pointer Rock::SwapDir::createStoreIO	(	StoreEntry &	e,
		StoreIOState::STIOCB *	cbIo,
		void *	cbData
	)

overrideprotectedvirtual

Implements Store::Disk.

Definition at line 612 of file RockSwapDir.cc.

References assert, debugs, Rock::IoState::file(), hash_link::key, Ipc::StoreMapAnchor::set(), StoreIOState::swap_dirn, StoreIOState::swap_filen, and Rock::IoState::writeableAnchor_.

◆ createUpdateIO()

StoreIOState::Pointer Rock::SwapDir::createUpdateIO	(	const Ipc::StoreMapUpdate &	update,
		StoreIOState::STIOCB *	cbIo,
		void *	data
	)

protected

Definition at line 652 of file RockSwapDir.cc.

References Ipc::StoreMapUpdate::Edition::anchor, debugs, Ipc::StoreMapUpdate::entry, Rock::IoState::file(), Ipc::StoreMapUpdate::Edition::fileNo, Ipc::StoreMapUpdate::fresh, Must, StoreIOState::swap_dirn, StoreIOState::swap_filen, and Rock::IoState::writeableAnchor_.

◆ currentCount()

uint64_t Rock::SwapDir::currentCount ( ) const

overridevirtual

Implements Store::Storage.

Definition at line 156 of file RockSwapDir.cc.

Referenced by TestRock::testRockSwapOut().

◆ currentSize()

uint64_t Rock::SwapDir::currentSize ( ) const

overridevirtual

Implements Store::Storage.

Definition at line 147 of file RockSwapDir.cc.

◆ dereference()

bool Rock::SwapDir::dereference ( StoreEntry & e )

overrideprotectedvirtual

somebody no longer needs this entry (usually after calling reference()) return false iff the idle entry should be destroyed

Implements Store::Controlled.

Definition at line 997 of file RockSwapDir.cc.

References debugs, StoreEntry::repl, StoreEntry::swap_dirn, and StoreEntry::swap_filen.

◆ disconnect()

void Rock::SwapDir::disconnect ( StoreEntry & )

overridevirtual

Reimplemented from Store::Disk.

Definition at line 120 of file RockSwapDir.cc.

References assert, CollapsedForwarding::Broadcast(), StoreEntry::detachFromDisk(), StoreEntry::hasDisk(), StoreEntry::mem_obj, MemObject::SwapOut::sio, StoreEntry::storeWriterDone(), StoreEntry::swap_filen, MemObject::swapout, and Rock::IoState::writeableAnchor_.

◆ diskFull()

void Rock::SwapDir::diskFull ( )

overrideprotectedvirtual

Notify this disk that it is full. XXX move into a protected api call between store files and their stores, rather than a top level api call

Reimplemented from Store::Disk.

Definition at line 972 of file RockSwapDir.cc.

References DBG_IMPORTANT, and debugs.

◆ diskOffset() [1/2]

int64_t Rock::SwapDir::diskOffset ( int filen ) const

◆ diskOffset() [2/2]

int64_t Rock::SwapDir::diskOffset ( Ipc::Mem::PageId & pageId ) const

Definition at line 686 of file RockSwapDir.cc.

References assert, and Ipc::Mem::PageId::number.

◆ diskOffsetLimit()

int64_t Rock::SwapDir::diskOffsetLimit ( ) const

protected

Definition at line 693 of file RockSwapDir.cc.

References assert.

Referenced by Rock::Rebuild::Rebuild().

◆ doReportStat()

bool Rock::SwapDir::doReportStat ( ) const

overridevirtual

In SMP mode only the disker process reports stats to avoid counting the same stats by multiple processes.

Reimplemented from Store::Disk.

Definition at line 164 of file RockSwapDir.cc.

References IamDiskProcess(), and UsingSmp().

◆ doubleCheck()

bool Store::Disk::doubleCheck ( StoreEntry & )

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 46 of file Disk.cc.

Referenced by storeCleanup().

◆ dump()

void Store::Disk::dump ( StoreEntry & ) const

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 43 of file Disk.cc.

◆ dumpOptions()

void Store::Disk::dumpOptions ( StoreEntry * e ) const

protectedinherited

Definition at line 307 of file Disk.cc.

References ConfigOption::dump().

◆ dumpRateOption()

void Rock::SwapDir::dumpRateOption ( StoreEntry * e ) const

protected

Definition at line 486 of file RockSwapDir.cc.

References storeAppendPrintf().

Referenced by getOptionTree().

◆ dumpSizeOption()

void Rock::SwapDir::dumpSizeOption ( StoreEntry * e ) const

protected

Definition at line 534 of file RockSwapDir.cc.

References PRId64, and storeAppendPrintf().

Referenced by getOptionTree().

◆ dumpTimeOption()

void Rock::SwapDir::dumpTimeOption ( StoreEntry * e ) const

protected

Definition at line 435 of file RockSwapDir.cc.

References PRId64, and storeAppendPrintf().

Referenced by getOptionTree().

◆ entryLimitAbsolute()

int64_t Rock::SwapDir::entryLimitAbsolute ( ) const

inline

Definition at line 62 of file RockSwapDir.h.

References SwapFilenMax.

◆ entryLimitActual()

int64_t Rock::SwapDir::entryLimitActual ( ) const

Definition at line 204 of file RockSwapDir.cc.

References min().

Referenced by Rock::Rebuild::Rebuild(), and Rock::Rebuild::Stats::completed().

◆ evictCached()

void Rock::SwapDir::evictCached ( StoreEntry & e )

overridevirtual

Prevent new get() calls from returning the matching entry. If the matching entry is unused, it may be removed from the store now. The store entry is matched using either e attachment info or e.key.

Implements Store::Storage.

Definition at line 1022 of file RockSwapDir.cc.

References CollapsedForwarding::Broadcast(), debugs, StoreEntry::hasDisk(), StoreEntry::locked(), StoreEntry::publicKey(), and StoreEntry::swap_filen.

◆ evictIfFound()

void Rock::SwapDir::evictIfFound ( const cache_key * )

overridevirtual

An evictCached() equivalent for callers that did not get() a StoreEntry. Callers with StoreEntry objects must use evictCached() instead.

Implements Store::Storage.

Definition at line 1015 of file RockSwapDir.cc.

◆ finalizeSwapoutFailure()

void Rock::SwapDir::finalizeSwapoutFailure ( StoreEntry & )

overridevirtual

Implements Store::Disk.

Definition at line 179 of file RockSwapDir.cc.

References debugs.

◆ finalizeSwapoutSuccess()

void Rock::SwapDir::finalizeSwapoutSuccess ( const StoreEntry & )

overridevirtual

Implements Store::Disk.

Definition at line 170 of file RockSwapDir.cc.

References assert, StoreEntry::mem_obj, MemObject::SwapOut::sio, MemObject::swapout, and Rock::IoState::writeableAnchor_.

◆ freeSlotsPath()

const char * Rock::SwapDir::freeSlotsPath ( ) const

Definition at line 1106 of file RockSwapDir.cc.

References String::append(), and String::termedBuf().

◆ full()

bool Rock::SwapDir::full ( ) const

protected

Definition at line 964 of file RockSwapDir.cc.

◆ get()

StoreEntry * Rock::SwapDir::get ( const cache_key * )

overridevirtual

Returns: a possibly unlocked/unregistered stored entry with key (or nil) The returned entry might not match the caller's Store ID or method. The caller must abandon()/release() the entry or register it with Root(). This method must not trigger slow I/O operations (e.g., disk swap in).

Implements Store::Controlled.

Definition at line 56 of file RockSwapDir.cc.

References StoreEntry::createMemObject().

◆ getOptionTree()

ConfigOption * Rock::SwapDir::getOptionTree ( ) const

overrideprotectedvirtual

Reimplemented from Store::Disk.

Definition at line 369 of file RockSwapDir.cc.

References dumpRateOption(), dumpSizeOption(), dumpTimeOption(), Store::Disk::getOptionTree(), parseRateOption(), parseSizeOption(), parseTimeOption(), and vector.

◆ getStats()

void Store::Disk::getStats ( StoreInfoStats & stats ) const

overridevirtualinherited

Implements Store::Storage.

Definition at line 52 of file Disk.cc.

References Ping::stats.

◆ handleWriteCompletionProblem()

void Rock::SwapDir::handleWriteCompletionProblem	(	const int	errflag,
		const WriteRequest &	request
	)

private

Definition at line 920 of file RockSwapDir.cc.

References Rock::WriteRequest::sidCurrent, and Rock::WriteRequest::sio.

◆ handleWriteCompletionSuccess()

void Rock::SwapDir::handleWriteCompletionSuccess ( const WriteRequest & request )

private

Definition at line 881 of file RockSwapDir.cc.

References assert, DISK_OK, Rock::WriteRequest::eof, WriteRequest::len, Must, Ipc::StoreMapSlice::next, Rock::WriteRequest::sidCurrent, Rock::WriteRequest::sidPrevious, Rock::WriteRequest::sio, and Ipc::StoreMapSlice::size.

◆ hasReadableEntry()

bool Rock::SwapDir::hasReadableEntry ( const StoreEntry & e ) const

overridevirtual

Implements Store::Disk.

Definition at line 1115 of file RockSwapDir.cc.

References hash_link::key.

◆ ignoreReferences()

void Rock::SwapDir::ignoreReferences ( StoreEntry & e )

protected

Definition at line 1044 of file RockSwapDir.cc.

References debugs, and StoreEntry::repl.

◆ init()

void Rock::SwapDir::init ( )

overrideprotectedvirtual

Start preparing the store for use. To check readiness, callers should use readable() and writable() methods.

Implements Store::Storage.

Definition at line 280 of file RockSwapDir.cc.

References DBG_CRITICAL, debugs, fatal(), DiskIOModule::Find(), Must, MYNAME, and shm_old.

◆ inodeMapPath()

SBuf Rock::SwapDir::inodeMapPath ( ) const

Definition at line 1100 of file RockSwapDir.cc.

References Ipc::Mem::Segment::Name().

◆ ioCompletedNotification()

void Rock::SwapDir::ioCompletedNotification ( )

overrideprotectedvirtual

Implements IORequestor.

Definition at line 813 of file RockSwapDir.cc.

References debugs, fatalf(), Rock::Rebuild::Start(), storeRebuildComplete(), and xstrerr().

◆ logEntry()

void Store::Disk::logEntry	(	const StoreEntry &	e,
		int	op
	)		const

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 227 of file Disk.cc.

Referenced by storeDirSwapLog().

◆ maintain()

void Rock::SwapDir::maintain ( )

overrideprotectedvirtual

Implements Store::Storage.

Definition at line 980 of file RockSwapDir.cc.

◆ maxObjectSize() [1/2]

int64_t Store::Disk::maxObjectSize ( ) const

overridevirtualinherited

Implements Store::Storage.

Definition at line 103 of file Disk.cc.

References Config, SquidConfig::maxObjectSize, min(), and SquidConfig::Store.

Referenced by Fs::Ufs::UFSStoreState::write().

◆ maxObjectSize() [2/2]

void Store::Disk::maxObjectSize ( int64_t newMax )

inherited

configure the maximum object size for this storage area. May be any size up to the total storage area.

Definition at line 115 of file Disk.cc.

References DBG_PARSE_NOTE, and debugs.

◆ maxSize()

uint64_t Store::Disk::maxSize ( ) const

inlineoverridevirtualinherited

The maximum size the store will support in normal use. Inaccuracy is permitted, but may throw estimates for memory etc out of whack.

Implements Store::Storage.

Reimplemented in TestSwapDir.

Definition at line 48 of file Disk.h.

References Store::Disk::max_size.

◆ minObjectSize()

int64_t Store::Disk::minObjectSize ( ) const

inherited

Definition at line 96 of file Disk.cc.

References Config, SquidConfig::minObjectSize, and SquidConfig::Store.

◆ minSize()

uint64_t Store::Disk::minSize ( ) const

overridevirtualinherited

Implements Store::Storage.

Definition at line 89 of file Disk.cc.

References Config, SquidConfig::lowWaterMark, and SquidConfig::Swap.

◆ needsDiskStrand()

bool Rock::SwapDir::needsDiskStrand ( ) const

overrideprotectedvirtual

Reimplemented from Store::Disk.

Definition at line 311 of file RockSwapDir.cc.

References Config, DiskIOModule::Find(), InDaemonMode(), and SquidConfig::workers.

◆ noteFreeMapSlice()

void Rock::SwapDir::noteFreeMapSlice ( const Ipc::StoreMapSliceId sliceId )

overridevirtual

Implements Ipc::StoreMapCleaner.

Definition at line 740 of file RockSwapDir.cc.

References Ipc::Mem::PageStack::IdForSwapDirSpace(), Ipc::Mem::PageId::number, and Ipc::Mem::PageId::pool.

◆ objectSizeIsAcceptable()

bool Store::Disk::objectSizeIsAcceptable ( int64_t objSize ) const

inherited

whether we can store an object of the given size negative objSize means the object size is currently unknown

Definition at line 156 of file Disk.cc.

References assert.

◆ openLog()

void Store::Disk::openLog ( )

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 212 of file Disk.cc.

Referenced by storeDirOpenSwapLogs().

◆ openStoreIO()

StoreIOState::Pointer Rock::SwapDir::openStoreIO	(	StoreEntry &	e,
		StoreIOState::STIOCB *	cbIo,
		void *	cbData
	)

overrideprotectedvirtual

Implements Store::Disk.

Definition at line 755 of file RockSwapDir.cc.

References assert, Ipc::StoreMapAnchor::basics, debugs, Rock::IoState::file(), StoreEntry::hasDisk(), Ipc::Mem::PageId::ioPage, Ipc::Mem::PageLevel(), Ipc::Mem::PageLimit(), StoreEntry::publicKey(), Rock::IoState::readableAnchor_, Ipc::StoreMapAnchor::sameKey(), StoreIOState::swap_dirn, Ipc::StoreMapAnchor::Basics::swap_file_sz, StoreEntry::swap_file_sz, StoreEntry::swap_filen, and StoreIOState::swap_filen.

◆ optionObjectSizeDump()

void Store::Disk::optionObjectSizeDump ( StoreEntry * e ) const

privateinherited

Definition at line 382 of file Disk.cc.

References PRId64, and storeAppendPrintf().

Referenced by Store::Disk::getOptionTree().

◆ optionObjectSizeParse()

bool Store::Disk::optionObjectSizeParse	(	char const *	option,
		const char *	value,
		int	reconfiguring
	)

privateinherited

Definition at line 347 of file Disk.cc.

References DBG_IMPORTANT, debugs, self_destruct(), size, and strtoll().

Referenced by Store::Disk::getOptionTree().

◆ optionReadOnlyDump()

void Store::Disk::optionReadOnlyDump ( StoreEntry * e ) const

privateinherited

Definition at line 340 of file Disk.cc.

References storeAppendPrintf().

Referenced by Store::Disk::getOptionTree().

◆ optionReadOnlyParse()

bool Store::Disk::optionReadOnlyParse	(	char const *	option,
		const char *	value,
		int	reconfiguring
	)

privateinherited

Definition at line 318 of file Disk.cc.

References DBG_PARSE_NOTE, debugs, and xatoi().

Referenced by Store::Disk::getOptionTree().

◆ parse()

void Rock::SwapDir::parse	(	int	index,
		char *	path
	)

overridevirtual

Implements Store::Disk.

Definition at line 320 of file RockSwapDir.cc.

References String::append(), assert, String::termedBuf(), and xstrdup.

Referenced by TestRock::setUp().

◆ parseOptions()

void Store::Disk::parseOptions ( int reconfiguring )

protectedinherited

Definition at line 267 of file Disk.cc.

References DBG_IMPORTANT, debugs, ConfigParser::NextToken(), ConfigOption::parse(), and self_destruct().

◆ parseRateOption()

bool Rock::SwapDir::parseRateOption	(	char const *	option,
		const char *	value,
		int	reconfiguring
	)

protected

Definition at line 444 of file RockSwapDir.cc.

References DBG_CRITICAL, DBG_IMPORTANT, debugs, self_destruct(), and strtoll().

Referenced by getOptionTree().

◆ parseSize()

void Rock::SwapDir::parseSize ( const bool reconfiguring )

protected

parse maximum db disk size

Definition at line 352 of file RockSwapDir.cc.

References DBG_IMPORTANT, debugs, fatal(), and GetInteger().

◆ parseSizeOption()

bool Rock::SwapDir::parseSizeOption	(	char const *	option,
		const char *	value,
		int	reconfiguring
	)

protected

Definition at line 494 of file RockSwapDir.cc.

References DBG_CRITICAL, DBG_IMPORTANT, debugs, self_destruct(), and strtoll().

Referenced by getOptionTree().

◆ parseTimeOption()

bool Rock::SwapDir::parseTimeOption	(	char const *	option,
		const char *	value,
		int	reconfiguring
	)

protected

Definition at line 396 of file RockSwapDir.cc.

References DBG_CRITICAL, DBG_IMPORTANT, debugs, self_destruct(), and strtoll().

Referenced by getOptionTree().

◆ purgeSome()

void Rock::SwapDir::purgeSome ( )

◆ readCompleted() [1/2]

void Rock::SwapDir::readCompleted	(	const char *	buf,
		int	len,
		int	errflag,
		RefCount< ::ReadRequest >	r
	)

overrideprotected

Definition at line 840 of file RockSwapDir.cc.

References assert, RefCount< C >::getRaw(), Rock::IoState::handleReadCompletion(), and Rock::ReadRequest::sio.

◆ readCompleted() [2/2]

virtual void IORequestor::readCompleted	(	const char *	buf,
		int	len,
		int	errflag,
		RefCount< ReadRequest >
	)

pure virtualinherited

Implemented in Fs::Ufs::UFSStoreState.

Referenced by MmappedFile::read(), IpcIoFile::readCompleted(), DiskdFile::readDone(), BlockingFile::readDone(), and DiskThreadsDiskFile::readDone().

◆ reconfigure()

void Rock::SwapDir::reconfigure ( )

overridevirtual

Implements Store::Disk.

Definition at line 342 of file RockSwapDir.cc.

◆ reference()

void Rock::SwapDir::reference ( StoreEntry & e )

overrideprotectedvirtual

Implements Store::Controlled.

Definition at line 989 of file RockSwapDir.cc.

References debugs, StoreEntry::repl, StoreEntry::swap_dirn, and StoreEntry::swap_filen.

◆ reserveSlotForWriting()

Rock::SlotId Rock::SwapDir::reserveSlotForWriting ( )

Definition at line 700 of file RockSwapDir.cc.

References assert, debugs, Ipc::Mem::PageId::number, Ipc::Mem::PageId::set(), and TexcHere.

◆ sizeInBlocks()

int64_t Store::Disk::sizeInBlocks ( const int64_t size ) const

inlineprotectedinherited

Definition at line 87 of file Disk.h.

References Store::Disk::fs, and size.

◆ slotLimitAbsolute()

int64_t Rock::SwapDir::slotLimitAbsolute ( ) const

Definition at line 186 of file RockSwapDir.cc.

References assert, and max().

◆ slotLimitActual()

int64_t Rock::SwapDir::slotLimitActual ( ) const

Definition at line 195 of file RockSwapDir.cc.

References max(), and min().

Referenced by Rock::Rebuild::Rebuild(), and Rock::Rebuild::Stats::completed().

◆ smpAware()

bool Rock::SwapDir::smpAware ( ) const

inlineoverridevirtual

Implements Store::Disk.

Definition at line 54 of file RockSwapDir.h.

◆ stat()

void Store::Disk::stat ( StoreEntry & e ) const

overridevirtualinherited

Output stats to the provided store entry. TODO: make these calls asynchronous

Implements Store::Storage.

Reimplemented in TestSwapDir.

Definition at line 63 of file Disk.cc.

References storeAppendPrintf().

◆ statfs()

void Rock::SwapDir::statfs ( StoreEntry & e ) const

overrideprotectedvirtual

Reimplemented from Store::Disk.

Definition at line 1052 of file RockSwapDir.cc.

References Config, Math::doublePercent(), SquidConfig::max_open_disk_fds, PRIu64, Ping::stats, store_open_disk_fd, and storeAppendPrintf().

◆ sync()

virtual void Store::Storage::sync ( void )

inlinevirtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir, Store::Controller, and Store::Disks.

Definition at line 78 of file Storage.h.

◆ trackReferences()

void Rock::SwapDir::trackReferences ( StoreEntry & e )

protected

Definition at line 1036 of file RockSwapDir.cc.

References debugs, and StoreEntry::repl.

◆ type()

char const * Store::Disk::type ( ) const

inherited

Definition at line 230 of file Disk.cc.

◆ unlinkdUseful()

bool Rock::SwapDir::unlinkdUseful ( ) const

overrideprotectedvirtual

Implements Store::Disk.

Definition at line 1008 of file RockSwapDir.cc.

◆ updateAnchored()

bool Rock::SwapDir::updateAnchored ( StoreEntry & )

overrideprotectedvirtual

Update a local Transients entry with fresh info from this cache (if any). Return true iff the cache supports Transients entries and the given local Transients entry is now in sync with this storage.

Reimplemented from Store::Controlled.

Definition at line 93 of file RockSwapDir.cc.

References assert, StoreEntry::hasDisk(), StoreEntry::swap_file_sz, and StoreEntry::swap_filen.

◆ updateHeaders()

void Rock::SwapDir::updateHeaders ( StoreEntry * )

overrideprotectedvirtual

Reimplemented from Store::Controlled.

Definition at line 946 of file RockSwapDir.cc.

References debugs, AsyncJob::Start(), and StoreEntry::swap_filen.

◆ updateHeadersOrThrow()

void Rock::SwapDir::updateHeadersOrThrow ( Ipc::StoreMapUpdate & update )

protected

◆ validateOptions()

void Rock::SwapDir::validateOptions ( )

protected

check the results of the configuration; only level-0 debugging works here

Definition at line 541 of file RockSwapDir.cc.

References DBG_CRITICAL, debugs, fatal(), and max().

◆ validSlotId()

bool Rock::SwapDir::validSlotId ( const SlotId slotId ) const

Definition at line 734 of file RockSwapDir.cc.

◆ writeCleanDone()

void Store::Disk::writeCleanDone ( )

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 224 of file Disk.cc.

Referenced by storeDirWriteCleanLogs().

◆ writeCleanStart()

int Store::Disk::writeCleanStart ( )

virtualinherited

Reimplemented in Fs::Ufs::UFSSwapDir.

Definition at line 218 of file Disk.cc.

◆ writeCompleted() [1/2]

void Rock::SwapDir::writeCompleted	(	int	errflag,
		size_t	len,
		RefCount< ::WriteRequest >	r
	)

overrideprotected

Definition at line 849 of file RockSwapDir.cc.

References assert, CollapsedForwarding::Broadcast(), debugs, DISK_ERROR, DISK_OK, StoreIOState::e, Rock::WriteRequest::eof, Rock::IoState::expectedReply(), RefCount< C >::getRaw(), Rock::WriteRequest::id, WriteRequest::len, Rock::WriteRequest::sidCurrent, Rock::WriteRequest::sio, Rock::IoState::stillWaiting(), StoreIOState::swap_filen, and StoreIOState::touchingStoreEntry().

◆ writeCompleted() [2/2]

virtual void IORequestor::writeCompleted	(	int	errflag,
		size_t	len,
		RefCount< WriteRequest >
	)

pure virtualinherited

Implemented in Fs::Ufs::UFSStoreState.

Referenced by MmappedFile::write(), IpcIoFile::writeCompleted(), DiskdFile::writeDone(), BlockingFile::writeDone(), and DiskThreadsDiskFile::writeDone().

◆ writeError()

void Rock::SwapDir::writeError ( StoreIOState & sio )

Definition at line 932 of file RockSwapDir.cc.

References CollapsedForwarding::Broadcast(), StoreIOState::e, StoreIOState::swap_filen, and StoreIOState::touchingStoreEntry().

Friends And Related Function Documentation

◆ HeaderUpdater

friend class HeaderUpdater

friend

Definition at line 134 of file RockSwapDir.h.

◆ IoState

friend class IoState

friend

Definition at line 133 of file RockSwapDir.h.

◆ Rebuild

friend class Rebuild

friend

Definition at line 132 of file RockSwapDir.h.

Member Data Documentation

◆ blksize

int Store::Disk::blksize

inherited

Definition at line 146 of file Disk.h.

◆ cleanLog

CleanLog* Store::Disk::cleanLog

inherited

Definition at line 140 of file Disk.h.

Referenced by UFSCleanLog::write().

◆ disker

int Store::Disk::disker

inherited

Definition at line 104 of file Disk.h.

◆ fileConfig

DiskFile::Config Rock::SwapDir::fileConfig

private

Definition at line 149 of file RockSwapDir.h.

◆ filePath

const char* Rock::SwapDir::filePath

protected

Definition at line 135 of file RockSwapDir.h.

Referenced by Rock::Rebuild::Start().

◆ flags

struct Store::Disk::Flags Store::Disk::flags

inherited

Referenced by storeDirSelectSwapDirLeastLoad().

◆ freeSlots

Ipc::Mem::Pointer<Ipc::Mem::PageStack> Rock::SwapDir::freeSlots

private

Definition at line 145 of file RockSwapDir.h.

◆

struct { ... } Store::Disk::fs

Referenced by Store::Disk::Disk(), and Store::Disk::sizeInBlocks().

◆ HeaderSize

const int64_t Rock::SwapDir::HeaderSize = 16*1024

staticprivate

Definition at line 151 of file RockSwapDir.h.

Referenced by Rock::Rebuild::start().

◆ index

int Store::Disk::index

inherited

Definition at line 103 of file Disk.h.

Referenced by Fs::Ufs::UFSStoreState::UFSStoreState(), and Rock::Rebuild::Start().

◆ io

DiskIOStrategy* Rock::SwapDir::io

private

Definition at line 143 of file RockSwapDir.h.

◆ map

DirMap* Rock::SwapDir::map

protected

Definition at line 136 of file RockSwapDir.h.

◆ max_objsize

int64_t Store::Disk::max_objsize

protectedinherited

Definition at line 99 of file Disk.h.

◆ max_size

uint64_t Store::Disk::max_size

protectedinherited

Definition at line 97 of file Disk.h.

Referenced by Store::Disk::maxSize().

◆ min_objsize

int64_t Store::Disk::min_objsize

protectedinherited

Definition at line 98 of file Disk.h.

◆ path

char* Store::Disk::path

inherited

Definition at line 102 of file Disk.h.

Referenced by Fs::Ufs::UFSSwapDir::DirClean(), Rock::Rebuild::Stats::Init(), and Rock::Rebuild::Start().

◆ removals

int Store::Disk::removals

inherited

Definition at line 106 of file Disk.h.

◆ repl

RemovalPolicy* Store::Disk::repl

inherited

Definition at line 105 of file Disk.h.

◆ scanned

int Store::Disk::scanned

inherited

Definition at line 107 of file Disk.h.

◆ slotSize

uint64_t Rock::SwapDir::slotSize

Definition at line 83 of file RockSwapDir.h.

Referenced by Rock::Rebuild::Rebuild().

◆ theFile

RefCount<DiskFile> Rock::SwapDir::theFile

private

Definition at line 144 of file RockSwapDir.h.

◆ theType

char const* Store::Disk::theType

privateinherited

Definition at line 94 of file Disk.h.

◆ waitingForPage

Ipc::Mem::PageId* Rock::SwapDir::waitingForPage

private

Definition at line 146 of file RockSwapDir.h.

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

src/fs/rock/RockSwapDir.h
src/fs/rock/RockSwapDir.cc

squid-cache.org

Optimising Web Delivery

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Friends

Detailed Description

Member Typedef Documentation

◆ DirMap

◆ Pointer

Constructor & Destructor Documentation

◆ SwapDir()

◆ ~SwapDir()

Member Function Documentation

◆ active()

◆ allowOptionReconfigure()

◆ anchorEntry()

◆ anchorToCache()

◆ callback()

◆ canLog()

◆ canStore()

◆ closeCompleted()

◆ closeLog()

◆ create()

◆ createError()

◆ createStoreIO()

◆ createUpdateIO()

◆ currentCount()

◆ currentSize()

◆ dereference()

◆ disconnect()

◆ diskFull()

◆ diskOffset() [1/2]

◆ diskOffset() [2/2]

◆ diskOffsetLimit()

◆ doReportStat()

◆ doubleCheck()

◆ dump()

◆ dumpOptions()

◆ dumpRateOption()

◆ dumpSizeOption()

◆ dumpTimeOption()

◆ entryLimitAbsolute()

◆ entryLimitActual()

◆ evictCached()

◆ evictIfFound()

◆ finalizeSwapoutFailure()

◆ finalizeSwapoutSuccess()

◆ freeSlotsPath()

◆ full()

◆ get()

◆ getOptionTree()

◆ getStats()

◆ handleWriteCompletionProblem()

◆ handleWriteCompletionSuccess()

◆ hasReadableEntry()

◆ ignoreReferences()

◆ init()

◆ inodeMapPath()

◆ ioCompletedNotification()

◆ logEntry()

◆ maintain()

◆ maxObjectSize() [1/2]

◆ maxObjectSize() [2/2]

◆ maxSize()

◆ minObjectSize()

◆ minSize()

◆ needsDiskStrand()

◆ noteFreeMapSlice()

◆ objectSizeIsAcceptable()

◆ openLog()

◆ openStoreIO()

◆ optionObjectSizeDump()

◆ optionObjectSizeParse()

◆ optionReadOnlyDump()