2 * This file is part of GNUnet
3 * Copyright (C) 2009, 2011 GNUnet e.V.
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., 51 Franklin Street, Fifth Floor,
18 * Boston, MA 02110-1301, USA.
22 * @file datastore/plugin_datastore_sqlite.c
23 * @brief sqlite-based datastore backend
24 * @author Christian Grothoff
28 #include "gnunet_datastore_plugin.h"
33 * We allocate items on the stack at times. To prevent a stack
34 * overflow, we impose a limit on the maximum size for the data per
35 * item. 64k should be enough.
37 #define MAX_ITEM_SIZE 65536
40 * After how many ms "busy" should a DB operation fail for good?
41 * A low value makes sure that we are more responsive to requests
42 * (especially PUTs). A high value guarantees a higher success
43 * rate (SELECTs in iterate can take several seconds despite LIMIT=1).
45 * The default value of 250ms should ensure that users do not experience
46 * huge latencies while at the same time allowing operations to succeed
47 * with reasonable probability.
49 #define BUSY_TIMEOUT_MS 250
53 * Log an error message at log-level 'level' that indicates
54 * a failure of the command 'cmd' on file 'filename'
55 * with the message given by strerror(errno).
57 #define LOG_SQLITE(db, level, cmd) do { GNUNET_log_from (level, "sqlite", _("`%s' failed at %s:%d with error: %s\n"), cmd, __FILE__, __LINE__, sqlite3_errmsg(db->dbh)); } while(0)
61 * Log an error message at log-level 'level' that indicates
62 * a failure of the command 'cmd' on file 'filename'
63 * with the message given by strerror(errno).
65 #define LOG_SQLITE_MSG(db, msg, level, cmd) do { GNUNET_log_from (level, "sqlite", _("`%s' failed at %s:%d with error: %s\n"), cmd, __FILE__, __LINE__, sqlite3_errmsg(db->dbh)); GNUNET_asprintf(msg, _("`%s' failed at %s:%u with error: %s"), cmd, __FILE__, __LINE__, sqlite3_errmsg(db->dbh)); } while(0)
70 * Context for all functions in this plugin.
75 * Our execution environment.
77 struct GNUNET_DATASTORE_PluginEnvironment *env;
85 * Native SQLite database handle.
90 * Precompiled SQL for deletion.
95 * Precompiled SQL for update.
97 sqlite3_stmt *updPrio;
100 * Get maximum repl value in database.
102 sqlite3_stmt *maxRepl;
105 * Precompiled SQL for replication decrement.
107 sqlite3_stmt *updRepl;
110 * Precompiled SQL for replication selection.
112 sqlite3_stmt *selRepl;
115 * Precompiled SQL for expiration selection.
117 sqlite3_stmt *selExpi;
120 * Precompiled SQL for expiration selection.
122 sqlite3_stmt *selZeroAnon;
125 * Precompiled SQL for insertion.
127 sqlite3_stmt *insertContent;
130 * Should the database be dropped on shutdown?
132 int drop_on_shutdown;
138 * @brief Prepare a SQL statement
140 * @param dbh handle to the database
141 * @param zSql SQL statement, UTF-8 encoded
142 * @param ppStmt set to the prepared statement
143 * @return 0 on success
146 sq_prepare (sqlite3 *dbh,
148 sqlite3_stmt **ppStmt)
154 sqlite3_prepare_v2 (dbh, zSql, strlen (zSql), ppStmt,
155 (const char **) &dummy);
156 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
157 "Prepared `%s' / %p: %d\n", zSql, *ppStmt, result);
163 * Create our database indices.
165 * @param dbh handle to the database
168 create_indices (sqlite3 * dbh)
172 sqlite3_exec (dbh, "CREATE INDEX IF NOT EXISTS idx_hash ON gn090 (hash)",
173 NULL, NULL, NULL)) ||
176 "CREATE INDEX IF NOT EXISTS idx_hash_vhash ON gn090 (hash,vhash)",
177 NULL, NULL, NULL)) ||
180 "CREATE INDEX IF NOT EXISTS idx_expire_repl ON gn090 (expire ASC,repl DESC)",
181 NULL, NULL, NULL)) ||
184 "CREATE INDEX IF NOT EXISTS idx_comb ON gn090 (anonLevel ASC,expire ASC,prio,type,hash)",
185 NULL, NULL, NULL)) ||
188 "CREATE INDEX IF NOT EXISTS idx_anon_type_hash ON gn090 (anonLevel ASC,type,hash)",
189 NULL, NULL, NULL)) ||
192 "CREATE INDEX IF NOT EXISTS idx_expire ON gn090 (expire ASC)",
193 NULL, NULL, NULL)) ||
196 "CREATE INDEX IF NOT EXISTS idx_repl_rvalue ON gn090 (repl,rvalue)",
197 NULL, NULL, NULL)) ||
200 "CREATE INDEX IF NOT EXISTS idx_repl ON gn090 (repl DESC)",
202 GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR, "sqlite",
203 "Failed to create indices: %s\n", sqlite3_errmsg (dbh));
208 #define CHECK(a) GNUNET_break(a)
212 #define ENULL_DEFINED 1
213 #define CHECK(a) if (! (a)) { GNUNET_log(GNUNET_ERROR_TYPE_ERROR, "%s\n", e); sqlite3_free(e); }
218 * Initialize the database connections and associated
219 * data structures (create tables and indices
220 * as needed as well).
222 * @param cfg our configuration
223 * @param plugin the plugin context (state for this module)
224 * @return #GNUNET_OK on success
227 database_setup (const struct GNUNET_CONFIGURATION_Handle *cfg,
228 struct Plugin *plugin)
237 GNUNET_CONFIGURATION_get_value_filename (cfg,
242 GNUNET_log_config_missing (GNUNET_ERROR_TYPE_ERROR,
245 return GNUNET_SYSERR;
247 if (GNUNET_OK != GNUNET_DISK_file_test (afsdir))
250 GNUNET_DISK_directory_create_for_file (afsdir))
253 GNUNET_free (afsdir);
254 return GNUNET_SYSERR;
256 /* database is new or got deleted, reset payload to zero! */
257 if (NULL != plugin->env->duc)
258 plugin->env->duc (plugin->env->cls,
261 /* afsdir should be UTF-8-encoded. If it isn't, it's a bug */
264 /* Open database and precompile statements */
266 sqlite3_open (plugin->fn, &plugin->dbh))
268 GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR, "sqlite",
269 _("Unable to initialize SQLite: %s.\n"),
270 sqlite3_errmsg (plugin->dbh));
271 return GNUNET_SYSERR;
274 sqlite3_exec (plugin->dbh,
275 "PRAGMA temp_store=MEMORY", NULL, NULL,
278 sqlite3_exec (plugin->dbh,
279 "PRAGMA synchronous=OFF", NULL, NULL,
282 sqlite3_exec (plugin->dbh,
283 "PRAGMA legacy_file_format=OFF", NULL, NULL,
286 sqlite3_exec (plugin->dbh,
287 "PRAGMA auto_vacuum=INCREMENTAL", NULL,
290 sqlite3_exec (plugin->dbh,
291 "PRAGMA locking_mode=EXCLUSIVE", NULL, NULL,
294 sqlite3_exec (plugin->dbh,
295 "PRAGMA page_size=4092", NULL, NULL,
299 sqlite3_busy_timeout (plugin->dbh, BUSY_TIMEOUT_MS));
302 /* We have to do it here, because otherwise precompiling SQL might fail */
304 sq_prepare (plugin->dbh,
305 "SELECT 1 FROM sqlite_master WHERE tbl_name = 'gn090'",
308 /* FIXME: SQLite does not have unsigned integers! This is ok for the type column because
309 * we only test equality on it and can cast it to/from uint32_t. For repl, prio, and anonLevel
310 * we do math or inequality tests, so we can't handle the entire range of uint32_t.
311 * This will also cause problems for expiration times after 294247-01-10-04:00:54 UTC.
313 if ((sqlite3_step (stmt) == SQLITE_DONE) &&
316 "CREATE TABLE gn090 (" " repl INT4 NOT NULL DEFAULT 0,"
317 " type INT4 NOT NULL DEFAULT 0," " prio INT4 NOT NULL DEFAULT 0,"
318 " anonLevel INT4 NOT NULL DEFAULT 0,"
319 " expire INT8 NOT NULL DEFAULT 0," " rvalue INT8 NOT NULL,"
320 " hash TEXT NOT NULL DEFAULT ''," " vhash TEXT NOT NULL DEFAULT '',"
321 " value BLOB NOT NULL DEFAULT '')", NULL, NULL, NULL) != SQLITE_OK))
323 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR, "sqlite3_exec");
324 sqlite3_finalize (stmt);
325 return GNUNET_SYSERR;
327 sqlite3_finalize (stmt);
328 create_indices (plugin->dbh);
333 "SET prio = prio + ?, expire = MAX(expire,?) WHERE _ROWID_ = ?",
334 &plugin->updPrio) != SQLITE_OK) ||
337 "UPDATE gn090 " "SET repl = MAX (0, repl - 1) WHERE _ROWID_ = ?",
338 &plugin->updRepl) != SQLITE_OK) ||
341 "SELECT type,prio,anonLevel,expire,hash,value,_ROWID_ " "FROM gn090 "
342 #if SQLITE_VERSION_NUMBER >= 3007000
343 "INDEXED BY idx_repl_rvalue "
345 "WHERE repl=?2 AND " " (rvalue>=?1 OR "
346 " NOT EXISTS (SELECT 1 FROM gn090 "
347 #if SQLITE_VERSION_NUMBER >= 3007000
348 "INDEXED BY idx_repl_rvalue "
350 "WHERE repl=?2 AND rvalue>=?1 LIMIT 1) ) "
351 "ORDER BY rvalue ASC LIMIT 1", &plugin->selRepl) != SQLITE_OK) ||
352 (sq_prepare (plugin->dbh, "SELECT MAX(repl) FROM gn090"
353 #if SQLITE_VERSION_NUMBER >= 3007000
354 " INDEXED BY idx_repl_rvalue"
356 "", &plugin->maxRepl) != SQLITE_OK) ||
359 "SELECT type,prio,anonLevel,expire,hash,value,_ROWID_ " "FROM gn090 "
360 #if SQLITE_VERSION_NUMBER >= 3007000
361 "INDEXED BY idx_expire "
363 "WHERE NOT EXISTS (SELECT 1 FROM gn090 WHERE expire < ?1 LIMIT 1) OR (expire < ?1) "
364 "ORDER BY expire ASC LIMIT 1", &plugin->selExpi) != SQLITE_OK) ||
367 "SELECT type,prio,anonLevel,expire,hash,value,_ROWID_ " "FROM gn090 "
368 #if SQLITE_VERSION_NUMBER >= 3007000
369 "INDEXED BY idx_anon_type_hash "
371 "WHERE (anonLevel = 0 AND type=?1) "
372 "ORDER BY hash DESC LIMIT 1 OFFSET ?2",
373 &plugin->selZeroAnon) != SQLITE_OK) ||
376 "INSERT INTO gn090 (repl, type, prio, anonLevel, expire, rvalue, hash, vhash, value) "
377 "VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)",
378 &plugin->insertContent) != SQLITE_OK) ||
380 (plugin->dbh, "DELETE FROM gn090 WHERE _ROWID_ = ?",
381 &plugin->delRow) != SQLITE_OK))
383 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR, "precompiling");
384 return GNUNET_SYSERR;
392 * Shutdown database connection and associate data
395 * @param plugin the plugin context (state for this module)
398 database_shutdown (struct Plugin *plugin)
402 #if SQLITE_VERSION_NUMBER >= 3007000
406 if (plugin->delRow != NULL)
407 sqlite3_finalize (plugin->delRow);
408 if (plugin->updPrio != NULL)
409 sqlite3_finalize (plugin->updPrio);
410 if (plugin->updRepl != NULL)
411 sqlite3_finalize (plugin->updRepl);
412 if (plugin->selRepl != NULL)
413 sqlite3_finalize (plugin->selRepl);
414 if (plugin->maxRepl != NULL)
415 sqlite3_finalize (plugin->maxRepl);
416 if (plugin->selExpi != NULL)
417 sqlite3_finalize (plugin->selExpi);
418 if (plugin->selZeroAnon != NULL)
419 sqlite3_finalize (plugin->selZeroAnon);
420 if (plugin->insertContent != NULL)
421 sqlite3_finalize (plugin->insertContent);
422 result = sqlite3_close (plugin->dbh);
423 #if SQLITE_VERSION_NUMBER >= 3007000
424 if (result == SQLITE_BUSY)
426 GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "sqlite",
428 ("Tried to close sqlite without finalizing all prepared statements.\n"));
429 stmt = sqlite3_next_stmt (plugin->dbh, NULL);
432 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
433 "Closing statement %p\n", stmt);
434 result = sqlite3_finalize (stmt);
435 if (result != SQLITE_OK)
436 GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "sqlite",
437 "Failed to close statement %p: %d\n", stmt, result);
438 stmt = sqlite3_next_stmt (plugin->dbh, NULL);
440 result = sqlite3_close (plugin->dbh);
443 if (SQLITE_OK != result)
444 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR, "sqlite3_close");
446 GNUNET_free_non_null (plugin->fn);
451 * Delete the database entry with the given
454 * @param plugin the plugin context (state for this module)
455 * @param rid the ID of the row to delete
458 delete_by_rowid (struct Plugin *plugin,
459 unsigned long long rid)
461 if (SQLITE_OK != sqlite3_bind_int64 (plugin->delRow, 1, rid))
463 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
464 "sqlite3_bind_XXXX");
465 if (SQLITE_OK != sqlite3_reset (plugin->delRow))
467 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
469 return GNUNET_SYSERR;
471 if (SQLITE_DONE != sqlite3_step (plugin->delRow))
473 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
475 if (SQLITE_OK != sqlite3_reset (plugin->delRow))
477 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
479 return GNUNET_SYSERR;
481 if (SQLITE_OK != sqlite3_reset (plugin->delRow))
482 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
489 * Store an item in the datastore.
492 * @param key key for the item
493 * @param size number of bytes in @a data
494 * @param data content stored
495 * @param type type of the content
496 * @param priority priority of the content
497 * @param anonymity anonymity-level for the content
498 * @param replication replication-level for the content
499 * @param expiration expiration time for the content
500 * @param cont continuation called with success or failure status
501 * @param cont_cls continuation closure
504 sqlite_plugin_put (void *cls,
505 const struct GNUNET_HashCode *key,
508 enum GNUNET_BLOCK_Type type,
511 uint32_t replication,
512 struct GNUNET_TIME_Absolute expiration,
516 struct Plugin *plugin = cls;
520 struct GNUNET_HashCode vhash;
524 if (size > MAX_ITEM_SIZE)
526 cont (cont_cls, key, size, GNUNET_SYSERR, _("Data too large"));
529 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
530 "Storing in database block with type %u/key `%s'/priority %u/expiration in %s (%s).\n",
534 GNUNET_STRINGS_relative_time_to_string (GNUNET_TIME_absolute_get_remaining (expiration),
536 GNUNET_STRINGS_absolute_time_to_string (expiration));
537 GNUNET_CRYPTO_hash (data, size, &vhash);
538 stmt = plugin->insertContent;
539 rvalue = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_WEAK, UINT64_MAX);
540 if ((SQLITE_OK != sqlite3_bind_int (stmt, 1, replication)) ||
541 (SQLITE_OK != sqlite3_bind_int (stmt, 2, type)) ||
542 (SQLITE_OK != sqlite3_bind_int (stmt, 3, priority)) ||
543 (SQLITE_OK != sqlite3_bind_int (stmt, 4, anonymity)) ||
544 (SQLITE_OK != sqlite3_bind_int64 (stmt, 5, expiration.abs_value_us)) ||
545 (SQLITE_OK != sqlite3_bind_int64 (stmt, 6, rvalue)) ||
547 sqlite3_bind_blob (stmt, 7, key, sizeof (struct GNUNET_HashCode),
548 SQLITE_TRANSIENT)) ||
550 sqlite3_bind_blob (stmt, 8, &vhash, sizeof (struct GNUNET_HashCode),
551 SQLITE_TRANSIENT)) ||
552 (SQLITE_OK != sqlite3_bind_blob (stmt, 9, data, size, SQLITE_TRANSIENT)))
554 LOG_SQLITE_MSG (plugin, &msg, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
555 "sqlite3_bind_XXXX");
556 if (SQLITE_OK != sqlite3_reset (stmt))
558 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
560 cont (cont_cls, key, size, GNUNET_SYSERR, msg);
561 GNUNET_free_non_null(msg);
564 n = sqlite3_step (stmt);
568 if (NULL != plugin->env->duc)
569 plugin->env->duc (plugin->env->cls,
570 size + GNUNET_DATASTORE_ENTRY_OVERHEAD);
571 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
572 "Stored new entry (%u bytes)\n",
573 size + GNUNET_DATASTORE_ENTRY_OVERHEAD);
578 LOG_SQLITE_MSG (plugin, &msg, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
583 LOG_SQLITE_MSG (plugin, &msg, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
585 if (SQLITE_OK != sqlite3_reset (stmt))
587 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
589 database_shutdown (plugin);
590 database_setup (plugin->env->cfg, plugin);
591 cont (cont_cls, key, size, GNUNET_SYSERR, msg);
592 GNUNET_free_non_null(msg);
595 if (SQLITE_OK != sqlite3_reset (stmt))
596 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
598 cont (cont_cls, key, size, ret, msg);
599 GNUNET_free_non_null(msg);
604 * Update the priority for a particular key in the datastore. If
605 * the expiration time in value is different than the time found in
606 * the datastore, the higher value should be kept. For the
607 * anonymity level, the lower value is to be used. The specified
608 * priority should be added to the existing priority, ignoring the
611 * Note that it is possible for multiple values to match this put.
612 * In that case, all of the respective values are updated.
614 * @param cls the plugin context (state for this module)
615 * @param uid unique identifier of the datum
616 * @param delta by how much should the priority
618 * @param expire new expiration time should be the
619 * MAX of any existing expiration time and
621 * @param cont continuation called with success or failure status
622 * @param cons_cls continuation closure
625 sqlite_plugin_update (void *cls,
628 struct GNUNET_TIME_Absolute expire,
629 PluginUpdateCont cont,
632 struct Plugin *plugin = cls;
636 if ((SQLITE_OK != sqlite3_bind_int (plugin->updPrio, 1, delta)) ||
637 (SQLITE_OK != sqlite3_bind_int64 (plugin->updPrio, 2, expire.abs_value_us))
638 || (SQLITE_OK != sqlite3_bind_int64 (plugin->updPrio, 3, uid)))
640 LOG_SQLITE_MSG (plugin, &msg, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
641 "sqlite3_bind_XXXX");
642 if (SQLITE_OK != sqlite3_reset (plugin->updPrio))
644 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
646 cont (cont_cls, GNUNET_SYSERR, msg);
647 GNUNET_free_non_null(msg);
650 n = sqlite3_step (plugin->updPrio);
651 if (SQLITE_OK != sqlite3_reset (plugin->updPrio))
652 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
657 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite", "Block updated\n");
658 cont (cont_cls, GNUNET_OK, NULL);
661 LOG_SQLITE_MSG (plugin, &msg,
662 GNUNET_ERROR_TYPE_WARNING | GNUNET_ERROR_TYPE_BULK,
664 cont (cont_cls, GNUNET_NO, msg);
665 GNUNET_free_non_null(msg);
668 LOG_SQLITE_MSG (plugin, &msg, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
670 cont (cont_cls, GNUNET_SYSERR, msg);
671 GNUNET_free_non_null(msg);
678 * Execute statement that gets a row and call the callback
679 * with the result. Resets the statement afterwards.
681 * @param plugin the plugin
682 * @param stmt the statement
683 * @param proc processor to call
684 * @param proc_cls closure for @a proc
687 execute_get (struct Plugin *plugin,
689 PluginDatumProcessor proc,
693 struct GNUNET_TIME_Absolute expiration;
694 unsigned long long rowid;
698 n = sqlite3_step (stmt);
702 size = sqlite3_column_bytes (stmt, 5);
703 rowid = sqlite3_column_int64 (stmt, 6);
704 if (sqlite3_column_bytes (stmt, 4) != sizeof (struct GNUNET_HashCode))
706 GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "sqlite",
707 _("Invalid data in database. Trying to fix (by deletion).\n"));
708 if (SQLITE_OK != sqlite3_reset (stmt))
710 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
712 if ( (GNUNET_OK == delete_by_rowid (plugin, rowid)) &&
713 (NULL != plugin->env->duc) )
714 plugin->env->duc (plugin->env->cls,
715 -(size + GNUNET_DATASTORE_ENTRY_OVERHEAD));
718 expiration.abs_value_us = sqlite3_column_int64 (stmt, 3);
719 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
720 "Found reply in database with expiration %s\n",
721 GNUNET_STRINGS_absolute_time_to_string (expiration));
722 ret = proc (proc_cls, sqlite3_column_blob (stmt, 4) /* key */ ,
723 size, sqlite3_column_blob (stmt, 5) /* data */ ,
724 sqlite3_column_int (stmt, 0) /* type */ ,
725 sqlite3_column_int (stmt, 1) /* priority */ ,
726 sqlite3_column_int (stmt, 2) /* anonymity */ ,
728 if (SQLITE_OK != sqlite3_reset (stmt))
730 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
732 if ( (GNUNET_NO == ret) &&
733 (GNUNET_OK == delete_by_rowid (plugin, rowid)) &&
734 (NULL != plugin->env->duc) )
735 plugin->env->duc (plugin->env->cls,
736 -(size + GNUNET_DATASTORE_ENTRY_OVERHEAD));
739 /* database must be empty */
740 if (SQLITE_OK != sqlite3_reset (stmt))
742 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
749 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
751 if (SQLITE_OK != sqlite3_reset (stmt))
753 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
756 database_shutdown (plugin);
757 database_setup (plugin->env->cfg, plugin);
760 if (SQLITE_OK != sqlite3_reset (stmt))
761 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
763 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
768 * Select a subset of the items in the datastore and call
769 * the given processor for the item.
771 * @param cls our plugin context
772 * @param offset offset of the result (modulo num-results);
773 * specific ordering does not matter for the offset
774 * @param type entries of which type should be considered?
775 * Use 0 for any type.
776 * @param proc function to call on each matching value;
777 * will be called once with a NULL value at the end
778 * @param proc_cls closure for @a proc
781 sqlite_plugin_get_zero_anonymity (void *cls, uint64_t offset,
782 enum GNUNET_BLOCK_Type type,
783 PluginDatumProcessor proc, void *proc_cls)
785 struct Plugin *plugin = cls;
788 GNUNET_assert (type != GNUNET_BLOCK_TYPE_ANY);
789 stmt = plugin->selZeroAnon;
790 if ((SQLITE_OK != sqlite3_bind_int (stmt, 1, type)) ||
791 (SQLITE_OK != sqlite3_bind_int64 (stmt, 2, offset)))
793 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
794 "sqlite3_bind_XXXX");
795 if (SQLITE_OK != sqlite3_reset (stmt))
797 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
799 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
802 execute_get (plugin, stmt, proc, proc_cls);
807 * Get results for a particular key in the datastore.
810 * @param offset offset (mod count).
811 * @param key key to match, never NULL
812 * @param vhash hash of the value, maybe NULL (to
813 * match all values that have the right key).
814 * Note that for DBlocks there is no difference
815 * betwen key and vhash, but for other blocks
817 * @param type entries of which type are relevant?
818 * Use 0 for any type.
819 * @param proc function to call on each matching value;
820 * will be called once with a NULL value at the end
821 * @param proc_cls closure for @a proc
824 sqlite_plugin_get_key (void *cls,
826 const struct GNUNET_HashCode *key,
827 const struct GNUNET_HashCode *vhash,
828 enum GNUNET_BLOCK_Type type,
829 PluginDatumProcessor proc,
832 struct Plugin *plugin = cls;
840 GNUNET_assert (proc != NULL);
841 GNUNET_assert (key != NULL);
842 GNUNET_snprintf (scratch, sizeof (scratch),
843 "SELECT count(*) FROM gn090 WHERE hash=?%s%s",
844 vhash == NULL ? "" : " AND vhash=?",
845 type == 0 ? "" : " AND type=?");
846 if (sq_prepare (plugin->dbh, scratch, &stmt) != SQLITE_OK)
848 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
850 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
855 sqlite3_bind_blob (stmt, sqoff++, key, sizeof (struct GNUNET_HashCode),
857 if ((vhash != NULL) && (ret == SQLITE_OK))
859 sqlite3_bind_blob (stmt, sqoff++, vhash, sizeof (struct GNUNET_HashCode),
861 if ((type != 0) && (ret == SQLITE_OK))
862 ret = sqlite3_bind_int (stmt, sqoff++, type);
863 if (SQLITE_OK != ret)
865 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR, "sqlite_bind");
866 sqlite3_finalize (stmt);
867 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
870 ret = sqlite3_step (stmt);
871 if (ret != SQLITE_ROW)
873 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
875 sqlite3_finalize (stmt);
876 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
879 total = sqlite3_column_int (stmt, 0);
880 sqlite3_finalize (stmt);
883 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
886 limit_off = (int) (offset % total);
889 GNUNET_snprintf (scratch, sizeof (scratch),
890 "SELECT type, prio, anonLevel, expire, hash, value, _ROWID_ "
891 "FROM gn090 WHERE hash=?%s%s "
892 "ORDER BY _ROWID_ ASC LIMIT 1 OFFSET ?",
893 vhash == NULL ? "" : " AND vhash=?",
894 type == 0 ? "" : " AND type=?");
895 if (sq_prepare (plugin->dbh, scratch, &stmt) != SQLITE_OK)
897 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
899 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
903 ret = sqlite3_bind_blob (stmt, sqoff++, key,
904 sizeof (struct GNUNET_HashCode),
906 if ((vhash != NULL) && (ret == SQLITE_OK))
907 ret = sqlite3_bind_blob (stmt, sqoff++, vhash,
908 sizeof (struct GNUNET_HashCode),
910 if ((type != 0) && (ret == SQLITE_OK))
911 ret = sqlite3_bind_int (stmt, sqoff++, type);
912 if (ret == SQLITE_OK)
913 ret = sqlite3_bind_int64 (stmt, sqoff++, limit_off);
914 if (ret != SQLITE_OK)
917 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
919 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
922 execute_get (plugin, stmt, proc, proc_cls);
923 sqlite3_finalize (stmt);
928 * Context for #repl_proc() function.
934 * Function to call for the result (or the NULL).
936 PluginDatumProcessor proc;
939 * Closure for @e proc.
949 * Yes if UID was set.
956 * Wrapper for the processor for #sqlite_plugin_get_replication().
957 * Decrements the replication counter and calls the original
961 * @param key key for the content
962 * @param size number of bytes in @a data
963 * @param data content stored
964 * @param type type of the content
965 * @param priority priority of the content
966 * @param anonymity anonymity-level for the content
967 * @param expiration expiration time for the content
968 * @param uid unique identifier for the datum;
969 * maybe 0 if no unique identifier is available
970 * @return #GNUNET_OK for normal return,
971 * #GNUNET_NO to delete the item
974 repl_proc (void *cls,
975 const struct GNUNET_HashCode *key,
978 enum GNUNET_BLOCK_Type type,
981 struct GNUNET_TIME_Absolute expiration,
984 struct ReplCtx *rc = cls;
987 ret = rc->proc (rc->proc_cls,
997 rc->have_uid = GNUNET_YES;
1004 * Get a random item for replication. Returns a single random item
1005 * from those with the highest replication counters. The item's
1006 * replication counter is decremented by one IF it was positive before.
1007 * Call @a proc with all values ZERO or NULL if the datastore is empty.
1009 * @param cls closure
1010 * @param proc function to call the value (once only).
1011 * @param proc_cls closure for @a proc
1014 sqlite_plugin_get_replication (void *cls, PluginDatumProcessor proc,
1017 struct Plugin *plugin = cls;
1023 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
1024 "Getting random block based on replication order.\n");
1025 rc.have_uid = GNUNET_NO;
1027 rc.proc_cls = proc_cls;
1028 stmt = plugin->maxRepl;
1029 if (SQLITE_ROW != sqlite3_step (stmt))
1031 if (SQLITE_OK != sqlite3_reset (stmt))
1033 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1036 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
1039 repl = sqlite3_column_int (stmt, 0);
1040 if (SQLITE_OK != sqlite3_reset (stmt))
1041 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1043 stmt = plugin->selRepl;
1044 rvalue = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_WEAK, UINT64_MAX);
1045 if (SQLITE_OK != sqlite3_bind_int64 (stmt, 1, rvalue))
1047 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1048 "sqlite3_bind_XXXX");
1049 if (SQLITE_OK != sqlite3_reset (stmt))
1051 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1053 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
1056 if (SQLITE_OK != sqlite3_bind_int (stmt, 2, repl))
1058 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1059 "sqlite3_bind_XXXX");
1060 if (SQLITE_OK != sqlite3_reset (stmt))
1062 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1064 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
1067 execute_get (plugin, stmt, &repl_proc, &rc);
1068 if (GNUNET_YES == rc.have_uid)
1070 if (SQLITE_OK != sqlite3_bind_int64 (plugin->updRepl, 1, rc.uid))
1073 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1074 "sqlite3_bind_XXXX");
1075 if (SQLITE_OK != sqlite3_reset (plugin->updRepl))
1077 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1081 if (SQLITE_DONE != sqlite3_step (plugin->updRepl))
1083 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1085 if (SQLITE_OK != sqlite3_reset (plugin->updRepl))
1087 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1094 * Get a random item that has expired or has low priority.
1095 * Call @a proc with all values ZERO or NULL if the datastore is empty.
1097 * @param cls closure
1098 * @param proc function to call the value (once only).
1099 * @param proc_cls closure for @a proc
1102 sqlite_plugin_get_expiration (void *cls, PluginDatumProcessor proc,
1105 struct Plugin *plugin = cls;
1107 struct GNUNET_TIME_Absolute now;
1109 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
1110 "Getting random block based on expiration and priority order.\n");
1111 now = GNUNET_TIME_absolute_get ();
1112 stmt = plugin->selExpi;
1113 if (SQLITE_OK != sqlite3_bind_int64 (stmt, 1, now.abs_value_us))
1115 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1116 "sqlite3_bind_XXXX");
1117 if (SQLITE_OK != sqlite3_reset (stmt))
1119 GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1121 proc (proc_cls, NULL, 0, NULL, 0, 0, 0, GNUNET_TIME_UNIT_ZERO_ABS, 0);
1124 execute_get (plugin, stmt, proc, proc_cls);
1129 * Get all of the keys in the datastore.
1131 * @param cls closure
1132 * @param proc function to call on each key
1133 * @param proc_cls closure for @a proc
1136 sqlite_plugin_get_keys (void *cls,
1137 PluginKeyProcessor proc,
1140 struct Plugin *plugin = cls;
1141 const struct GNUNET_HashCode *key;
1145 GNUNET_assert (proc != NULL);
1146 if (sq_prepare (plugin->dbh, "SELECT hash FROM gn090", &stmt) != SQLITE_OK)
1148 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR | GNUNET_ERROR_TYPE_BULK,
1150 proc (proc_cls, NULL, 0);
1153 while (SQLITE_ROW == (ret = sqlite3_step (stmt)))
1155 key = sqlite3_column_blob (stmt, 0);
1156 if (sizeof (struct GNUNET_HashCode) == sqlite3_column_bytes (stmt, 0))
1157 proc (proc_cls, key, 1);
1161 if (SQLITE_DONE != ret)
1162 LOG_SQLITE (plugin, GNUNET_ERROR_TYPE_ERROR, "sqlite_step");
1163 sqlite3_finalize (stmt);
1164 proc (proc_cls, NULL, 0);
1171 * @param cls our plugin context
1174 sqlite_plugin_drop (void *cls)
1176 struct Plugin *plugin = cls;
1178 plugin->drop_on_shutdown = GNUNET_YES;
1183 * Get an estimate of how much space the database is
1186 * @param cls the `struct Plugin`
1187 * @return the size of the database on disk (estimate)
1190 sqlite_plugin_estimate_size (void *cls, unsigned long long *estimate)
1192 struct Plugin *plugin = cls;
1201 if (NULL == estimate)
1203 if (SQLITE_VERSION_NUMBER < 3006000)
1205 GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "datastore-sqlite",
1207 ("sqlite version to old to determine size, assuming zero\n"));
1211 CHECK (SQLITE_OK == sqlite3_exec (plugin->dbh, "VACUUM", NULL, NULL, ENULL));
1213 sqlite3_exec (plugin->dbh, "PRAGMA auto_vacuum=INCREMENTAL", NULL,
1215 CHECK (SQLITE_OK == sq_prepare (plugin->dbh, "PRAGMA page_count", &stmt));
1216 if (SQLITE_ROW == sqlite3_step (stmt))
1217 pages = sqlite3_column_int64 (stmt, 0);
1220 sqlite3_finalize (stmt);
1221 CHECK (SQLITE_OK == sq_prepare (plugin->dbh, "PRAGMA page_size", &stmt));
1222 CHECK (SQLITE_ROW == sqlite3_step (stmt));
1223 page_size = sqlite3_column_int64 (stmt, 0);
1224 sqlite3_finalize (stmt);
1225 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1227 ("Using sqlite page utilization to estimate payload (%llu pages of size %llu bytes)\n"),
1228 (unsigned long long) pages, (unsigned long long) page_size);
1229 *estimate = pages * page_size;
1234 * Entry point for the plugin.
1236 * @param cls the `struct GNUNET_DATASTORE_PluginEnvironment *`
1237 * @return NULL on error, othrewise the plugin context
1240 libgnunet_plugin_datastore_sqlite_init (void *cls)
1242 static struct Plugin plugin;
1243 struct GNUNET_DATASTORE_PluginEnvironment *env = cls;
1244 struct GNUNET_DATASTORE_PluginFunctions *api;
1246 if (plugin.env != NULL)
1247 return NULL; /* can only initialize once! */
1248 memset (&plugin, 0, sizeof (struct Plugin));
1250 if (GNUNET_OK != database_setup (env->cfg, &plugin))
1252 database_shutdown (&plugin);
1255 api = GNUNET_new (struct GNUNET_DATASTORE_PluginFunctions);
1257 api->estimate_size = &sqlite_plugin_estimate_size;
1258 api->put = &sqlite_plugin_put;
1259 api->update = &sqlite_plugin_update;
1260 api->get_key = &sqlite_plugin_get_key;
1261 api->get_replication = &sqlite_plugin_get_replication;
1262 api->get_expiration = &sqlite_plugin_get_expiration;
1263 api->get_zero_anonymity = &sqlite_plugin_get_zero_anonymity;
1264 api->get_keys = &sqlite_plugin_get_keys;
1265 api->drop = &sqlite_plugin_drop;
1266 GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "sqlite",
1267 _("Sqlite database running\n"));
1273 * Exit point from the plugin.
1275 * @param cls the plugin context (as returned by "init")
1276 * @return always NULL
1279 libgnunet_plugin_datastore_sqlite_done (void *cls)
1282 struct GNUNET_DATASTORE_PluginFunctions *api = cls;
1283 struct Plugin *plugin = api->cls;
1285 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
1286 "sqlite plugin is done\n");
1288 if (plugin->drop_on_shutdown)
1289 fn = GNUNET_strdup (plugin->fn);
1290 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
1291 "Shutting down database\n");
1292 database_shutdown (plugin);
1297 if (0 != UNLINK (fn))
1298 GNUNET_log_strerror_file (GNUNET_ERROR_TYPE_WARNING, "unlink", fn);
1301 GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "sqlite",
1302 "sqlite plugin is finished\n");
1306 /* end of plugin_datastore_sqlite.c */