libnl  3.2.27
cache.h
1 /*
2  * netlink/cache.h Caching Module
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation version 2.1
7  * of the License.
8  *
9  * Copyright (c) 2003-2012 Thomas Graf <tgraf@suug.ch>
10  */
11 
12 #ifndef NETLINK_CACHE_H_
13 #define NETLINK_CACHE_H_
14 
15 #include <netlink/netlink.h>
16 #include <netlink/msg.h>
17 #include <netlink/utils.h>
18 #include <netlink/object.h>
19 
20 #ifdef __cplusplus
21 extern "C" {
22 #endif
23 
24 enum {
25  NL_ACT_UNSPEC,
26  NL_ACT_NEW,
27  NL_ACT_DEL,
28  NL_ACT_GET,
29  NL_ACT_SET,
30  NL_ACT_CHANGE,
31  __NL_ACT_MAX,
32 };
33 
34 #define NL_ACT_MAX (__NL_ACT_MAX - 1)
35 
36 struct nl_cache;
37 typedef void (*change_func_t)(struct nl_cache *, struct nl_object *, int, void *);
38 
39 /**
40  * @ingroup cache
41  * Explicitely iterate over all address families when updating the cache
42  */
43 #define NL_CACHE_AF_ITER 0x0001
44 
45 /* Access Functions */
46 extern int nl_cache_nitems(struct nl_cache *);
47 extern int nl_cache_nitems_filter(struct nl_cache *,
48  struct nl_object *);
49 extern struct nl_cache_ops * nl_cache_get_ops(struct nl_cache *);
50 extern struct nl_object * nl_cache_get_first(struct nl_cache *);
51 extern struct nl_object * nl_cache_get_last(struct nl_cache *);
52 extern struct nl_object * nl_cache_get_next(struct nl_object *);
53 extern struct nl_object * nl_cache_get_prev(struct nl_object *);
54 
55 extern struct nl_cache * nl_cache_alloc(struct nl_cache_ops *);
56 extern int nl_cache_alloc_and_fill(struct nl_cache_ops *,
57  struct nl_sock *,
58  struct nl_cache **);
59 extern int nl_cache_alloc_name(const char *,
60  struct nl_cache **);
61 extern struct nl_cache * nl_cache_subset(struct nl_cache *,
62  struct nl_object *);
63 extern struct nl_cache * nl_cache_clone(struct nl_cache *);
64 extern void nl_cache_clear(struct nl_cache *);
65 extern void nl_cache_get(struct nl_cache *);
66 extern void nl_cache_free(struct nl_cache *);
67 extern void nl_cache_put(struct nl_cache *cache);
68 
69 /* Cache modification */
70 extern int nl_cache_add(struct nl_cache *,
71  struct nl_object *);
72 extern int nl_cache_parse_and_add(struct nl_cache *,
73  struct nl_msg *);
74 extern int nl_cache_move(struct nl_cache *,
75  struct nl_object *);
76 extern void nl_cache_remove(struct nl_object *);
77 extern int nl_cache_refill(struct nl_sock *,
78  struct nl_cache *);
79 extern int nl_cache_pickup(struct nl_sock *,
80  struct nl_cache *);
81 extern int nl_cache_pickup_checkdup(struct nl_sock *,
82  struct nl_cache *);
83 extern int nl_cache_resync(struct nl_sock *,
84  struct nl_cache *,
85  change_func_t,
86  void *);
87 extern int nl_cache_include(struct nl_cache *,
88  struct nl_object *,
89  change_func_t,
90  void *);
91 extern void nl_cache_set_arg1(struct nl_cache *, int);
92 extern void nl_cache_set_arg2(struct nl_cache *, int);
93 extern void nl_cache_set_flags(struct nl_cache *, unsigned int);
94 
95 /* General */
96 extern int nl_cache_is_empty(struct nl_cache *);
97 extern struct nl_object * nl_cache_search(struct nl_cache *,
98  struct nl_object *);
99 extern struct nl_object *nl_cache_find(struct nl_cache *,
100  struct nl_object *);
101 extern void nl_cache_mark_all(struct nl_cache *);
102 
103 /* Dumping */
104 extern void nl_cache_dump(struct nl_cache *,
105  struct nl_dump_params *);
106 extern void nl_cache_dump_filter(struct nl_cache *,
107  struct nl_dump_params *,
108  struct nl_object *);
109 
110 /* Iterators */
111 extern void nl_cache_foreach(struct nl_cache *,
112  void (*cb)(struct nl_object *,
113  void *),
114  void *arg);
115 extern void nl_cache_foreach_filter(struct nl_cache *,
116  struct nl_object *,
117  void (*cb)(struct
118  nl_object *,
119  void *),
120  void *arg);
121 
122 /* --- cache management --- */
123 
124 /* Cache type management */
125 extern struct nl_cache_ops * nl_cache_ops_lookup(const char *);
126 extern struct nl_cache_ops * nl_cache_ops_lookup_safe(const char *);
127 extern struct nl_cache_ops * nl_cache_ops_associate(int, int);
128 extern struct nl_cache_ops * nl_cache_ops_associate_safe(int, int);
129 extern struct nl_msgtype * nl_msgtype_lookup(struct nl_cache_ops *, int);
130 extern void nl_cache_ops_foreach(void (*cb)(struct nl_cache_ops *, void *), void *);
131 extern int nl_cache_mngt_register(struct nl_cache_ops *);
132 extern int nl_cache_mngt_unregister(struct nl_cache_ops *);
133 
134 /* Global cache provisioning/requiring */
135 extern void nl_cache_mngt_provide(struct nl_cache *);
136 extern void nl_cache_mngt_unprovide(struct nl_cache *);
137 extern struct nl_cache * nl_cache_mngt_require(const char *);
138 extern struct nl_cache * nl_cache_mngt_require_safe(const char *);
139 extern struct nl_cache * __nl_cache_mngt_require(const char *);
140 
141 struct nl_cache_mngr;
142 
143 #define NL_AUTO_PROVIDE 1
144 #define NL_ALLOCATED_SOCK 2 /* For internal use only, do not use */
145 
146 extern int nl_cache_mngr_alloc(struct nl_sock *,
147  int, int,
148  struct nl_cache_mngr **);
149 extern int nl_cache_mngr_add(struct nl_cache_mngr *,
150  const char *,
151  change_func_t,
152  void *,
153  struct nl_cache **);
154 extern int nl_cache_mngr_add_cache(struct nl_cache_mngr *mngr,
155  struct nl_cache *cache,
156  change_func_t cb, void *data);
157 extern int nl_cache_mngr_get_fd(struct nl_cache_mngr *);
158 extern int nl_cache_mngr_poll(struct nl_cache_mngr *,
159  int);
160 extern int nl_cache_mngr_data_ready(struct nl_cache_mngr *);
161 extern void nl_cache_mngr_info(struct nl_cache_mngr *,
162  struct nl_dump_params *);
163 extern void nl_cache_mngr_free(struct nl_cache_mngr *);
164 
165 extern void nl_cache_ops_get(struct nl_cache_ops *);
166 extern void nl_cache_ops_put(struct nl_cache_ops *);
167 extern void nl_cache_ops_set_flags(struct nl_cache_ops *,
168  unsigned int);
169 
170 #ifdef __cplusplus
171 }
172 #endif
173 
174 #endif
void nl_cache_mngt_provide(struct nl_cache *)
Provide a cache for global use.
Definition: cache_mngt.c:332
void nl_cache_ops_put(struct nl_cache_ops *)
Decrement reference counter.
Definition: cache_mngt.c:65
struct nl_object * nl_cache_get_prev(struct nl_object *)
Return the previous element in the cache.
Definition: cache.c:158
int nl_cache_alloc_name(const char *, struct nl_cache **)
Allocate new cache based on type name.
Definition: cache.c:264
struct nl_cache * nl_cache_subset(struct nl_cache *, struct nl_object *)
Allocate new cache containing a subset of an existing cache.
Definition: cache.c:297
void nl_cache_ops_get(struct nl_cache_ops *)
Increment reference counter.
Definition: cache_mngt.c:56
int nl_cache_mngr_alloc(struct nl_sock *, int, int, struct nl_cache_mngr **)
Allocate new cache manager.
Definition: cache_mngr.c:135
int nl_cache_mngr_get_fd(struct nl_cache_mngr *)
Get socket file descriptor.
Definition: cache_mngr.c:359
int nl_cache_mngt_unregister(struct nl_cache_ops *)
Unregister a set of cache operations.
Definition: cache_mngt.c:287
struct nl_cache * nl_cache_mngt_require_safe(const char *)
Return cache previously provided via nl_cache_mngt_provide()
Definition: cache_mngt.c:430
void nl_cache_get(struct nl_cache *)
Increase reference counter of cache.
Definition: cache.c:391
struct nl_object * nl_cache_find(struct nl_cache *, struct nl_object *)
Find object in cache.
Definition: cache.c:1098
void nl_cache_dump_filter(struct nl_cache *, struct nl_dump_params *, struct nl_object *)
Dump all elements of a cache (filtered).
Definition: cache.c:1166
void nl_cache_mngr_info(struct nl_cache_mngr *, struct nl_dump_params *)
Print information about cache manager.
Definition: cache_mngr.c:460
void nl_cache_foreach_filter(struct nl_cache *cache, struct nl_object *filter, void(*cb)(struct nl_object *, void *), void *arg)
Call a callback on each element of the cache (filtered).
Definition: cache.c:1232
struct nl_object * nl_cache_get_last(struct nl_cache *)
Return the last element in the cache.
Definition: cache.c:132
int nl_cache_mngr_poll(struct nl_cache_mngr *, int)
Check for event notifications.
Definition: cache_mngr.c:383
struct nl_cache_ops * nl_cache_ops_lookup(const char *)
Lookup cache operations by name.
Definition: cache_mngt.c:79
int nl_cache_pickup_checkdup(struct nl_sock *, struct nl_cache *)
Pickup a netlink dump response and put it into a cache.
Definition: cache.c:763
void nl_cache_free(struct nl_cache *)
Free a cache.
Definition: cache.c:408
void nl_cache_set_arg1(struct nl_cache *, int)
Set synchronization arg1 of cache.
Definition: cache.c:590
int nl_cache_mngt_register(struct nl_cache_ops *)
Register a set of cache operations.
Definition: cache_mngt.c:252
struct nl_object * nl_cache_search(struct nl_cache *, struct nl_object *)
Search object in cache.
Definition: cache.c:1063
void nl_cache_foreach(struct nl_cache *, void(*cb)(struct nl_object *, void *), void *arg)
Call a callback on each element of the cache.
Definition: cache.c:1215
void nl_cache_remove(struct nl_object *)
Remove object from cache.
Definition: cache.c:551
struct nl_cache * nl_cache_mngt_require(const char *)
Return cache previously provided via nl_cache_mngt_provide()
Definition: cache_mngt.c:408
int nl_cache_is_empty(struct nl_cache *)
Returns true if the cache is empty.
Definition: cache.c:101
void nl_cache_clear(struct nl_cache *)
Remove all objects of a cache.
Definition: cache.c:366
struct nl_cache_ops * nl_cache_ops_lookup_safe(const char *)
Lookup cache operations by name.
Definition: cache_mngt.c:99
void nl_cache_set_arg2(struct nl_cache *, int)
Set synchronization arg2 of cache.
Definition: cache.c:603
void nl_cache_dump(struct nl_cache *, struct nl_dump_params *)
Dump all elements of a cache.
Definition: cache.c:1152
void nl_cache_mngt_unprovide(struct nl_cache *)
Unprovide a cache for global use.
Definition: cache_mngt.c:365
int nl_cache_parse_and_add(struct nl_cache *, struct nl_msg *)
Parse a netlink message and add it to the cache.
Definition: cache.c:970
int nl_cache_nitems(struct nl_cache *)
Return the number of items in the cache.
Definition: cache.c:68
void nl_cache_ops_set_flags(struct nl_cache_ops *, unsigned int)
Set default flags for caches of this type.
Definition: cache_mngt.c:236
int nl_cache_mngr_add_cache(struct nl_cache_mngr *mngr, struct nl_cache *cache, change_func_t cb, void *data)
Add cache to cache manager.
Definition: cache_mngr.c:221
struct nl_object * nl_cache_get_next(struct nl_object *)
Return the next element in the cache.
Definition: cache.c:145
int nl_cache_refill(struct nl_sock *, struct nl_cache *)
(Re)fill a cache with the contents in the kernel.
Definition: cache.c:990
void nl_cache_ops_foreach(void(*cb)(struct nl_cache_ops *, void *), void *)
Call a function for each registered cache operation.
Definition: cache_mngt.c:218
void nl_cache_mark_all(struct nl_cache *)
Mark all objects of a cache.
Definition: cache.c:1127
int nl_cache_move(struct nl_cache *, struct nl_object *)
Move object from one cache to another.
Definition: cache.c:523
int nl_cache_mngr_data_ready(struct nl_cache_mngr *)
Receive available event notifications.
Definition: cache_mngr.c:424
int nl_cache_nitems_filter(struct nl_cache *, struct nl_object *)
Return the number of items matching a filter in the cache.
Definition: cache.c:78
struct nl_cache_ops * nl_cache_ops_associate(int, int)
Associate protocol and message type to cache operations.
Definition: cache_mngt.c:140
Dumping parameters.
Definition: types.h:33
void nl_cache_mngr_free(struct nl_cache_mngr *)
Free cache manager and all caches.
Definition: cache_mngr.c:499
void nl_cache_set_flags(struct nl_cache *, unsigned int)
Set cache flags.
Definition: cache.c:613
struct nl_cache_ops * nl_cache_get_ops(struct nl_cache *)
Return the operations set of the cache.
Definition: cache.c:110
int nl_cache_mngr_add(struct nl_cache_mngr *, const char *, change_func_t, void *, struct nl_cache **)
Add cache to cache manager.
Definition: cache_mngr.c:321
struct nl_cache * nl_cache_clone(struct nl_cache *)
Allocate new cache and copy the contents of an existing cache.
Definition: cache.c:337
int nl_cache_add(struct nl_cache *, struct nl_object *)
Add object to cache.
Definition: cache.c:479
struct nl_msgtype * nl_msgtype_lookup(struct nl_cache_ops *, int)
Lookup message type cache association.
Definition: cache_mngt.c:189
struct nl_cache_ops * nl_cache_ops_associate_safe(int, int)
Associate protocol and message type to cache operations.
Definition: cache_mngt.c:164
struct nl_object * nl_cache_get_first(struct nl_cache *)
Return the first element in the cache.
Definition: cache.c:119
int nl_cache_alloc_and_fill(struct nl_cache_ops *, struct nl_sock *, struct nl_cache **)
Allocate new cache and fill it.
Definition: cache.c:233
struct nl_cache * nl_cache_alloc(struct nl_cache_ops *)
Allocate new cache.
Definition: cache.c:183
int nl_cache_pickup(struct nl_sock *, struct nl_cache *)
Pickup a netlink dump response and put it into a cache.
Definition: cache.c:781