5 This file is part of catta.
7 catta is free software; you can redistribute it and/or modify it
8 under the terms of the GNU Lesser General Public License as
9 published by the Free Software Foundation; either version 2.1 of the
10 License, or (at your option) any later version.
12 catta is distributed in the hope that it will be useful, but WITHOUT
13 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
14 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
15 Public License for more details.
17 You should have received a copy of the GNU Lesser General Public
18 License along with catta; if not, write to the Free Software
19 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
23 typedef struct CattaCache CattaCache;
25 #include <catta/llist.h>
28 #include "timeeventq.h"
36 CATTA_CACHE_EXPIRY_FINAL,
37 CATTA_CACHE_POOF, /* Passive observation of failure */
38 CATTA_CACHE_POOF_FINAL,
39 CATTA_CACHE_GOODBYE_FINAL,
40 CATTA_CACHE_REPLACE_FINAL
41 } CattaCacheEntryState;
43 typedef struct CattaCacheEntry CattaCacheEntry;
45 struct CattaCacheEntry {
48 struct timeval timestamp;
49 struct timeval poof_timestamp;
50 struct timeval expiry;
56 CattaCacheEntryState state;
57 CattaTimeEvent *time_event;
59 CattaAddress poof_address;
61 CATTA_LLIST_FIELDS(CattaCacheEntry, by_key);
62 CATTA_LLIST_FIELDS(CattaCacheEntry, entry);
68 CattaInterface *iface;
70 CattaHashmap *hashmap;
72 CATTA_LLIST_HEAD(CattaCacheEntry, entries);
77 time_t last_rand_timestamp;
80 CattaCache *catta_cache_new(CattaServer *server, CattaInterface *iface);
81 void catta_cache_free(CattaCache *c);
83 void catta_cache_update(CattaCache *c, CattaRecord *r, int cache_flush, const CattaAddress *a);
85 int catta_cache_dump(CattaCache *c, CattaDumpCallback callback, void* userdata);
87 typedef void* CattaCacheWalkCallback(CattaCache *c, CattaKey *pattern, CattaCacheEntry *e, void* userdata);
88 void* catta_cache_walk(CattaCache *c, CattaKey *pattern, CattaCacheWalkCallback cb, void* userdata);
90 int catta_cache_entry_half_ttl(CattaCache *c, CattaCacheEntry *e);
92 /** Start the "Passive observation of Failure" algorithm for all
93 * records of the specified key. The specified address is */
94 void catta_cache_start_poof(CattaCache *c, CattaKey *key, const CattaAddress *a);
96 /* Stop a previously started POOF algorithm for a record. (Used for response suppresions records */
97 void catta_cache_stop_poof(CattaCache *c, CattaRecord *record, const CattaAddress *a);
99 void catta_cache_flush(CattaCache *c);