ASTdb Management. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include "asterisk/paths.h"
#include <sys/time.h>
#include <signal.h>
#include <dirent.h>
#include "asterisk/channel.h"
#include "asterisk/file.h"
#include "asterisk/app.h"
#include "asterisk/dsp.h"
#include "asterisk/astdb.h"
#include "asterisk/cli.h"
#include "asterisk/utils.h"
#include "asterisk/lock.h"
#include "asterisk/manager.h"
#include "db1-ast/include/db.h"

Include dependency graph for db.c:

Go to the source code of this file.

Defines
#define	MAX_DB_FIELD 256
Typedefs
typedef int(*	process_keys_cb )(DBT key, DBT value, const char filter, void data)
Functions
int	ast_db_del (const char family, const char keys)
	Delete entry in astdb.
int	ast_db_deltree (const char family, const char keytree)
	Delete one or more entries in astdb If both parameters are NULL, the entire database will be purged. If only keytree is NULL, all entries within the family will be purged. It is an error for keytree to have a value when family is NULL.
void	ast_db_freetree (struct ast_db_entry *dbe)
	Free structure created by ast_db_gettree()
int	ast_db_get (const char family, const char keys, char *value, int valuelen)
	Get key value specified by family/key.
struct ast_db_entry *	ast_db_gettree (const char family, const char keytree)
	Get a list of values within the astdb tree If family is specified, only those keys will be returned. If keytree is specified, subkeys are expected to exist (separated from the key with a slash). If subkeys do not exist and keytree is specified, the tree will consist of either a single entry or NULL will be returned.
int	ast_db_put (const char family, const char keys, const char *value)
	Store value addressed by family/key.
int	astdb_init (void)
static int	db_deltree_cb (DBT key, DBT value, const char filter, void data)
static int	db_gettree_cb (DBT key, DBT value, const char filter, void data)
static int	db_show_cb (DBT key, DBT value, const char filter, void data)
static int	db_showkey_cb (DBT key, DBT value, const char filter, void data)
static void	db_sync (void)
static void *	db_sync_thread (void *data)
static int	dbinit (void)
static const char *	dbt_data2str (DBT *dbt)
static const char *	dbt_data2str_full (DBT dbt, const char def)
static char *	handle_cli_database_del (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static char *	handle_cli_database_deltree (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static char *	handle_cli_database_get (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static char *	handle_cli_database_put (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static char *	handle_cli_database_show (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static char *	handle_cli_database_showkey (struct ast_cli_entry e, int cmd, struct ast_cli_args a)
static int	keymatch (const char key, const char prefix)
static int	manager_dbdel (struct mansession s, const struct message m)
static int	manager_dbdeltree (struct mansession s, const struct message m)
static int	manager_dbget (struct mansession s, const struct message m)
static int	manager_dbput (struct mansession s, const struct message m)
static int	process_db_keys (process_keys_cb cb, void data, const char filter, int sync)
static int	subkeymatch (const char key, const char suffix)
Variables
static DB *	astdb
static struct ast_cli_entry	cli_database []
static ast_cond_t	dbcond
static ast_mutex_t	dblock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, 1 }

Detailed Description

ASTdb Management.

Author:: Mark Spencer <markster@digium.com>

Note:: DB3 is licensed under Sleepycat Public License and is thus incompatible with GPL. To avoid having to make another exception (and complicate licensing even further) we elect to use DB1 which is BSD licensed

Definition in file db.c.

Define Documentation

#define MAX_DB_FIELD 256

Definition at line 103 of file db.c.

Referenced by process_db_keys(), ast_db_deltree(), ast_db_put(), ast_db_get(), ast_db_del(), handle_cli_database_get(), handle_cli_database_show(), handle_cli_database_showkey(), ast_db_gettree(), and manager_dbget().

Typedef Documentation

typedef int(* process_keys_cb)(DBT *key, DBT *value, const char *filter, void *data)

Definition at line 108 of file db.c.

Function Documentation

int ast_db_del	(	const char *	family,
		const char *	keys
	)

Delete entry in astdb.

Definition at line 314 of file db.c.

References MAX_DB_FIELD, ast_mutex_lock, dblock, dbinit(), ast_mutex_unlock, db_sync(), and ast_debug.

Referenced by auth_exec(), del_exec(), dump_queue_members(), reload_queue_members(), destroy_all_channels(), mkintf(), __expire_registry(), update_registry(), destroy_association(), handle_cli_database_del(), manager_dbdel(), function_db_delete(), dialgroup_refreshdb(), cache_lookup_internal(), process_clearcache(), ast_privacy_set(), handle_dbdel(), and pri_dchannel().

{
   char fullkey[MAX_DB_FIELD];
   DBT key;
   int res, fullkeylen;

   ast_mutex_lock(&dblock);
   if (dbinit()) {
      ast_mutex_unlock(&dblock);
      return -1;
   }
   
   fullkeylen = snprintf(fullkey, sizeof(fullkey), "/%s/%s", family, keys);
   memset(&key, 0, sizeof(key));
   key.data = fullkey;
   key.size = fullkeylen + 1;
   
   res = astdb->del(astdb, &key, 0);
   db_sync();
   
   ast_mutex_unlock(&dblock);

   if (res) {
      ast_debug(1, "Unable to find key '%s' in family '%s'\n", keys, family);
   }
   return res;
}

int ast_db_deltree	(	const char *	family,
		const char *	keytree
	)

Delete one or more entries in astdb If both parameters are NULL, the entire database will be purged. If only keytree is NULL, all entries within the family will be purged. It is an error for keytree to have a value when family is NULL.

Return values:

-1	An error occurred
>=	0 Number of records deleted

Definition at line 223 of file db.c.

References prefix, MAX_DB_FIELD, process_db_keys(), and db_deltree_cb().

Referenced by deltree_exec(), handle_cli_database_deltree(), manager_dbdeltree(), iax_provision_reload(), dundi_flush(), ast_privacy_reset(), and handle_dbdeltree().

{
   char prefix[MAX_DB_FIELD];

   if (family) {
      if (keytree) {
         snprintf(prefix, sizeof(prefix), "/%s/%s", family, keytree);
      } else {
         snprintf(prefix, sizeof(prefix), "/%s", family);
      }
   } else if (keytree) {
      return -1;
   } else {
      prefix[0] = '\0';
   }

   return process_db_keys(db_deltree_cb, NULL, prefix, 1);
}

void ast_db_freetree ( struct ast_db_entry * dbe )

Free structure created by ast_db_gettree()

Definition at line 599 of file db.c.

References last, ast_db_entry::next, and ast_free.

Referenced by reload_queue_members(), handle_cli_devstate_list(), load_module(), and process_clearcache().

{
   struct ast_db_entry *last;
   while (dbe) {
      last = dbe;
      dbe = dbe->next;
      ast_free(last);
   }
}

int ast_db_get	(	const char *	family,
		const char *	keys,
		char *	value,
		int	valuelen
	)

Get key value specified by family/key.

Definition at line 270 of file db.c.

References MAX_DB_FIELD, ast_mutex_lock, dblock, dbinit(), ast_mutex_unlock, ast_debug, ast_copy_string(), ast_log(), and LOG_NOTICE.

Referenced by database_increment(), auth_exec(), reload_queue_members(), destroy_all_channels(), mkintf(), create_addr(), check_access(), reg_source_db(), handle_cli_database_get(), manager_dbget(), blacklist_read(), function_db_read(), function_db_exists(), function_db_delete(), custom_devstate_callback(), iax_provision_version(), cache_lookup_internal(), load_password(), populate_addr(), ast_privacy_check(), and handle_dbget().

{
   char fullkey[MAX_DB_FIELD] = "";
   DBT key, data;
   int res, fullkeylen;

   ast_mutex_lock(&dblock);
   if (dbinit()) {
      ast_mutex_unlock(&dblock);
      return -1;
   }

   fullkeylen = snprintf(fullkey, sizeof(fullkey), "/%s/%s", family, keys);
   memset(&key, 0, sizeof(key));
   memset(&data, 0, sizeof(data));
   memset(value, 0, valuelen);
   key.data = fullkey;
   key.size = fullkeylen + 1;

   res = astdb->get(astdb, &key, &data, 0);

   /* Be sure to NULL terminate our data either way */
   if (res) {
      ast_debug(1, "Unable to find key '%s' in family '%s'\n", keys, family);
   } else {
#if 0
      printf("Got value of size %d\n", data.size);
#endif
      if (data.size) {
         ((char *)data.data)[data.size - 1] = '\0';
         /* Make sure that we don't write too much to the dst pointer or we don't read too much from the source pointer */
         ast_copy_string(value, data.data, (valuelen > data.size) ? data.size : valuelen);
      } else {
         ast_log(LOG_NOTICE, "Strange, empty value for /%s/%s\n", family, keys);
      }
   }

   /* Data is not fully isolated for concurrency, so the lock must be extended
    * to after the copy to the output buffer. */
   ast_mutex_unlock(&dblock);

   return res;
}

struct ast_db_entry* ast_db_gettree	(	const char *	family,
		const char *	keytree
	)		`[read]`

Get a list of values within the astdb tree If family is specified, only those keys will be returned. If keytree is specified, subkeys are expected to exist (separated from the key with a slash). If subkeys do not exist and keytree is specified, the tree will consist of either a single entry or NULL will be returned.

Resulting tree should be freed by passing the return value to ast_db_freetree() when usage is concluded.

Definition at line 574 of file db.c.

References prefix, MAX_DB_FIELD, ast_strlen_zero(), process_db_keys(), db_gettree_cb(), ast_log(), and LOG_WARNING.

Referenced by reload_queue_members(), handle_cli_devstate_list(), load_module(), and process_clearcache().

{
   char prefix[MAX_DB_FIELD];
   struct ast_db_entry *ret = NULL;

   if (!ast_strlen_zero(family)) {
      if (!ast_strlen_zero(keytree)) {
         /* Family and key tree */
         snprintf(prefix, sizeof(prefix), "/%s/%s", family, keytree);
      } else {
         /* Family only */
         snprintf(prefix, sizeof(prefix), "/%s", family);
      }
   } else {
      prefix[0] = '\0';
   }

   if (process_db_keys(db_gettree_cb, &ret, prefix, 0) < 0) {
      ast_log(LOG_WARNING, "Database unavailable\n");
      return NULL;
   }

   return ret;
}

int ast_db_put	(	const char *	family,
		const char *	keys,
		const char *	value
	)

Store value addressed by family/key.

Definition at line 242 of file db.c.

References MAX_DB_FIELD, ast_mutex_lock, dblock, dbinit(), ast_mutex_unlock, db_sync(), ast_log(), and LOG_WARNING.

Referenced by database_increment(), dump_queue_members(), update_registry(), mgcp_ss(), parse_register_contact(), handle_cli_database_put(), manager_dbput(), function_db_write(), devstate_write(), handle_cli_devstate_change(), dialgroup_refreshdb(), iax_provision_build(), cache_save_hint(), cache_save(), handle_command_response(), save_secret(), ast_privacy_set(), handle_dbput(), __analog_ss_thread(), and pri_dchannel().

{
   char fullkey[MAX_DB_FIELD];
   DBT key, data;
   int res, fullkeylen;

   ast_mutex_lock(&dblock);
   if (dbinit()) {
      ast_mutex_unlock(&dblock);
      return -1;
   }

   fullkeylen = snprintf(fullkey, sizeof(fullkey), "/%s/%s", family, keys);
   memset(&key, 0, sizeof(key));
   memset(&data, 0, sizeof(data));
   key.data = fullkey;
   key.size = fullkeylen + 1;
   data.data = (char *) value;
   data.size = strlen(value) + 1;
   res = astdb->put(astdb, &key, &data, 0);
   db_sync();
   ast_mutex_unlock(&dblock);
   if (res)
      ast_log(LOG_WARNING, "Unable to put value '%s' for key '%s' in family '%s'\n", value, keys, family);

   return res;
}

int astdb_init ( void )

Provided by db.c

Definition at line 768 of file db.c.

References ast_cond_init, ast_pthread_create_background, db_sync_thread(), dbinit(), ast_cli_register_multiple(), ARRAY_LEN, ast_manager_register_xml, EVENT_FLAG_SYSTEM, EVENT_FLAG_REPORTING, manager_dbget(), manager_dbput(), manager_dbdel(), and manager_dbdeltree().

Referenced by main().

{
   pthread_t dont_care;

   ast_cond_init(&dbcond, NULL);
   if (ast_pthread_create_background(&dont_care, NULL, db_sync_thread, NULL)) {
      return -1;
   }

   dbinit();
   ast_cli_register_multiple(cli_database, ARRAY_LEN(cli_database));
   ast_manager_register_xml("DBGet", EVENT_FLAG_SYSTEM | EVENT_FLAG_REPORTING, manager_dbget);
   ast_manager_register_xml("DBPut", EVENT_FLAG_SYSTEM, manager_dbput);
   ast_manager_register_xml("DBDel", EVENT_FLAG_SYSTEM, manager_dbdel);
   ast_manager_register_xml("DBDelTree", EVENT_FLAG_SYSTEM, manager_dbdeltree);
   return 0;
}

static int db_deltree_cb	(	DBT *	key,
		DBT *	value,
		const char *	filter,
		void *	data
	)		`[static]`

Definition at line 212 of file db.c.

References keymatch(), and dbt_data2str_full().

Referenced by ast_db_deltree().

{
   int res = 0;

   if (keymatch(dbt_data2str_full(key, "<bad key>"), filter)) {
      astdb->del(astdb, key, 0);
      res = 1;
   }
   return res;
}

static int db_gettree_cb	(	DBT *	key,
		DBT *	value,
		const char *	filter,
		void *	data
	)		`[static]`

Definition at line 554 of file db.c.

References ast_db_entry::data, dbt_data2str_full(), keymatch(), ast_malloc, ast_db_entry::next, and ast_db_entry::key.

Referenced by ast_db_gettree().

{
   struct ast_db_entry **ret = data;
   struct ast_db_entry *cur;
   const char *key_s = dbt_data2str_full(key, "<bad key>");
   const char *value_s = dbt_data2str_full(value, "<bad value>");
   size_t key_slen = strlen(key_s) + 1, value_slen = strlen(value_s) + 1;

   if (keymatch(key_s, filter) && (cur = ast_malloc(sizeof(*cur) + key_slen + value_slen))) {
      cur->next = *ret;
      cur->key = cur->data + value_slen;
      strcpy(cur->data, value_s);
      strcpy(cur->key, key_s);
      *ret = cur;
      return 1;
   }

   return 0;
}

static int db_show_cb	(	DBT *	key,
		DBT *	value,
		const char *	filter,
		void *	data
	)		`[static]`

Definition at line 455 of file db.c.

References dbt_data2str_full(), keymatch(), ast_cli(), and ast_cli_args::fd.

Referenced by handle_cli_database_show().

{
   struct ast_cli_args *a = data;
   const char *key_s = dbt_data2str_full(key, "<bad key>");
   const char *value_s = dbt_data2str_full(value, "<bad value>");

   if (keymatch(key_s, filter)) {
      ast_cli(a->fd, "%-50s: %-25s\n", key_s, value_s);
      return 1;
   }

   return 0;
}

static int db_showkey_cb	(	DBT *	key,
		DBT *	value,
		const char *	filter,
		void *	data
	)		`[static]`

Definition at line 508 of file db.c.

References dbt_data2str_full(), subkeymatch(), ast_cli(), and ast_cli_args::fd.

Referenced by handle_cli_database_showkey().

{
   struct ast_cli_args *a = data;
   const char *key_s = dbt_data2str_full(key, "<bad key>");
   const char *value_s = dbt_data2str_full(value, "<bad value>");

   if (subkeymatch(key_s, filter)) {
      ast_cli(a->fd, "%-50s: %-25s\n", key_s, value_s);
      return 1;
   }

   return 0;
}

static void db_sync ( void ) [static]

Definition at line 739 of file db.c.

References ast_cond_signal.

Referenced by process_db_keys(), ast_db_put(), and ast_db_del().

{
   ast_cond_signal(&dbcond);
}

static void* db_sync_thread ( void * data ) [static]

Definition at line 754 of file db.c.

References ast_mutex_lock, dblock, ast_cond_wait, and ast_mutex_unlock.

Referenced by astdb_init().

{
   ast_mutex_lock(&dblock);
   for (;;) {
      ast_cond_wait(&dbcond, &dblock);
      ast_mutex_unlock(&dblock);
      sleep(1);
      ast_mutex_lock(&dblock);
      astdb->sync(astdb, 0);
   }

   return NULL;
}

static int dbinit ( void ) [static]

Definition at line 112 of file db.c.

References ast_config_AST_DB, AST_FILE_MODE, ast_log(), LOG_WARNING, and errno.

Referenced by load_module(), process_db_keys(), ast_db_put(), ast_db_get(), ast_db_del(), and astdb_init().

{
   if (!astdb && !(astdb = dbopen(ast_config_AST_DB, O_CREAT | O_RDWR, AST_FILE_MODE, DB_BTREE, NULL))) {
      ast_log(LOG_WARNING, "Unable to open Asterisk database '%s': %s\n", ast_config_AST_DB, strerror(errno));
      return -1;
   }
   return 0;
}

static const char* dbt_data2str ( DBT * dbt ) [static]

Definition at line 149 of file db.c.

Referenced by dbt_data2str_full().

{
   char *data = "";

   if (dbt->size) {
      data = dbt->data;
      data[dbt->size - 1] = '\0';
   }

   return data;
}

static const char* dbt_data2str_full	(	DBT *	dbt,
		const char *	def
	)		`[inline, static]`

Definition at line 161 of file db.c.

References S_OR, and dbt_data2str().

Referenced by process_db_keys(), db_deltree_cb(), db_show_cb(), db_showkey_cb(), and db_gettree_cb().

{
   return S_OR(dbt_data2str(dbt), def);
}

static char* handle_cli_database_del	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 397 of file db.c.

References CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, CLI_SHOWUSAGE, ast_db_del(), ast_cli_args::argv, ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   int res;

   switch (cmd) {
   case CLI_INIT:
      e->command = "database del";
      e->usage =
         "Usage: database del <family> <key>\n"
         "       Deletes an entry in the Asterisk database for a given\n"
         "       family and key.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 4)
      return CLI_SHOWUSAGE;
   res = ast_db_del(a->argv[2], a->argv[3]);
   if (res) {
      ast_cli(a->fd, "Database entry does not exist.\n");
   } else {
      ast_cli(a->fd, "Database entry removed.\n");
   }
   return CLI_SUCCESS;
}

static char* handle_cli_database_deltree	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 424 of file db.c.

References CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, CLI_SHOWUSAGE, ast_db_deltree(), ast_cli_args::argv, ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   int res;

   switch (cmd) {
   case CLI_INIT:
      e->command = "database deltree";
      e->usage =
         "Usage: database deltree <family> [keytree]\n"
         "       Deletes a family or specific keytree within a family\n"
         "       in the Asterisk database.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if ((a->argc < 3) || (a->argc > 4))
      return CLI_SHOWUSAGE;
   if (a->argc == 4) {
      res = ast_db_deltree(a->argv[2], a->argv[3]);
   } else {
      res = ast_db_deltree(a->argv[2], NULL);
   }
   if (res < 0) {
      ast_cli(a->fd, "Database entries do not exist.\n");
   } else {
      ast_cli(a->fd, "%d database entries removed.\n",res);
   }
   return CLI_SUCCESS;
}

static char* handle_cli_database_get	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 369 of file db.c.

References MAX_DB_FIELD, CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, CLI_SHOWUSAGE, ast_db_get(), ast_cli_args::argv, ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   int res;
   char tmp[MAX_DB_FIELD];

   switch (cmd) {
   case CLI_INIT:
      e->command = "database get";
      e->usage =
         "Usage: database get <family> <key>\n"
         "       Retrieves an entry in the Asterisk database for a given\n"
         "       family and key.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 4)
      return CLI_SHOWUSAGE;
   res = ast_db_get(a->argv[2], a->argv[3], tmp, sizeof(tmp));
   if (res) {
      ast_cli(a->fd, "Database entry not found.\n");
   } else {
      ast_cli(a->fd, "Value: %s\n", tmp);
   }
   return CLI_SUCCESS;
}

static char* handle_cli_database_put	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 342 of file db.c.

References CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, CLI_SHOWUSAGE, ast_db_put(), ast_cli_args::argv, ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   int res;

   switch (cmd) {
   case CLI_INIT:
      e->command = "database put";
      e->usage =
         "Usage: database put <family> <key> <value>\n"
         "       Adds or updates an entry in the Asterisk database for\n"
         "       a given family, key, and value.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc != 5)
      return CLI_SHOWUSAGE;
   res = ast_db_put(a->argv[2], a->argv[3], a->argv[4]);
   if (res)  {
      ast_cli(a->fd, "Failed to update entry\n");
   } else {
      ast_cli(a->fd, "Updated database successfully\n");
   }
   return CLI_SUCCESS;
}

static char* handle_cli_database_show	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 469 of file db.c.

References prefix, MAX_DB_FIELD, CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, ast_cli_args::argv, CLI_SHOWUSAGE, process_db_keys(), db_show_cb(), ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   char prefix[MAX_DB_FIELD];
   int counter = 0;

   switch (cmd) {
   case CLI_INIT:
      e->command = "database show";
      e->usage =
         "Usage: database show [family [keytree]]\n"
         "       Shows Asterisk database contents, optionally restricted\n"
         "       to a given family, or family and keytree.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc == 4) {
      /* Family and key tree */
      snprintf(prefix, sizeof(prefix), "/%s/%s", a->argv[2], a->argv[3]);
   } else if (a->argc == 3) {
      /* Family only */
      snprintf(prefix, sizeof(prefix), "/%s", a->argv[2]);
   } else if (a->argc == 2) {
      /* Neither */
      prefix[0] = '\0';
   } else {
      return CLI_SHOWUSAGE;
   }

   if((counter = process_db_keys(db_show_cb, a, prefix, 0)) < 0) {
      ast_cli(a->fd, "Database unavailable\n");
      return CLI_SUCCESS;
   }

   ast_cli(a->fd, "%d results found.\n", counter);
   return CLI_SUCCESS;
}

static char* handle_cli_database_showkey	(	struct ast_cli_entry *	e,
		int	cmd,
		struct ast_cli_args *	a
	)		`[static]`

Definition at line 522 of file db.c.

References MAX_DB_FIELD, CLI_INIT, ast_cli_entry::command, ast_cli_entry::usage, CLI_GENERATE, ast_cli_args::argc, ast_cli_args::argv, CLI_SHOWUSAGE, process_db_keys(), db_showkey_cb(), ast_cli(), ast_cli_args::fd, and CLI_SUCCESS.

{
   char suffix[MAX_DB_FIELD];
   int counter = 0;

   switch (cmd) {
   case CLI_INIT:
      e->command = "database showkey";
      e->usage =
         "Usage: database showkey <keytree>\n"
         "       Shows Asterisk database contents, restricted to a given key.\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc == 3) {
      /* Key only */
      snprintf(suffix, sizeof(suffix), "/%s", a->argv[2]);
   } else {
      return CLI_SHOWUSAGE;
   }

   if ((counter = process_db_keys(db_showkey_cb, a, suffix, 0)) < 0) {
      ast_cli(a->fd, "Database unavailable\n");
      return CLI_SUCCESS;
   }

   ast_cli(a->fd, "%d results found.\n", counter);
   return CLI_SUCCESS;
}

static int keymatch	(	const char *	key,
		const char *	prefix
	)		`[inline, static]`

Definition at line 122 of file db.c.

Referenced by db_deltree_cb(), db_show_cb(), and db_gettree_cb().

{
   int preflen = strlen(prefix);
   if (!preflen)
      return 1;
   if (!strcasecmp(key, prefix))
      return 1;
   if ((strlen(key) > preflen) && !strncasecmp(key, prefix, preflen)) {
      if (key[preflen] == '/')
         return 1;
   }
   return 0;
}

static int manager_dbdel	(	struct mansession *	s,
		const struct message *	m
	)		`[static]`

Definition at line 684 of file db.c.

References astman_get_header(), ast_strlen_zero(), astman_send_error(), ast_db_del(), and astman_send_ack().

Referenced by astdb_init().

{
   const char *family = astman_get_header(m, "Family");
   const char *key = astman_get_header(m, "Key");
   int res;

   if (ast_strlen_zero(family)) {
      astman_send_error(s, m, "No family specified.");
      return 0;
   }

   if (ast_strlen_zero(key)) {
      astman_send_error(s, m, "No key specified.");
      return 0;
   }

   res = ast_db_del(family, key);
   if (res)
      astman_send_error(s, m, "Database entry not found");
   else
      astman_send_ack(s, m, "Key deleted successfully");

   return 0;
}

static int manager_dbdeltree	(	struct mansession *	s,
		const struct message *	m
	)		`[static]`

Definition at line 709 of file db.c.

References astman_get_header(), ast_strlen_zero(), astman_send_error(), ast_db_deltree(), and astman_send_ack().

Referenced by astdb_init().

{
   const char *family = astman_get_header(m, "Family");
   const char *key = astman_get_header(m, "Key");
   int res;

   if (ast_strlen_zero(family)) {
      astman_send_error(s, m, "No family specified.");
      return 0;
   }

   if (!ast_strlen_zero(key))
      res = ast_db_deltree(family, key);
   else
      res = ast_db_deltree(family, NULL);

   if (res < 0)
      astman_send_error(s, m, "Database entry not found");
   else
      astman_send_ack(s, m, "Key tree deleted successfully");
   
   return 0;
}

static int manager_dbget	(	struct mansession *	s,
		const struct message *	m
	)		`[static]`

Definition at line 643 of file db.c.

References astman_get_header(), MAX_DB_FIELD, ast_strlen_zero(), astman_send_error(), ast_db_get(), astman_send_ack(), and astman_append().

Referenced by astdb_init().

{
   const char *id = astman_get_header(m,"ActionID");
   char idText[256] = "";
   const char *family = astman_get_header(m, "Family");
   const char *key = astman_get_header(m, "Key");
   char tmp[MAX_DB_FIELD];
   int res;

   if (ast_strlen_zero(family)) {
      astman_send_error(s, m, "No family specified.");
      return 0;
   }
   if (ast_strlen_zero(key)) {
      astman_send_error(s, m, "No key specified.");
      return 0;
   }

   if (!ast_strlen_zero(id))
      snprintf(idText, sizeof(idText) ,"ActionID: %s\r\n", id);

   res = ast_db_get(family, key, tmp, sizeof(tmp));
   if (res) {
      astman_send_error(s, m, "Database entry not found");
   } else {
      astman_send_ack(s, m, "Result will follow");
      astman_append(s, "Event: DBGetResponse\r\n"
            "Family: %s\r\n"
            "Key: %s\r\n"
            "Val: %s\r\n"
            "%s"
            "\r\n",
            family, key, tmp, idText);
      astman_append(s, "Event: DBGetComplete\r\n"
            "%s"
            "\r\n",
            idText);
   }
   return 0;
}

static int manager_dbput	(	struct mansession *	s,
		const struct message *	m
	)		`[static]`

Definition at line 618 of file db.c.

References astman_get_header(), ast_strlen_zero(), astman_send_error(), ast_db_put(), S_OR, and astman_send_ack().

Referenced by astdb_init().

{
   const char *family = astman_get_header(m, "Family");
   const char *key = astman_get_header(m, "Key");
   const char *val = astman_get_header(m, "Val");
   int res;

   if (ast_strlen_zero(family)) {
      astman_send_error(s, m, "No family specified");
      return 0;
   }
   if (ast_strlen_zero(key)) {
      astman_send_error(s, m, "No key specified");
      return 0;
   }

   res = ast_db_put(family, key, S_OR(val, ""));
   if (res) {
      astman_send_error(s, m, "Failed to update entry");
   } else {
      astman_send_ack(s, m, "Updated database successfully");
   }
   return 0;
}

static int process_db_keys	(	process_keys_cb	cb,
		void *	data,
		const char *	filter,
		int	sync
	)		`[static]`

Definition at line 166 of file db.c.

References last, MAX_DB_FIELD, ast_mutex_lock, dblock, dbinit(), ast_mutex_unlock, MIN, dbt_data2str_full(), and db_sync().

Referenced by ast_db_deltree(), handle_cli_database_show(), handle_cli_database_showkey(), and ast_db_gettree().

{
   DBT key = { 0, }, value = { 0, }, last_key = { 0, };
   int counter = 0;
   int res, last = 0;
   char last_key_s[MAX_DB_FIELD];

   ast_mutex_lock(&dblock);
   if (dbinit()) {
      ast_mutex_unlock(&dblock);
      return -1;
   }

   /* Somehow, the database can become corrupted such that astdb->seq will continue looping through
    * the database indefinitely. The pointer to last_key.data ends up getting re-used by the BDB lib
    * so this specifically queries for the last entry, makes a copy of the key, and then uses it as
    * a sentinel to avoid repeatedly looping over the list. */

   if (astdb->seq(astdb, &last_key, &value, R_LAST)) {
      /* Empty database */
      ast_mutex_unlock(&dblock);
      return 0;
   }

   memcpy(last_key_s, last_key.data, MIN(last_key.size - 1, sizeof(last_key_s)));
   last_key_s[last_key.size - 1] = '\0';
   for (res = astdb->seq(astdb, &key, &value, R_FIRST);
         !res;
         res = astdb->seq(astdb, &key, &value, R_NEXT)) {
      /* The callback might delete the key, so we have to check it before calling */
      last = !strcmp(dbt_data2str_full(&key, "<bad key>"), last_key_s);
      counter += cb(&key, &value, filter, data);
      if (last) {
         break;
      }
   }

   if (sync) {
      db_sync();
   }

   ast_mutex_unlock(&dblock);

   return counter;
}

static int subkeymatch	(	const char *	key,
		const char *	suffix
	)		`[inline, static]`

Definition at line 136 of file db.c.

Referenced by db_showkey_cb().

{
   int suffixlen = strlen(suffix);
   if (suffixlen) {
      const char *subkey = key + strlen(key) - suffixlen;
      if (subkey < key)
         return 0;
      if (!strcasecmp(subkey, suffix))
         return 1;
   }
   return 0;
}