OSSP CVS Repository

Check-in Number:	1887
Date:	2002-Feb-16 13:57:57 (local) 2002-Feb-16 12:57:57 (UTC)
User:	rse
Branch:
Comment:	flush my already done work
Tickets:
Inspections:
Files:	ossp-pkg/cache/cache.c      1.1 -> 1.2     57 inserted, 0 deleted ossp-pkg/cache/cache.h      1.1 -> 1.2     53 inserted, 0 deleted

---

ossp-pkg/cache/cache.c 1.1 -> 1.2

--- cache.c 2002/01/09 10:44:28 1.1 +++ cache.c 2002/02/16 12:57:57 1.2 @@ -47,3 +47,60 @@ #define TRUE (!FALSE) #endif +/* forward declarations */ +struct cache_st; +struct cache_obj_st; + +/* type definitions */ +typedef struct cache_obj_st cache_obj_t; + +/* support for relative pointers (offset pointers) */ +typedef long op_t; +#define VP2OP(bp,vp) \ + (long)(((char *)(vp))-((char *)(bp))) +#define OP2VP(bp,op) \ + (void *)(((char *)(bp))+((char *)(op))) + +/* definition: top-level cache structure */ +struct cache_st { + /* top level access pointers */ + op_t opHash; /* pointer to hash table */ + op_t opObjMRU; /* pointer to MRU object */ + op_t opObjLRU; /* pointer to LRU object */ + op_t opObjEmpty; /* pointer to empty object */ + + /* information */ + int bExpireReset; /* whether expire resets on each access or is absolute */ + int tExpireReset; /* the optional expire reset time */ + + /* sub-structure information */ + op_t opKeyIndex; /* base address of key bucket index */ + op_t opKeyBuckets; /* base address of key bucket pool */ + int nKeyBuckets; /* number of buckets in key bucket pool */ + op_t opValIndex; /* base address of key bucket index */ + op_t opValBuckets; /* base address of value bucket pool */ + int nValBuckets; /* number of buckets in value bucket pool */ + + /* statistics */ + long nInserts; + long nLookups; + long nLookupsSuccess; + long nRemoves; + + /* callbacks */ + /* ... */ +}; + +/* definition: cache object */ +struct cache_obj_st { + int bUsed; /* used in an ongoing iteration */ + op_t opHashNext; /* next object in hash table collision chain */ + op_t opQueuePrev; /* previous object in LRU queue */ + op_t opQueueNext; /* next object in LRU queue */ + op_t opKey; /* pointer to first key segment in key index */ + size_t nKey; /* size of key in bytes */ + op_t opVal; /* pointer to first value segment in value index */ + size_t nVal; /* size of value in bytes */ + time_t tExpire; /* expire time of object */ +}; +

---

ossp-pkg/cache/cache.h 1.1 -> 1.2

--- cache.h 2002/01/09 10:44:28 1.1 +++ cache.h 2002/02/16 12:57:58 1.2 @@ -31,5 +31,58 @@ #ifndef __CACHE_H__ #define __CACHE_H__ +struct cache_st; +typedef cache_st cache_t; + +typedef enum { + CACHE_OK = 0, + CACHE_ERR_INVAL, + CACHE_ERR_SYS +} cache_rc_t; + +typedef enum { + CACHE_SET, + CACHE_GET, +} cache_config_t; + +typedef enum { + CACHE_ST_MAXKEY, + CACHE_CB_MUTEXACQUIRE, + CACHE_CB_MUTEXRELEASE, + CACHE_CB_OBJECTREMOVE, +} cache_param_t; + +typedef enum { + CACHE_INPLACE, /* re-arrange segments internally */ + CACHE_COPYOUT, /* copy as serialized object into new buffer */ + CACHE_MOVEOUT, /* move as serialized object into existing buffer */ +} cache_fetch_t; + +typedef struct { + void *ptr; + size_t len; +} cache_blob_t; + +cache_rc_t cache_attach (cache_t **cache, void *memptr, size_t memlen, size_t keyseg, size_t valseg); +cache_rc_t cache_config (cache_t *cache, cache_config_t mode, cache_param_t id, ...); +cache_rc_t cache_detach (cache_t *cache); + +cache_rc_t cache_insert (cache_t *cache, cache_blob_t key, cache_blob_t val, time_t now, time_t expire); +cache_rc_t cache_lookup (cache_t *cache, cache_blob_t key, cache_obj_t **obj, time_t now); +cache_rc_t cache_remove (cache_t *cache, cache_blob_t key); + +cache_rc_t cache_obj_size (cache_obj_t *obj, size_t *size); +cache_rc_t cache_obj_fetch (cache_obj_t *obj, cache_fetch_t mode, cache_blob_t *val); +cache_rc_t cache_obj_release (cache_obj_t *obj); + +cache_rc_t cache_fetch (cache_t *cache, cache_iter_t *iter, cache_blob_t *val); + +cache_rc_t cache_iter_create (cache_t *cache, cache_iter_t *iter); +cache_rc_t cache_iter_key (cache_t *cache, cache_iter_t *iter); +cache_rc_t cache_iter_destroy(cache_t *cache, cache_iter_t *iter); + +cache_rc_t cache_export (cache_t *cache, void *); +cache_rc_t cache_import (cache_t *cache, void *); + #endif /* __CACHE_H__ */