GNUnet 0.28.1-dev.5-1-gae1c02d74
 
Loading...
Searching...
No Matches
plugin_namecache_postgres.c
Go to the documentation of this file.
1/*
2 * This file is part of GNUnet
3 * Copyright (C) 2009-2013, 2016, 2017, 2022 GNUnet e.V.
4 *
5 * GNUnet is free software: you can redistribute it and/or modify it
6 * under the terms of the GNU Affero General Public License as published
7 * by the Free Software Foundation, either version 3 of the License,
8 * or (at your option) any later version.
9 *
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 * Affero General Public License for more details.
14 *
15 * You should have received a copy of the GNU Affero General Public License
16 * along with this program. If not, see <http://www.gnu.org/licenses/>.
17
18 SPDX-License-Identifier: AGPL3.0-or-later
19 */
20
26#include "platform.h"
29#include "gnunet_pq_lib.h"
30
31
32#define LOG(kind, ...) GNUNET_log_from (kind, "namecache-postgres", __VA_ARGS__)
33
34
38struct Plugin
39{
40 const struct GNUNET_CONFIGURATION_Handle *cfg;
41
45 struct GNUNET_PQ_Context *dbh;
46
50 bool ready;
51};
52
53
61static void
62reconnect_setup (void *cls,
63 struct GNUNET_PQ_Context *pq)
64{
65 struct Plugin *plugin = cls;
67 GNUNET_PQ_make_prepare ("cache_block",
68 "INSERT INTO namecache.ns096blocks"
69 " (query, block, expiration_time)"
70 " VALUES"
71 " ($1, $2, $3)"),
72 GNUNET_PQ_make_prepare ("expire_blocks",
73 "DELETE FROM namecache.ns096blocks"
74 " WHERE expiration_time<$1"),
75 GNUNET_PQ_make_prepare ("delete_block",
76 "DELETE FROM namecache.ns096blocks"
77 " WHERE query=$1 AND expiration_time<=$2"),
78 GNUNET_PQ_make_prepare ("purge_block",
79 "DELETE FROM namecache.ns096blocks"
80 " WHERE query=$1"),
81 GNUNET_PQ_make_prepare ("lookup_block",
82 "SELECT block"
83 " FROM namecache.ns096blocks"
84 " WHERE query=$1"
85 " ORDER BY expiration_time DESC LIMIT 1"),
87 };
88
89 if (GNUNET_SYSERR ==
91 {
92 plugin->ready = false;
93 return;
94 }
95 if (GNUNET_OK !=
97 "namecache-"))
98 {
99 plugin->ready = false;
100 return;
101 }
102 if (GNUNET_OK !=
104 ps))
105 {
106 plugin->ready = false;
107 return;
108 }
109 plugin->ready = true;
110}
111
112
123{
124 plugin->dbh = GNUNET_PQ_init (plugin->cfg,
125 "namecache-postgres",
127 plugin);
128 if (NULL == plugin->dbh)
129 return GNUNET_SYSERR;
130 if (! plugin->ready)
131 return GNUNET_NO;
132 return GNUNET_OK;
133}
134
135
141static void
156
157
165static void
167 const struct GNUNET_HashCode *query,
168 struct GNUNET_TIME_Absolute expiration_time)
169{
170 struct GNUNET_PQ_QueryParam params[] = {
172 GNUNET_PQ_query_param_absolute_time (&expiration_time),
174 };
176
178 "delete_block",
179 params);
181}
182
183
193 const struct GNUNET_GNSRECORD_Block *block)
194{
195 struct Plugin *plugin = cls;
196 struct GNUNET_HashCode query;
197 size_t block_size = GNUNET_GNSRECORD_block_get_size (block);
199 );
201
204 &query);
205 if (block_size > 64 * 65536)
206 {
207 GNUNET_break (0);
208 return GNUNET_SYSERR;
209 }
210 {
211 struct GNUNET_PQ_QueryParam params[] = {
213 GNUNET_PQ_query_param_fixed_size (block, block_size),
216 };
218 &query,
219 exp);
220
222 "cache_block",
223 params);
224 }
225 if (0 > res)
226 return GNUNET_SYSERR;
227 return GNUNET_OK;
228}
229
230
242 const struct GNUNET_HashCode *query)
243{
244 struct Plugin *plugin = cls;
245 struct GNUNET_PQ_QueryParam params[] = {
248 };
250
252 "purge_block",
253 params);
255 return GNUNET_NO;
256 if (0 > res)
257 return GNUNET_SYSERR;
258 return GNUNET_OK;
259}
260
261
274 const struct GNUNET_HashCode *query,
276 void *iter_cls)
277{
278 struct Plugin *plugin = cls;
279 size_t bsize;
280 struct GNUNET_GNSRECORD_Block *block;
281 struct GNUNET_PQ_QueryParam params[] = {
284 };
285 struct GNUNET_PQ_ResultSpec rs[] = {
287 (void **) &block,
288 &bsize),
290 };
292
294 "lookup_block",
295 params,
296 rs);
297 if (0 > res)
298 {
300 "Failing lookup block in namecache (postgres error)\n");
301 return GNUNET_SYSERR;
302 }
304 {
305 /* no result */
307 "Ending iteration (no more results)\n");
308 return GNUNET_NO;
309 }
310 if ((bsize < sizeof(*block)))
311 {
312 GNUNET_break (0);
314 "Failing lookup (corrupt block)\n");
316 return GNUNET_SYSERR;
317 }
318 iter (iter_cls,
319 block);
321 return GNUNET_OK;
322}
323
324
331static void
333{
335 plugin->dbh = NULL;
336}
337
338
339void *
341
348void *
350{
351 static struct Plugin plugin;
352 const struct GNUNET_CONFIGURATION_Handle *cfg = cls;
354
355 if (NULL != plugin.cfg)
356 return NULL; /* can only initialize once! */
357 memset (&plugin,
358 0,
359 sizeof(struct Plugin));
360 plugin.cfg = cfg;
361 if (GNUNET_OK !=
363 {
365 return NULL;
366 }
368 api->cls = &plugin;
373 "Postgres namecache plugin running\n");
374 return api;
375}
376
377
378void *
380
387void *
389{
391 struct Plugin *plugin = api->cls;
392
394 plugin->cfg = NULL;
397 "Postgres namecache plugin is finished\n");
398 return NULL;
399}
400
401
402/* end of plugin_namecache_postgres.c */
static struct GNUNET_CONFIGURATION_Handle * cfg
Our configuration.
Definition gnunet-arm.c:108
static struct GNUNET_TESTING_PluginFunctions * plugin
Plugin to dynamically load a test case.
static struct GNUNET_PEERSTORE_Handle * ps
Handle to the PEERSTORE service.
static char * res
Currently read line or NULL on EOF.
static unsigned int bsize
GNUNET_DB_QueryStatus
Status code returned from functions running database commands.
@ GNUNET_DB_STATUS_HARD_ERROR
A hard error occurred, retrying will not help.
@ GNUNET_DB_STATUS_SUCCESS_NO_RESULTS
The transaction succeeded, but yielded zero results.
API that can be used to manipulate GNS record data.
Plugin API for the namecache database backend.
helper functions for Postgres DB interactions
struct GNUNET_PQ_QueryParam GNUNET_PQ_query_param_fixed_size(const void *ptr, size_t ptr_size)
Generate query parameter for a buffer ptr of ptr_size bytes.
#define GNUNET_PQ_query_param_auto_from_type(x)
Generate fixed-size query parameter with size determined by variable type.
enum GNUNET_DB_QueryStatus GNUNET_PQ_eval_prepared_singleton_select(struct GNUNET_PQ_Context *db, const char *statement_name, const struct GNUNET_PQ_QueryParam *params, struct GNUNET_PQ_ResultSpec *rs)
Execute a named prepared statement that is a SELECT statement which must return a single result in co...
Definition pq_eval.c:199
struct GNUNET_PQ_QueryParam GNUNET_PQ_query_param_absolute_time(const struct GNUNET_TIME_Absolute *x)
Generate query parameter for an absolute time value.
enum GNUNET_GenericReturnValue GNUNET_PQ_prepare_statements(struct GNUNET_PQ_Context *db, const struct GNUNET_PQ_PreparedStatement *ps)
Request creation of prepared statements ps from Postgres.
Definition pq_prepare.c:77
void GNUNET_PQ_disconnect(struct GNUNET_PQ_Context *db)
Disconnect from the database, destroying the prepared statements and releasing other associated resou...
Definition pq_connect.c:788
struct GNUNET_PQ_PreparedStatement GNUNET_PQ_make_prepare(const char *name, const char *sql)
Create a struct GNUNET_PQ_PreparedStatement.
Definition pq_prepare.c:30
#define GNUNET_PQ_query_param_end
End of query parameter specification.
struct GNUNET_PQ_Context * GNUNET_PQ_init(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, GNUNET_PQ_ReconnectCallback rc, void *rc_cls)
Connect to a postgres database using the configuration option "CONFIG" in section.
struct GNUNET_PQ_ResultSpec GNUNET_PQ_result_spec_variable_size(const char *name, void **dst, size_t *sptr)
Variable-size result expected.
void GNUNET_PQ_cleanup_result(struct GNUNET_PQ_ResultSpec *rs)
Free all memory that was allocated in rs during GNUNET_PQ_extract_result().
Definition pq.c:142
#define GNUNET_PQ_PREPARED_STATEMENT_END
Terminator for prepared statement list.
enum GNUNET_DB_QueryStatus GNUNET_PQ_eval_prepared_non_select(struct GNUNET_PQ_Context *db, const char *statement_name, const struct GNUNET_PQ_QueryParam *params)
Execute a named prepared statement that is NOT a SELECT statement in connection using the given param...
Definition pq_eval.c:135
enum GNUNET_GenericReturnValue GNUNET_PQ_load_versioning(struct GNUNET_PQ_Context *db)
Setup database versioning.
Definition pq_connect.c:712
#define GNUNET_PQ_result_spec_end
End of result parameter specification.
enum GNUNET_GenericReturnValue GNUNET_PQ_run_sql(struct GNUNET_PQ_Context *db, const char *load_suffix)
Within the db context, run all the SQL files in the load path where the name starts with the load_suf...
Definition pq_connect.c:486
size_t GNUNET_GNSRECORD_block_get_size(const struct GNUNET_GNSRECORD_Block *block)
Returns the length of this block in bytes.
enum GNUNET_GenericReturnValue GNUNET_GNSRECORD_query_from_block(const struct GNUNET_GNSRECORD_Block *block, struct GNUNET_HashCode *query)
Builds the query hash from a block.
struct GNUNET_TIME_Absolute GNUNET_GNSRECORD_block_get_expiration(const struct GNUNET_GNSRECORD_Block *block)
Returns the expiration of a block.
GNUNET_GenericReturnValue
Named constants for return values.
@ GNUNET_OK
@ GNUNET_NO
@ GNUNET_SYSERR
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
@ GNUNET_ERROR_TYPE_WARNING
@ GNUNET_ERROR_TYPE_DEBUG
@ GNUNET_ERROR_TYPE_INFO
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
void(* GNUNET_NAMECACHE_BlockCallback)(void *cls, const struct GNUNET_GNSRECORD_Block *block)
Function called for matching blocks.
struct GNUNET_TIME_Absolute GNUNET_TIME_absolute_get(void)
Get the current time.
Definition time.c:111
static enum GNUNET_GenericReturnValue database_setup(struct Plugin *plugin)
Initialize the database connections and associated data structures (create tables and indices as need...
void * libgnunet_plugin_namecache_postgres_init(void *cls)
Entry point for the plugin.
static enum GNUNET_GenericReturnValue namecache_postgres_cache_block(void *cls, const struct GNUNET_GNSRECORD_Block *block)
Cache a block in the datastore.
static enum GNUNET_GenericReturnValue namecache_postgres_del_block(void *cls, const struct GNUNET_HashCode *query)
Remove the block for a particular zone and label from the datastore.
static void database_shutdown(struct Plugin *plugin)
Shutdown database connection and associate data structures.
static void delete_old_block(struct Plugin *plugin, const struct GNUNET_HashCode *query, struct GNUNET_TIME_Absolute expiration_time)
Delete older block in the datastore.
static void namecache_postgres_expire_blocks(struct Plugin *plugin)
Removes any expired block.
#define LOG(kind,...)
static void reconnect_setup(void *cls, struct GNUNET_PQ_Context *pq)
Function called whenever we reconnect to the DB.
void * libgnunet_plugin_namecache_postgres_done(void *cls)
Exit point from the plugin.
static enum GNUNET_GenericReturnValue namecache_postgres_lookup_block(void *cls, const struct GNUNET_HashCode *query, GNUNET_NAMECACHE_BlockCallback iter, void *iter_cls)
Get the block for a particular zone and label in the datastore.
void * cls
Closure for all of the callbacks.
A 512-bit hashcode.
struct returned by the initialization function of the plugin
int(* lookup_block)(void *cls, const struct GNUNET_HashCode *query, GNUNET_NAMECACHE_BlockCallback iter, void *iter_cls)
Get the block for a particular zone and label in the datastore.
int(* del_block)(void *cls, const struct GNUNET_HashCode *query)
Remove the block for a particular zone and label from the datastore.
int(* cache_block)(void *cls, const struct GNUNET_GNSRECORD_Block *block)
Cache a block in the datastore.
void * cls
Closure to pass to all plugin functions.
Handle to Postgres database.
Definition pq.h:36
Information needed to prepare a list of SQL statements using GNUNET_PQ_prepare_statements().
Description of a DB query parameter.
Description of a DB result cell.
void * cls
Closure for conv and cleaner.
Time for absolute times used by GNUnet, in microseconds.
Handle for a plugin.
Definition block.c:38
struct GNUNET_BLOCK_PluginFunctions * api
Plugin API.
Definition block.c:47
bool ready
Set to true if the DB is ready for action.
struct GNUNET_PQ_Context * dbh
Native Postgres database handle.
const struct GNUNET_CONFIGURATION_Handle * cfg
Our configuration.