forked from 0ad/0ad
janwas
8371f42da9
adts: slight improvements allocators: change POOL_VARIABLE_ALLOCS to -1 for safety; fix invalid assumptions of it being 0 lib: more expressive param names file: add file_get_random_name for randomized trace generation; allow file_cache.h to declare externally visible file_buf_alloc API file_cache: zero-length file bugfix; also add several flags to the API routines allowing statistics gathering to be disabled (avoids distorting stats due to e.g. trace_entry_causes_io cache simulation) file_stats: add archive builder info; separate IO timing and seek accounting (-> correct results) trace: add random generation capability vfs: made responsible for cache hit/miss accounting (fixes cache miss rate display) This was SVN commit r3681.
67 lines
2.1 KiB
C
67 lines
2.1 KiB
C
#ifndef TRACE_H__
|
|
#define TRACE_H__
|
|
|
|
extern void trace_enable(bool want_enabled);
|
|
extern void trace_shutdown();
|
|
|
|
extern void trace_notify_load(const char* P_fn, size_t size, uint flags);
|
|
extern void trace_notify_free(const char* P_fn, size_t size);
|
|
|
|
// TraceEntry operation type.
|
|
// note: rather than only a list of accessed files, we also need to
|
|
// know the application's behavior WRT caching (e.g. when it releases
|
|
// cached buffers). this is necessary so that our simulation can
|
|
// yield the same results.
|
|
enum TraceOp
|
|
{
|
|
TO_LOAD,
|
|
TO_FREE
|
|
};
|
|
|
|
// stores one event that is relevant for file IO / caching.
|
|
//
|
|
// size-optimized a bit since these are all kept in memory
|
|
// (to prevent trace file writes from affecting other IOs)
|
|
struct TraceEntry
|
|
{
|
|
// note: float instead of double for nice 16 byte struct size
|
|
float timestamp; // returned by get_time before operation starts
|
|
const char* atom_fn; // path+name of affected file
|
|
// rationale: store size in the trace because other applications
|
|
// that use this trace format but not our IO code wouldn't know
|
|
// size (since they cannot retrieve the file info given atom_fn).
|
|
size_t size; // of IO (usually the entire file)
|
|
uint op : 8; // operation - see TraceOp
|
|
uint flags : 24; // misc, e.g. file_io flags.
|
|
};
|
|
|
|
struct Trace
|
|
{
|
|
const TraceEntry* ents;
|
|
size_t num_ents;
|
|
};
|
|
|
|
extern void trace_get(Trace* t);
|
|
extern LibError trace_write_to_file(const char* trace_filename);
|
|
extern LibError trace_read_from_file(const char* trace_filename, Trace* t);
|
|
|
|
extern void trace_gen_random(size_t num_entries);
|
|
|
|
|
|
// simulate carrying out the entry's TraceOp to determine
|
|
// whether this IO would be satisfied by the file_buf cache.
|
|
extern bool trace_entry_causes_io(const TraceEntry* ent);
|
|
|
|
enum TraceRunFlags
|
|
{
|
|
TRF_SYNC_TO_TIMESTAMP = 1
|
|
};
|
|
|
|
// carry out all operations specified in the trace.
|
|
// if flags&TRF_SYNC_TO_TIMESTAMP, waits until timestamp for each event is
|
|
// reached; otherwise, they are run as fast as possible.
|
|
extern LibError trace_run(const char* trace_filename, uint flags = 0);
|
|
|
|
|
|
#endif // #ifndef TRACE_H__
|