Debian Codegraph @

include/net-snmp/library/oid_stash.h

raw
1 #ifndef OID_STASH_H
2 #define OID_STASH_H
3
4 /*
5 * designed to store/retrieve information associated with a given oid.
6 * Storage is done in an efficient tree manner for fast lookups.
7 */
8
9 #define OID_STASH_CHILDREN_SIZE 31
10
11 #ifdef __cplusplus
12 extern "C" {
13 #endif
14
15 struct netsnmp_oid_stash_node_s;
16
17 /* args: buffer, sizeof(buffer), yourdata, stashnode */
18 typedef int (NetSNMPStashDump) (char *, size_t,
19 void *,
20 struct netsnmp_oid_stash_node_s *);
21
22 typedef void (NetSNMPStashFreeNode) (void *);
23
24 typedef struct netsnmp_oid_stash_node_s {
25 oid value;
26 struct netsnmp_oid_stash_node_s **children; /* array of children */
27 size_t children_size;
28 struct netsnmp_oid_stash_node_s *next_sibling; /* cache too small links */
29 struct netsnmp_oid_stash_node_s *prev_sibling;
30 struct netsnmp_oid_stash_node_s *parent;
31
32 void *thedata;
33 } netsnmp_oid_stash_node;
34
35 typedef struct netsnmp_oid_stash_save_info_s {
36 const char *token;
37 netsnmp_oid_stash_node **root;
38 NetSNMPStashDump *dumpfn;
39 } netsnmp_oid_stash_save_info;
40
41 NETSNMP_IMPORT
42 int netsnmp_oid_stash_add_data(netsnmp_oid_stash_node **root,
43 const oid * lookup,
44 size_t lookup_len,
45 void *mydata);
46 SNMPCallback netsnmp_oid_stash_store_all;
47
48
49 netsnmp_oid_stash_node
50 *netsnmp_oid_stash_get_node(netsnmp_oid_stash_node *root,
51 const oid * lookup, size_t lookup_len);
52 NETSNMP_IMPORT
53 void *netsnmp_oid_stash_get_data(netsnmp_oid_stash_node *root,
54 const oid * lookup,
55 size_t lookup_len);
56 NETSNMP_IMPORT
57 netsnmp_oid_stash_node *
58 netsnmp_oid_stash_getnext_node(netsnmp_oid_stash_node *root,
59 oid * lookup, size_t lookup_len);
60
61 netsnmp_oid_stash_node *netsnmp_oid_stash_create_sized_node(size_t
62 mysize);
63 netsnmp_oid_stash_node *netsnmp_oid_stash_create_node(void); /* returns a malloced node */
64
65 void netsnmp_oid_stash_store(netsnmp_oid_stash_node *root,
66 const char *tokenname,
67 NetSNMPStashDump *dumpfn,
68 oid *curoid, size_t curoid_len);
69
70 /* frees all data in the stash and cleans it out. Sets root = NULL */
71 NETSNMP_IMPORT
72 void netsnmp_oid_stash_free(netsnmp_oid_stash_node **root,
73 NetSNMPStashFreeNode *freefn);
74
75
76 /* a noop function that can be passed to netsnmp_oid_stash_node to
77 NOT free the data */
78 NetSNMPStashFreeNode netsnmp_oid_stash_no_free;
79 #ifdef __cplusplus
80 }
81 #endif
82 #endif /* OID_STASH_H */