2 This file is part of GNUnet
3 (C) 2012, 2013 Christian Grothoff (and other contributing authors)
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18 Boston, MA 02111-1307, USA.
22 * @file include/gnunet_peerstore_plugin.h
23 * @brief plugin API for the peerstore database backend
24 * @author Omar Tarabai
26 #ifndef GNUNET_PEERSTORE_PLUGIN_H
27 #define GNUNET_PEERSTORE_PLUGIN_H
29 #include "gnunet_util_lib.h"
30 #include "gnunet_peerstore_service.h"
35 #if 0 /* keep Emacsens' auto-indent happy */
42 * Function called by for each matching record.
45 * @param peer peer identity
46 * @param sub_system name of the GNUnet sub system responsible
47 * @param value stored value
48 * @param size size of stored value
50 typedef void (*GNUNET_PEERSTORE_RecordIterator) (void *cls,
51 const char *sub_system,
52 const struct GNUNET_PeerIdentity *peer,
58 * @brief struct returned by the initialization function of the plugin
60 struct GNUNET_PEERSTORE_PluginFunctions
64 * Closure to pass to all plugin functions.
69 * Store a record in the peerstore.
70 * Key is the combination of sub system and peer identity.
71 * One key can store multiple values.
73 * @param cls closure (internal context for the plugin)
74 * @param sub_system name of the GNUnet sub system responsible
75 * @param peer peer identity
76 * @param value value to be stored
77 * @param size size of value to be stored
78 * @return #GNUNET_OK on success, else #GNUNET_SYSERR
81 (*store_record) (void *cls,
82 const char *sub_system,
83 const struct GNUNET_PeerIdentity *peer,
87 struct GNUNET_TIME_Absolute expiry);
90 * Iterate over the records given an optional peer id
93 * @param cls closure (internal context for the plugin)
94 * @param sub_system name of sub system
95 * @param peer Peer identity (can be NULL)
96 * @param key entry key string (can be NULL)
97 * @param iter function to call with the result
98 * @param iter_cls closure for @a iter
99 * @return #GNUNET_OK on success, #GNUNET_SYSERR on error
102 (*iterate_records) (void *cls,
103 const char *sub_system,
104 const struct GNUNET_PeerIdentity *peer,
106 GNUNET_PEERSTORE_RecordIterator iter, void *iter_cls);
111 #if 0 /* keep Emacsens' auto-indent happy */
118 /* end of gnunet_peerstore_plugin.h */