]> git.meshlink.io Git - catta/blob - avahi-core/cache.h
* move unicast DNS server registration/browsing routines to their own header dns...
[catta] / avahi-core / cache.h
1 #ifndef foocachehfoo
2 #define foocachehfoo
3
4 /* $Id$ */
5
6 /***
7   This file is part of avahi.
8  
9   avahi is free software; you can redistribute it and/or modify it
10   under the terms of the GNU Lesser General Public License as
11   published by the Free Software Foundation; either version 2.1 of the
12   License, or (at your option) any later version.
13  
14   avahi is distributed in the hope that it will be useful, but WITHOUT
15   ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
16   or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General
17   Public License for more details.
18  
19   You should have received a copy of the GNU Lesser General Public
20   License along with avahi; if not, write to the Free Software
21   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
22   USA.
23 ***/
24
25 typedef struct AvahiCache AvahiCache;
26
27 #include <avahi-common/llist.h>
28 #include "prioq.h"
29 #include "server.h"
30 #include "timeeventq.h"
31 #include "hashmap.h"
32
33 typedef enum {
34     AVAHI_CACHE_VALID,
35     AVAHI_CACHE_EXPIRY1,
36     AVAHI_CACHE_EXPIRY2,
37     AVAHI_CACHE_EXPIRY3,
38     AVAHI_CACHE_EXPIRY_FINAL,
39     AVAHI_CACHE_POOF,       /* Passive observation of failure */
40     AVAHI_CACHE_POOF_FINAL,
41     AVAHI_CACHE_GOODBYE_FINAL,
42     AVAHI_CACHE_REPLACE_FINAL
43 } AvahiCacheEntryState;
44
45 typedef struct AvahiCacheEntry AvahiCacheEntry;
46
47 struct AvahiCacheEntry {
48     AvahiCache *cache;
49     AvahiRecord *record;
50     struct timeval timestamp;
51     struct timeval expiry;
52     int cache_flush;
53     
54     AvahiAddress origin;
55
56     AvahiCacheEntryState state;
57     AvahiTimeEvent *time_event;
58
59     AvahiAddress poof_address;
60
61     AVAHI_LLIST_FIELDS(AvahiCacheEntry, by_key);
62     AVAHI_LLIST_FIELDS(AvahiCacheEntry, entry);
63 };
64
65 struct AvahiCache {
66     AvahiServer *server;
67     
68     AvahiInterface *interface;
69     
70     AvahiHashmap *hashmap;
71
72     AVAHI_LLIST_HEAD(AvahiCacheEntry, entries);
73
74     unsigned n_entries;
75 };
76
77 AvahiCache *avahi_cache_new(AvahiServer *server, AvahiInterface *interface);
78 void avahi_cache_free(AvahiCache *c);
79
80 void avahi_cache_update(AvahiCache *c, AvahiRecord *r, int cache_flush, const AvahiAddress *a);
81
82 int avahi_cache_dump(AvahiCache *c, AvahiDumpCallback callback, void* userdata);
83
84 typedef void* AvahiCacheWalkCallback(AvahiCache *c, AvahiKey *pattern, AvahiCacheEntry *e, void* userdata);
85 void* avahi_cache_walk(AvahiCache *c, AvahiKey *pattern, AvahiCacheWalkCallback cb, void* userdata);
86
87 int avahi_cache_entry_half_ttl(AvahiCache *c, AvahiCacheEntry *e);
88
89 /** Start the "Passive observation of Failure" algorithm for all
90  * records of the specified key. The specified address is  */
91 void avahi_cache_start_poof(AvahiCache *c, AvahiKey *key, const AvahiAddress *a);
92
93 /* Stop a previously started POOF algorithm for a record. (Used for response suppresions records */    
94 void avahi_cache_stop_poof(AvahiCache *c, AvahiRecord *record, const AvahiAddress *a);
95
96 void avahi_cache_flush(AvahiCache *c);
97
98 #endif