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 struct GNUNET_PeerIdentity *peer,
52 const char *sub_system,
57 * @brief struct returned by the initialization function of the plugin
59 struct GNUNET_PEERSTORE_PluginFunctions
63 * Closure to pass to all plugin functions.
68 * Store a record in the peerstore.
69 * Key is the combination of sub system and peer identity.
70 * One key can store multiple values.
72 * @param cls closure (internal context for the plugin)
73 * @param sub_system name of the GNUnet sub system responsible
74 * @param peer peer identity
75 * @param value value to be stored
76 * @param size size of value to be stored
77 * @return #GNUNET_OK on success, else #GNUNET_SYSERR
80 (*store_record) (void *cls,
81 const struct GNUNET_PeerIdentity *peer,
82 const char *sub_system,
87 * Iterate over the records given an optional peer id
90 * @param cls closure (internal context for the plugin)
91 * @param peer Peer identity (can be NULL)
92 * @param sub_system name of sub system (can be NULL)
93 * @param iter function to call with the result
94 * @param iter_cls closure for @a iter
95 * @return #GNUNET_OK on success, #GNUNET_NO if there were no results, #GNUNET_SYSERR on error
98 (*iterate_records) (void *cls,
99 const struct GNUNET_PeerIdentity *peer,
100 const char *sub_system,
101 GNUNET_PEERSTORE_RecordIterator iter, void *iter_cls);
106 #if 0 /* keep Emacsens' auto-indent happy */
113 /* end of gnunet_peerstore_plugin.h */