datastore.c File Reference

Asterisk datastore objects. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include "asterisk/datastore.h"
#include "asterisk/utils.h"

Include dependency graph for datastore.c:

Go to the source code of this file.

Functions
struct ast_datastore *	__ast_datastore_alloc (const struct ast_datastore_info *info, const char *uid, const char *file, int line, const char *function)
	Create a data store object.
struct ast_datastore *	ast_datastore_alloc (const struct ast_datastore_info *info, const char *uid)
int	ast_datastore_free (struct ast_datastore *datastore)
	Free a data store object.

---

Detailed Description

Asterisk datastore objects.

Definition in file datastore.c.

---

Function Documentation

struct ast_datastore* __ast_datastore_alloc	(	const struct ast_datastore_info *	info,
		const char *	uid,
		const char *	file,
		int	line,
		const char *	function
	)		[read]

Create a data store object.

Parameters:

[in]	info	information describing the data store object
[in]	uid	unique identifer

Version:

1.6.1 moved here and renamed from ast_channel_datastore_alloc

Definition at line 35 of file datastore.c.

References __ast_calloc(), ast_calloc, ast_free, ast_strdup, ast_strlen_zero(), ast_datastore::info, and ast_datastore::uid.

Referenced by ast_datastore_alloc().

{
   struct ast_datastore *datastore = NULL;

   /* Make sure we at least have type so we can identify this */
   if (!info) {
      return NULL;
   }

#if defined(__AST_DEBUG_MALLOC)
   if (!(datastore = __ast_calloc(1, sizeof(*datastore), file, line, function))) {
      return NULL;
   }
#else
   if (!(datastore = ast_calloc(1, sizeof(*datastore)))) {
      return NULL;
   }
#endif

   datastore->info = info;

   if (!ast_strlen_zero(uid) && !(datastore->uid = ast_strdup(uid))) {
      ast_free(datastore);
      datastore = NULL;
   }

   return datastore;
}

struct ast_datastore * ast_datastore_alloc	(	const struct ast_datastore_info *	info,
		const char *	uid
	)		[read]

Definition at line 98 of file datastore.c.

References __ast_datastore_alloc().

Referenced by _macro_exec(), acf_curlopt_write(), acf_iaxvar_write(), acf_odbc_read(), add_features_datastore(), add_to_agi(), apply_plc(), ast_cel_fabricate_channel_from_event(), ast_channel_cc_params_init(), ast_channel_datastore_alloc(), ast_channel_datastore_inherit(), ast_channel_transfer_masquerade(), ast_do_pickup(), ast_iax2_new(), ast_setup_cc_recall_datastore(), audiohook_volume_get(), authenticate_reply(), calendar_query_exec(), cc_interfaces_datastore_init(), create_msg_q_chan(), dial_exec_full(), do_notify(), dundi_query_read(), enable_jack_hook(), enum_query_read(), find_or_create_details(), find_transaction(), frame_trace_helper(), func_channel_write_real(), get_feature_ds(), get_lock(), gosub_exec(), initialize_mutehook(), jb_helper(), lua_get_state(), msg_datastore_find_or_create(), pitchshift_helper(), raise_exception(), set_chan_app_data(), setup_inheritance_datastore(), setup_mixmonitor_ds(), setup_transfer_datastore(), shared_write(), smdi_msg_retrieve_read(), socket_process_helper(), speech_create(), speex_write(), srv_datastore_setup(), try_calling(), and volume_write().

{
   return __ast_datastore_alloc(info, uid, __FILE__, __LINE__, __FUNCTION__);
}

int ast_datastore_free

(

struct ast_datastore *

datastore

)

Free a data store object.

Parameters:

[in]

datastore

datastore to free

Version:

1.6.1 moved here and renamed from ast_channel_datastore_free

Definition at line 65 of file datastore.c.

References ast_free, ast_datastore::data, ast_datastore_info::destroy, ast_datastore::info, and ast_datastore::uid.

Referenced by acf_curlopt_write(), acf_fetch(), acf_iaxvar_write(), acf_odbc_read(), add_features_datastore(), add_to_agi(), adjust_frame_for_plc(), apply_plc(), ast_cel_fabricate_channel_from_event(), ast_channel_datastore_free(), ast_channel_destructor(), ast_channel_transfer_masquerade(), ast_do_masquerade(), ast_do_pickup(), ast_dummy_channel_destructor(), ast_iax2_new(), ast_setup_cc_recall_datastore(), audiohook_volume_get(), authenticate_reply(), cc_interfaces_datastore_init(), chan_cleanup(), clear_dialed_interfaces(), dial_exec_full(), disable_jack_hook(), enable_jack_hook(), exec_odbcfinish(), find_transaction(), frame_trace_helper(), func_mute_write(), get_lock(), gosub_exec(), initialize_mutehook(), jb_helper(), lua_get_state(), manager_mutestream(), msg_datastore_find_or_create(), pitchshift_helper(), raise_exception(), session_destructor(), set_chan_app_data(), setup_inheritance_datastore(), shared_write(), socket_process_helper(), speex_write(), srv_query_read(), stop_mixmonitor_full(), try_calling(), and volume_write().

{
   int res = 0;

   /* Using the destroy function (if present) destroy the data */
   if (datastore->info->destroy != NULL && datastore->data != NULL) {
      datastore->info->destroy(datastore->data);
      datastore->data = NULL;
   }

   /* Free allocated UID memory */
   if (datastore->uid != NULL) {
      ast_free((void *) datastore->uid);
      datastore->uid = NULL;
   }

   /* Finally free memory used by ourselves */
   ast_free(datastore);

   return res;
}