cdr.c File Reference

Call Detail Record API. More...

#include "asterisk.h"
#include <signal.h>
#include <inttypes.h>
#include "asterisk/lock.h"
#include "asterisk/channel.h"
#include "asterisk/cdr.h"
#include "asterisk/callerid.h"
#include "asterisk/manager.h"
#include "asterisk/module.h"
#include "asterisk/causes.h"
#include "asterisk/linkedlists.h"
#include "asterisk/utils.h"
#include "asterisk/sched.h"
#include "asterisk/config.h"
#include "asterisk/cli.h"
#include "asterisk/stringfields.h"
#include "asterisk/config_options.h"
#include "asterisk/json.h"
#include "asterisk/parking.h"
#include "asterisk/stasis.h"
#include "asterisk/stasis_channels.h"
#include "asterisk/stasis_bridges.h"
#include "asterisk/stasis_message_router.h"
#include "asterisk/astobj2.h"
#include "asterisk/taskprocessor.h"

Include dependency graph for cdr.c:

Go to the source code of this file.

Data Structures
struct	be_list
	List of registered backends. More...
struct	bridge_leave_data
struct	cdr_batch
	The actual batch queue. More...
struct	cdr_batch_item
	Queued CDR waiting to be batched. More...
struct	cdr_beitem
	Registration object for CDR backends. More...
struct	cdr_object
	An in-memory representation of an active CDR. More...
struct	cdr_object_fn_table
	A virtual table used for cdr_object. More...
struct	cdr_object_snapshot
	A wrapper object around a snapshot. Fields that are mutable by the CDR engine are replicated here. More...
struct	mo_list
	List of registered modifiers. More...
struct	module_config
	The configuration settings for this module. More...
struct	party_b_userfield_update

Macros
#define	CDR_DEBUG(fmt, ...)
#define	cdr_set_debug_mode(mod_cfg)
#define	DEFAULT_BATCH_SAFE_SHUTDOWN   "1"
#define	DEFAULT_BATCH_SCHEDULER_ONLY   "0"
#define	DEFAULT_BATCH_SIZE   "100"
#define	DEFAULT_BATCH_TIME   "300"
#define	DEFAULT_BATCHMODE   "0"
#define	DEFAULT_CONGESTION   "0"
#define	DEFAULT_ENABLED   "1"
#define	DEFAULT_END_BEFORE_H_EXTEN   "1"
#define	DEFAULT_INITIATED_SECONDS   "0"
#define	DEFAULT_UNANSWERED   "0"
#define	FORMAT_STRING   "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8ld %-8.8ld\n"
#define	FORMAT_STRING   "%-10.10s %-20.20s %-25.25s %-15.15s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8ld %-8.8ld\n"
#define	MAX_BATCH_SIZE   1000
#define	MAX_BATCH_TIME   86400
#define	TITLE_STRING   "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\n"
#define	TITLE_STRING   "%-10.10s %-20.20s %-25.25s %-15.15s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\n"

Enumerations
enum	process_bridge_enter_results { BRIDGE_ENTER_ONLY_PARTY, BRIDGE_ENTER_OBTAINED_PARTY_B, BRIDGE_ENTER_NO_PARTY_B, BRIDGE_ENTER_NEED_CDR }
	Return types for process_bridge_enter functions. More...

Functions
static void	__reg_module (void)
static void	__unreg_module (void)
static	AO2_GLOBAL_OBJ_STATIC (module_configs)
	The container for the module configuration. More...
struct ast_cdr *	ast_cdr_alloc (void)
	Allocate a CDR record. More...
int	ast_cdr_backend_suspend (const char *name)
	Suspend a CDR backend temporarily. More...
int	ast_cdr_backend_unsuspend (const char *name)
	Unsuspend a CDR backend. More...
int	ast_cdr_clear_property (const char *channel_name, enum ast_cdr_options option)
	Clear a property on a CDR for a channel. More...
const char *	ast_cdr_disp2str (int disposition)
	Disposition to a string. More...
struct ast_cdr *	ast_cdr_dup (struct ast_cdr *cdr)
	Duplicate a public CDR. More...
void	ast_cdr_engine_term (void)
int	ast_cdr_fork (const char *channel_name, struct ast_flags *options)
	Fork a CDR. More...
void	ast_cdr_format_var (struct ast_cdr *cdr, const char *name, char **ret, char *workspace, int workspacelen, int raw)
	Format a CDR variable from an already posted CDR. More...
void	ast_cdr_free (struct ast_cdr *cdr)
	Free a CDR record. More...
static int	ast_cdr_generic_unregister (struct be_list *generic_list, const char *name)
struct ast_cdr_config *	ast_cdr_get_config (void)
	Obtain the current CDR configuration. More...
int	ast_cdr_getvar (const char *channel_name, const char *name, char *value, size_t length)
	Retrieve a CDR variable from a channel's current CDR. More...
int	ast_cdr_is_enabled (void)
	Return TRUE if CDR subsystem is enabled. More...
struct stasis_message_router *	ast_cdr_message_router (void)
	Return the message router for the CDR engine. More...
int	ast_cdr_modifier_register (const char *name, const char *desc, ast_cdrbe be)
	Register a CDR modifier. More...
int	ast_cdr_modifier_unregister (const char *name)
	Unregister a CDR modifier. More...
int	ast_cdr_register (const char *name, const char *desc, ast_cdrbe be)
	Register a CDR handling engine. More...
int	ast_cdr_reset (const char *channel_name, int keep_variables)
	Reset the detail record. More...
int	ast_cdr_serialize_variables (const char *channel_name, struct ast_str **buf, char delim, char sep)
	Serializes all the data and variables for a current CDR record. More...
void	ast_cdr_set_config (struct ast_cdr_config *config)
	Set the current CDR configuration. More...
int	ast_cdr_set_property (const char *channel_name, enum ast_cdr_options option)
	Set a property on a CDR for a channel. More...
void	ast_cdr_setuserfield (const char *channel_name, const char *userfield)
	Set CDR user field for channel (stored in CDR) More...
int	ast_cdr_setvar (const char *channel_name, const char *name, const char *value)
	Set a variable on a CDR. More...
int	ast_cdr_unregister (const char *name)
	Unregister a CDR handling engine. More...
struct ast_module *	AST_MODULE_SELF_SYM (void)
static enum process_bridge_enter_results	base_process_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	base_process_bridge_leave (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	base_process_dial_end (struct cdr_object *cdr, struct ast_channel_snapshot *caller, struct ast_channel_snapshot *peer, const char *dial_status)
static int	base_process_parked_channel (struct cdr_object *cdr, struct ast_parked_call_payload *parking_info)
static int	base_process_party_a (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static void	bridge_candidate_add_to_cdr (struct cdr_object *cdr, struct cdr_object_snapshot *party_b)
static void	bridge_candidate_process (struct cdr_object *cdr, struct cdr_object *base_cand_cdr)
	Process a single bridge_candidate. More...
static int	bridge_state_process_bridge_leave (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static void	bridge_state_process_party_b (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static int	cdr_all_cmp_fn (void *obj, void *arg, int flags)
static int	cdr_all_hash_fn (const void *obj, const int flags)
static void	cdr_all_print_fn (void *v_obj, void *where, ao2_prnt_fn *prnt)
static void	cdr_all_relink (struct cdr_object *cdr)
static void	cdr_all_unlink (struct cdr_object *cdr)
static void	cdr_detach (struct ast_cdr *cdr)
static void	cdr_enable_batch_mode (struct ast_cdr_config *config)
static void	cdr_engine_shutdown (void)
static const char *	cdr_format_var_internal (struct ast_cdr *cdr, const char *name)
static int	cdr_generic_register (struct be_list *generic_list, const char *name, const char *desc, ast_cdrbe be)
static void	cdr_get_tv (struct timeval when, const char *fmt, char *buf, int bufsize)
static int	cdr_master_cmp_fn (void *obj, void *arg, int flags)
static int	cdr_master_hash_fn (const void *obj, const int flags)
static void	cdr_master_print_fn (void *v_obj, void *where, ao2_prnt_fn *prnt)
static struct cdr_object *	cdr_object_alloc (struct ast_channel_snapshot *chan, const struct timeval *event_time)
	cdr_object constructor More...
static void	cdr_object_check_party_a_answer (struct cdr_object *cdr)
	Check to see if a CDR needs to be answered based on its Party A. Note that this is safe to call as much as you want - we won't answer twice. More...
static void	cdr_object_check_party_a_hangup (struct cdr_object *cdr)
	Check to see if a CDR needs to move to the finalized state because its Party A hungup. More...
static struct cdr_object *	cdr_object_create_and_append (struct cdr_object *cdr, const struct timeval *event_time)
	Create a new cdr_object and append it to an existing chain. More...
static struct ast_cdr *	cdr_object_create_public_records (struct cdr_object *cdr)
	Create a chain of ast_cdr objects from a chain of cdr_object suitable for consumption by the registered CDR backends. More...
static void	cdr_object_dispatch (struct cdr_object *cdr)
	Dispatch a CDR. More...
static int	cdr_object_dispatch_all_cb (void *obj, void *arg, int flags)
	This dispatches all cdr_objects. It should only be used during shutdown, so that we get billing records for everything that we can. More...
static void	cdr_object_dtor (void *obj)
	cdr_object Destructor More...
static void	cdr_object_finalize (struct cdr_object *cdr)
	Finalize a CDR. More...
static int	cdr_object_finalize_party_b (void *obj, void *arg, void *data, int flags)
static int	cdr_object_format_property (struct cdr_object *cdr_obj, const char *name, char *value, size_t length)
	Format one of the standard properties on a cdr_object. More...
static void	cdr_object_format_var_internal (struct cdr_object *cdr, const char *name, char *value, size_t length)
	Format a variable on a cdr_object. More...
static long	cdr_object_get_billsec (struct cdr_object *cdr)
	Compute the billsec for a cdr_object. More...
static struct cdr_object *	cdr_object_get_by_name (const char *name)
static int	cdr_object_get_by_name_cb (void *obj, void *arg, int flags)
static long	cdr_object_get_duration (struct cdr_object *cdr)
static int	cdr_object_party_b_left_bridge_cb (void *obj, void *arg, void *data, int flags)
	Callback used to notify CDRs of a Party B leaving the bridge. More...
static struct cdr_object_snapshot *	cdr_object_pick_party_a (struct cdr_object_snapshot *left, struct cdr_object_snapshot *right)
	Given two CDR snapshots, figure out who should be Party A for the resulting CDR. More...
static int	cdr_object_select_all_by_name_cb (void *obj, void *arg, int flags)
static void	cdr_object_set_disposition (struct cdr_object *cdr, int hangupcause)
	Set the disposition on a cdr_object based on a hangupcause code. More...
static void	cdr_object_snapshot_copy (struct cdr_object_snapshot *dst, struct cdr_object_snapshot *src)
	Copy a snapshot and its details. More...
static void	cdr_object_swap_snapshot (struct cdr_object_snapshot *old_snapshot, struct ast_channel_snapshot *new_snapshot)
	Swap an old cdr_object_snapshot's ast_channel_snapshot for a new ast_channel_snapshot. More...
static void	cdr_object_transition_state (struct cdr_object *cdr, struct cdr_object_fn_table *fn_table)
	Transition a cdr_object to a new state. More...
static void	cdr_object_transition_state_init (struct cdr_object *cdr, struct cdr_object_fn_table *fn_table, int do_init)
	Transition a cdr_object to a new state with initiation flag. More...
static void	cdr_object_update_cid (struct cdr_object_snapshot *old_snapshot, struct ast_channel_snapshot *new_snapshot)
static int	cdr_object_update_party_b (void *obj, void *arg, void *data, int flags)
static int	cdr_object_update_party_b_userfield_cb (void *obj, void *arg, void *data, int flags)
	Callback used to update the userfield on Party B on all CDRs. More...
static void	cdr_submit_batch (int shutdown)
static int	cdr_toggle_runtime_options (void)
	Checks if CDRs are enabled and enables/disables the necessary options. More...
static int	check_new_cdr_needed (struct ast_channel_snapshot *old_snapshot, struct ast_channel_snapshot *new_snapshot)
	Determine if we need to add a new CDR based on snapshots. More...
static char *	cli_complete_show (struct ast_cli_args *a)
	Complete user input for 'cdr show'. More...
static void	cli_show_channel (struct ast_cli_args *a)
static void	cli_show_channels (struct ast_cli_args *a)
	CONFIG_INFO_CORE ("cdr", cfg_info, module_configs, module_config_alloc,.files=ACO_FILES(&module_file_conf),.post_apply_config=module_config_post_apply,)
static int	copy_variables (struct varshead *to_list, struct varshead *from_list)
	Copy variables from one list to another. More...
static int	create_subscriptions (void)
	Create the Stasis subcriptions for CDRs. More...
static void	destroy_subscriptions (void)
	Destroy the active Stasis subscriptions. More...
static enum process_bridge_enter_results	dial_state_process_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	dial_state_process_dial_begin (struct cdr_object *cdr, struct ast_channel_snapshot *caller, struct ast_channel_snapshot *peer)
static int	dial_state_process_dial_end (struct cdr_object *cdr, struct ast_channel_snapshot *caller, struct ast_channel_snapshot *peer, const char *dial_status)
static void	dial_state_process_party_b (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static int	dial_status_end (const char *dialstatus)
static enum ast_cdr_disposition	dial_status_to_disposition (const char *dial_status)
static enum process_bridge_enter_results	dialed_pending_state_process_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	dialed_pending_state_process_dial_begin (struct cdr_object *cdr, struct ast_channel_snapshot *caller, struct ast_channel_snapshot *peer)
static int	dialed_pending_state_process_parking_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	dialed_pending_state_process_party_a (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static void *	do_batch_backend_process (void *data)
static void *	do_cdr (void *data)
static int	filter_bridge_messages (struct ast_bridge_snapshot *bridge)
	Filter bridge messages based on bridge technology. More...
static int	filter_channel_snapshot (struct ast_channel_snapshot *snapshot)
static int	filter_channel_snapshot_message (struct ast_channel_snapshot *old_snapshot, struct ast_channel_snapshot *new_snapshot)
static void	finalize_batch_mode (void)
static void	finalized_state_init_function (struct cdr_object *cdr)
static int	finalized_state_process_party_a (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static void	free_variables (struct varshead *headp)
	Delete all variables from a variable list. More...
static void	handle_bridge_enter_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
static void	handle_bridge_leave_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
	Handler for when a channel leaves a bridge. More...
static void	handle_bridge_pairings (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge)
	Handle creating bridge pairings for the cdr_object that just entered a bridge. More...
static void	handle_cdr_sync_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
	Handler for a synchronization message. More...
static void	handle_channel_snapshot_update_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
	Handler for channel snapshot update messages. More...
static char *	handle_cli_debug (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_cli_show (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_cli_status (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_cli_submit (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static void	handle_dial_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
	Handler for Stasis-Core dial messages. More...
static void	handle_parked_call_message (void *data, struct stasis_subscription *sub, struct stasis_message *message)
	Handler for when a channel is parked. More...
static void	handle_parking_bridge_enter_message (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel, const struct timeval *event_time)
	Handle entering into a parking bridge. More...
static void	handle_standard_bridge_enter_message (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel, const struct timeval *event_time)
	Handle a bridge enter message for a 'normal' bridge. More...
static int	init_batch (void)
static int	is_cdr_flag_set (unsigned int cdr_flag)
static int	load_module (void)
static void *	module_config_alloc (void)
	Create a new module config object. More...
static void	module_config_destructor (void *obj)
	Dispose of a module config object. More...
static void	module_config_post_apply (void)
static int	parked_state_process_bridge_leave (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static void	post_cdr (struct ast_cdr *cdr)
static int	process_config (int reload)
static int	reload_module (void)
static void	reset_batch (void)
static void	set_variable (struct varshead *headp, const char *name, const char *value)
static int	single_state_bridge_enter_comparison (struct cdr_object *cdr, struct cdr_object *cand_cdr)
	Handle a comparison between our cdr_object and a cdr_object already in the bridge while in the Single state. The goal of this is to find a Party B for our CDR. More...
static void	single_state_init_function (struct cdr_object *cdr)
static enum process_bridge_enter_results	single_state_process_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static int	single_state_process_dial_begin (struct cdr_object *cdr, struct ast_channel_snapshot *caller, struct ast_channel_snapshot *peer)
static int	single_state_process_parking_bridge_enter (struct cdr_object *cdr, struct ast_bridge_snapshot *bridge, struct ast_channel_snapshot *channel)
static void	single_state_process_party_b (struct cdr_object *cdr, struct ast_channel_snapshot *snapshot)
static int	snapshot_cep_changed (struct ast_channel_snapshot *old_snapshot, struct ast_channel_snapshot *new_snapshot)
	Return whether or not a channel has changed its state in the dialplan, subject to endbeforehexten logic. More...
static int	snapshot_is_dialed (struct ast_channel_snapshot *snapshot)
	Return whether or not a ast_channel_snapshot is for a channel that was created as the result of a dial operation. More...
static void	start_batch_mode (void)
	STASIS_MESSAGE_TYPE_DEFN_LOCAL (cdr_sync_message_type)
	A message type used to synchronize with the CDR topic. More...
static int	submit_scheduled_batch (const void *data)
static int	unload_module (void)

Variables
static struct ast_module_info	__mod_info = { .name = AST_MODULE, .flags = AST_MODFLAG_GLOBAL_SYMBOLS | AST_MODFLAG_LOAD_ORDER , .description = "CDR Engine" , .key = "This paragraph is copyright (c) 2006 by Digium, Inc. \In order for your module to load, it must return this \key via a function called \"key\". Any code which \includes this paragraph must be licensed under the GNU \General Public License version 2 or later (at your \option). In addition to Digium's general reservations \of rights, Digium expressly reserves the right to \allow other parties to license this paragraph under \different terms. Any use of Digium, Inc. trademarks or \logos (including \"Asterisk\" or \"Digium\") without \express written permission of Digium, Inc. is prohibited.\n" , .buildopt_sum = "30ef0c93b36035ec78c9cfd712d36d9b" , .support_level = AST_MODULE_SUPPORT_CORE, .load = load_module, .unload = unload_module, .reload = reload_module, .load_pri = AST_MODPRI_CORE, .requires = "extconfig", }
static struct ao2_container *	active_cdrs_all
	A container of all active CDRs with a Party B indexed by Party B channel name. More...
static struct ao2_container *	active_cdrs_master
	A container of the active master CDRs indexed by Party A channel uniqueid. More...
static const struct ast_module_info *	ast_module_info = &__mod_info
static struct cdr_batch *	batch = NULL
static struct be_list	be_list = { .first = NULL, .last = NULL, .lock = { PTHREAD_RWLOCK_INITIALIZER , NULL, {1, 0} } , }
struct cdr_object_fn_table	bridge_state_fn_table
	The virtual table for the Bridged state. More...
static struct stasis_forward *	bridge_subscription
	Our subscription for bridges. More...
static ast_mutex_t	cdr_batch_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
	Lock protecting modifications to the batch queue. More...
static int	cdr_debug_enabled
static ast_cond_t	cdr_pending_cond
static ast_mutex_t	cdr_pending_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
	These are used to wake up the CDR thread when there's work to do. More...
static const char *const	cdr_readonly_vars []
static int	cdr_sched = -1
static ast_mutex_t	cdr_sched_lock = { PTHREAD_RECURSIVE_MUTEX_INITIALIZER_NP , NULL, {1, 0} }
static pthread_t	cdr_thread = AST_PTHREADT_NULL
static struct stasis_topic *	cdr_topic
	The parent topic for all topics we want to aggregate for CDRs. More...
static struct stasis_forward *	channel_subscription
	Our subscription for channels. More...
static struct ast_cli_entry	cli_commands []
struct cdr_object_fn_table	dial_state_fn_table
	The virtual table for the Dial state. More...
struct cdr_object_fn_table	dialed_pending_state_fn_table
	The virtual table for the Dialed Pending state. More...
struct cdr_object_fn_table	finalized_state_fn_table
	The virtual table for the finalized state. More...
static struct aco_type	general_option
	The type definition for general options. More...
static struct aco_type *	general_options [] = ACO_TYPES(&general_option)
static int	global_cdr_sequence = 0
	The global sequence counter used for CDRs. More...
static const char *	ignore_categories []
static struct aco_type	ignore_option
static struct mo_list	mo_list = { .first = NULL, .last = NULL, .lock = { PTHREAD_RWLOCK_INITIALIZER , NULL, {1, 0} } , }
static struct aco_file	module_file_conf
	The file definition. More...
struct cdr_object_fn_table	parked_state_fn_table
	The virtual table for the Parked state. More...
static struct stasis_forward *	parking_subscription
	Our subscription for parking. More...
static struct ast_sched_context *	sched
	Scheduler items. More...
struct cdr_object_fn_table	single_state_fn_table
	The virtual table for the Single state. More...
static struct stasis_message_router *	stasis_router
	Message router for stasis messages regarding channel state. More...

Detailed Description

Call Detail Record API.

Author

Mark Spencer marks.nosp@m.ter@.nosp@m.digiu.nosp@m.m.co.nosp@m.m

Note

Includes code and algorithms from the Zapata library.

We do a lot of checking here in the CDR code to try to be sure we don't ever let a CDR slip through our fingers somehow. If someone allocates a CDR, it must be completely handled normally or a WARNING shall be logged, so that we can best keep track of any escape condition where the CDR isn't properly generated and posted.

Definition in file cdr.c.

Macro Definition Documentation

CDR_DEBUG

#define CDR_DEBUG	(		fmt,
			...
	)

Value:

do { \
 if (cdr_debug_enabled) { \
 ast_verbose((fmt), ##__VA_ARGS__); \
 } \
 } while (0)

Definition at line 210 of file cdr.c.

Referenced by bridge_candidate_add_to_cdr(), bridge_candidate_process(), cdr_object_alloc(), cdr_object_check_party_a_answer(), cdr_object_dispatch(), cdr_object_transition_state_init(), handle_bridge_enter_message(), handle_bridge_leave_message(), handle_channel_snapshot_update_message(), handle_cli_debug(), handle_dial_message(), handle_parked_call_message(), handle_parking_bridge_enter_message(), handle_standard_bridge_enter_message(), process_config(), single_state_bridge_enter_comparison(), and single_state_process_dial_begin().

cdr_set_debug_mode

#define cdr_set_debug_mode

(

mod_cfg

)

Value:

do { \
 cdr_debug_enabled = ast_test_flag(&(mod_cfg)->general->settings, CDR_DEBUG); \
 } while (0)

Definition at line 203 of file cdr.c.

Referenced by ast_cdr_set_config(), handle_cli_debug(), module_config_post_apply(), and process_config().

DEFAULT_BATCH_SAFE_SHUTDOWN

#define DEFAULT_BATCH_SAFE_SHUTDOWN   "1"

Definition at line 201 of file cdr.c.

Referenced by process_config().

DEFAULT_BATCH_SCHEDULER_ONLY

#define DEFAULT_BATCH_SCHEDULER_ONLY   "0"

Definition at line 200 of file cdr.c.

Referenced by process_config().

DEFAULT_BATCH_SIZE

#define DEFAULT_BATCH_SIZE   "100"

Definition at line 196 of file cdr.c.

Referenced by process_config().

DEFAULT_BATCH_TIME

#define DEFAULT_BATCH_TIME   "300"

Definition at line 198 of file cdr.c.

Referenced by process_config().

DEFAULT_BATCHMODE

#define DEFAULT_BATCHMODE   "0"

Definition at line 190 of file cdr.c.

Referenced by process_config().

DEFAULT_CONGESTION

#define DEFAULT_CONGESTION   "0"

Definition at line 192 of file cdr.c.

DEFAULT_ENABLED

#define DEFAULT_ENABLED   "1"

Definition at line 189 of file cdr.c.

Referenced by process_config().

DEFAULT_END_BEFORE_H_EXTEN

#define DEFAULT_END_BEFORE_H_EXTEN   "1"

Definition at line 193 of file cdr.c.

Referenced by process_config().

DEFAULT_INITIATED_SECONDS

#define DEFAULT_INITIATED_SECONDS   "0"

Definition at line 194 of file cdr.c.

Referenced by process_config().

DEFAULT_UNANSWERED

#define DEFAULT_UNANSWERED   "0"

Definition at line 191 of file cdr.c.

Referenced by process_config().

FORMAT_STRING [1/2]

#define FORMAT_STRING   "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8ld %-8.8ld\n"

Referenced by cli_show_channel(), and cli_show_channels().

FORMAT_STRING [2/2]

#define FORMAT_STRING   "%-10.10s %-20.20s %-25.25s %-15.15s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8ld %-8.8ld\n"

MAX_BATCH_SIZE

#define MAX_BATCH_SIZE   1000

Definition at line 197 of file cdr.c.

Referenced by process_config().

MAX_BATCH_TIME

#define MAX_BATCH_TIME   86400

Definition at line 199 of file cdr.c.

Referenced by process_config().

TITLE_STRING [1/2]

#define TITLE_STRING   "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\n"

Referenced by cli_show_channel(), and cli_show_channels().

TITLE_STRING [2/2]

#define TITLE_STRING   "%-10.10s %-20.20s %-25.25s %-15.15s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\n"

Enumeration Type Documentation

process_bridge_enter_results

enum process_bridge_enter_results

Return types for process_bridge_enter functions.

Enumerator
BRIDGE_ENTER_ONLY_PARTY	The CDR was the only party in the bridge.
BRIDGE_ENTER_OBTAINED_PARTY_B	The CDR was able to obtain a Party B from some other party already in the bridge
BRIDGE_ENTER_NO_PARTY_B	The CDR was not able to obtain a Party B
BRIDGE_ENTER_NEED_CDR	This CDR can't handle a bridge enter message and a new CDR needs to be created

Definition at line 391 of file cdr.c.

 {
 /*!
 * The CDR was the only party in the bridge.
 */
 BRIDGE_ENTER_ONLY_PARTY,
 /*!
 * The CDR was able to obtain a Party B from some other party already in the bridge
 */
 BRIDGE_ENTER_OBTAINED_PARTY_B,
 /*!
 * The CDR was not able to obtain a Party B
 */
 BRIDGE_ENTER_NO_PARTY_B,
 /*!
 * This CDR can't handle a bridge enter message and a new CDR needs to be created
 */
 BRIDGE_ENTER_NEED_CDR,
};

Function Documentation

__reg_module()

static void __reg_module ( void  )

static

Definition at line 4651 of file cdr.c.

__unreg_module()

static void __unreg_module ( void  )

static

Definition at line 4651 of file cdr.c.

AO2_GLOBAL_OBJ_STATIC()

static AO2_GLOBAL_OBJ_STATIC ( module_configs  )

static

The container for the module configuration.

ast_cdr_alloc()

struct ast_cdr* ast_cdr_alloc

(

void

)

Allocate a CDR record.

Return values

a	malloc'd ast_cdr structure
NULL	on error (malloc failure)

Definition at line 3422 of file cdr.c.

References ast_calloc.

Referenced by ast_cdr_dup().

{
 struct ast_cdr *x;

 x = ast_calloc(1, sizeof(*x));
 return x;
}

ast_cdr_backend_suspend()

int ast_cdr_backend_suspend

(

const char *

name

)

Suspend a CDR backend temporarily.

Return values

0	The backend is suspdended
-1	The backend could not be suspended

Definition at line 2866 of file cdr.c.

References ast_debug, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, cdr_beitem::name, and NULL.

Referenced by load_config(), my_unload_module(), and odbc_load_module().

{
 int success = -1;
 struct cdr_beitem *i = NULL;

 AST_RWLIST_WRLOCK(&be_list);
 AST_RWLIST_TRAVERSE(&be_list, i, list) {
 if (!strcasecmp(name, i->name)) {
 ast_debug(3, "Suspending CDR backend %s\n", i->name);
 i->suspended = 1;
 success = 0;
 }
 }
 AST_RWLIST_UNLOCK(&be_list);

 return success;
}

ast_cdr_backend_unsuspend()

int ast_cdr_backend_unsuspend

(

const char *

name

)

Unsuspend a CDR backend.

Return values

0	The backend was unsuspended
-1	The back could not be unsuspended

Definition at line 2884 of file cdr.c.

References ast_debug, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, cdr_beitem::name, and NULL.

Referenced by load_config(), my_load_module(), and odbc_load_module().

{
 int success = -1;
 struct cdr_beitem *i = NULL;

 AST_RWLIST_WRLOCK(&be_list);
 AST_RWLIST_TRAVERSE(&be_list, i, list) {
 if (!strcasecmp(name, i->name)) {
 ast_debug(3, "Unsuspending CDR backend %s\n", i->name);
 i->suspended = 0;
 success = 0;
 }
 }
 AST_RWLIST_UNLOCK(&be_list);

 return success;
}

ast_cdr_clear_property()

int ast_cdr_clear_property	(	const char *	channel_name,
		enum ast_cdr_options	option
	)

Clear a property on a CDR for a channel.

Since

12 Clears a flag previously set by ast_cdr_set_property

Parameters

channel_name	The CDR's channel
option	Option to clear from the CDR

Return values

0	on success
1	on error

Definition at line 3575 of file cdr.c.

References ao2_cleanup, ao2_lock, ao2_unlock, ast_clear_flag, cdr_object_get_by_name(), cdr_object::flags, cdr_object::fn_table, and cdr_object::next.

Referenced by appcdr_callback(), AST_TEST_DEFINE(), and cdr_prop_write_callback().

{
 struct cdr_object *cdr;
 struct cdr_object *it_cdr;

 cdr = cdr_object_get_by_name(channel_name);
 if (!cdr) {
 return -1;
 }

 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 if (it_cdr->fn_table == &finalized_state_fn_table) {
 continue;
 }
 ast_clear_flag(&it_cdr->flags, option);
 }
 ao2_unlock(cdr);

 ao2_cleanup(cdr);
 return 0;
}

ast_cdr_disp2str()

const char* ast_cdr_disp2str

(

int

disposition

)

Disposition to a string.

Parameters

disposition

input binary form Converts the binary form of a disposition to string form.

Returns

a pointer to the string form

Definition at line 3430 of file cdr.c.

References AST_CDR_ANSWERED, AST_CDR_BUSY, AST_CDR_CONGESTION, AST_CDR_FAILED, AST_CDR_NOANSWER, and AST_CDR_NULL.

Referenced by ast_cdr_format_var(), beanstalk_put(), build_csv_record(), build_radius_record(), cdr_object_finalize(), cdr_read_callback(), execute_cb(), manager_log(), and tds_log().

{
 switch (disposition) {
 case AST_CDR_NULL:
 return "NO ANSWER"; /* by default, for backward compatibility */
 case AST_CDR_NOANSWER:
 return "NO ANSWER";
 case AST_CDR_FAILED:
 return "FAILED";
 case AST_CDR_BUSY:
 return "BUSY";
 case AST_CDR_ANSWERED:
 return "ANSWERED";
 case AST_CDR_CONGESTION:
 return "CONGESTION";
 }
 return "UNKNOWN";
}

ast_cdr_dup()

struct ast_cdr* ast_cdr_dup

(

struct ast_cdr *

cdr

)

Duplicate a public CDR.

Parameters

cdr	the record to duplicate

Return values

a	malloc'd ast_cdr structure,
NULL	on error (malloc failure)

Definition at line 2998 of file cdr.c.

References ast_cdr_alloc(), AST_LIST_HEAD_INIT_NOLOCK, copy_variables(), ast_cdr::next, NULL, and ast_cdr::varshead.

Referenced by custom_log(), load_values_config(), manager_log(), and syslog_log().

{
 struct ast_cdr *newcdr;

 if (!cdr) {
 return NULL;
 }
 newcdr = ast_cdr_alloc();
 if (!newcdr) {
 return NULL;
 }

 *newcdr = *cdr;
 AST_LIST_HEAD_INIT_NOLOCK(&newcdr->varshead);
 copy_variables(&newcdr->varshead, &cdr->varshead);
 newcdr->next = NULL;

 return newcdr;
}

ast_cdr_engine_term()

void ast_cdr_engine_term

(

void

)

Submit any remaining CDRs and prepare for shutdown

Definition at line 4577 of file cdr.c.

References ao2_alloc, ao2_cleanup, ao2_global_obj_ref, ast_debug, ast_test_flag, BATCH_MODE_SAFE_SHUTDOWN, CDR_BATCHMODE, cdr_submit_batch(), NULL, RAII_VAR, stasis_message_create(), and stasis_message_router_publish_sync().

Referenced by can_safely_quit(), and finalize_batch_mode().

{
 RAII_VAR(struct module_config *, mod_cfg, ao2_global_obj_ref(module_configs), ao2_cleanup);

 /* Since this is called explicitly during process shutdown, we might not have ever
 * been initialized. If so, the config object will be NULL.
 */
 if (!mod_cfg) {
 return;
 }

 if (cdr_sync_message_type()) {
 void *payload;
 struct stasis_message *message;

 if (!stasis_router) {
 return;
 }

 /* Make sure we have the needed items */
 payload = ao2_alloc(sizeof(*payload), NULL);
 if (!payload) {
 return;
 }

 ast_debug(1, "CDR Engine termination request received; waiting on messages...\n");

 message = stasis_message_create(cdr_sync_message_type(), payload);
 if (message) {
 stasis_message_router_publish_sync(stasis_router, message);
 }
 ao2_cleanup(message);
 ao2_cleanup(payload);
 }

 if (ast_test_flag(&mod_cfg->general->settings, CDR_BATCHMODE)) {
 cdr_submit_batch(ast_test_flag(&mod_cfg->general->batch_settings.settings, BATCH_MODE_SAFE_SHUTDOWN));
 }
}

ast_cdr_fork()

int ast_cdr_fork	(	const char *	channel_name,
		struct ast_flags *	options
	)

Fork a CDR.

Since

12

Parameters

channel_name	The name of the channel whose CDR should be forked
options	Options to control how the fork occurs.

Return values

0	on success
-1	on failure

Definition at line 3637 of file cdr.c.

References cdr_object::answer, ao2_cleanup, ao2_ref, cdr_object::appl, AST_CDR_FLAG_FINALIZE, AST_CDR_FLAG_KEEP_VARS, AST_CDR_FLAG_RESET, AST_CDR_FLAG_SET_ANSWER, AST_CDR_LOCK_APP, ast_clear_flag, ast_debug, AST_STATE_UP, ast_string_field_set, ast_test_flag, ast_tvnow(), ast_channel_snapshot::base, cdr_object::bridge, cdr_all_relink(), cdr_object_create_and_append(), cdr_object_finalize(), cdr_object_get_by_name(), cdr_object_transition_state(), context, cdr_object::context, copy_variables(), cdr_object::data, exten, cdr_object::exten, cdr_object_snapshot::flags, cdr_object::flags, cdr_object::fn_table, free_variables(), cdr_object::last, cdr_object::lastevent, lock, ast_channel_snapshot_base::name, cdr_object::next, cdr_object::party_a, cdr_object::party_b, RAII_VAR, SCOPED_AO2LOCK, cdr_object_snapshot::snapshot, cdr_object::start, ast_channel_snapshot::state, cdr_object_snapshot::userfield, and cdr_object_snapshot::variables.

Referenced by AST_TEST_DEFINE(), and forkcdr_callback().

{
 RAII_VAR(struct cdr_object *, cdr, cdr_object_get_by_name(channel_name), ao2_cleanup);
 struct cdr_object *new_cdr;
 struct cdr_object *it_cdr;
 struct cdr_object *cdr_obj;

 if (!cdr) {
 return -1;
 }

 {
 SCOPED_AO2LOCK(lock, cdr);
 struct timeval now = ast_tvnow();

 cdr_obj = cdr->last;
 if (cdr_obj->fn_table == &finalized_state_fn_table) {
 /* If the last CDR in the chain is finalized, don't allow a fork -
 * things are already dying at this point
 */
 return -1;
 }

 /* Copy over the basic CDR information. The Party A information is
 * copied over automatically as part of the append
 */
 ast_debug(1, "Forking CDR for channel %s\n", cdr->party_a.snapshot->base->name);
 new_cdr = cdr_object_create_and_append(cdr, &now);
 if (!new_cdr) {
 return -1;
 }
 new_cdr->fn_table = cdr_obj->fn_table;
 ast_string_field_set(new_cdr, bridge, cdr->bridge);
 ast_string_field_set(new_cdr, appl, cdr->appl);
 ast_string_field_set(new_cdr, data, cdr->data);
 ast_string_field_set(new_cdr, context, cdr->context);
 ast_string_field_set(new_cdr, exten, cdr->exten);
 new_cdr->flags = cdr->flags;
 /* Explicitly clear the AST_CDR_LOCK_APP flag - we want
 * the application to be changed on the new CDR if the
 * dialplan demands it
 */
 ast_clear_flag(&new_cdr->flags, AST_CDR_LOCK_APP);

 /* If there's a Party B, copy it over as well */
 if (cdr_obj->party_b.snapshot) {
 new_cdr->party_b.snapshot = cdr_obj->party_b.snapshot;
 ao2_ref(new_cdr->party_b.snapshot, +1);
 cdr_all_relink(new_cdr);
 strcpy(new_cdr->party_b.userfield, cdr_obj->party_b.userfield);
 new_cdr->party_b.flags = cdr_obj->party_b.flags;
 if (ast_test_flag(options, AST_CDR_FLAG_KEEP_VARS)) {
 copy_variables(&new_cdr->party_b.variables, &cdr_obj->party_b.variables);
 }
 }
 new_cdr->start = cdr_obj->start;
 new_cdr->answer = cdr_obj->answer;
 new_cdr->lastevent = ast_tvnow();

 /* Modify the times based on the flags passed in */
 if (ast_test_flag(options, AST_CDR_FLAG_SET_ANSWER)
 && new_cdr->party_a.snapshot->state == AST_STATE_UP) {
 new_cdr->answer = ast_tvnow();
 }
 if (ast_test_flag(options, AST_CDR_FLAG_RESET)) {
 new_cdr->answer = ast_tvnow();
 new_cdr->start = ast_tvnow();
 }

 /* Create and append, by default, copies over the variables */
 if (!ast_test_flag(options, AST_CDR_FLAG_KEEP_VARS)) {
 free_variables(&new_cdr->party_a.variables);
 }

 /* Finalize any current CDRs */
 if (ast_test_flag(options, AST_CDR_FLAG_FINALIZE)) {
 for (it_cdr = cdr; it_cdr != new_cdr; it_cdr = it_cdr->next) {
 if (it_cdr->fn_table == &finalized_state_fn_table) {
 continue;
 }
 /* Force finalization on the CDR. This will bypass any checks for
 * end before 'h' extension.
 */
 cdr_object_finalize(it_cdr);
 cdr_object_transition_state(it_cdr, &finalized_state_fn_table);
 }
 }
 }

 return 0;
}

ast_cdr_format_var()

void ast_cdr_format_var	(	struct ast_cdr *	cdr,
		const char *	name,
		char **	ret,
		char *	workspace,
		int	workspacelen,
		int	raw
	)

Format a CDR variable from an already posted CDR.

Since

12

Parameters

cdr	The dispatched CDR to process
name	The name of the variable
ret	Pointer to the formatted buffer
workspace	A pointer to the buffer to use to format the variable
workspacelen	The size of workspace
raw	If non-zero and a date/time is extraced, provide epoch seconds. Otherwise format as a date/time stamp

Definition at line 3050 of file cdr.c.

References ast_cdr::accountcode, ast_cdr::amaflags, ast_cdr::answer, ast_cdr_disp2str(), ast_channel_amaflags2string(), ast_copy_string(), ast_strlen_zero, ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_cdr::billsec, cdr_format_var_internal(), cdr_get_tv(), ast_cdr::channel, ast_cdr::clid, ast_cdr::dcontext, ast_cdr::disposition, ast_cdr::dst, ast_cdr::dstchannel, ast_cdr::duration, ast_cdr::end, ast_cdr::lastapp, ast_cdr::lastdata, ast_cdr::linkedid, NULL, ast_cdr::peeraccount, ast_cdr::sequence, ast_cdr::src, ast_cdr::start, ast_cdr::uniqueid, and ast_cdr::userfield.

Referenced by cdr_handler(), cdr_read_callback(), cdr_retrieve_time(), mysql_log(), odbc_log(), and pgsql_log().

{
 const char *fmt = "%Y-%m-%d %T";
 const char *varbuf;

 if (!cdr) {
 return;
 }

 *ret = NULL;

 if (!strcasecmp(name, "clid")) {
 ast_copy_string(workspace, cdr->clid, workspacelen);
 } else if (!strcasecmp(name, "src")) {
 ast_copy_string(workspace, cdr->src, workspacelen);
 } else if (!strcasecmp(name, "dst")) {
 ast_copy_string(workspace, cdr->dst, workspacelen);
 } else if (!strcasecmp(name, "dcontext")) {
 ast_copy_string(workspace, cdr->dcontext, workspacelen);
 } else if (!strcasecmp(name, "channel")) {
 ast_copy_string(workspace, cdr->channel, workspacelen);
 } else if (!strcasecmp(name, "dstchannel")) {
 ast_copy_string(workspace, cdr->dstchannel, workspacelen);
 } else if (!strcasecmp(name, "lastapp")) {
 ast_copy_string(workspace, cdr->lastapp, workspacelen);
 } else if (!strcasecmp(name, "lastdata")) {
 ast_copy_string(workspace, cdr->lastdata, workspacelen);
 } else if (!strcasecmp(name, "start")) {
 cdr_get_tv(cdr->start, raw ? NULL : fmt, workspace, workspacelen);
 } else if (!strcasecmp(name, "answer")) {
 cdr_get_tv(cdr->answer, raw ? NULL : fmt, workspace, workspacelen);
 } else if (!strcasecmp(name, "end")) {
 cdr_get_tv(cdr->end, raw ? NULL : fmt, workspace, workspacelen);
 } else if (!strcasecmp(name, "duration")) {
 snprintf(workspace, workspacelen, "%ld", cdr->end.tv_sec != 0 ? cdr->duration : (long)ast_tvdiff_ms(ast_tvnow(), cdr->start) / 1000);
 } else if (!strcasecmp(name, "billsec")) {
 snprintf(workspace, workspacelen, "%ld", (cdr->billsec || !ast_tvzero(cdr->end) || ast_tvzero(cdr->answer)) ? cdr->billsec : (long)ast_tvdiff_ms(ast_tvnow(), cdr->answer) / 1000);
 } else if (!strcasecmp(name, "disposition")) {
 if (raw) {
 snprintf(workspace, workspacelen, "%ld", cdr->disposition);
 } else {
 ast_copy_string(workspace, ast_cdr_disp2str(cdr->disposition), workspacelen);
 }
 } else if (!strcasecmp(name, "amaflags")) {
 if (raw) {
 snprintf(workspace, workspacelen, "%ld", cdr->amaflags);
 } else {
 ast_copy_string(workspace, ast_channel_amaflags2string(cdr->amaflags), workspacelen);
 }
 } else if (!strcasecmp(name, "accountcode")) {
 ast_copy_string(workspace, cdr->accountcode, workspacelen);
 } else if (!strcasecmp(name, "peeraccount")) {
 ast_copy_string(workspace, cdr->peeraccount, workspacelen);
 } else if (!strcasecmp(name, "uniqueid")) {
 ast_copy_string(workspace, cdr->uniqueid, workspacelen);
 } else if (!strcasecmp(name, "linkedid")) {
 ast_copy_string(workspace, cdr->linkedid, workspacelen);
 } else if (!strcasecmp(name, "userfield")) {
 ast_copy_string(workspace, cdr->userfield, workspacelen);
 } else if (!strcasecmp(name, "sequence")) {
 snprintf(workspace, workspacelen, "%d", cdr->sequence);
 } else if ((varbuf = cdr_format_var_internal(cdr, name))) {
 ast_copy_string(workspace, varbuf, workspacelen);
 } else {
 workspace[0] = '\0';
 }

 if (!ast_strlen_zero(workspace)) {
 *ret = workspace;
 }
}

ast_cdr_free()

void ast_cdr_free

(

struct ast_cdr *

cdr

)

Free a CDR record.

Parameters

cdr	ast_cdr structure to free Returns nothing

Definition at line 3411 of file cdr.c.

References ast_free, free_variables(), ast_cdr::next, and ast_cdr::varshead.

Referenced by ast_channel_destructor(), ast_dummy_channel_destructor(), cdr_detach(), clear_mock_cdr_backend(), and do_batch_backend_process().

{
 while (cdr) {
 struct ast_cdr *next = cdr->next;

 free_variables(&cdr->varshead);
 ast_free(cdr);
 cdr = next;
 }
}

ast_cdr_generic_unregister()

static int ast_cdr_generic_unregister ( struct be_list *  generic_list, const char *  name  )

static

Definition at line 2953 of file cdr.c.

References ao2_container_count(), ast_free, ast_log, AST_LOG_WARNING, AST_RWLIST_REMOVE, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, match(), cdr_beitem::name, and NULL.

Referenced by ast_cdr_modifier_unregister(), and ast_cdr_unregister().

{
 struct cdr_beitem *match = NULL;
 int active_count;

 AST_RWLIST_WRLOCK(generic_list);
 AST_RWLIST_TRAVERSE(generic_list, match, list) {
 if (!strcasecmp(name, match->name)) {
 break;
 }
 }

 if (!match) {
 AST_RWLIST_UNLOCK(generic_list);
 return 0;
 }

 active_count = ao2_container_count(active_cdrs_master);

 if (!match->suspended && active_count != 0) {
 AST_RWLIST_UNLOCK(generic_list);
 ast_log(AST_LOG_WARNING, "Unable to unregister CDR backend %s; %d CDRs are still active\n",
 name, active_count);
 return -1;
 }

 AST_RWLIST_REMOVE(generic_list, match, list);
 AST_RWLIST_UNLOCK(generic_list);

 ast_verb(2, "Unregistered '%s' CDR backend\n", name);
 ast_free(match);

 return 0;
}

ast_cdr_get_config()

struct ast_cdr_config* ast_cdr_get_config

(

void

)

Obtain the current CDR configuration.

Since

12 The configuration is a ref counted object. The caller of this function must decrement the ref count when finished with the configuration.

Return values

NULL	on error
The	current CDR configuration

Definition at line 2826 of file cdr.c.

References ao2_bump, ao2_cleanup, ao2_global_obj_ref, module_config::general, and NULL.

Referenced by test_cdr_init_cb().

{
 struct ast_cdr_config *general;
 struct module_config *mod_cfg;

 mod_cfg = ao2_global_obj_ref(module_configs);
 if (!mod_cfg) {
 return NULL;
 }
 general = ao2_bump(mod_cfg->general);
 ao2_cleanup(mod_cfg);
 return general;
}

ast_cdr_getvar()

int ast_cdr_getvar	(	const char *	channel_name,
		const char *	name,
		char *	value,
		size_t	length
	)

Retrieve a CDR variable from a channel's current CDR.

Since

12

Parameters

channel_name	The name of the party A channel that the CDR is associated with
name	The name of the variable to retrieve
value	Buffer to hold the value
length	The size of the buffer

Return values

0	on success
non-zero	on failure

Definition at line 3324 of file cdr.c.

References ao2_cleanup, ao2_lock, ao2_unlock, ast_log, AST_LOG_ERROR, ast_strlen_zero, cdr_object_format_property(), cdr_object_format_var_internal(), cdr_object_get_by_name(), and cdr_object::last.

Referenced by AST_TEST_DEFINE(), cdr_read_callback(), and cdr_retrieve_time().

{
 struct cdr_object *cdr;
 struct cdr_object *cdr_obj;

 if (ast_strlen_zero(name)) {
 return 1;
 }

 cdr = cdr_object_get_by_name(channel_name);
 if (!cdr) {
 ast_log(AST_LOG_ERROR, "Unable to find CDR for channel %s\n", channel_name);
 return 1;
 }

 ao2_lock(cdr);

 cdr_obj = cdr->last;
 if (cdr_object_format_property(cdr_obj, name, value, length)) {
 /* Property failed; attempt variable */
 cdr_object_format_var_internal(cdr_obj, name, value, length);
 }

 ao2_unlock(cdr);

 ao2_cleanup(cdr);
 return 0;
}

ast_cdr_is_enabled()

int ast_cdr_is_enabled

(

void

)

Return TRUE if CDR subsystem is enabled.

Definition at line 2861 of file cdr.c.

References CDR_ENABLED, and is_cdr_flag_set().

Referenced by action_coresettings(), and handle_show_settings().

{
 return is_cdr_flag_set(CDR_ENABLED);
}

ast_cdr_message_router()

struct stasis_message_router* ast_cdr_message_router

(

void

)

Return the message router for the CDR engine.

This returns the stasis_message_router that the CDR engine uses for dispatching Stasis Message Bus API messages. The reference on the message router is bumped and must be released by the caller of this function.

Return values

NULL	if the CDR engine is disabled or unavailable
the	stasis_message_router otherwise

Definition at line 4291 of file cdr.c.

References ao2_bump, NULL, and stasis_router.

Referenced by cdr_prop_write(), cdr_read(), cdr_write(), forkcdr_exec(), load_module(), publish_app_cdr_message(), and unload_module().

{
 if (!stasis_router) {
 return NULL;
 }

 ao2_bump(stasis_router);
 return stasis_router;
}

ast_cdr_modifier_register()

int ast_cdr_modifier_register	(	const char *	name,
		const char *	desc,
		ast_cdrbe	be
	)

Register a CDR modifier.

Parameters

name	name associated with the particular CDR modifier
desc	description of the CDR modifier
be	function pointer to a CDR modifier

Used to register a Call Detail Record modifier.

This gives modules a chance to modify CDR fields before they are dispatched to registered backends (odbc, syslog, etc).

Note

The modified CDR will be passed to all registered backends for logging. For instance, if cdr_manager changes the CDR data, cdr_adaptive_odbc will also get the modified CDR.

Return values

0	on success.
-1	on error

Definition at line 2948 of file cdr.c.

References cdr_generic_register().

{
 return cdr_generic_register((struct be_list *)&mo_list, name, desc, be);
}

ast_cdr_modifier_unregister()

int ast_cdr_modifier_unregister

(

const char *

name

)

Unregister a CDR modifier.

Parameters

name	name of CDR modifier to unregister Unregisters a CDR modifier by its name

Return values

0	The modifier unregistered successfully
-1	The modifier could not be unregistered at this time

Definition at line 2993 of file cdr.c.

References ast_cdr_generic_unregister().

{
 return ast_cdr_generic_unregister((struct be_list *)&mo_list, name);
}

ast_cdr_register()

int ast_cdr_register	(	const char *	name,
		const char *	desc,
		ast_cdrbe	be
	)

Register a CDR handling engine.

Parameters

name	name associated with the particular CDR handler
desc	description of the CDR handler
be	function pointer to a CDR handler Used to register a Call Detail Record handler.

Return values

0	on success.
-1	on error

Definition at line 2943 of file cdr.c.

References cdr_generic_register().

Referenced by load_module(), load_values_config(), my_load_module(), odbc_load_module(), and unload_module().

{
 return cdr_generic_register(&be_list, name, desc, be);
}

ast_cdr_reset()

int ast_cdr_reset	(	const char *	channel_name,
		int	keep_variables
	)

Reset the detail record.

Parameters

channel_name	The channel that the CDR is associated with
keep_variables	Keep the variables during the reset. If zero, variables are discarded during the reset.

Return values

0	on success
-1	on failure

Definition at line 3598 of file cdr.c.

References cdr_object::answer, ao2_cleanup, ao2_lock, ao2_unlock, AST_LIST_REMOVE_HEAD, ast_tvnow(), ast_var_delete(), cdr_object_check_party_a_answer(), cdr_object_get_by_name(), cdr_object::end, cdr_object::lastevent, cdr_object::next, cdr_object::party_a, cdr_object::party_b, cdr_object_snapshot::snapshot, cdr_object::start, and cdr_object_snapshot::variables.

Referenced by appcdr_callback(), and dial_exec_full().

{
 struct cdr_object *cdr;
 struct ast_var_t *vardata;
 struct cdr_object *it_cdr;

 cdr = cdr_object_get_by_name(channel_name);
 if (!cdr) {
 return -1;
 }

 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 /* clear variables */
 if (!keep_variables) {
 while ((vardata = AST_LIST_REMOVE_HEAD(&it_cdr->party_a.variables, entries))) {
 ast_var_delete(vardata);
 }
 if (cdr->party_b.snapshot) {
 while ((vardata = AST_LIST_REMOVE_HEAD(&it_cdr->party_b.variables, entries))) {
 ast_var_delete(vardata);
 }
 }
 }

 /* Reset to initial state */
 memset(&it_cdr->start, 0, sizeof(it_cdr->start));
 memset(&it_cdr->end, 0, sizeof(it_cdr->end));
 memset(&it_cdr->answer, 0, sizeof(it_cdr->answer));
 it_cdr->start = ast_tvnow();
 it_cdr->lastevent = it_cdr->start;
 cdr_object_check_party_a_answer(it_cdr);
 }
 ao2_unlock(cdr);

 ao2_cleanup(cdr);
 return 0;
}

ast_cdr_serialize_variables()

int ast_cdr_serialize_variables	(	const char *	channel_name,
		struct ast_str **	buf,
		char	delim,
		char	sep
	)

Serializes all the data and variables for a current CDR record.

Parameters

channel_name	The channel to get the CDR for
buf	A buffer to use for formatting the data
delim	A delimeter to use to separate variable keys/values
sep	A separator to use between nestings

Return values

the	total number of serialized variables

Definition at line 3353 of file cdr.c.

References ao2_cleanup, ao2_lock, ao2_unlock, ast_assert, AST_LIST_TRAVERSE, ast_log, AST_LOG_ERROR, ast_str_append(), ast_str_reset(), ast_strlen_zero, ast_var_name(), ast_var_value(), CDR_ENABLED, cdr_object_format_property(), cdr_object_get_by_name(), ast_var_t::entries, is_cdr_flag_set(), LOG_ERROR, cdr_object::next, cdr_object::party_a, S_OR, total, var, and cdr_object_snapshot::variables.

Referenced by handle_showchan().

{
 struct cdr_object *cdr;
 struct cdr_object *it_cdr;
 struct ast_var_t *variable;
 const char *var;
 char workspace[256];
 int total = 0, x = 0, i;

 cdr = cdr_object_get_by_name(channel_name);
 if (!cdr) {
 if (is_cdr_flag_set(CDR_ENABLED)) {
 ast_log(AST_LOG_ERROR, "Unable to find CDR for channel %s\n", channel_name);
 }
 return 0;
 }

 ast_str_reset(*buf);

 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 if (++x > 1) {
 ast_str_append(buf, 0, "\n");
 }

 AST_LIST_TRAVERSE(&it_cdr->party_a.variables, variable, entries) {
 if (!(var = ast_var_name(variable))) {
 continue;
 }

 if (ast_str_append(buf, 0, "level %d: %s%c%s%c", x, var, delim, S_OR(ast_var_value(variable), ""), sep) < 0) {
 ast_log(LOG_ERROR, "Data Buffer Size Exceeded!\n");
 break;
 }

 total++;
 }

 for (i = 0; cdr_readonly_vars[i]; i++) {
 if (cdr_object_format_property(it_cdr, cdr_readonly_vars[i], workspace, sizeof(workspace))) {
 /* Unhandled read-only CDR variable. */
 ast_assert(0);
 continue;
 }

 if (!ast_strlen_zero(workspace)
 && ast_str_append(buf, 0, "level %d: %s%c%s%c", x, cdr_readonly_vars[i], delim, workspace, sep) < 0) {
 ast_log(LOG_ERROR, "Data Buffer Size Exceeded!\n");
 break;
 }
 total++;
 }
 }
 ao2_unlock(cdr);
 ao2_cleanup(cdr);
 return total;
}

ast_cdr_set_config()

void ast_cdr_set_config

(

struct ast_cdr_config *

config

)

Set the current CDR configuration.

Since

12

Parameters

config

The new CDR configuration

Definition at line 2840 of file cdr.c.

References ao2_cleanup, ao2_global_obj_ref, ao2_replace, cdr_set_debug_mode, cdr_toggle_runtime_options(), and module_config::general.

Referenced by test_cdr_cleanup_cb().

{
 struct module_config *mod_cfg;

 if (!config) {
 return;
 }

 mod_cfg = ao2_global_obj_ref(module_configs);
 if (!mod_cfg) {
 return;
 }

 ao2_replace(mod_cfg->general, config);

 cdr_set_debug_mode(mod_cfg);
 cdr_toggle_runtime_options();

 ao2_cleanup(mod_cfg);
}

ast_cdr_set_property()

int ast_cdr_set_property	(	const char *	channel_name,
		enum ast_cdr_options	option
	)

Set a property on a CDR for a channel.

Since

12 This function sets specific administrative properties on a CDR for a channel. This includes properties like preventing a CDR from being dispatched, to setting the channel as the preferred Party A in future CDRs. See enum ast_cdr_options for more information.

Parameters

channel_name	The CDR's channel
option	Option to apply to the CDR

Return values

0	on success
1	on error

Definition at line 3548 of file cdr.c.

References ao2_cleanup, ao2_lock, ao2_unlock, ast_set_flag, cdr_object_get_by_name(), cdr_object::flags, cdr_object::fn_table, cdr_object::next, and cdr_object::party_a.

Referenced by appcdr_callback(), AST_TEST_DEFINE(), and cdr_prop_write_callback().

{
 struct cdr_object *cdr;
 struct cdr_object *it_cdr;

 cdr = cdr_object_get_by_name(channel_name);
 if (!cdr) {
 return -1;
 }

 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 if (it_cdr->fn_table == &finalized_state_fn_table) {
 continue;
 }
 /* Note: in general, set the flags on both the CDR record as well as the
 * Party A. Sometimes all we have is the Party A to look at.
 */
 ast_set_flag(&it_cdr->flags, option);
 ast_set_flag(&it_cdr->party_a, option);
 }
 ao2_unlock(cdr);

 ao2_cleanup(cdr);
 return 0;
}

ast_cdr_setuserfield()

void ast_cdr_setuserfield	(	const char *	channel_name,
		const char *	userfield
	)

Set CDR user field for channel (stored in CDR)

Parameters

channel_name	The name of the channel that owns the CDR
userfield	The user field to set

Definition at line 3477 of file cdr.c.

References ao2_callback_data, ao2_cleanup, ao2_lock, ao2_unlock, ast_copy_string(), cdr_object_get_by_name(), cdr_object_update_party_b_userfield_cb(), party_b_userfield_update::channel_name, cdr_object::fn_table, cdr_object::next, NULL, OBJ_MULTIPLE, OBJ_NODATA, OBJ_SEARCH_KEY, cdr_object::party_a, cdr_object_snapshot::userfield, and party_b_userfield_update::userfield.

Referenced by AST_TEST_DEFINE(), cdr_write_callback(), handle_request_info(), and start_monitor_exec().

{
 struct cdr_object *cdr;
 struct party_b_userfield_update party_b_info = {
 .channel_name = channel_name,
 .userfield = userfield,
 };
 struct cdr_object *it_cdr;

 /* Handle Party A */
 cdr = cdr_object_get_by_name(channel_name);
 if (cdr) {
 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 if (it_cdr->fn_table == &finalized_state_fn_table && it_cdr->next != NULL) {
 continue;
 }
 ast_copy_string(it_cdr->party_a.userfield, userfield,
 sizeof(it_cdr->party_a.userfield));
 }
 ao2_unlock(cdr);
 }

 /* Handle Party B */
 ao2_callback_data(active_cdrs_all, OBJ_NODATA | OBJ_MULTIPLE | OBJ_SEARCH_KEY,
 cdr_object_update_party_b_userfield_cb, (char *) party_b_info.channel_name,
 &party_b_info);

 ao2_cleanup(cdr);
}

ast_cdr_setvar()

int ast_cdr_setvar	(	const char *	channel_name,
		const char *	name,
		const char *	value
	)

Set a variable on a CDR.

Since

12

Parameters

channel_name	The channel to set the variable on
name	The name of the variable to set
value	The value of the variable to set

Return values

0	on success
non-zero	on failure

Definition at line 3178 of file cdr.c.

References ao2_callback, ao2_cleanup, ao2_iterator_destroy(), ao2_iterator_next, ao2_lock, ao2_unlock, ast_log, AST_LOG_ERROR, ast_strdupa, ast_channel_snapshot::base, cdr_object_select_all_by_name_cb(), cdr_object::fn_table, LOG_ERROR, ast_channel_snapshot_base::name, cdr_object::next, NULL, OBJ_MULTIPLE, cdr_object::party_a, cdr_object::party_b, set_variable(), cdr_object_snapshot::snapshot, and cdr_object_snapshot::variables.

Referenced by AST_TEST_DEFINE(), and cdr_write_callback().

{
 struct cdr_object *cdr;
 struct cdr_object *it_cdr;
 struct ao2_iterator *it_cdrs;
 char *arg = ast_strdupa(channel_name);
 int x;

 for (x = 0; cdr_readonly_vars[x]; x++) {
 if (!strcasecmp(name, cdr_readonly_vars[x])) {
 ast_log(LOG_ERROR, "Attempt to set the '%s' read-only variable!\n", name);
 return -1;
 }
 }

 it_cdrs = ao2_callback(active_cdrs_master, OBJ_MULTIPLE, cdr_object_select_all_by_name_cb, arg);
 if (!it_cdrs) {
 ast_log(AST_LOG_ERROR, "Unable to find CDR for channel %s\n", channel_name);
 return -1;
 }

 for (; (cdr = ao2_iterator_next(it_cdrs)); ao2_unlock(cdr), ao2_cleanup(cdr)) {
 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 struct varshead *headp = NULL;

 if (it_cdr->fn_table == &finalized_state_fn_table && it_cdr->next != NULL) {
 continue;
 }
 if (!strcasecmp(channel_name, it_cdr->party_a.snapshot->base->name)) {
 headp = &it_cdr->party_a.variables;
 } else if (it_cdr->party_b.snapshot
 && !strcasecmp(channel_name, it_cdr->party_b.snapshot->base->name)) {
 headp = &it_cdr->party_b.variables;
 }
 if (headp) {
 set_variable(headp, name, value);
 }
 }
 }
 ao2_iterator_destroy(it_cdrs);

 return 0;
}

ast_cdr_unregister()

int ast_cdr_unregister

(

const char *

name

)

Unregister a CDR handling engine.

Parameters

name	name of CDR handler to unregister Unregisters a CDR by it's name

Return values

0	The backend unregistered successfully
-1	The backend could not be unregistered at this time

Definition at line 2988 of file cdr.c.

References ast_cdr_generic_unregister().

Referenced by load_module(), load_values_config(), my_unload_module(), reload(), tds_unload_module(), and unload_module().

{
 return ast_cdr_generic_unregister(&be_list, name);
}

AST_MODULE_SELF_SYM()

struct ast_module* AST_MODULE_SELF_SYM

(

void

)

Definition at line 4651 of file cdr.c.

base_process_bridge_enter()

static enum process_bridge_enter_results base_process_bridge_enter ( struct cdr_object *  cdr, struct ast_bridge_snapshot *  bridge, struct ast_channel_snapshot *  channel  )

static

Definition at line 1611 of file cdr.c.

References BRIDGE_ENTER_NEED_CDR.

{
 /* Base process bridge enter simply indicates that we can't handle it */
 return BRIDGE_ENTER_NEED_CDR;
}

base_process_bridge_leave()

static int base_process_bridge_leave ( struct cdr_object *  cdr, struct ast_bridge_snapshot *  bridge, struct ast_channel_snapshot *  channel  )

static

Definition at line 1601 of file cdr.c.

{
 return 0;
}

base_process_dial_end()

static int base_process_dial_end ( struct cdr_object *  cdr, struct ast_channel_snapshot *  caller, struct ast_channel_snapshot *  peer, const char *  dial_status  )

static

Definition at line 1606 of file cdr.c.

{
 return 0;
}

base_process_parked_channel()

static int base_process_parked_channel ( struct cdr_object *  cdr, struct ast_parked_call_payload *  parking_info  )

static

Definition at line 1617 of file cdr.c.

References ast_assert, AST_CDR_LOCK_APP, ast_set_flag, ast_string_field_set, ast_channel_snapshot::base, cdr_object::flags, cdr_object::fn_table, ast_channel_snapshot_base::name, ast_parked_call_payload::parkee, ast_parked_call_payload::parkinglot, ast_parked_call_payload::parkingspace, cdr_object::party_a, cdr_object_fn_table::process_party_a, and cdr_object_snapshot::snapshot.

{
 char park_info[128];

 ast_assert(!strcasecmp(parking_info->parkee->base->name, cdr->party_a.snapshot->base->name));

 /* Update Party A information regardless */
 cdr->fn_table->process_party_a(cdr, parking_info->parkee);

 /* Fake out where we're parked */
 ast_string_field_set(cdr, appl, "Park");
 snprintf(park_info, sizeof(park_info), "%s:%u", parking_info->parkinglot, parking_info->parkingspace);
 ast_string_field_set(cdr, data, park_info);

 /* Prevent any further changes to the App/Data fields for this record */
 ast_set_flag(&cdr->flags, AST_CDR_LOCK_APP);

 return 0;
}

base_process_party_a()

static int base_process_party_a ( struct cdr_object *  cdr, struct ast_channel_snapshot *  snapshot  )

static

Definition at line 1540 of file cdr.c.

References ast_channel_snapshot_dialplan::appl, cdr_object::appl, ast_assert, AST_CDR_LOCK_APP, AST_FLAG_SUBROUTINE_EXEC, ast_set_flag, AST_SOFTHANGUP_HANGUP_EXEC, ast_string_field_set, ast_strlen_zero, ast_test_flag, ast_channel_snapshot::base, CDR_END_BEFORE_H_EXTEN, cdr_object_check_party_a_answer(), cdr_object_check_party_a_hangup(), cdr_object_finalize(), cdr_object_swap_snapshot(), ast_channel_snapshot_dialplan::context, context, cdr_object::context, ast_channel_snapshot_dialplan::data, cdr_object::data, ast_channel_snapshot::dialplan, ast_channel_snapshot_dialplan::exten, exten, cdr_object::exten, ast_channel_snapshot::flags, cdr_object::flags, is_cdr_flag_set(), ast_channel_snapshot_peer::linkedid, ast_cdr::linkedid, cdr_object::linkedid, ast_channel_snapshot_base::name, cdr_object::party_a, ast_channel_snapshot::peer, cdr_object_snapshot::snapshot, and ast_channel_snapshot::softhangup_flags.

Referenced by dialed_pending_state_process_party_a(), and single_state_process_dial_begin().

{
 ast_assert(strcasecmp(snapshot->base->name, cdr->party_a.snapshot->base->name) == 0);

 /* Finalize the CDR if we're in hangup logic and we're set to do so */
 if (ast_test_flag(&snapshot->softhangup_flags, AST_SOFTHANGUP_HANGUP_EXEC)
 && is_cdr_flag_set(CDR_END_BEFORE_H_EXTEN)) {
 cdr_object_finalize(cdr);
 return 0;
 }

 /*
 * Only record the context and extension if we aren't in a subroutine, or if
 * we are executing hangup logic.
 */
 if (!ast_test_flag(&snapshot->flags, AST_FLAG_SUBROUTINE_EXEC)
 || ast_test_flag(&snapshot->softhangup_flags, AST_SOFTHANGUP_HANGUP_EXEC)) {
 if (strcmp(cdr->context, snapshot->dialplan->context)) {
 ast_string_field_set(cdr, context, snapshot->dialplan->context);
 }
 if (strcmp(cdr->exten, snapshot->dialplan->exten)) {
 ast_string_field_set(cdr, exten, snapshot->dialplan->exten);
 }
 }

 cdr_object_swap_snapshot(&cdr->party_a, snapshot);

 /* When Party A is originated to an application and the application exits, the stack
 * will attempt to clear the application and restore the dummy originate application
 * of "AppDialX". Prevent that, and any other application changes we might not want
 * here.
 */
 if (!ast_test_flag(&cdr->flags, AST_CDR_LOCK_APP)
 && !ast_strlen_zero(snapshot->dialplan->appl)
 && (strncasecmp(snapshot->dialplan->appl, "appdial", 7) || ast_strlen_zero(cdr->appl))) {
 if (strcmp(cdr->appl, snapshot->dialplan->appl)) {
 ast_string_field_set(cdr, appl, snapshot->dialplan->appl);
 }
 if (strcmp(cdr->data, snapshot->dialplan->data)) {
 ast_string_field_set(cdr, data, snapshot->dialplan->data);
 }

 /* Dial (app_dial) is a special case. Because pre-dial handlers, which
 * execute before the dial begins, will alter the application/data to
 * something people typically don't want to see, if we see a channel enter
 * into Dial here, we set the appl/data accordingly and lock it.
 */
 if (!strcmp(snapshot->dialplan->appl, "Dial")) {
 ast_set_flag(&cdr->flags, AST_CDR_LOCK_APP);
 }
 }

 if (strcmp(cdr->linkedid, snapshot->peer->linkedid)) {
 ast_string_field_set(cdr, linkedid, snapshot->peer->linkedid);
 }
 cdr_object_check_party_a_answer(cdr);
 cdr_object_check_party_a_hangup(cdr);

 return 0;
}

bridge_candidate_add_to_cdr()

static void bridge_candidate_add_to_cdr ( struct cdr_object *  cdr, struct cdr_object_snapshot *  party_b  )

static

Definition at line 2472 of file cdr.c.

References ast_string_field_set, ast_channel_snapshot::base, cdr_object::bridge, cdr_all_relink(), CDR_DEBUG, cdr_object_check_party_a_answer(), cdr_object_create_and_append(), cdr_object_snapshot_copy(), cdr_object_transition_state(), cdr_object::lastevent, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by bridge_candidate_process().

{
 struct cdr_object *new_cdr;

 new_cdr = cdr_object_create_and_append(cdr, &cdr->lastevent);
 if (!new_cdr) {
 return;
 }
 cdr_object_snapshot_copy(&new_cdr->party_b, party_b);
 cdr_all_relink(new_cdr);
 cdr_object_check_party_a_answer(new_cdr);
 ast_string_field_set(new_cdr, bridge, cdr->bridge);
 cdr_object_transition_state(new_cdr, &bridge_state_fn_table);
 CDR_DEBUG("%p - Party A %s has new Party B %s\n",
 new_cdr, new_cdr->party_a.snapshot->base->name,
 party_b->snapshot->base->name);
}

bridge_candidate_process()

static void bridge_candidate_process ( struct cdr_object *  cdr, struct cdr_object *  base_cand_cdr  )

static

Process a single bridge_candidate.

When a CDR enters a bridge, it needs to make pairings with everyone else that it is not currently paired with. This function determines, for the CDR for the channel that entered the bridge and the CDR for every other channel currently in the bridge, who is Party A and makes new CDRs.

Parameters

cdr	The cdr_obj being processed
cand_cdr	The cdr_object that is a candidate

Definition at line 2503 of file cdr.c.

References ao2_lock, ao2_unlock, ast_channel_snapshot::base, cdr_object::bridge, bridge_candidate_add_to_cdr(), cdr_all_relink(), CDR_DEBUG, cdr_object_pick_party_a(), cdr_object_snapshot_copy(), cdr_object::end, ast_channel_snapshot_base::name, cdr_object::next, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by handle_bridge_pairings().

{
 struct cdr_object_snapshot *party_a;
 struct cdr_object *cand_cdr;

 ao2_lock(base_cand_cdr);

 for (cand_cdr = base_cand_cdr; cand_cdr; cand_cdr = cand_cdr->next) {
 /* Skip any records that are not in this bridge */
 if (strcmp(cand_cdr->bridge, cdr->bridge)) {
 continue;
 }

 /* If the candidate is us or someone we've taken on, pass on by */
 if (!strcasecmp(cdr->party_a.snapshot->base->name, cand_cdr->party_a.snapshot->base->name)
 || (cdr->party_b.snapshot
 && !strcasecmp(cdr->party_b.snapshot->base->name, cand_cdr->party_a.snapshot->base->name))) {
 break;
 }

 party_a = cdr_object_pick_party_a(&cdr->party_a, &cand_cdr->party_a);
 /* We're party A - make a new CDR, append it to us, and set the candidate as
 * Party B */
 if (!strcasecmp(party_a->snapshot->base->name, cdr->party_a.snapshot->base->name)) {
 bridge_candidate_add_to_cdr(cdr, &cand_cdr->party_a);
 break;
 }

 /* We're Party B. Check if we can add ourselves immediately or if we need
 * a new CDR for them (they already have a Party B) */
 if (cand_cdr->party_b.snapshot
 && strcasecmp(cand_cdr->party_b.snapshot->base->name, cdr->party_a.snapshot->base->name)) {
 bridge_candidate_add_to_cdr(cand_cdr, &cdr->party_a);
 } else {
 CDR_DEBUG("%p - Party A %s has new Party B %s\n",
 cand_cdr, cand_cdr->party_a.snapshot->base->name,
 cdr->party_a.snapshot->base->name);
 cdr_object_snapshot_copy(&cand_cdr->party_b, &cdr->party_a);
 cdr_all_relink(cand_cdr);
 /* It's possible that this joined at one point and was never chosen
 * as party A. Clear their end time, as it would be set in such a
 * case.
 */
 memset(&cand_cdr->end, 0, sizeof(cand_cdr->end));
 }

 break;
 }

 ao2_unlock(base_cand_cdr);
}

bridge_state_process_bridge_leave()

static int bridge_state_process_bridge_leave ( struct cdr_object *  cdr, struct ast_bridge_snapshot *  bridge, struct ast_channel_snapshot *  channel  )

static

Definition at line 2015 of file cdr.c.

References ast_channel_snapshot::base, cdr_object::bridge, cdr_object_transition_state(), ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, cdr_object_snapshot::snapshot, and ast_bridge_snapshot::uniqueid.

{
 if (strcmp(cdr->bridge, bridge->uniqueid)) {
 return 1;
 }
 if (strcasecmp(cdr->party_a.snapshot->base->name, channel->base->name)
 && cdr->party_b.snapshot
 && strcasecmp(cdr->party_b.snapshot->base->name, channel->base->name)) {
 return 1;
 }
 cdr_object_transition_state(cdr, &finalized_state_fn_table);

 return 0;
}

bridge_state_process_party_b()

static void bridge_state_process_party_b ( struct cdr_object *  cdr, struct ast_channel_snapshot *  snapshot  )

static

Definition at line 2002 of file cdr.c.

References ast_assert, AST_FLAG_DEAD, ast_test_flag, ast_channel_snapshot::base, cdr_object_swap_snapshot(), cdr_object_transition_state(), ast_channel_snapshot::flags, ast_channel_snapshot_base::name, cdr_object::party_b, and cdr_object_snapshot::snapshot.

{
 ast_assert(cdr->party_b.snapshot
 && !strcasecmp(cdr->party_b.snapshot->base->name, snapshot->base->name));

 cdr_object_swap_snapshot(&cdr->party_b, snapshot);

 /* If party B hangs up, finalize this CDR */
 if (ast_test_flag(&cdr->party_b.snapshot->flags, AST_FLAG_DEAD)) {
 cdr_object_transition_state(cdr, &finalized_state_fn_table);
 }
}

cdr_all_cmp_fn()

static int cdr_all_cmp_fn ( void *  obj, void *  arg, int  flags  )

static

Definition at line 912 of file cdr.c.

References ast_assert, CMP_MATCH, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, OBJ_SEARCH_PARTIAL_KEY, and cdr_object::party_b_name.

Referenced by load_module().

{
 struct cdr_object *left = obj;
 struct cdr_object *right = arg;
 const char *right_key = arg;
 int cmp;

 switch (flags & OBJ_SEARCH_MASK) {
 case OBJ_SEARCH_OBJECT:
 right_key = right->party_b_name;
 /* Fall through */
 case OBJ_SEARCH_KEY:
 cmp = strcasecmp(left->party_b_name, right_key);
 break;
 case OBJ_SEARCH_PARTIAL_KEY:
 /*
 * We could also use a partial key struct containing a length
 * so strlen() does not get called for every comparison instead.
 */
 cmp = strncasecmp(left->party_b_name, right_key, strlen(right_key));
 break;
 default:
 /* Sort can only work on something with a full or partial key. */
 ast_assert(0);
 cmp = 0;
 break;
 }
 return cmp ? 0 : CMP_MATCH;
}

cdr_all_hash_fn()

static int cdr_all_hash_fn ( const void *  obj, const int  flags  )

static

Definition at line 888 of file cdr.c.

References ast_assert, ast_str_case_hash(), OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, and cdr_object::party_b_name.

Referenced by load_module().

{
 const struct cdr_object *cdr;
 const char *key;

 switch (flags & OBJ_SEARCH_MASK) {
 case OBJ_SEARCH_KEY:
 key = obj;
 break;
 case OBJ_SEARCH_OBJECT:
 cdr = obj;
 key = cdr->party_b_name;
 break;
 default:
 ast_assert(0);
 return 0;
 }
 return ast_str_case_hash(key);
}

cdr_all_print_fn()

static void cdr_all_print_fn ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 4472 of file cdr.c.

References ast_channel_snapshot::base, cdr_object::bridge, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by load_module().

{
 struct cdr_object *cdr = v_obj;

 if (!cdr) {
 return;
 }
 prnt(where, "Party A: %s; Party B: %s; Bridge %s",
 cdr->party_a.snapshot->base->name,
 cdr->party_b.snapshot ? cdr->party_b.snapshot->base->name : "<unknown>",
 cdr->bridge);
}

cdr_all_relink()

static void cdr_all_relink ( struct cdr_object *  cdr )

static

Definition at line 949 of file cdr.c.

References ao2_link_flags, ao2_lock, ao2_unlink_flags, ao2_unlock, ast_string_field_set, ast_channel_snapshot::base, ast_channel_snapshot_base::name, OBJ_NOLOCK, cdr_object::party_b, cdr_object::party_b_name, and cdr_object_snapshot::snapshot.

Referenced by ast_cdr_fork(), bridge_candidate_add_to_cdr(), bridge_candidate_process(), single_state_bridge_enter_comparison(), and single_state_process_dial_begin().

{
 ao2_lock(active_cdrs_all);
 if (cdr->party_b.snapshot) {
 if (strcasecmp(cdr->party_b_name, cdr->party_b.snapshot->base->name)) {
 ao2_unlink_flags(active_cdrs_all, cdr, OBJ_NOLOCK);
 ast_string_field_set(cdr, party_b_name, cdr->party_b.snapshot->base->name);
 ao2_link_flags(active_cdrs_all, cdr, OBJ_NOLOCK);
 }
 } else {
 ao2_unlink_flags(active_cdrs_all, cdr, OBJ_NOLOCK);
 ast_string_field_set(cdr, party_b_name, "");
 }
 ao2_unlock(active_cdrs_all);
}

cdr_all_unlink()

static void cdr_all_unlink ( struct cdr_object *  cdr )

static

Definition at line 972 of file cdr.c.

References ao2_lock, ao2_ref, ao2_unlink_flags, ao2_unlock, ast_assert, ast_string_field_set, cdr_object::is_root, cdr_object::next, OBJ_NOLOCK, and cdr_object::party_b_name.

Referenced by cdr_object_dispatch_all_cb(), and handle_channel_snapshot_update_message().

{
 struct cdr_object *cur;
 struct cdr_object *next;

 ast_assert(cdr->is_root);

 /* Hold a ref to the root CDR to ensure the list members don't go away on us. */
 ao2_ref(cdr, +1);
 ao2_lock(active_cdrs_all);
 for (cur = cdr; cur; cur = next) {
 next = cur->next;
 ao2_unlink_flags(active_cdrs_all, cur, OBJ_NOLOCK);
 /*
 * It is safe to still use cur after unlinking because the
 * root CDR holds a ref to all the CDRs in the list and we
 * have a ref to the root CDR.
 */
 ast_string_field_set(cur, party_b_name, "");
 }
 ao2_unlock(active_cdrs_all);
 ao2_ref(cdr, -1);
}

cdr_detach()

static void cdr_detach ( struct ast_cdr *  cdr )

static

Definition at line 3841 of file cdr.c.

References ao2_cleanup, ao2_global_obj_ref, ast_calloc, ast_cdr_free(), ast_debug, ast_mutex_lock, ast_mutex_unlock, ast_test_flag, batch, cdr_batch_item::cdr, cdr_batch_lock, CDR_BATCHMODE, CDR_ENABLED, cdr_batch::head, init_batch(), cdr_batch_item::next, post_cdr(), RAII_VAR, cdr_batch::size, start_batch_mode(), and cdr_batch::tail.

Referenced by cdr_object_dispatch().

{
 struct cdr_batch_item *newtail;
 int curr;
 RAII_VAR(struct module_config *, mod_cfg, ao2_global_obj_ref(module_configs), ao2_cleanup);
 int submit_batch = 0;

 if (!cdr) {
 return;
 }

 /* maybe they disabled CDR stuff completely, so just drop it */
 if (!mod_cfg || !ast_test_flag(&mod_cfg->general->settings, CDR_ENABLED)) {
 ast_debug(1, "Dropping CDR !\n");
 ast_cdr_free(cdr);
 return;
 }

 /* post stuff immediately if we are not in batch mode, this is legacy behaviour */
 if (!ast_test_flag(&mod_cfg->general->settings, CDR_BATCHMODE)) {
 post_cdr(cdr);
 ast_cdr_free(cdr);
 return;
 }

 /* otherwise, each CDR gets put into a batch list (at the end) */
 ast_debug(1, "CDR detaching from this thread\n");

 /* we'll need a new tail for every CDR */
 if (!(newtail = ast_calloc(1, sizeof(*newtail)))) {
 post_cdr(cdr);
 ast_cdr_free(cdr);
 return;
 }

 /* don't traverse a whole list (just keep track of the tail) */
 ast_mutex_lock(&cdr_batch_lock);
 if (!batch)
 init_batch();
 if (!batch->head) {
 /* new batch is empty, so point the head at the new tail */
 batch->head = newtail;
 } else {
 /* already got a batch with something in it, so just append a new tail */
 batch->tail->next = newtail;
 }
 newtail->cdr = cdr;
 batch->tail = newtail;
 curr = batch->size++;

 /* if we have enough stuff to post, then do it */
 if (curr >= (mod_cfg->general->batch_settings.size - 1)) {
 submit_batch = 1;
 }
 ast_mutex_unlock(&cdr_batch_lock);

 /* Don't submit a batch with cdr_batch_lock held */
 if (submit_batch) {
 start_batch_mode();
 }
}

cdr_enable_batch_mode()

static void cdr_enable_batch_mode ( struct ast_cdr_config *  config )

static

Definition at line 4416 of file cdr.c.

References ast_cond_init, ast_log, ast_pthread_create_background, AST_PTHREADT_NULL, ast_cdr_config::batch_settings, cdr_pending_cond, cdr_thread, do_cdr(), LOG_ERROR, LOG_NOTICE, NULL, ast_cdr_config::batch_settings::size, start_batch_mode(), and ast_cdr_config::batch_settings::time.

Referenced by cdr_toggle_runtime_options().

{
 /* Only create the thread level portions once */
 if (cdr_thread == AST_PTHREADT_NULL) {
 ast_cond_init(&cdr_pending_cond, NULL);
 if (ast_pthread_create_background(&cdr_thread, NULL, do_cdr, NULL) < 0) {
 ast_log(LOG_ERROR, "Unable to start CDR thread.\n");
 return;
 }
 }

 /* Start the batching process */
 start_batch_mode();

 ast_log(LOG_NOTICE, "CDR batch mode logging enabled, first of either size %u or time %u seconds.\n",
 config->batch_settings.size, config->batch_settings.time);
}

cdr_engine_shutdown()

static void cdr_engine_shutdown ( void  )

static

Definition at line 4385 of file cdr.c.

References aco_info_destroy(), ao2_callback, ao2_cleanup, ao2_container_unregister(), ao2_global_obj_release, ARRAY_LEN, ast_cli_unregister_multiple(), ast_free, ast_sched_context_destroy(), batch, cdr_object_dispatch_all_cb(), finalize_batch_mode(), NULL, OBJ_MULTIPLE, OBJ_NODATA, OBJ_UNLINK, stasis_message_router_unsubscribe_and_join(), and STASIS_MESSAGE_TYPE_CLEANUP.

Referenced by load_module().

{
 stasis_message_router_unsubscribe_and_join(stasis_router);
 stasis_router = NULL;

 ao2_cleanup(cdr_topic);
 cdr_topic = NULL;

 STASIS_MESSAGE_TYPE_CLEANUP(cdr_sync_message_type);

 ao2_callback(active_cdrs_master, OBJ_NODATA | OBJ_MULTIPLE | OBJ_UNLINK,
 cdr_object_dispatch_all_cb, NULL);
 finalize_batch_mode();
 ast_cli_unregister_multiple(cli_commands, ARRAY_LEN(cli_commands));
 ast_sched_context_destroy(sched);
 sched = NULL;
 ast_free(batch);
 batch = NULL;

 aco_info_destroy(&cfg_info);
 ao2_global_obj_release(module_configs);

 ao2_container_unregister("cdrs_master");
 ao2_cleanup(active_cdrs_master);
 active_cdrs_master = NULL;

 ao2_container_unregister("cdrs_all");
 ao2_cleanup(active_cdrs_all);
 active_cdrs_all = NULL;
}

cdr_format_var_internal()

static const char* cdr_format_var_internal ( struct ast_cdr *  cdr, const char *  name  )

static

Definition at line 3018 of file cdr.c.

References AST_LIST_TRAVERSE, ast_strlen_zero, ast_var_name(), ast_var_value(), ast_var_t::entries, NULL, and ast_cdr::varshead.

Referenced by ast_cdr_format_var().

{
 struct ast_var_t *variables;

 if (ast_strlen_zero(name)) {
 return NULL;
 }

 AST_LIST_TRAVERSE(&cdr->varshead, variables, entries) {
 if (!strcasecmp(name, ast_var_name(variables))) {
 return ast_var_value(variables);
 }
 }

 return NULL;
}

cdr_generic_register()

static int cdr_generic_register ( struct be_list *  generic_list, const char *  name, const char *  desc, ast_cdrbe  be  )

static

Definition at line 2902 of file cdr.c.

References ast_calloc, ast_copy_string(), ast_free, ast_log, AST_RWLIST_INSERT_HEAD, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, be, cdr_beitem::be, cdr_beitem::desc, LOG_WARNING, and cdr_beitem::name.

Referenced by ast_cdr_modifier_register(), and ast_cdr_register().

{
 struct cdr_beitem *i;
 struct cdr_beitem *cur;

 if (!name) {
 return -1;
 }

 if (!be) {
 ast_log(LOG_WARNING, "CDR engine '%s' lacks backend\n", name);

 return -1;
 }

 i = ast_calloc(1, sizeof(*i));
 if (!i) {
 return -1;
 }

 i->be = be;
 ast_copy_string(i->name, name, sizeof(i->name));
 ast_copy_string(i->desc, desc, sizeof(i->desc));

 AST_RWLIST_WRLOCK(generic_list);
 AST_RWLIST_TRAVERSE(generic_list, cur, list) {
 if (!strcasecmp(name, cur->name)) {
 ast_log(LOG_WARNING, "Already have a CDR backend called '%s'\n", name);
 AST_RWLIST_UNLOCK(generic_list);
 ast_free(i);

 return -1;
 }
 }

 AST_RWLIST_INSERT_HEAD(generic_list, i, list);
 AST_RWLIST_UNLOCK(generic_list);

 return 0;
}

cdr_get_tv()

static void cdr_get_tv ( struct timeval  when, const char *  fmt, char *  buf, int  bufsize  )

static

Definition at line 3035 of file cdr.c.

References ast_localtime(), ast_strftime(), and NULL.

Referenced by ast_cdr_format_var(), cdr_object_format_property(), cli_show_channel(), and cli_show_channels().

{
 if (fmt == NULL) { /* raw mode */
 snprintf(buf, bufsize, "%ld.%06ld", (long)when.tv_sec, (long)when.tv_usec);
 } else {
 buf[0] = '\0';/* Ensure the buffer is initialized. */
 if (when.tv_sec) {
 struct ast_tm tm;

 ast_localtime(&when, &tm, NULL);
 ast_strftime(buf, bufsize, fmt, &tm);
 }
 }
}

cdr_master_cmp_fn()

static int cdr_master_cmp_fn ( void *  obj, void *  arg, int  flags  )

static

Definition at line 854 of file cdr.c.

References ast_assert, CMP_MATCH, OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, OBJ_SEARCH_PARTIAL_KEY, and cdr_object::uniqueid.

Referenced by load_module().

{
 struct cdr_object *left = obj;
 struct cdr_object *right = arg;
 const char *right_key = arg;
 int cmp;

 switch (flags & OBJ_SEARCH_MASK) {
 case OBJ_SEARCH_OBJECT:
 right_key = right->uniqueid;
 /* Fall through */
 case OBJ_SEARCH_KEY:
 cmp = strcmp(left->uniqueid, right_key);
 break;
 case OBJ_SEARCH_PARTIAL_KEY:
 /*
 * We could also use a partial key struct containing a length
 * so strlen() does not get called for every comparison instead.
 */
 cmp = strncmp(left->uniqueid, right_key, strlen(right_key));
 break;
 default:
 /* Sort can only work on something with a full or partial key. */
 ast_assert(0);
 cmp = 0;
 break;
 }
 return cmp ? 0 : CMP_MATCH;
}

cdr_master_hash_fn()

static int cdr_master_hash_fn ( const void *  obj, const int  flags  )

static

Definition at line 830 of file cdr.c.

References ast_assert, ast_str_case_hash(), OBJ_SEARCH_KEY, OBJ_SEARCH_MASK, OBJ_SEARCH_OBJECT, and cdr_object::uniqueid.

Referenced by load_module().

{
 const struct cdr_object *cdr;
 const char *key;

 switch (flags & OBJ_SEARCH_MASK) {
 case OBJ_SEARCH_KEY:
 key = obj;
 break;
 case OBJ_SEARCH_OBJECT:
 cdr = obj;
 key = cdr->uniqueid;
 break;
 default:
 ast_assert(0);
 return 0;
 }
 return ast_str_case_hash(key);
}

cdr_master_print_fn()

static void cdr_master_print_fn ( void *  v_obj, void *  where, ao2_prnt_fn *  prnt  )

static

Definition at line 4445 of file cdr.c.

References ast_channel_snapshot::base, cdr_object::bridge, ast_channel_snapshot_base::name, cdr_object::next, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by load_module().

{
 struct cdr_object *cdr = v_obj;
 struct cdr_object *it_cdr;

 if (!cdr) {
 return;
 }
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 prnt(where, "Party A: %s; Party B: %s; Bridge %s\n",
 it_cdr->party_a.snapshot->base->name,
 it_cdr->party_b.snapshot ? it_cdr->party_b.snapshot->base->name : "<unknown>",
 it_cdr->bridge);
 }
}

cdr_object_alloc()

static struct cdr_object* cdr_object_alloc ( struct ast_channel_snapshot *  chan, const struct timeval *  event_time  )

static

cdr_object constructor

Parameters

chan	The ast_channel_snapshot that is the CDR's Party A

This implicitly sets the state of the newly created CDR to the Single state (single_state_fn_table)

Definition at line 1039 of file cdr.c.

References ao2_alloc, ao2_cleanup, ao2_t_ref, ast_assert, ast_atomic_fetchadd_int(), AST_CDR_NULL, ast_string_field_init, ast_string_field_set, ast_channel_snapshot::base, CDR_DEBUG, cdr_object_dtor(), cdr_object_transition_state(), cdr_object::disposition, global_cdr_sequence, cdr_object::last, cdr_object::lastevent, ast_channel_snapshot_peer::linkedid, cdr_object::linkedid, name, ast_channel_snapshot_base::name, NULL, cdr_object::party_a, ast_channel_snapshot::peer, cdr_object::sequence, cdr_object_snapshot::snapshot, ast_channel_snapshot_base::uniqueid, and cdr_object::uniqueid.

Referenced by cdr_object_create_and_append(), and handle_channel_snapshot_update_message().

{
 struct cdr_object *cdr;

 ast_assert(chan != NULL);

 cdr = ao2_alloc(sizeof(*cdr), cdr_object_dtor);
 if (!cdr) {
 return NULL;
 }
 cdr->last = cdr;
 if (ast_string_field_init(cdr, 64)) {
 ao2_cleanup(cdr);
 return NULL;
 }
 ast_string_field_set(cdr, uniqueid, chan->base->uniqueid);
 ast_string_field_set(cdr, name, chan->base->name);
 ast_string_field_set(cdr, linkedid, chan->peer->linkedid);
 cdr->disposition = AST_CDR_NULL;
 cdr->sequence = ast_atomic_fetchadd_int(&global_cdr_sequence, +1);
 cdr->lastevent = *event_time;

 cdr->party_a.snapshot = chan;
 ao2_t_ref(cdr->party_a.snapshot, +1, "bump snapshot during CDR creation");

 CDR_DEBUG("%p - Created CDR for channel %s\n", cdr, chan->base->name);

 cdr_object_transition_state(cdr, &single_state_fn_table);

 return cdr;
}

cdr_object_check_party_a_answer()

static void cdr_object_check_party_a_answer ( struct cdr_object *  cdr )

static

Check to see if a CDR needs to be answered based on its Party A. Note that this is safe to call as much as you want - we won't answer twice.

Definition at line 1494 of file cdr.c.

References cdr_object::answer, AST_STATE_UP, ast_tvzero(), CDR_DEBUG, cdr_object::lastevent, cdr_object::party_a, cdr_object_snapshot::snapshot, and ast_channel_snapshot::state.

Referenced by ast_cdr_reset(), base_process_party_a(), bridge_candidate_add_to_cdr(), and single_state_init_function().

{
 if (cdr->party_a.snapshot->state == AST_STATE_UP && ast_tvzero(cdr->answer)) {
 cdr->answer = cdr->lastevent;
 /* tv_usec is suseconds_t, which could be int or long */
 CDR_DEBUG("%p - Set answered time to %ld.%06ld\n", cdr,
 (long)cdr->answer.tv_sec,
 (long)cdr->answer.tv_usec);
 }
}

cdr_object_check_party_a_hangup()

static void cdr_object_check_party_a_hangup ( struct cdr_object *  cdr )

static

Check to see if a CDR needs to move to the finalized state because its Party A hungup.

Definition at line 1477 of file cdr.c.

References AST_FLAG_DEAD, AST_SOFTHANGUP_HANGUP_EXEC, ast_test_flag, CDR_END_BEFORE_H_EXTEN, cdr_object_finalize(), cdr_object_transition_state(), ast_channel_snapshot::flags, cdr_object::fn_table, is_cdr_flag_set(), cdr_object::party_a, cdr_object_snapshot::snapshot, and ast_channel_snapshot::softhangup_flags.

Referenced by base_process_party_a().

{
 if (ast_test_flag(&cdr->party_a.snapshot->softhangup_flags, AST_SOFTHANGUP_HANGUP_EXEC)
 && is_cdr_flag_set(CDR_END_BEFORE_H_EXTEN)) {
 cdr_object_finalize(cdr);
 }

 if (ast_test_flag(&cdr->party_a.snapshot->flags, AST_FLAG_DEAD)
 && cdr->fn_table != &finalized_state_fn_table) {
 cdr_object_transition_state(cdr, &finalized_state_fn_table);
 }
}

cdr_object_create_and_append()

static struct cdr_object* cdr_object_create_and_append ( struct cdr_object *  cdr, const struct timeval *  event_time  )

static

Create a new cdr_object and append it to an existing chain.

Parameters

cdr	The cdr_object to append to

Definition at line 1075 of file cdr.c.

References cdr_object::appl, AST_CDR_FLAG_DISABLE_ALL, AST_CDR_NULL, ast_set_flag, ast_string_field_set, ast_test_flag, cdr_object_alloc(), cdr_object_snapshot_copy(), context, cdr_object::context, cdr_object::data, cdr_object::disposition, exten, cdr_object::exten, cdr_object::flags, cdr_object::last, cdr_object::linkedid, cdr_object::next, NULL, cdr_object::party_a, and cdr_object_snapshot::snapshot.

Referenced by ast_cdr_fork(), bridge_candidate_add_to_cdr(), handle_channel_snapshot_update_message(), handle_dial_message(), handle_parked_call_message(), handle_parking_bridge_enter_message(), and handle_standard_bridge_enter_message().

{
 struct cdr_object *new_cdr;
 struct cdr_object *it_cdr;
 struct cdr_object *cdr_last;

 cdr_last = cdr->last;
 new_cdr = cdr_object_alloc(cdr_last->party_a.snapshot, event_time);
 if (!new_cdr) {
 return NULL;
 }
 new_cdr->disposition = AST_CDR_NULL;

 /* Copy over the linkedid, as it may have changed */
 ast_string_field_set(new_cdr, linkedid, cdr_last->linkedid);
 ast_string_field_set(new_cdr, appl, cdr_last->appl);
 ast_string_field_set(new_cdr, data, cdr_last->data);
 ast_string_field_set(new_cdr, context, cdr_last->context);
 ast_string_field_set(new_cdr, exten, cdr_last->exten);

 /*
 * If the current CDR says to disable all future ones,
 * keep the disable chain going
 */
 if (ast_test_flag(&cdr_last->flags, AST_CDR_FLAG_DISABLE_ALL)) {
 ast_set_flag(&new_cdr->flags, AST_CDR_FLAG_DISABLE_ALL);
 }

 /* Copy over other Party A information */
 cdr_object_snapshot_copy(&new_cdr->party_a, &cdr_last->party_a);

 /* Append the CDR to the end of the list */
 for (it_cdr = cdr; it_cdr->next; it_cdr = it_cdr->next) {
 it_cdr->last = new_cdr;
 }
 it_cdr->last = new_cdr;
 it_cdr->next = new_cdr;

 return new_cdr;
}

cdr_object_create_public_records()

static struct ast_cdr* cdr_object_create_public_records ( struct cdr_object *  cdr )

static

Create a chain of ast_cdr objects from a chain of cdr_object suitable for consumption by the registered CDR backends.

Parameters

cdr	The cdr_object to convert to a public record

Return values

A	chain of ast_cdr objects on success
NULL	on failure

Definition at line 1287 of file cdr.c.

References ast_channel_snapshot_base::accountcode, ast_cdr::accountcode, ast_channel_snapshot::amaflags, ast_cdr::amaflags, ast_cdr::answer, cdr_object::answer, cdr_object::appl, ast_assert, ast_callerid_merge(), ast_calloc, ast_copy_flags, ast_copy_string(), ast_debug, AST_FLAGS_ALL, ast_free, AST_LIST_INSERT_TAIL, AST_LIST_TRAVERSE, ast_strlen_zero, ast_var_assign, ast_var_name(), ast_var_value(), ast_channel_snapshot::base, ast_cdr::billsec, ast_channel_snapshot::caller, cdr_object_get_billsec(), cdr_object_get_duration(), ast_cdr::channel, ast_cdr::clid, cdr_object::context, copy_variables(), cdr_object::data, ast_cdr::dcontext, ast_cdr::disposition, cdr_object::disposition, ast_cdr::dst, ast_cdr::dstchannel, ast_cdr::duration, ast_cdr::end, cdr_object::end, ast_var_t::entries, cdr_object::exten, cdr_object::flags, ast_cdr::lastapp, ast_cdr::lastdata, ast_cdr::linkedid, cdr_object::linkedid, ast_channel_snapshot_caller::name, ast_channel_snapshot_base::name, ast_cdr::next, cdr_object::next, NULL, ast_channel_snapshot_caller::number, cdr_object::party_a, cdr_object::party_b, ast_cdr::peeraccount, ast_cdr::sequence, cdr_object::sequence, cdr_object_snapshot::snapshot, snapshot_is_dialed(), ast_cdr::src, ast_cdr::start, cdr_object::start, ast_channel_snapshot_base::uniqueid, ast_cdr::uniqueid, ast_cdr::userfield, cdr_object_snapshot::userfield, cdr_object_snapshot::variables, and ast_cdr::varshead.

Referenced by cdr_object_dispatch().

{
 struct ast_cdr *pub_cdr = NULL, *cdr_prev = NULL;
 struct cdr_object *it_cdr;
 struct ast_var_t *it_var, *it_copy_var;
 struct ast_channel_snapshot *party_a;
 struct ast_channel_snapshot *party_b;

 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 struct ast_cdr *cdr_copy;

 /* Don't create records for CDRs where the party A was a dialed channel */
 if (snapshot_is_dialed(it_cdr->party_a.snapshot) && !it_cdr->party_b.snapshot) {
 ast_debug(1, "CDR for %s is dialed and has no Party B; discarding\n",
 it_cdr->party_a.snapshot->base->name);
 continue;
 }

 cdr_copy = ast_calloc(1, sizeof(*cdr_copy));
 if (!cdr_copy) {
 ast_free(pub_cdr);
 return NULL;
 }

 party_a = it_cdr->party_a.snapshot;
 party_b = it_cdr->party_b.snapshot;

 /* Party A */
 ast_assert(party_a != NULL);
 ast_copy_string(cdr_copy->accountcode, party_a->base->accountcode, sizeof(cdr_copy->accountcode));
 cdr_copy->amaflags = party_a->amaflags;
 ast_copy_string(cdr_copy->channel, party_a->base->name, sizeof(cdr_copy->channel));
 ast_callerid_merge(cdr_copy->clid, sizeof(cdr_copy->clid), party_a->caller->name, party_a->caller->number, "");
 ast_copy_string(cdr_copy->src, party_a->caller->number, sizeof(cdr_copy->src));
 ast_copy_string(cdr_copy->uniqueid, party_a->base->uniqueid, sizeof(cdr_copy->uniqueid));
 ast_copy_string(cdr_copy->lastapp, it_cdr->appl, sizeof(cdr_copy->lastapp));
 ast_copy_string(cdr_copy->lastdata, it_cdr->data, sizeof(cdr_copy->lastdata));
 ast_copy_string(cdr_copy->dst, it_cdr->exten, sizeof(cdr_copy->dst));
 ast_copy_string(cdr_copy->dcontext, it_cdr->context, sizeof(cdr_copy->dcontext));

 /* Party B */
 if (party_b) {
 ast_copy_string(cdr_copy->dstchannel, party_b->base->name, sizeof(cdr_copy->dstchannel));
 ast_copy_string(cdr_copy->peeraccount, party_b->base->accountcode, sizeof(cdr_copy->peeraccount));
 if (!ast_strlen_zero(it_cdr->party_b.userfield)) {
 snprintf(cdr_copy->userfield, sizeof(cdr_copy->userfield), "%s;%s", it_cdr->party_a.userfield, it_cdr->party_b.userfield);
 }
 }
 if (ast_strlen_zero(cdr_copy->userfield) && !ast_strlen_zero(it_cdr->party_a.userfield)) {
 ast_copy_string(cdr_copy->userfield, it_cdr->party_a.userfield, sizeof(cdr_copy->userfield));
 }

 /* Timestamps/durations */
 cdr_copy->start = it_cdr->start;
 cdr_copy->answer = it_cdr->answer;
 cdr_copy->end = it_cdr->end;
 cdr_copy->billsec = cdr_object_get_billsec(it_cdr);
 cdr_copy->duration = cdr_object_get_duration(it_cdr);

 /* Flags and IDs */
 ast_copy_flags(cdr_copy, &it_cdr->flags, AST_FLAGS_ALL);
 ast_copy_string(cdr_copy->linkedid, it_cdr->linkedid, sizeof(cdr_copy->linkedid));
 cdr_copy->disposition = it_cdr->disposition;
 cdr_copy->sequence = it_cdr->sequence;

 /* Variables */
 copy_variables(&cdr_copy->varshead, &it_cdr->party_a.variables);
 AST_LIST_TRAVERSE(&it_cdr->party_b.variables, it_var, entries) {
 int found = 0;
 struct ast_var_t *newvariable;
 AST_LIST_TRAVERSE(&cdr_copy->varshead, it_copy_var, entries) {
 if (!strcasecmp(ast_var_name(it_var), ast_var_name(it_copy_var))) {
 found = 1;
 break;
 }
 }
 if (!found && (newvariable = ast_var_assign(ast_var_name(it_var), ast_var_value(it_var)))) {
 AST_LIST_INSERT_TAIL(&cdr_copy->varshead, newvariable, entries);
 }
 }

 if (!pub_cdr) {
 pub_cdr = cdr_copy;
 cdr_prev = pub_cdr;
 } else {
 cdr_prev->next = cdr_copy;
 cdr_prev = cdr_copy;
 }
 }

 return pub_cdr;
}

cdr_object_dispatch()

static void cdr_object_dispatch ( struct cdr_object *  cdr )

static

Dispatch a CDR.

Parameters

cdr	The cdr_object to dispatch

This will create a ast_cdr object and publish it to the various backends

Definition at line 1386 of file cdr.c.

References ast_channel_snapshot::base, CDR_DEBUG, cdr_detach(), cdr_object_create_public_records(), ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by cdr_object_dispatch_all_cb(), and handle_channel_snapshot_update_message().

{
 struct ast_cdr *pub_cdr;

 CDR_DEBUG("%p - Dispatching CDR for Party A %s, Party B %s\n", cdr,
 cdr->party_a.snapshot->base->name,
 cdr->party_b.snapshot ? cdr->party_b.snapshot->base->name : "<none>");
 pub_cdr = cdr_object_create_public_records(cdr);
 cdr_detach(pub_cdr);
}

cdr_object_dispatch_all_cb()

static int cdr_object_dispatch_all_cb ( void *  obj, void *  arg, int  flags  )

static

This dispatches all cdr_objects. It should only be used during shutdown, so that we get billing records for everything that we can.

Definition at line 4260 of file cdr.c.

References ao2_lock, ao2_unlock, cdr_all_unlink(), cdr_object_dispatch(), cdr_object_transition_state(), CMP_MATCH, and cdr_object::next.

Referenced by cdr_engine_shutdown().

{
 struct cdr_object *cdr = obj;
 struct cdr_object *it_cdr;

 ao2_lock(cdr);
 for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
 cdr_object_transition_state(it_cdr, &finalized_state_fn_table);
 }
 cdr_object_dispatch(cdr);
 ao2_unlock(cdr);

 cdr_all_unlink(cdr);

 return CMP_MATCH;
}

cdr_object_dtor()

static void cdr_object_dtor ( void *  obj )

static

cdr_object Destructor

Definition at line 999 of file cdr.c.

References ao2_cleanup, AST_LIST_REMOVE_HEAD, ast_string_field_free_memory, ast_var_delete(), ast_var_t::entries, cdr_object::is_root, cdr_object::next, cdr_object::party_a, cdr_object::party_b, cdr_object_snapshot::snapshot, and cdr_object_snapshot::variables.

Referenced by cdr_object_alloc().

{
 struct cdr_object *cdr = obj;
 struct ast_var_t *it_var;

 ao2_cleanup(cdr->party_a.snapshot);
 ao2_cleanup(cdr->party_b.snapshot);
 while ((it_var = AST_LIST_REMOVE_HEAD(&cdr->party_a.variables, entries))) {
 ast_var_delete(it_var);
 }
 while ((it_var = AST_LIST_REMOVE_HEAD(&cdr->party_b.variables, entries))) {
 ast_var_delete(it_var);
 }
 ast_string_field_free_memory(cdr);

 /* CDR destruction used to work by calling ao2_cleanup(next) and
 * allowing the chain to destroy itself neatly. Unfortunately, for
 * really long chains, this can result in a stack overflow. So now
 * when the root CDR is destroyed, it is responsible for unreffing
 * all CDRs in the chain
 */
 if (cdr->is_root) {
 struct cdr_object *curr = cdr->next;
 struct cdr_object *next;

 while (curr) {
 next = curr->next;
 ao2_cleanup(curr);
 curr = next;
 }
 }
}

cdr_object_finalize()

static void cdr_object_finalize ( struct cdr_object *  cdr )

static

Finalize a CDR.

This function is safe to call multiple times. Note that you can call this explicitly before going to the finalized state if there's a chance the CDR will be re-activated, in which case the cdr_object's end time should be cleared. This function is implicitly called when a CDR transitions to the finalized state and right before it is dispatched

Parameters

cdr_object

The CDR to finalize

Definition at line 1440 of file cdr.c.

References cdr_object::answer, AST_CDR_ANSWERED, ast_cdr_disp2str(), AST_CDR_FAILED, AST_CDR_NULL, ast_debug, ast_tvdiff_ms(), ast_tvzero(), ast_channel_snapshot::base, ast_channel_snapshot_hangup::cause, cdr_object_set_disposition(), cdr_object::disposition, cdr_object::end, ast_channel_snapshot::hangup, cdr_object::lastevent, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, cdr_object_snapshot::snapshot, and cdr_object::start.

Referenced by ast_cdr_fork(), base_process_party_a(), cdr_object_check_party_a_hangup(), cdr_object_finalize_party_b(), cdr_object_party_b_left_bridge_cb(), dial_state_process_bridge_enter(), finalized_state_init_function(), handle_channel_snapshot_update_message(), handle_standard_bridge_enter_message(), and single_state_bridge_enter_comparison().

{
 if (!ast_tvzero(cdr->end)) {
 return;
 }
 cdr->end = cdr->lastevent;

 if (cdr->disposition == AST_CDR_NULL) {
 if (!ast_tvzero(cdr->answer)) {
 cdr->disposition = AST_CDR_ANSWERED;
 } else if (cdr->party_a.snapshot->hangup->cause) {
 cdr_object_set_disposition(cdr, cdr->party_a.snapshot->hangup->cause);
 } else if (cdr->party_b.snapshot && cdr->party_b.snapshot->hangup->cause) {
 cdr_object_set_disposition(cdr, cdr->party_b.snapshot->hangup->cause);
 } else {
 cdr->disposition = AST_CDR_FAILED;
 }
 }

 /* tv_usec is suseconds_t, which could be int or long */
 ast_debug(1, "Finalized CDR for %s - start %ld.%06ld answer %ld.%06ld end %ld.%06ld dur %.3f bill %.3f dispo %s\n",
 cdr->party_a.snapshot->base->name,
 (long)cdr->start.tv_sec,
 (long)cdr->start.tv_usec,
 (long)cdr->answer.tv_sec,
 (long)cdr->answer.tv_usec,
 (long)cdr->end.tv_sec,
 (long)cdr->end.tv_usec,
 (double)ast_tvdiff_ms(cdr->end, cdr->start) / 1000.0,
 (double)ast_tvdiff_ms(cdr->end, cdr->answer) / 1000.0,
 ast_cdr_disp2str(cdr->disposition));
}

cdr_object_finalize_party_b()

static int cdr_object_finalize_party_b ( void *  obj, void *  arg, void *  data, int  flags  )

static

Definition at line 2196 of file cdr.c.

References ast_assert, ast_channel_snapshot::base, cdr_object_finalize(), ast_channel_snapshot_base::name, cdr_object::party_b, cdr_object::party_b_name, and cdr_object_snapshot::snapshot.

Referenced by handle_channel_snapshot_update_message().

{
 struct cdr_object *cdr = obj;

 if (!strcasecmp(cdr->party_b_name, arg)) {
#ifdef AST_DEVMODE
 struct ast_channel_snapshot *party_b = data;

 /*
 * For sanity's sake we also assert the party_b snapshot
 * is consistent with the key.
 */
 ast_assert(cdr->party_b.snapshot
 && !strcasecmp(cdr->party_b.snapshot->base->name, party_b->base->name));
#endif

 /* Don't transition to the finalized state - let the Party A do
 * that when its ready
 */
 cdr_object_finalize(cdr);
 }
 return 0;
}

cdr_object_format_property()

static int cdr_object_format_property ( struct cdr_object *  cdr_obj, const char *  name, char *  value, size_t  length  )

static

Format one of the standard properties on a cdr_object.

Definition at line 3243 of file cdr.c.

References ast_channel_snapshot_base::accountcode, ast_channel_snapshot::amaflags, cdr_object::answer, ast_channel_snapshot_dialplan::appl, ast_callerid_merge(), ast_copy_string(), ast_channel_snapshot::base, ast_channel_snapshot::caller, cdr_get_tv(), cdr_object_get_billsec(), cdr_object_get_duration(), ast_channel_snapshot_dialplan::context, ast_channel_snapshot_dialplan::data, ast_channel_snapshot::dialplan, cdr_object::disposition, cdr_object::end, ast_channel_snapshot_dialplan::exten, cdr_object::linkedid, ast_channel_snapshot_caller::name, ast_channel_snapshot_base::name, NULL, ast_channel_snapshot_caller::number, cdr_object::party_a, cdr_object::party_b, cdr_object::sequence, cdr_object_snapshot::snapshot, cdr_object::start, ast_channel_snapshot_base::uniqueid, and cdr_object_snapshot::userfield.

Referenced by ast_cdr_getvar(), and ast_cdr_serialize_variables().

{
 struct ast_channel_snapshot *party_a = cdr_obj->party_a.snapshot;
 struct ast_channel_snapshot *party_b = cdr_obj->party_b.snapshot;

 if (!strcasecmp(name, "clid")) {
 ast_callerid_merge(value, length, party_a->caller->name, party_a->caller->number, "");
 } else if (!strcasecmp(name, "src")) {
 ast_copy_string(value, party_a->caller->number, length);
 } else if (!strcasecmp(name, "dst")) {
 ast_copy_string(value, party_a->dialplan->exten, length);
 } else if (!strcasecmp(name, "dcontext")) {
 ast_copy_string(value, party_a->dialplan->context, length);
 } else if (!strcasecmp(name, "channel")) {
 ast_copy_string(value, party_a->base->name, length);
 } else if (!strcasecmp(name, "dstchannel")) {
 if (party_b) {
 ast_copy_string(value, party_b->base->name, length);
 } else {
 ast_copy_string(value, "", length);
 }
 } else if (!strcasecmp(name, "lastapp")) {
 ast_copy_string(value, party_a->dialplan->appl, length);
 } else if (!strcasecmp(name, "lastdata")) {
 ast_copy_string(value, party_a->dialplan->data, length);
 } else if (!strcasecmp(name, "start")) {
 cdr_get_tv(cdr_obj->start, NULL, value, length);
 } else if (!strcasecmp(name, "answer")) {
 cdr_get_tv(cdr_obj->answer, NULL, value, length);
 } else if (!strcasecmp(name, "end")) {
 cdr_get_tv(cdr_obj->end, NULL, value, length);
 } else if (!strcasecmp(name, "duration")) {
 snprintf(value, length, "%ld", cdr_object_get_duration(cdr_obj));
 } else if (!strcasecmp(name, "billsec")) {
 snprintf(value, length, "%ld", cdr_object_get_billsec(cdr_obj));
 } else if (!strcasecmp(name, "disposition")) {
 snprintf(value, length, "%u", cdr_obj->disposition);
 } else if (!strcasecmp(name, "amaflags")) {
 snprintf(value, length, "%d", party_a->amaflags);
 } else if (!strcasecmp(name, "accountcode")) {
 ast_copy_string(value, party_a->base->accountcode, length);
 } else if (!strcasecmp(name, "peeraccount")) {
 if (party_b) {
 ast_copy_string(value, party_b->base->accountcode, length);
 } else {
 ast_copy_string(value, "", length);
 }
 } else if (!strcasecmp(name, "uniqueid")) {
 ast_copy_string(value, party_a->base->uniqueid, length);
 } else if (!strcasecmp(name, "linkedid")) {
 ast_copy_string(value, cdr_obj->linkedid, length);
 } else if (!strcasecmp(name, "userfield")) {
 ast_copy_string(value, cdr_obj->party_a.userfield, length);
 } else if (!strcasecmp(name, "sequence")) {
 snprintf(value, length, "%u", cdr_obj->sequence);
 } else {
 return 1;
 }

 return 0;
}

cdr_object_format_var_internal()

static void cdr_object_format_var_internal ( struct cdr_object *  cdr, const char *  name, char *  value, size_t  length  )

static

Format a variable on a cdr_object.

Definition at line 3226 of file cdr.c.

References ast_copy_string(), AST_LIST_TRAVERSE, ast_var_name(), ast_var_value(), ast_var_t::entries, cdr_object::party_a, and cdr_object_snapshot::variables.

Referenced by ast_cdr_getvar().

{
 struct ast_var_t *variable;

 AST_LIST_TRAVERSE(&cdr->party_a.variables, variable, entries) {
 if (!strcasecmp(name, ast_var_name(variable))) {
 ast_copy_string(value, ast_var_value(variable), length);
 return;
 }
 }

 *value = '\0';
}

cdr_object_get_billsec()

static long cdr_object_get_billsec ( struct cdr_object *  cdr )

static

Compute the billsec for a cdr_object.

Definition at line 1235 of file cdr.c.

References cdr_object::answer, ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), CDR_INITIATED_SECONDS, cdr_object::end, and is_cdr_flag_set().

Referenced by cdr_object_create_public_records(), and cdr_object_format_property().

{
 long int ms;

 if (ast_tvzero(cdr->answer)) {
 return 0;
 }

 ms = ast_tvdiff_ms(ast_tvzero(cdr->end) ? ast_tvnow() : cdr->end, cdr->answer);
 if (ms % 1000 >= 500
 && is_cdr_flag_set(CDR_INITIATED_SECONDS)) {
 ms = (ms / 1000) + 1;
 } else {
 ms = ms / 1000;
 }

 return ms;
}

cdr_object_get_by_name()

static struct cdr_object* cdr_object_get_by_name ( const char *  name )

static

Definition at line 3312 of file cdr.c.

References ao2_callback, ast_strdupa, ast_strlen_zero, cdr_object_get_by_name_cb(), and NULL.

Referenced by ast_cdr_clear_property(), ast_cdr_fork(), ast_cdr_getvar(), ast_cdr_reset(), ast_cdr_serialize_variables(), ast_cdr_set_property(), ast_cdr_setuserfield(), and cli_show_channel().

{
 char *param;

 if (ast_strlen_zero(name)) {
 return NULL;
 }

 param = ast_strdupa(name);
 return ao2_callback(active_cdrs_master, 0, cdr_object_get_by_name_cb, param);
}

cdr_object_get_by_name_cb()

static int cdr_object_get_by_name_cb ( void *  obj, void *  arg, int  flags  )

static

Definition at line 3142 of file cdr.c.

References ast_channel_snapshot::base, CMP_MATCH, name, ast_channel_snapshot_base::name, cdr_object::party_a, and cdr_object_snapshot::snapshot.

Referenced by cdr_object_get_by_name().

{
 struct cdr_object *cdr = obj;
 const char *name = arg;

 if (!strcasecmp(cdr->party_a.snapshot->base->name, name)) {
 return CMP_MATCH;
 }
 return 0;
}

cdr_object_get_duration()

static long cdr_object_get_duration ( struct cdr_object *  cdr )

static

Compute the duration for a cdr_object

Definition at line 1227 of file cdr.c.

References ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), cdr_object::end, and cdr_object::start.

Referenced by cdr_object_create_public_records(), and cdr_object_format_property().

{
 return (long)(ast_tvdiff_ms(ast_tvzero(cdr->end) ? ast_tvnow() : cdr->end, cdr->start) / 1000);
}

cdr_object_party_b_left_bridge_cb()

static int cdr_object_party_b_left_bridge_cb ( void *  obj, void *  arg, void *  data, int  flags  )

static

Callback used to notify CDRs of a Party B leaving the bridge.

Definition at line 2361 of file cdr.c.

References ast_assert, ast_channel_snapshot::base, cdr_object::bridge, bridge_leave_data::bridge, cdr_object_finalize(), bridge_leave_data::channel, cdr_object::fn_table, cdr_object::lastevent, bridge_leave_data::lastevent, ast_channel_snapshot_base::name, cdr_object::party_b, cdr_object::party_b_name, cdr_object_snapshot::snapshot, and ast_bridge_snapshot::uniqueid.

Referenced by handle_bridge_leave_message().

{
 struct cdr_object *cdr = obj;
 struct bridge_leave_data *leave_data = data;

 if (cdr->fn_table == &bridge_state_fn_table
 && !strcmp(cdr->bridge, leave_data->bridge->uniqueid)
 && !strcasecmp(cdr->party_b_name, arg)) {
 /*
 * For sanity's sake we also assert the party_b snapshot
 * is consistent with the key.
 */
 ast_assert(cdr->party_b.snapshot
 && !strcasecmp(cdr->party_b.snapshot->base->name, leave_data->channel->base->name));

 /* It is our Party B, in our bridge. Set the last event and let the handler
 * transition our CDR appropriately when we leave the bridge.
 */
 cdr->lastevent = *leave_data->lastevent;
 cdr_object_finalize(cdr);
 }
 return 0;
}

cdr_object_pick_party_a()

static struct cdr_object_snapshot* cdr_object_pick_party_a ( struct cdr_object_snapshot *  left, struct cdr_object_snapshot *  right  )

static

Given two CDR snapshots, figure out who should be Party A for the resulting CDR.

Parameters

left	One of the snapshots
right	The other snapshot

Return values

The	snapshot that won

Definition at line 1192 of file cdr.c.

References AST_CDR_FLAG_PARTY_A, ast_test_flag, ast_channel_snapshot::base, ast_channel_snapshot_base::creationtime, cdr_object_snapshot::snapshot, and snapshot_is_dialed().

Referenced by bridge_candidate_process(), and single_state_bridge_enter_comparison().

{
 /* Check whether or not the party is dialed. A dialed party is never the
 * Party A with a party that was not dialed.
 */
 if (!snapshot_is_dialed(left->snapshot) && snapshot_is_dialed(right->snapshot)) {
 return left;
 } else if (snapshot_is_dialed(left->snapshot) && !snapshot_is_dialed(right->snapshot)) {
 return right;
 }

 /* Try the Party A flag */
 if (ast_test_flag(left, AST_CDR_FLAG_PARTY_A) && !ast_test_flag(right, AST_CDR_FLAG_PARTY_A)) {
 return left;
 } else if (!ast_test_flag(right, AST_CDR_FLAG_PARTY_A) && ast_test_flag(right, AST_CDR_FLAG_PARTY_A)) {
 return right;
 }

 /* Neither party is dialed and neither has the Party A flag - defer to
 * creation time */
 if (left->snapshot->base->creationtime.tv_sec < right->snapshot->base->creationtime.tv_sec) {
 return left;
 } else if (left->snapshot->base->creationtime.tv_sec > right->snapshot->base->creationtime.tv_sec) {
 return right;
 } else if (left->snapshot->base->creationtime.tv_usec > right->snapshot->base->creationtime.tv_usec) {
 return right;
 } else {
 /* Okay, fine, take the left one */
 return left;
 }
}

cdr_object_select_all_by_name_cb()

static int cdr_object_select_all_by_name_cb ( void *  obj, void *  arg, int  flags  )

static

Definition at line 3126 of file cdr.c.

References ast_channel_snapshot::base, CMP_MATCH, name, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

Referenced by ast_cdr_setvar().

{
 struct cdr_object *cdr = obj;
 const char *name = arg;

 if (!strcasecmp(cdr->party_a.snapshot->base->name, name) ||
 (cdr->party_b.snapshot && !strcasecmp(cdr->party_b.snapshot->base->name, name))) {
 return CMP_MATCH;
 }
 return 0;
}

cdr_object_set_disposition()

static void cdr_object_set_disposition ( struct cdr_object *  cdr, int  hangupcause  )

static

Set the disposition on a cdr_object based on a hangupcause code.

Parameters

cdr	The cdr_object
hangupcause	The Asterisk hangup cause code

Definition at line 1402 of file cdr.c.

References AST_CAUSE_BUSY, AST_CAUSE_CONGESTION, AST_CAUSE_NO_ANSWER, AST_CAUSE_NO_ROUTE_DESTINATION, AST_CAUSE_NORMAL_CLEARING, AST_CAUSE_UNREGISTERED, AST_CDR_BUSY, AST_CDR_CONGESTION, AST_CDR_FAILED, AST_CDR_NOANSWER, CDR_CONGESTION, cdr_object::disposition, and is_cdr_flag_set().

Referenced by cdr_object_finalize().

{
 /* Change the disposition based on the hang up cause */
 switch (hangupcause) {
 case AST_CAUSE_BUSY:
 cdr->dispos