This class manages the caching of data that is unchanging during server operation. More...

#include <cachemanager.h>

Classes
struct	CachedObject
class	psCacheExpireEvent
	The generic cache sets timers for each object added to the cache, then if the object is not removed by the expiration time, it calls the iCachedObject interface and deletes the object. More...
Public Types
typedef csPDelArray< psSpell > ::Iterator	SpellIterator
Public Member Functions
void	AddBadName (const char *)
void	AddItemStatsToHashTable (psItemStats *newitem)
void	AddToCache (iCachedObject obj, const char name, int max_cache_time_seconds)
void	ApplyItemModifiers (psItemStats baseItem, RandomizedOverlay overlay, csArray< uint32_t > &modifierIds)
	Applies on a randomized overlay structure, starting with the base item stats passed, the modifier ids passed.
	CacheManager ()
PSCHARACTER_GENDER	ConvertGenderString (const char *genderstring)
PSSKILL	ConvertSkill (int skill_id)
PSSKILL	ConvertSkillString (const char *skillstring)
void	DelBadName (const char *)
csPDelArray< psItemAnimation > *	FindAnimationList (int id)
MathScript *	GetArmorSkillsPractice ()
psAttackType *	GetAttackTypeByID (unsigned int id)
psAttackType *	GetAttackTypeByName (csString name)
const char *	GetBadName (int pos)
size_t	GetBadNamesCount ()
MathScript *	GetBaseSkillValuesGet ()
MathScript *	GetCalcDecay ()
MathScript *	GetCalcItemPrice ()
MathScript *	GetCalcItemSellPrice ()
MathScript *	GetCastSuccess ()
MathScript *	GetCharLevelGet ()
const psCharMode *	GetCharMode (size_t id) const
uint8_t	GetCharModeID (const char *name)
const csPDelArray< psCharMode > &	GetCharModes () const
psCommandManager *	GetCommandManager ()
MathScript *	GetDoDamage ()
MathScript *	GetDodgeValueCalc ()
MathScript *	GetExpSkillCalc ()
Faction *	GetFaction (const char *name)
Faction *	GetFaction (int id)
Faction *	GetFactionByName (const char *name)
csHash< Faction *, int > &	GetFactionHash ()
MathScript *	GetFamiliarAffinity ()
size_t	GetItemCategoryAmount ()
	Gets the size of the item category array.
psItemCategory *	GetItemCategoryByID (unsigned int id)
psItemCategory *	GetItemCategoryByName (const csString &name)
psItemCategory *	GetItemCategoryByPos (size_t pos)
	Gets an item category by its position in the array.
const psCharacterLimitation *	GetLimitation (size_t index)
	This allows psServerChar to build a list of limitations for each player on demand.
LootRandomizer *	getLootRandomizer ()
	Returns a pointer to the loot randomizer which is hosted within the cache manager.
MathScript *	GetManaCost ()
MathScript *	GetMaxCarryAmount ()
MathScript *	GetMaxCarryWeight ()
MathScript *	GetMaxHPScript ()
MathScript *	GetMaxManaScript ()
MathScript *	GetMaxRealmScript ()
const psMovement *	GetMovement (size_t id) const
uint8_t	GetMovementID (const char *name)
const csPDelArray< psMovement > &	GetMovements () const
optionEntry *	getOption (const csString path)
	Wrapper for the getOption method of the root optionEntry stored in cachemanager.
optionEntry *	getOptionSafe (const csString path, const csString value)
	Wrapper for the getOptionSafe method of the root optionEntry stored in cachemanager.
MathScript *	GetPlayerSketchLimits ()
ProgressionScript *	GetProgressionScript (const char *name)
MathScript *	GetResearchSuccess ()
MathScript *	GetSetBaseSkillsScript ()
MathScript *	GetSkillValuesGet ()
psSpell *	GetSpellByID (unsigned int id)
psSpell *	GetSpellByName (const csString &name)
SpellIterator	GetSpellIterator ()
MathScript *	GetSpellPowerLevel ()
MathScript *	GetSpellPractice ()
MathScript *	GetStaminaCalc ()
MathScript *	GetStaminaCombat ()
MathScript *	GetStaminaMove ()
MathScript *	GetStaminaRatioSit ()
MathScript *	GetStaminaRatioStill ()
MathScript *	GetStaminaRatioWalk ()
MathScript *	GetStaminaRatioWork ()
void	GetTipByID (int id, csString &tip)
unsigned int	GetTipLength ()
	Returns how many tips there is.
psWay *	GetWayByID (unsigned int id)
psWay *	GetWayByName (const csString &name)
psWeaponType *	GetWeaponTypeByID (unsigned int id)
psWeaponType *	GetWeaponTypeByName (csString name)
const char *	MakeCacheName (const char *prefix, uint32 id)
uint32_t	NextEffectUID ()
	Used to track effect IDs.
bool	PreloadAll (EntityManager *entitymanager)
	Convenience function to preload all of the above in an appropriate order.
void	RandomizeItem (psItem *item, float maxCost, size_t numModifiers)
	Randomizes the passed item.
bool	ReloadOptions ()
	Reloads the server_options.
iCachedObject *	RemoveFromCache (const char *name)
void	UnloadAll ()
	~CacheManager ()
Sector Info Table cache
psSectorInfo *	GetSectorInfoByName (const char *name)
psSectorInfo *	GetSectorInfoByID (unsigned int id)
csHash< psSectorInfo * > ::GlobalIterator	GetSectorIterator ()
Races
size_t	GetRaceInfoCount ()
psRaceInfo *	GetRaceInfoByIndex (int idx)
psRaceInfo *	GetRaceInfoByID (unsigned int id)
psRaceInfo *	GetRaceInfoByNameGender (const char *name, PSCHARACTER_GENDER gender)
psRaceInfo *	GetRaceInfoByNameGender (unsigned int id, PSCHARACTER_GENDER gender)
psRaceInfo *	GetRaceInfoByMeshName (const csString &meshname)
Skills
psSkillInfo *	GetSkillByID (unsigned int id)
size_t	GetSkillAmount ()
psSkillInfo *	GetSkillByName (const char *name)
void	GetSkillsListbyCategory (csArray< psSkillInfo * > &listskill, int category)
	Get all skills belonging to a specific category.
Common Strings
const char *	FindCommonString (unsigned int id)
unsigned int	FindCommonStringID (const char *name)
void	AddCommonStringID (const char *name)
csStringSet *	GetMsgStrings ()
	Returns the message strings hash table.
void	GetCompressedMessageStrings (char *&data, unsigned long &size, uint32_t &num_strings, csMD5::Digest &digest)
	Returns compressed message strings data.
Guilds
psGuildInfo *	FindGuild (unsigned int id)
psGuildInfo *	FindGuild (const csString &name)
bool	CreateGuild (const char guildname, Client client)
void	RemoveGuild (psGuildInfo *which)
Guild alliances
psGuildAlliance *	FindAlliance (unsigned int id)
bool	CreateAlliance (const csString &name, psGuildInfo founder, Client client)
bool	RemoveAlliance (psGuildAlliance *which)
Quests
psQuest *	GetQuestByID (unsigned int id)
psQuest *	GetQuestByName (const char *name)
psQuest *	AddDynamicQuest (const char name, psQuest parentQuest, int step)
bool	UnloadQuest (int id)
	Unloads a quest and its scripts.
bool	LoadQuest (int id)
	Loads a quest and its scripts.
csHash< psQuest * >::GlobalIterator	GetQuestIterator ()
Attacks
psAttack *	GetAttackByID (unsigned int id)
psAttack *	GetAttackByName (const char *name)
csArray< psAttack * >	GetAllAttacks ()
bool	UnloadAttack (int id)
	unload an attack and its scripts
bool	LoadAttack (int id)
	Loads an attack and its scripts.
csHash< psAttack * > ::GlobalIterator	GetAttackIterator ()
Accounts
psAccountInfo *	GetAccountInfoByID (AccountID accountid)
	Retrieves account information given an accountid.
psAccountInfo *	GetAccountInfoByCharID (PID charid)
	Retrieves account information given an character ID.
psAccountInfo *	GetAccountInfoByUsername (const char *username)
	Retrieves account information given a username.
bool	UpdateAccountInfo (psAccountInfo *ainfo)
	Call to store modified account information back to the database.
unsigned int	NewAccountInfo (psAccountInfo *ainfo)
	Call to create a new account in the database.
Trades
csPDelArray < CombinationConstruction > *	FindCombinationsList (uint32 patternid)
	Get set of transformations for that pattern.
csPDelArray < psTradeTransformations > *	FindTransformationsList (uint32 patternid, uint32 targetid)
	Get transformation array for pattern and target item.
bool	PreloadUniqueTradeTransformations ()
csArray< uint32 > *	GetTradeTransUniqueByID (uint32 id)
bool	PreloadTradeProcesses ()
csArray< psTradeProcesses * > *	GetTradeProcessesByID (uint32 id)
bool	PreloadTradePatterns ()
csArray< psTradePatterns * >	GetTradePatternByItemID (uint32 id)
psTradePatterns *	GetTradePatternByName (csString name)
csString	CreateTransCraftDescription (psTradeTransformations tran, psTradeProcesses proc)
csString	CreateComboCraftDescription (CombinationConstruction *combArray)
csString	CreateComboCraftDescription (Result *combArray)
csArray< CraftTransInfo * > *	GetTradeTransInfoByItemID (uint32 id)
csArray< CraftComboInfo * > *	GetTradeComboInfoByItemID (uint32 id)
Items
psItemStats *	GetBasicItemStatsByName (csString name)
	Get item basic stats by hashed table.
psItemStats *	GetBasicItemStatsByID (uint32 id)
	Get item basic stats by hashed table.
psItemStats *	CopyItemStats (uint32 id, csString newName)
uint32	BasicItemStatsByNameExist (csString name)
	return id of item if 'name' exists already
size_t	ItemStatsSize (void)
void	CacheNameChange (csString oldName, csString newName)
	If an item changes name (eg book title) keep cache up to date.
bool	LoadWorldItems (psSectorInfo sector, csArray< psItem > &items)
float	GetArmorVSWeaponResistance (const char armor_type, const char weapon_type)
float	GetArmorVSWeaponResistance (psItemStats armor, psItemStats weapon)
void	RemoveInstance (psItem *&item)
void	RemoveItemStats (psItemStats *&itemStats)
PSITEMSTATS_STAT	ConvertAttributeString (const char *attributestring)
const char *	Attribute2String (PSITEMSTATS_STAT s)
	Converts the stat enum to a string.
Public Attributes
csArray< psItemStatFlags >	ItemStatFlagArray
	Translation table for Flag strings (from db) into bit codes.
PSITEMSTATS_SLOTLIST	slotMap [PSCHARACTER_SLOT_BULK1]
SlotNameHash	slotNameHash
csArray< csString >	stanceID
	Map of locations.
csArray< Stance >	stances
	List of stances.
Protected Member Functions
void	CacheCraftCombos (psMsgCraftingInfo *tradePattern, int patternID, int group)
	Caches in the crafting combinations.
void	CacheCraftTransforms (psMsgCraftingInfo *tradePattern, int patternID, int group)
	Caches in the crafting transforms.
int	Contains (csArray< uint32 > *list, uint32 id)
	Check if an int value is already in an array This is used primarily with the "stack" arrays that track progress through a network of data nodes, to determine if a node has already been visited.
PSTRAIT_LOCATION	ConvertTraitLocationString (const char *locationstring)
bool	DescribeCombination (Result combinations, csArray< CraftTransInfo > *newArray)
	build the description of a trade combination
bool	DescribeMultiTransformation (csPDelArray< psTradeTransformations > rArray, csArray< CraftTransInfo > *newArray)
	build the description of the trade transformation where multiple tools can be used to produce the same result.
bool	DescribeTransformation (psTradeTransformations t, csArray< CraftTransInfo > *newArray)
	build the description of the trade transformation
bool	FindFinalItem (csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txItemHash, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > rxItemHash, csArray< uint32 > finalItems, uint32 itemID, csArray< uint32 > itemStack)
	Build the list of 'final' items.
bool	freeTradeTransformationsByPatternAndGroup (csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txItemHash, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txResultHash)
	dispose of transformation hashes for craft books.
bool	ListProductionSteps (csArray< CraftTransInfo * > newArray, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txResultHash, csArray< uint32 > finalItems, uint32 itemID, uint32 patternID, uint32 groupID, csArray< uint32 > itemStack)
	main procedure constructing the recipe steps
bool	loadTradeTransformationsByPatternAndGroup (Result result, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txResultHash, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *txItemHash)
	load transformations into hashes for faster access.
bool	PreloadArmorVsWeapon ()
bool	PreloadAttacks ()
bool	PreloadAttackTypes ()
bool	PreloadBadNames ()
void	PreloadCommandGroups ()
bool	PreloadCraftMessages ()
	Cache in the crafting messages.
void	PreloadFactionCharacterEvents (const char script, Faction faction)
	preloads the character events script for a faction
bool	PreloadFactions ()
bool	PreloadItemAnimList ()
bool	PreloadItemCategories ()
bool	PreloadItemStatsDatabase ()
bool	PreloadLimitations ()
bool	PreloadLootModifiers ()
	Loads the loot modifiers from the loot modifiers table.
bool	PreloadMathScripts ()
bool	PreloadMovement ()
bool	PreloadOptions ()
	Preloads the server_options and stores them in an easily accessible structure.
bool	PreloadQuests ()
bool	PreloadRaceInfo ()
bool	PreloadScripts (EntityManager *entitymanager)
bool	PreloadSectors ()
bool	PreloadSkills ()
bool	PreloadSpells ()
bool	PreloadStances ()
bool	PreloadTips ()
bool	PreloadTradeCombinations ()
bool	PreloadTradeTransformations ()
bool	PreloadTraits ()
bool	PreloadWays ()
bool	PreloadWeaponTypes ()
bool	ReconcileFinalItems (csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > txItemHash, csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > rxItemHash, csArray< uint32 > finalItems, csArray< uint32 > craftBookItems, uint32 resultID, uint32 patternID, csArray< uint32 > *itemStack)
	From the list of final items, extract those that belong to the specified craft book.
bool	UniqueInsertIntoItemArray (csArray< uint32 > *finalItems, uint32 itemID)
	Insert the itemID into an array, sorted according the the item's Name, no more than one time.
Protected Attributes
csHash< psGuildAlliance * >	alliance_by_id
csPDelArray< ArmorVsWeapon >	armor_vs_weapon
MathScript *	armorSkillsPractice
	Script to set the practice points for armor skills.
csHash< psAttack * >	attacks_by_id
csPDelArray< psAttackType >	attackTypeList
csStringArray	bad_names
MathScript *	baseSkillValuesGet
	Script to get the base skill values.
char	CacheNameBuffer [15]
MathScript *	calc_decay
	This is the particular calculation for decay.
MathScript *	calcItemPrice
MathScript *	calcItemSellPrice
MathScript *	castSuccess
csPDelArray< psCharMode >	char_modes
MathScript *	charLevelGet
	Script to get the current char level.
psCommandManager *	commandManager
char *	compressed_msg_strings
csMD5::Digest	compressed_msg_strings_digest
unsigned long	compressed_msg_strings_size
MathScript *	doDamage
MathScript *	dodgeValueCalc
	Script for calculating dodge value.
uint32_t	effectID
MathScript *	expSkillCalc
	The exp calc script to assign experience on skill ranking.
csHash< Faction *, csString >	factions
csHash< Faction *, int >	factions_by_id
csHash< CachedObject *, csString >	generic_object_cache
	This cache is intended to keep database-loaded objects in memory for a time after we are done with them to avoid reloading in case they are reused soon.
csHash< psGuildInfo * >	guildinfo_by_id
csPDelArray< csPDelArray < psItemAnimation > >	item_anim_list
csPDelArray< psItemCategory >	itemCategoryList
csHash< psItemStats *, uint32 >	itemStats_IDHash
csHash< psItemStats *, csString >	itemStats_NameHash
csPDelArray < psCharacterLimitation >	limits
	All the limitations based on scores for characters.
LootRandomizer *	lootRandomizer
	A pointer to the lootrandomizer mantained by the cachemanager.
MathScript *	manaCost
MathScript *	maxCarryAmount
	A pointer maintained by MathScriptEngine.
MathScript *	maxCarryWeight
	A pointer maintained by MathScriptEngine.
MathScript *	maxHPScript
MathScript *	maxManaScript
MathScript *	maxRealmScript
csPDelArray< psMovement >	movements
MathScript *	msAffinity
csStringSet	msg_strings
uint32_t	num_compressed_strings
MathScript *	playerSketchLimits
csHash< psQuest * >	quests_by_id
csPDelArray< psRaceInfo >	raceinfolist
MathScript *	researchSuccess
optionEntry	rootOptionEntry
csHash< ProgressionScript *, csString >	scripts
csHash< psSectorInfo * >	sectorinfo_by_id
	Sector info list hashed by sector id.
csHash< psSectorInfo * >	sectorinfo_by_name
	Sector info list hashed by sector name.
MathScript *	setBaseSkillsScript
csHash< psSkillInfo *, int >	skillinfo_CategoryHash
csHash< psSkillInfo *, int >	skillinfo_IDHash
csHash< psSkillInfo *, csString >	skillinfo_NameHash
MathScript *	skillValuesGet
	Script to get the current skill values.
csPDelArray< psSpell >	spellList
MathScript *	spellPowerLevel
MathScript *	spellPractice
MathScript *	staminaCalc
	The stamina calc script.
MathScript *	staminaCombat
MathScript *	staminaMove
MathScript *	staminaRatioSit
	The stamina regen ration while sitting script.
MathScript *	staminaRatioStill
	The stamina regen ration while standing script.
MathScript *	staminaRatioWalk
	The stamina regen ration while walking script.
MathScript *	staminaRatioWork
	The stamina regen ration while working script.
csArray< csString >	tips_list
	List for the tips.
csHash< csPDelArray < CombinationConstruction > *, uint32 >	tradeCombinations_IDHash
csHash< csArray < CraftComboInfo * > *, uint32 >	tradeCraftComboInfo_IDHash
csHash< csArray < CraftTransInfo * > *, uint32 >	tradeCraftTransInfo_IDHash
csHash< psTradePatterns *, uint32 >	tradePatterns_IDHash
csHash< psTradePatterns *, csString >	tradePatterns_NameHash
csHash< csArray < psTradeProcesses * > *, uint32 >	tradeProcesses_IDHash
csHash< csHash< csPDelArray < psTradeTransformations > , uint32 > , uint32 >	tradeTransformations_IDHash
csHash< csArray< uint32 > *, uint32 >	tradeTransUnique_IDHash
csPDelArray< psTrait >	traitlist
csPDelArray< psWay >	wayList
csPDelArray< psWeaponType >	weaponTypeList
Traits
typedef csPDelArray< psTrait > ::Iterator	TraitIterator
psTrait *	GetTraitByID (unsigned int id)
psTrait *	GetTraitByName (const char *name)
TraitIterator	GetTraitIterator ()

Detailed Description

This class manages the caching of data that is unchanging during server operation.

Data stored here is loaded from the database at server startup and retrieved by other code from this cache. This allows the database to be used to store configuration data, but we don't have to query the database every time we need access.

Meshes, Textures, Images, Parts, and Sectors may be loaded without other lists being loaded first. Traits will fail if Textures, Parts and Meshes are not loaded beforehand. Races will fail if Meshes, Textures and Sectors are not loaded beforehand.

Definition at line 234 of file cachemanager.h.

Member Typedef Documentation

typedef csPDelArray<psSpell>::Iterator CacheManager::SpellIterator

Definition at line 490 of file cachemanager.h.

typedef csPDelArray<psTrait>::Iterator CacheManager::TraitIterator

Definition at line 256 of file cachemanager.h.

Constructor & Destructor Documentation

CacheManager::CacheManager ( )

CacheManager::~CacheManager ( )

Member Function Documentation

void CacheManager::AddBadName ( const char * )

void CacheManager::AddCommonStringID ( const char * name ) [inline]

Definition at line 289 of file cachemanager.h.

psQuest* CacheManager::AddDynamicQuest	(	const char *	name,
		psQuest *	parentQuest,
		int	step
	)

void CacheManager::AddItemStatsToHashTable ( psItemStats * newitem )

void CacheManager::AddToCache	(	iCachedObject *	obj,
		const char *	name,
		int	max_cache_time_seconds
	)

void CacheManager::ApplyItemModifiers	(	psItemStats *	baseItem,
		RandomizedOverlay *	overlay,
		csArray< uint32_t > &	modifierIds
	)		`[inline]`

Applies on a randomized overlay structure, starting with the base item stats passed, the modifier ids passed.

This is an accessor to the lootrandomizer own function

Parameters:

baseItem	The basic item stats of the item we are creating an overlay for.
overlay	The overlay which we will fill with the modifiers data.
modifierIds	An array of ids referencing loot_modifiers rules.

Definition at line 652 of file cachemanager.h.

const char* CacheManager::Attribute2String ( PSITEMSTATS_STAT s )

Converts the stat enum to a string.

uint32 CacheManager::BasicItemStatsByNameExist ( csString name )

return id of item if 'name' exists already

void CacheManager::CacheCraftCombos	(	psMsgCraftingInfo *	tradePattern,
		int	patternID,
		int	group
	)		`[protected]`

Caches in the crafting combinations.

Parameters:

tradePattern	The current pattern message we want to construct.
patternID	The pattern ID of the pattern we are cacheing.
group	The group.

void CacheManager::CacheCraftTransforms	(	psMsgCraftingInfo *	tradePattern,
		int	patternID,
		int	group
	)		`[protected]`

Caches in the crafting transforms.

Parameters:

tradePattern	The current pattern message we want to construct.
patternID	The pattern ID of the pattern we are cacheing.
group	The group.

void CacheManager::CacheNameChange	(	csString	oldName,
		csString	newName
	)

If an item changes name (eg book title) keep cache up to date.

int CacheManager::Contains	(	csArray< uint32 > *	list,
		uint32	id
	)		`[protected]`

Check if an int value is already in an array This is used primarily with the "stack" arrays that track progress through a network of data nodes, to determine if a node has already been visited.

Parameters:

list	The array of ints
id	The int value to be checked for

Returns:: The number of matches found

PSITEMSTATS_STAT CacheManager::ConvertAttributeString ( const char * attributestring )

PSCHARACTER_GENDER CacheManager::ConvertGenderString ( const char * genderstring )

PSSKILL CacheManager::ConvertSkill ( int skill_id )

PSSKILL CacheManager::ConvertSkillString ( const char * skillstring )

PSTRAIT_LOCATION CacheManager::ConvertTraitLocationString ( const char * locationstring ) [protected]

psItemStats* CacheManager::CopyItemStats	(	uint32	id,
		csString	newName
	)

bool CacheManager::CreateAlliance	(	const csString &	name,
		psGuildInfo *	founder,
		Client *	client
	)

csString CacheManager::CreateComboCraftDescription ( CombinationConstruction * combArray )

csString CacheManager::CreateComboCraftDescription ( Result * combArray )

bool CacheManager::CreateGuild	(	const char *	guildname,
		Client *	client
	)

csString CacheManager::CreateTransCraftDescription	(	psTradeTransformations *	tran,
		psTradeProcesses *	proc
	)

void CacheManager::DelBadName ( const char * )

bool CacheManager::DescribeCombination	(	Result *	combinations,
		csArray< CraftTransInfo * > *	newArray
	)		`[protected]`

build the description of a trade combination

Parameters:

combinations	list of components of a specific trade combination
newArray	Array that holds the CraftTransInfo objects needed to construct the text

Returns:: true

bool CacheManager::DescribeMultiTransformation	(	csPDelArray< psTradeTransformations > *	rArray,
		csArray< CraftTransInfo * > *	newArray
	)		`[protected]`

build the description of the trade transformation where multiple tools can be used to produce the same result.

This is especially useful for enchanting gems.

Parameters:

rArray	list of trade transformations with multiple tools for same transform
newArray	Array that holds the CraftTransInfo objects needed to construct the text

Returns:: true

bool CacheManager::DescribeTransformation	(	psTradeTransformations *	t,
		csArray< CraftTransInfo * > *	newArray
	)		`[protected]`

build the description of the trade transformation

Parameters:

t	list of trade transformations to describe
newArray	Array that holds the CraftTransInfo objects needed to construct the text

Returns:: true

psGuildAlliance* CacheManager::FindAlliance ( unsigned int id )

csPDelArray<psItemAnimation>* CacheManager::FindAnimationList ( int id )

csPDelArray<CombinationConstruction>* CacheManager::FindCombinationsList ( uint32 patternid )

Get set of transformations for that pattern.

const char* CacheManager::FindCommonString ( unsigned int id )

unsigned int CacheManager::FindCommonStringID ( const char * name )

bool CacheManager::FindFinalItem	(	csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txItemHash,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	rxItemHash,
		csArray< uint32 > *	finalItems,
		uint32	itemID,
		csArray< uint32 > *	itemStack
	)		`[protected]`

Build the list of 'final' items.

starting at any random node, recursively walk the data network until a 'final' looking node is encountered, then add it to the finalItems list.

Parameters:

txItemHash	Hash on item ID to find result ID
rxItemHash	Hash on result ID to find item ID
finalItems	Array listing item numbers considered 'final'
itemID	item under current considerations
itemStack	List of items already visited; used for detecting cycles inthe data

Returns:

psGuildInfo* CacheManager::FindGuild ( unsigned int id )

psGuildInfo* CacheManager::FindGuild ( const csString & name )

csPDelArray<psTradeTransformations>* CacheManager::FindTransformationsList	(	uint32	patternid,
		uint32	targetid
	)

Get transformation array for pattern and target item.

bool CacheManager::freeTradeTransformationsByPatternAndGroup	(	csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txItemHash,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txResultHash
	)		`[protected]`

dispose of transformation hashes for craft books.

Parameters:

txResultHash	Hash on result ID to find item ID
txItemHash	Hash on item ID to find result ID

Returns:: true

psAccountInfo* CacheManager::GetAccountInfoByCharID ( PID charid )

Retrieves account information given an character ID.

Parameters:

charid - The unique id associated with the character.

Returns:: NULL if no account information was found for the given ID. The returned pointer must be deleted when no longer needed.

psAccountInfo* CacheManager::GetAccountInfoByID ( AccountID accountid )

Retrieves account information given an accountid.

This is not the usual entry method. The username will be used more often.

Parameters:

accountid - The unique id associated with the account.

Returns:: NULL if no account information was found for the given ID. The returned pointer must be deleted when no longer needed.

psAccountInfo* CacheManager::GetAccountInfoByUsername ( const char * username )

Retrieves account information given a username.

This is the usual method for looking up account information.

Parameters:

username - The unique username associated with the account.

Returns:: NULL if no account information was found for the given ID. The returned pointer must be deleted when no longer needed.

csArray<psAttack*> CacheManager::GetAllAttacks ( )

MathScript* CacheManager::GetArmorSkillsPractice ( ) [inline]

Definition at line 471 of file cachemanager.h.

float CacheManager::GetArmorVSWeaponResistance	(	const char *	armor_type,
		const char *	weapon_type
	)

float CacheManager::GetArmorVSWeaponResistance	(	psItemStats *	armor,
		psItemStats *	weapon
	)

psAttack* CacheManager::GetAttackByID ( unsigned int id )

psAttack* CacheManager::GetAttackByName ( const char * name )

csHash<psAttack *>::GlobalIterator CacheManager::GetAttackIterator ( )

psAttackType* CacheManager::GetAttackTypeByID ( unsigned int id )

psAttackType* CacheManager::GetAttackTypeByName ( csString name )

const char* CacheManager::GetBadName ( int pos )

size_t CacheManager::GetBadNamesCount ( )

MathScript* CacheManager::GetBaseSkillValuesGet ( ) [inline]

Definition at line 474 of file cachemanager.h.

psItemStats* CacheManager::GetBasicItemStatsByID ( uint32 id )

Get item basic stats by hashed table.

psItemStats* CacheManager::GetBasicItemStatsByName ( csString name )

Get item basic stats by hashed table.

MathScript* CacheManager::GetCalcDecay ( ) [inline]

Definition at line 476 of file cachemanager.h.

MathScript* CacheManager::GetCalcItemPrice ( ) [inline]

Definition at line 477 of file cachemanager.h.

MathScript* CacheManager::GetCalcItemSellPrice ( ) [inline]

Definition at line 478 of file cachemanager.h.

MathScript* CacheManager::GetCastSuccess ( ) [inline]

Definition at line 482 of file cachemanager.h.

MathScript* CacheManager::GetCharLevelGet ( ) [inline]

Definition at line 472 of file cachemanager.h.

const psCharMode* CacheManager::GetCharMode ( size_t id ) const [inline]

Definition at line 583 of file cachemanager.h.

uint8_t CacheManager::GetCharModeID ( const char * name )

const csPDelArray<psCharMode>& CacheManager::GetCharModes ( ) const [inline]

Definition at line 575 of file cachemanager.h.

psCommandManager* CacheManager::GetCommandManager ( ) [inline]

Definition at line 248 of file cachemanager.h.

void CacheManager::GetCompressedMessageStrings	(	char *&	data,
		unsigned long &	size,
		uint32_t &	num_strings,
		csMD5::Digest &	digest
	)

Returns compressed message strings data.

Parameters:

data	Pointer to the compressed data.
size	Size of the compressed data in bytes.
num_strings	The number of strings encoded.
digest	The md5sum digest of the compressed data.

MathScript* CacheManager::GetDoDamage ( ) [inline]

Definition at line 485 of file cachemanager.h.

MathScript* CacheManager::GetDodgeValueCalc ( ) [inline]

Definition at line 470 of file cachemanager.h.

MathScript* CacheManager::GetExpSkillCalc ( ) [inline]

Definition at line 464 of file cachemanager.h.

Faction* CacheManager::GetFaction ( int id )

Faction* CacheManager::GetFaction ( const char * name )

Faction* CacheManager::GetFactionByName ( const char * name )

csHash<Faction*, int>& CacheManager::GetFactionHash ( ) [inline]

Definition at line 449 of file cachemanager.h.

MathScript* CacheManager::GetFamiliarAffinity ( ) [inline]

Definition at line 487 of file cachemanager.h.

size_t CacheManager::GetItemCategoryAmount ( ) [inline]

Gets the size of the item category array.

Useful to iterate it.

Returns:: The size of the array.

Definition at line 425 of file cachemanager.h.

psItemCategory* CacheManager::GetItemCategoryByID ( unsigned int id )

psItemCategory* CacheManager::GetItemCategoryByName ( const csString & name )

psItemCategory* CacheManager::GetItemCategoryByPos ( size_t pos ) [inline]

Gets an item category by its position in the array.

Useful to iterate it.

Parameters:

pos	The position in the array from where to extract the category.

Returns:: A pointer to the category in the position.

Definition at line 418 of file cachemanager.h.

const psCharacterLimitation* CacheManager::GetLimitation ( size_t index )

This allows psServerChar to build a list of limitations for each player on demand.

LootRandomizer* CacheManager::getLootRandomizer ( ) [inline]

Returns a pointer to the loot randomizer which is hosted within the cache manager.

Returns:: A pointer to the lootrandomizer.

Definition at line 641 of file cachemanager.h.

MathScript* CacheManager::GetManaCost ( ) [inline]

Definition at line 481 of file cachemanager.h.

MathScript* CacheManager::GetMaxCarryAmount ( ) [inline]

Definition at line 459 of file cachemanager.h.

MathScript* CacheManager::GetMaxCarryWeight ( ) [inline]

Definition at line 458 of file cachemanager.h.

MathScript* CacheManager::GetMaxHPScript ( ) [inline]

Definition at line 462 of file cachemanager.h.

MathScript* CacheManager::GetMaxManaScript ( ) [inline]

Definition at line 461 of file cachemanager.h.

MathScript* CacheManager::GetMaxRealmScript ( ) [inline]

Definition at line 460 of file cachemanager.h.

const psMovement* CacheManager::GetMovement ( size_t id ) const [inline]

Definition at line 587 of file cachemanager.h.

uint8_t CacheManager::GetMovementID ( const char * name )

const csPDelArray<psMovement>& CacheManager::GetMovements ( ) const [inline]

Definition at line 579 of file cachemanager.h.

csStringSet* CacheManager::GetMsgStrings ( ) [inline]

Returns the message strings hash table.

Returns:: Returns a reference to the message strings hash table.

Definition at line 298 of file cachemanager.h.

optionEntry* CacheManager::getOption ( const csString path ) [inline]

Wrapper for the getOption method of the root optionEntry stored in cachemanager.

Parameters:

path	A path to the requested option starting from the root optionEntry.

Returns:: An optionEntry in the requested position. NULL if the path was not found.

See also:: optionEntry

Definition at line 618 of file cachemanager.h.

optionEntry* CacheManager::getOptionSafe	(	const csString	path,
		const csString	value
	)		`[inline]`

Wrapper for the getOptionSafe method of the root optionEntry stored in cachemanager.

Parameters:

path	A path to the requested option starting from the root optionEntry.
value	The value.

Returns:: An optionEntry in the requested position. NULL if the path was invalid.

See also:: optionEntry

Definition at line 631 of file cachemanager.h.

MathScript* CacheManager::GetPlayerSketchLimits ( ) [inline]

Definition at line 479 of file cachemanager.h.

ProgressionScript* CacheManager::GetProgressionScript ( const char * name )

psQuest* CacheManager::GetQuestByID ( unsigned int id )

psQuest* CacheManager::GetQuestByName ( const char * name )

csHash<psQuest*>::GlobalIterator CacheManager::GetQuestIterator ( )

psRaceInfo* CacheManager::GetRaceInfoByID ( unsigned int id )

psRaceInfo* CacheManager::GetRaceInfoByIndex ( int idx )

psRaceInfo* CacheManager::GetRaceInfoByMeshName ( const csString & meshname )

psRaceInfo* CacheManager::GetRaceInfoByNameGender	(	const char *	name,
		PSCHARACTER_GENDER	gender
	)

psRaceInfo* CacheManager::GetRaceInfoByNameGender	(	unsigned int	id,
		PSCHARACTER_GENDER	gender
	)

size_t CacheManager::GetRaceInfoCount ( )

MathScript* CacheManager::GetResearchSuccess ( ) [inline]

Definition at line 483 of file cachemanager.h.

psSectorInfo* CacheManager::GetSectorInfoByID ( unsigned int id )

psSectorInfo* CacheManager::GetSectorInfoByName ( const char * name )

csHash<psSectorInfo*>::GlobalIterator CacheManager::GetSectorIterator ( )

MathScript* CacheManager::GetSetBaseSkillsScript ( ) [inline]

Definition at line 475 of file cachemanager.h.

size_t CacheManager::GetSkillAmount ( )

psSkillInfo* CacheManager::GetSkillByID ( unsigned int id )

psSkillInfo* CacheManager::GetSkillByName ( const char * name )

void CacheManager::GetSkillsListbyCategory	(	csArray< psSkillInfo * > &	listskill,
		int	category
	)

Get all skills belonging to a specific category.

MathScript* CacheManager::GetSkillValuesGet ( ) [inline]

Definition at line 473 of file cachemanager.h.

psSpell* CacheManager::GetSpellByID ( unsigned int id )

psSpell* CacheManager::GetSpellByName ( const csString & name )

SpellIterator CacheManager::GetSpellIterator ( )

MathScript* CacheManager::GetSpellPowerLevel ( ) [inline]

Definition at line 480 of file cachemanager.h.

MathScript* CacheManager::GetSpellPractice ( ) [inline]

Definition at line 484 of file cachemanager.h.

MathScript* CacheManager::GetStaminaCalc ( ) [inline]

Definition at line 463 of file cachemanager.h.

MathScript* CacheManager::GetStaminaCombat ( ) [inline]

Definition at line 469 of file cachemanager.h.

MathScript* CacheManager::GetStaminaMove ( ) [inline]

Definition at line 486 of file cachemanager.h.

MathScript* CacheManager::GetStaminaRatioSit ( ) [inline]

Definition at line 467 of file cachemanager.h.

MathScript* CacheManager::GetStaminaRatioStill ( ) [inline]

Definition at line 466 of file cachemanager.h.

MathScript* CacheManager::GetStaminaRatioWalk ( ) [inline]

Definition at line 465 of file cachemanager.h.

MathScript* CacheManager::GetStaminaRatioWork ( ) [inline]

Definition at line 468 of file cachemanager.h.

void CacheManager::GetTipByID	(	int	id,
		csString &	tip
	)

unsigned int CacheManager::GetTipLength ( )

Returns how many tips there is.

csArray<CraftComboInfo*>* CacheManager::GetTradeComboInfoByItemID ( uint32 id )

csArray<psTradePatterns*> CacheManager::GetTradePatternByItemID ( uint32 id )

psTradePatterns* CacheManager::GetTradePatternByName ( csString name )

csArray<psTradeProcesses*>* CacheManager::GetTradeProcessesByID ( uint32 id )

csArray<CraftTransInfo*>* CacheManager::GetTradeTransInfoByItemID ( uint32 id )

csArray<uint32>* CacheManager::GetTradeTransUniqueByID ( uint32 id )

psTrait* CacheManager::GetTraitByID ( unsigned int id )

psTrait* CacheManager::GetTraitByName ( const char * name )

TraitIterator CacheManager::GetTraitIterator ( )

psWay* CacheManager::GetWayByID ( unsigned int id )

psWay* CacheManager::GetWayByName ( const csString & name )

psWeaponType* CacheManager::GetWeaponTypeByID ( unsigned int id )

psWeaponType* CacheManager::GetWeaponTypeByName ( csString name )

size_t CacheManager::ItemStatsSize ( void ) [inline]

Definition at line 529 of file cachemanager.h.

bool CacheManager::ListProductionSteps	(	csArray< CraftTransInfo * > *	newArray,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txResultHash,
		csArray< uint32 > *	finalItems,
		uint32	itemID,
		uint32	patternID,
		uint32	groupID,
		csArray< uint32 > *	itemStack
	)		`[protected]`

main procedure constructing the recipe steps

Parameters:

newArray	Array that holds the CraftTransInfo objects needed to construct the text
txResultHash	Hash of trade transformations by result item
finalItems	list of items identified as 'final'; these are used to construct the seperate recipes in a single book.
itemID	which item to construct the recipe for
patternID	which pattern id to construct the recipe for
groupID	which group (ie craft book) to construct the recipe for
itemStack	array that keeps track of items visited in the traversal of data; used to detect loops in the data.

bool CacheManager::LoadAttack ( int id )

Loads an attack and its scripts.

bool CacheManager::LoadQuest ( int id )

Loads a quest and its scripts.

bool CacheManager::loadTradeTransformationsByPatternAndGroup	(	Result *	result,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txResultHash,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txItemHash
	)		`[protected]`

load transformations into hashes for faster access.

NOTE that these hashes are for use specifically in creating the Craft book messages and are cleaned up after.

Parameters:

txResultHash	Hash on result ID to find item ID
txItemHash	Hash on item ID to find result ID

Returns:: true

bool CacheManager::LoadWorldItems	(	psSectorInfo *	sector,
		csArray< psItem * > &	items
	)

const char* CacheManager::MakeCacheName	(	const char *	prefix,
		uint32	id
	)

unsigned int CacheManager::NewAccountInfo ( psAccountInfo * ainfo )

Call to create a new account in the database.

Parameters:

ainfo - Should be initialized with all needed account info.

Returns:: The accountid assigned to this account (also stored in the appropriate field in ainfo)

uint32_t CacheManager::NextEffectUID ( ) [inline]

Used to track effect IDs.

Definition at line 595 of file cachemanager.h.

bool CacheManager::PreloadAll ( EntityManager * entitymanager )

Convenience function to preload all of the above in an appropriate order.

bool CacheManager::PreloadArmorVsWeapon ( ) [protected]

bool CacheManager::PreloadAttacks ( ) [protected]

bool CacheManager::PreloadAttackTypes ( ) [protected]

bool CacheManager::PreloadBadNames ( ) [protected]

void CacheManager::PreloadCommandGroups ( ) [protected]

bool CacheManager::PreloadCraftMessages ( ) [protected]

Cache in the crafting messages.

void CacheManager::PreloadFactionCharacterEvents	(	const char *	script,
		Faction *	faction
	)		`[protected]`

preloads the character events script for a faction

bool CacheManager::PreloadFactions ( ) [protected]

bool CacheManager::PreloadItemAnimList ( ) [protected]

bool CacheManager::PreloadItemCategories ( ) [protected]

bool CacheManager::PreloadItemStatsDatabase ( ) [protected]

bool CacheManager::PreloadLimitations ( ) [protected]

bool CacheManager::PreloadLootModifiers ( ) [protected]

Loads the loot modifiers from the loot modifiers table.

Returns:: TRUE if there were no issues during loading, else FALSE.

bool CacheManager::PreloadMathScripts ( ) [protected]

bool CacheManager::PreloadMovement ( ) [protected]

bool CacheManager::PreloadOptions ( ) [protected]

Preloads the server_options and stores them in an easily accessible structure.

Returns:: FALSE if the load failed

bool CacheManager::PreloadQuests ( ) [protected]

bool CacheManager::PreloadRaceInfo ( ) [protected]

bool CacheManager::PreloadScripts ( EntityManager * entitymanager ) [protected]

bool CacheManager::PreloadSectors ( ) [protected]

bool CacheManager::PreloadSkills ( ) [protected]

bool CacheManager::PreloadSpells ( ) [protected]

bool CacheManager::PreloadStances ( ) [protected]

bool CacheManager::PreloadTips ( ) [protected]

bool CacheManager::PreloadTradeCombinations ( ) [protected]

bool CacheManager::PreloadTradePatterns ( )

bool CacheManager::PreloadTradeProcesses ( )

bool CacheManager::PreloadTradeTransformations ( ) [protected]

bool CacheManager::PreloadTraits ( ) [protected]

bool CacheManager::PreloadUniqueTradeTransformations ( )

bool CacheManager::PreloadWays ( ) [protected]

bool CacheManager::PreloadWeaponTypes ( ) [protected]

void CacheManager::RandomizeItem	(	psItem *	item,
		float	maxCost,
		size_t	numModifiers
	)		`[inline]`

Randomizes the passed item.

Parameters:

item	The item which we are going to randomize.
maxCost	The maximum cost allowed to the randomized item
numModifiers	The maximum amount of modifiers to apply.

Definition at line 662 of file cachemanager.h.

bool CacheManager::ReconcileFinalItems	(	csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	txItemHash,
		csHash< csHash< csPDelArray< psTradeTransformations > , uint32 > , uint32 > *	rxItemHash,
		csArray< uint32 > *	finalItems,
		csArray< uint32 > *	craftBookItems,
		uint32	resultID,
		uint32	patternID,
		csArray< uint32 > *	itemStack
	)		`[protected]`

From the list of final items, extract those that belong to the specified craft book.

Parameters:

txItemHash	Hash on item ID to find result ID
rxItemHash	Hash on result ID to find item ID
finalItems	Array listing item numbers considered 'final'
craftBookItems	Array listing item numbers considered 'final'
resultID	Item under current considerations
patternID	pattern that specifies the craft Book
itemStack	List of items already visited; used for detecting cycles inthe data

Returns:: true

bool CacheManager::ReloadOptions ( ) [inline]

Reloads the server_options.

Returns:: FALSE if the reload failed

Definition at line 670 of file cachemanager.h.

bool CacheManager::RemoveAlliance ( psGuildAlliance * which )

iCachedObject* CacheManager::RemoveFromCache ( const char * name )

void CacheManager::RemoveGuild ( psGuildInfo * which )

void CacheManager::RemoveInstance ( psItem *& item )

void CacheManager::RemoveItemStats ( psItemStats *& itemStats )

bool CacheManager::UniqueInsertIntoItemArray	(	csArray< uint32 > *	finalItems,
		uint32	itemID
	)		`[protected]`

Insert the itemID into an array, sorted according the the item's Name, no more than one time.

Parameters:

finalItems	The array of items
itemID	The ID number of the item to be inserted/sorted

void CacheManager::UnloadAll ( )

bool CacheManager::UnloadAttack ( int id )

unload an attack and its scripts

bool CacheManager::UnloadQuest ( int id )

Unloads a quest and its scripts.

bool CacheManager::UpdateAccountInfo ( psAccountInfo * ainfo )

Call to store modified account information back to the database.

Updates IP, security level, last login time, os, graphics card and graphics driver version.

Parameters:

ainfo - A pointer to account data to store.

Returns:: true - success false - failed

Member Data Documentation

csHash<psGuildAlliance*> CacheManager::alliance_by_id [protected]

Definition at line 921 of file cachemanager.h.

csPDelArray<ArmorVsWeapon> CacheManager::armor_vs_weapon [protected]

Definition at line 934 of file cachemanager.h.

MathScript* CacheManager::armorSkillsPractice [protected]

Script to set the practice points for armor skills.

Definition at line 955 of file cachemanager.h.

csHash<psAttack *> CacheManager::attacks_by_id [protected]

Definition at line 922 of file cachemanager.h.

csPDelArray<psAttackType > CacheManager::attackTypeList [protected]

Definition at line 910 of file cachemanager.h.

csStringArray CacheManager::bad_names [protected]

Definition at line 933 of file cachemanager.h.

MathScript* CacheManager::baseSkillValuesGet [protected]

Script to get the base skill values.

Definition at line 958 of file cachemanager.h.

char CacheManager::CacheNameBuffer[15] [protected]

Definition at line 677 of file cachemanager.h.

MathScript* CacheManager::calc_decay [protected]

This is the particular calculation for decay.

Definition at line 960 of file cachemanager.h.

MathScript* CacheManager::calcItemPrice [protected]

Definition at line 961 of file cachemanager.h.

MathScript* CacheManager::calcItemSellPrice [protected]

Definition at line 962 of file cachemanager.h.

MathScript* CacheManager::castSuccess [protected]

Definition at line 966 of file cachemanager.h.

csPDelArray<psCharMode> CacheManager::char_modes [protected]

Definition at line 935 of file cachemanager.h.

MathScript* CacheManager::charLevelGet [protected]

Script to get the current char level.

Definition at line 956 of file cachemanager.h.

psCommandManager* CacheManager::commandManager [protected]

Definition at line 938 of file cachemanager.h.

char* CacheManager::compressed_msg_strings [protected]

Definition at line 894 of file cachemanager.h.

csMD5::Digest CacheManager::compressed_msg_strings_digest [protected]

Definition at line 897 of file cachemanager.h.

unsigned long CacheManager::compressed_msg_strings_size [protected]

Definition at line 895 of file cachemanager.h.

MathScript* CacheManager::doDamage [protected]

Definition at line 969 of file cachemanager.h.

MathScript* CacheManager::dodgeValueCalc [protected]

Script for calculating dodge value.

Definition at line 954 of file cachemanager.h.

uint32_t CacheManager::effectID [protected]

Definition at line 676 of file cachemanager.h.

MathScript* CacheManager::expSkillCalc [protected]

The exp calc script to assign experience on skill ranking.

Definition at line 948 of file cachemanager.h.

csHash<Faction*, csString> CacheManager::factions [protected]

Definition at line 913 of file cachemanager.h.

csHash<Faction*, int> CacheManager::factions_by_id [protected]

Definition at line 912 of file cachemanager.h.

csHash<CachedObject*, csString> CacheManager::generic_object_cache [protected]

This cache is intended to keep database-loaded objects in memory for a time after we are done with them to avoid reloading in case they are reused soon.

Definition at line 890 of file cachemanager.h.

csHash<psGuildInfo*> CacheManager::guildinfo_by_id [protected]

Definition at line 920 of file cachemanager.h.

csPDelArray<csPDelArray<psItemAnimation > > CacheManager::item_anim_list [protected]

Definition at line 919 of file cachemanager.h.

csPDelArray<psItemCategory > CacheManager::itemCategoryList [protected]

Definition at line 908 of file cachemanager.h.

csArray<psItemStatFlags> CacheManager::ItemStatFlagArray

Translation table for Flag strings (from db) into bit codes.

Definition at line 569 of file cachemanager.h.

csHash<psItemStats*,uint32> CacheManager::itemStats_IDHash [protected]

Definition at line 917 of file cachemanager.h.