janwas
9269be9ee3
(see http://www.wildfiregames.com/forum/index.php?showtopic=11450&hl= ) clean up debug module . no longer include platform-dependent header (-> less rebuilds) . DISPLAY_ERROR -> DEBUG_DISPLAY_ERROR . parts of config.h that don't affect all files moved to config.2 (-> fewer full rebuilds) . remove creaky symbol cache (no longer needed for mmgr) . remove TLS thread naming stuff (can use debugger's thread window instead; no need for platform independence there) wdbg: remove thread suspension and breakpoint APIs (not needed) acpi: fix: u64 -> uintptr_t wutil: fix WinScopedLock, use that instead of direct lock() functions misc: . get rid of SAFE_STRCPY, replace with strcpy_s . remove _getcwd (shouldn't be used) This was SVN commit r5563.
91 lines
3.0 KiB
C++
91 lines
3.0 KiB
C++
/**
|
|
* =========================================================================
|
|
* File : file_cache.h
|
|
* Project : 0 A.D.
|
|
* Description : cache of file contents (supports zero-copy IO)
|
|
* =========================================================================
|
|
*/
|
|
|
|
// license: GPL; see lib/license.txt
|
|
|
|
#ifndef INCLUDED_FILE_CACHE
|
|
#define INCLUDED_FILE_CACHE
|
|
|
|
#include "vfs_path.h"
|
|
|
|
/**
|
|
* cache of file contents with support for zero-copy IO.
|
|
* this works by reserving a region of the cache, using it as the IO buffer,
|
|
* and returning the memory directly to users. optional write-protection
|
|
* via MMU ensures that the shared contents aren't inadvertently changed.
|
|
*
|
|
* (unique copies of) VFS pathnames are used as lookup key and owner tag.
|
|
*
|
|
* to ensure efficient operation and prevent fragmentation, only one
|
|
* reference should be active at a time. in other words, read a file,
|
|
* process it, and only then start reading the next file.
|
|
*
|
|
* rationale: this is rather similar to BlockCache; however, the differences
|
|
* (Reserve's size parameter, eviction policies) are enough to warrant
|
|
* separate implementations.
|
|
**/
|
|
class FileCache
|
|
{
|
|
public:
|
|
/**
|
|
* @param size maximum amount [bytes] of memory to use for the cache.
|
|
* (managed as a virtual memory region that's committed on-demand)
|
|
**/
|
|
FileCache(size_t size);
|
|
|
|
/**
|
|
* Reserve a chunk of the cache's memory region.
|
|
*
|
|
* @param size required number of bytes (more may be allocated due to
|
|
* alignment and/or internal fragmentation)
|
|
* @return memory suitably aligned for IO; never fails.
|
|
*
|
|
* it is expected that this data will be Add()-ed once its IO completes.
|
|
**/
|
|
shared_ptr<u8> Reserve(size_t size);
|
|
|
|
/**
|
|
* Add a file's contents to the cache.
|
|
*
|
|
* the cache will be able to satisfy subsequent Retrieve() calls by
|
|
* returning this data; if CONFIG2_CACHE_READ_ONLY, the buffer is made
|
|
* read-only. if need be and no references are currently attached to it,
|
|
* the memory can also be commandeered by Reserve().
|
|
*
|
|
* @param pathname key that will be used to Retrieve file contents.
|
|
* @param cost is the expected cost of retrieving the file again and
|
|
* influences how/when it is evicted from the cache.
|
|
**/
|
|
void Add(const VfsPath& pathname, shared_ptr<u8> data, size_t size, uint cost = 1);
|
|
|
|
/**
|
|
* Remove a file's contents from the cache (if it exists).
|
|
*
|
|
* this ensures subsequent reads of the files see the current, presumably
|
|
* recently changed, contents of the file.
|
|
*
|
|
* this would typically be called in response to a notification that a
|
|
* file has changed.
|
|
**/
|
|
void Remove(const VfsPath& pathname);
|
|
|
|
/**
|
|
* Attempt to retrieve a file's contents from the file cache.
|
|
*
|
|
* @return whether the contents were successfully retrieved; if so,
|
|
* data references the read-only file contents.
|
|
**/
|
|
bool Retrieve(const VfsPath& pathname, shared_ptr<u8>& data, size_t& size);
|
|
|
|
private:
|
|
class Impl;
|
|
shared_ptr<Impl> impl;
|
|
};
|
|
|
|
#endif // #ifndef INCLUDED_FILE_CACHE
|