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_CHANNEL_ENABLED "1"

#define	DEFAULT_CONGESTION "0"

#define	DEFAULT_ENABLED "1"

#define	DEFAULT_END_BEFORE_H_EXTEN "1"

#define	DEFAULT_IGNORE_DIAL_CHANGES "0"

#define	DEFAULT_IGNORE_STATE_CHANGES "0"

#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_object. 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)
	Set Caller ID information on a CDR. More...

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 = AST_BUILDOPT_SUM, .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 []

static int	dial_changes_ignored

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 252 of file cdr.c.

◆ 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 244 of file cdr.c.

◆ DEFAULT_BATCH_SAFE_SHUTDOWN

#define DEFAULT_BATCH_SAFE_SHUTDOWN "1"

Definition at line 242 of file cdr.c.

◆ DEFAULT_BATCH_SCHEDULER_ONLY

#define DEFAULT_BATCH_SCHEDULER_ONLY "0"

Definition at line 241 of file cdr.c.

◆ DEFAULT_BATCH_SIZE

#define DEFAULT_BATCH_SIZE "100"

Definition at line 237 of file cdr.c.

◆ DEFAULT_BATCH_TIME

#define DEFAULT_BATCH_TIME "300"

Definition at line 239 of file cdr.c.

◆ DEFAULT_BATCHMODE

#define DEFAULT_BATCHMODE "0"

Definition at line 228 of file cdr.c.

◆ DEFAULT_CHANNEL_ENABLED

#define DEFAULT_CHANNEL_ENABLED "1"

Definition at line 233 of file cdr.c.

◆ DEFAULT_CONGESTION

#define DEFAULT_CONGESTION "0"

Definition at line 230 of file cdr.c.

◆ DEFAULT_ENABLED

#define DEFAULT_ENABLED "1"

Definition at line 227 of file cdr.c.

◆ DEFAULT_END_BEFORE_H_EXTEN

#define DEFAULT_END_BEFORE_H_EXTEN "1"

Definition at line 231 of file cdr.c.

◆ DEFAULT_IGNORE_DIAL_CHANGES

#define DEFAULT_IGNORE_DIAL_CHANGES "0"

Definition at line 235 of file cdr.c.

◆ DEFAULT_IGNORE_STATE_CHANGES

#define DEFAULT_IGNORE_STATE_CHANGES "0"

Definition at line 234 of file cdr.c.

◆ DEFAULT_INITIATED_SECONDS

#define DEFAULT_INITIATED_SECONDS "0"

Definition at line 232 of file cdr.c.

◆ DEFAULT_UNANSWERED

#define DEFAULT_UNANSWERED "0"

Definition at line 229 of file cdr.c.

◆ FORMAT_STRING [1/2]

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

◆ 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 238 of file cdr.c.

◆ MAX_BATCH_TIME

#define MAX_BATCH_TIME 86400

Definition at line 240 of file cdr.c.

◆ TITLE_STRING [1/2]

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

◆ 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 433 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 4756 of file cdr.c.

◆ __unreg_module()

static void __unreg_module ( void )

static

Definition at line 4756 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.

Returns: a malloc'd ast_cdr structure

Return values

NULL	on error (malloc failure)

Definition at line 3501 of file cdr.c.

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

References ast_calloc.

Referenced by ast_cdr_dup().

◆ ast_cdr_backend_suspend()

int ast_cdr_backend_suspend ( const char * name )

Suspend a CDR backend temporarily.

Return values

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

Definition at line 2932 of file cdr.c.

{
    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;
}

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

Referenced by load_config(), and odbc_load_module().

◆ 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 2950 of file cdr.c.

{
    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;
}

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

Referenced by load_config(), and odbc_load_module().

◆ 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 3654 of file cdr.c.

{
    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;
}

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

Referenced by AST_TEST_DEFINE(), and cdr_prop_write_callback().

◆ 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 3509 of file cdr.c.

{
    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";
}

References AST_CDR_ANSWERED, AST_CDR_BUSY, AST_CDR_CONGESTION, AST_CDR_FAILED, AST_CDR_NOANSWER, AST_CDR_NULL, and ast_cdr::disposition.

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().

◆ ast_cdr_dup()

struct ast_cdr * ast_cdr_dup ( struct ast_cdr * cdr )

Duplicate a public CDR.

Parameters

cdr	the record to duplicate

Returns: a malloc'd ast_cdr structure,

Return values

NULL	on error (malloc failure)

Definition at line 3064 of file cdr.c.

{
    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;
}

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

Referenced by custom_log(), manager_log(), and write_cdr().

◆ ast_cdr_engine_term()

void ast_cdr_engine_term ( void )

Submit any remaining CDRs and prepare for shutdown

Definition at line 4682 of file cdr.c.

{
    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));
    }
}

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(), stasis_message_router_publish_sync(), and stasis_router.

Referenced by can_safely_quit(), and finalize_batch_mode().

◆ 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 3716 of file cdr.c.

{
    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;
}

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(), cdr_object::bridge, cdr_all_relink(), cdr_object_create_and_append(), cdr_object_finalize(), cdr_object_get_by_name(), cdr_object_transition_state(), voicemailpwcheck::context, copy_variables(), cdr_object::data, cdr_object::exten, finalized_state_fn_table, ast_flags::flags, cdr_object_snapshot::flags, cdr_object::flags, cdr_object::fn_table, free_variables(), cdr_object::last, cdr_object::lastevent, lock, cdr_object::next, options, 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().

◆ 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 extracted, provide epoch seconds. Otherwise format as a date/time stamp

Definition at line 3116 of file cdr.c.

{
    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, "tenantid")) {
        ast_copy_string(workspace, cdr->tenantid, workspacelen);
    } else if (!strcasecmp(name, "peertenantid")) {
        ast_copy_string(workspace, cdr->peertenantid, 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;
    }
}

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, name, NULL, ast_cdr::peeraccount, ast_cdr::peertenantid, ast_cdr::sequence, ast_cdr::src, ast_cdr::start, ast_cdr::tenantid, ast_cdr::uniqueid, and ast_cdr::userfield.

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

◆ ast_cdr_free()

void ast_cdr_free ( struct ast_cdr * cdr )

Free a CDR record.

Parameters

cdr	ast_cdr structure to free

Definition at line 3490 of file cdr.c.

{
    while (cdr) {
        struct ast_cdr *next = cdr->next;
 
        free_variables(&cdr->varshead);
        ast_free(cdr);
        cdr = next;
    }
}

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().

◆ ast_cdr_generic_unregister()

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

static

Definition at line 3019 of file cdr.c.

{
    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(5, "Unregistered '%s' CDR backend\n", name);
    ast_free(match);
 
    return 0;
}

References active_cdrs_master, 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(), name, and NULL.

Referenced by ast_cdr_modifier_unregister(), and ast_cdr_unregister().

◆ 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

Returns: The current CDR configuration

Definition at line 2892 of file cdr.c.

{
    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;
}

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

Referenced by test_cdr_init_cb().

◆ 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 3403 of file cdr.c.

{
    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;
}

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(), cdr_object::last, name, and value.

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

◆ ast_cdr_is_enabled()

int ast_cdr_is_enabled ( void )

Return TRUE if CDR subsystem is enabled.

Definition at line 2927 of file cdr.c.

{
    return is_cdr_flag_set(CDR_ENABLED);
}

References CDR_ENABLED, and is_cdr_flag_set().

Referenced by action_coresettings(), and handle_show_settings().

◆ 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

Returns: the stasis_message_router otherwise

Definition at line 4373 of file cdr.c.

{
    if (!stasis_router) {
        return NULL;
    }
 
    ao2_bump(stasis_router);
    return stasis_router;
}

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().

◆ 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 3014 of file cdr.c.

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

References be, cdr_generic_register(), desc, and name.

◆ 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 3059 of file cdr.c.

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

References ast_cdr_generic_unregister(), and 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 3009 of file cdr.c.

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

References be, cdr_generic_register(), desc, and name.

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

◆ 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 3677 of file cdr.c.

{
    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;
}

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().

◆ 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

Returns: the total number of serialized variables

Definition at line 3432 of file cdr.c.

{
    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;
}

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(), buf, CDR_ENABLED, cdr_object_format_property(), cdr_object_get_by_name(), cdr_readonly_vars, 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().

◆ 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 2906 of file cdr.c.

{
    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);
}

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

Referenced by test_cdr_cleanup_cb().

◆ 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 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 3627 of file cdr.c.

{
    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;
}

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

Referenced by AST_TEST_DEFINE(), and cdr_prop_write_callback().

◆ 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 3556 of file cdr.c.

{
    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);
}

References active_cdrs_all, 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, finalized_state_fn_table, 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(), and cdr_write_callback().

◆ 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 3249 of file cdr.c.

{
    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;
}

References active_cdrs_master, 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_readonly_vars, finalized_state_fn_table, cdr_object::fn_table, LOG_ERROR, name, 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, value, and cdr_object_snapshot::variables.

Referenced by AST_TEST_DEFINE(), and cdr_write_callback().

◆ 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 3054 of file cdr.c.

{
    return ast_cdr_generic_unregister(&be_list, name);
}

References ast_cdr_generic_unregister(), and name.

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

◆ AST_MODULE_SELF_SYM()

struct ast_module * AST_MODULE_SELF_SYM ( void )

Definition at line 4756 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 1654 of file cdr.c.

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

References 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 1644 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 1649 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 1660 of file cdr.c.

{
    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;
}

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.

◆ base_process_party_a()

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

static

Definition at line 1583 of file cdr.c.

{
    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;
}

Referenced by dialed_pending_state_process_party_a(), and single_state_process_dial_begin().

◆ 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 2539 of file cdr.c.

{
    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);
}

References ast_string_field_set, ast_channel_snapshot::base, cdr_object::bridge, bridge_state_fn_table, 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().

◆ 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_object being processed
base_cand_cdr	The cdr_object that is a candidate

Definition at line 2570 of file cdr.c.

{
    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);
}

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().

◆ 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 2058 of file cdr.c.

{
    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;
}

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

◆ 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 2045 of file cdr.c.

{
    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);
    }
}

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

◆ cdr_all_cmp_fn()

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

static

Definition at line 956 of file cdr.c.

{
    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;
}

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

Referenced by load_module().

◆ cdr_all_hash_fn()

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

static

Definition at line 932 of file cdr.c.

{
    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);
}

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

Referenced by load_module().

◆ cdr_all_print_fn()

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

static

Definition at line 4553 of file cdr.c.

{
    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);
}

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().

◆ cdr_all_relink()

static void cdr_all_relink ( struct cdr_object * cdr )

static

Definition at line 991 of file cdr.c.

{
    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);
}

References active_cdrs_all, 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().

◆ cdr_all_unlink()

static void cdr_all_unlink ( struct cdr_object * cdr )

static

Definition at line 1012 of file cdr.c.

{
    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);
}

References active_cdrs_all, 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().

◆ cdr_detach()

static void cdr_detach ( struct ast_cdr * cdr )

static

Definition at line 3920 of file cdr.c.

{
    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();
    }
}

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().

◆ cdr_enable_batch_mode()

static void cdr_enable_batch_mode ( struct ast_cdr_config * config )

static

Definition at line 4501 of file cdr.c.

{
    /* 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);
}

References ast_cond_init, ast_log, ast_pthread_create_background, AST_PTHREADT_NULL, cdr_pending_cond, cdr_thread, config, do_cdr(), LOG_ERROR, LOG_NOTICE, NULL, and start_batch_mode().

Referenced by cdr_toggle_runtime_options().

◆ cdr_engine_shutdown()

static void cdr_engine_shutdown ( void )

static

Definition at line 4470 of file cdr.c.

{
    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;
}

References aco_info_destroy(), active_cdrs_all, active_cdrs_master, 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(), cdr_topic, cli_commands, finalize_batch_mode(), NULL, OBJ_MULTIPLE, OBJ_NODATA, OBJ_UNLINK, stasis_message_router_unsubscribe_and_join(), STASIS_MESSAGE_TYPE_CLEANUP, and stasis_router.

Referenced by load_module().

◆ cdr_format_var_internal()

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

static

Definition at line 3084 of file cdr.c.

{
    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;
}

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

Referenced by ast_cdr_format_var().

◆ 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 2968 of file cdr.c.

{
    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;
}

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, desc, LOG_WARNING, cdr_beitem::name, and name.

Referenced by ast_cdr_modifier_register(), and ast_cdr_register().

◆ cdr_get_tv()

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

static

Definition at line 3101 of file cdr.c.

{
    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);
        }
    }
}

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

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

◆ cdr_master_cmp_fn()

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

static

Definition at line 898 of file cdr.c.

{
    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;
}

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

Referenced by load_module().

◆ cdr_master_hash_fn()

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

static

Definition at line 874 of file cdr.c.

{
    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);
}

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

Referenced by load_module().

◆ cdr_master_print_fn()

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

static

Definition at line 4528 of file cdr.c.

{
    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);
    }
}

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().

◆ 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
event_time

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

Definition at line 1080 of file cdr.c.

{
    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);
    ast_string_field_set(cdr, tenantid, chan->base->tenantid);
    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;
}

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, single_state_fn_table, cdr_object_snapshot::snapshot, ast_channel_snapshot_base::tenantid, cdr_object::tenantid, ast_channel_snapshot_base::uniqueid, and cdr_object::uniqueid.

Referenced by cdr_object_create_and_append(), and handle_channel_snapshot_update_message().

◆ 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 1537 of file cdr.c.

{
    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);
    }
}

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().

◆ 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 1520 of file cdr.c.

{
    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);
    }
}

References AST_FLAG_DEAD, AST_SOFTHANGUP_HANGUP_EXEC, ast_test_flag, CDR_END_BEFORE_H_EXTEN, cdr_object_finalize(), cdr_object_transition_state(), finalized_state_fn_table, 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().

◆ 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
event_time

Definition at line 1118 of file cdr.c.

{
    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;
}

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(), voicemailpwcheck::context, cdr_object::context, cdr_object::data, cdr_object::disposition, 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().

◆ 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

Returns: A chain of ast_cdr objects on success

Return values

NULL	on failure

Definition at line 1328 of file cdr.c.

{
    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));
        ast_copy_string(cdr_copy->tenantid, it_cdr->tenantid, sizeof(cdr_copy->tenantid));
 
        /* 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);
            }
            ast_copy_string(cdr_copy->peertenantid, party_b->base->tenantid, sizeof(cdr_copy->peertenantid));
        }
        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;
}

Referenced by cdr_object_dispatch().

◆ 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 1429 of file cdr.c.

{
    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);
}

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().

◆ cdr_object_dispatch_all_cb()

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

static

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

Definition at line 4342 of file cdr.c.

{
    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;
}

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

Referenced by cdr_engine_shutdown().

◆ cdr_object_dtor()

static void cdr_object_dtor ( void * obj )

static

cdr_object Destructor

Definition at line 1039 of file cdr.c.

{
    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;
        }
    }
}

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().

◆ 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'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	The CDR to finalize

Definition at line 1483 of file cdr.c.

{
    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));
}

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().

◆ cdr_object_finalize_party_b()

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

static

Definition at line 2252 of file cdr.c.

{
    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;
}

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().

◆ 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 3314 of file cdr.c.

{
    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, "tenantid")) {
        ast_copy_string(value, party_a->base->tenantid, length);
    } else if (!strcasecmp(name, "peertenantid")) {
        if (party_b) {
            ast_copy_string(value, party_b->base->tenantid, length);
        } else {
            ast_copy_string(value, "", 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;
}

Referenced by ast_cdr_getvar(), and ast_cdr_serialize_variables().

◆ 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 3297 of file cdr.c.

{
    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';
}

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

Referenced by ast_cdr_getvar().

◆ 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 1276 of file cdr.c.

{
    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;
}

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().

◆ cdr_object_get_by_name()

static struct cdr_object * cdr_object_get_by_name ( const char * name )

static

Definition at line 3391 of file cdr.c.

{
    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);
}

References active_cdrs_master, ao2_callback, ast_strdupa, ast_strlen_zero(), cdr_object_get_by_name_cb(), name, 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().

◆ cdr_object_get_by_name_cb()

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

static

Definition at line 3212 of file cdr.c.

{
    struct cdr_object *cdr = obj;
    const char *name = arg;
 
    if (!strcasecmp(cdr->party_a.snapshot->base->name, name)) {
        return CMP_MATCH;
    }
    return 0;
}

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().

◆ 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 1268 of file cdr.c.

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

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().

◆ 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 2429 of file cdr.c.

{
    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;
}

References ast_assert, ast_channel_snapshot::base, cdr_object::bridge, bridge_leave_data::bridge, bridge_state_fn_table, 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().

◆ 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

Returns: The snapshot that won

Definition at line 1233 of file cdr.c.

{
    /* 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(left, 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;
    }
}

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().

◆ 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 3196 of file cdr.c.

{
    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;
}

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().

◆ 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 1445 of file cdr.c.

{
    /* Change the disposition based on the hang up cause */
    switch (hangupcause) {
    case AST_CAUSE_BUSY:
        cdr->disposition = AST_CDR_BUSY;
        break;
    case AST_CAUSE_CONGESTION:
        if (!is_cdr_flag_set(CDR_CONGESTION)) {
            cdr->disposition = AST_CDR_FAILED;
        } else {
            cdr->disposition = AST_CDR_CONGESTION;
        }
        break;
    case AST_CAUSE_NO_ROUTE_DESTINATION:
    case AST_CAUSE_UNREGISTERED:
        cdr->disposition = AST_CDR_FAILED;
        break;
    case AST_CAUSE_NORMAL_CLEARING:
    case AST_CAUSE_NO_ANSWER:
        cdr->disposition = AST_CDR_NOANSWER;
        break;
    default:
        break;
    }
}

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().

◆ cdr_object_snapshot_copy()

static void cdr_object_snapshot_copy	(	struct cdr_object_snapshot *	dst,
		struct cdr_object_snapshot *	src
	)

static

Copy a snapshot and its details.

Parameters

dst	The destination
src	The source

Definition at line 834 of file cdr.c.

{
    ao2_t_replace(dst->snapshot, src->snapshot, "CDR snapshot copy");
    strcpy(dst->userfield, src->userfield);
    dst->flags = src->flags;
    copy_variables(&dst->variables, &src->variables);
}

References ao2_t_replace, copy_variables(), cdr_object_snapshot::flags, cdr_object_snapshot::snapshot, cdr_object_snapshot::userfield, and cdr_object_snapshot::variables.

Referenced by bridge_candidate_add_to_cdr(), bridge_candidate_process(), cdr_object_create_and_append(), dial_state_process_bridge_enter(), and single_state_bridge_enter_comparison().

◆ cdr_object_swap_snapshot()

static void cdr_object_swap_snapshot	(	struct cdr_object_snapshot *	old_snapshot,
		struct ast_channel_snapshot *	new_snapshot
	)

static

Swap an old cdr_object_snapshot's ast_channel_snapshot for a new ast_channel_snapshot.

Parameters

old_snapshot	The old cdr_object_snapshot
new_snapshot	The new ast_channel_snapshot for old_snapshot

Definition at line 1574 of file cdr.c.

{
    cdr_object_update_cid(old_snapshot, new_snapshot);
    ao2_t_replace(old_snapshot->snapshot, new_snapshot, "Swap CDR shapshot");
}

References ao2_t_replace, cdr_object_update_cid(), and cdr_object_snapshot::snapshot.

Referenced by base_process_party_a(), bridge_state_process_party_b(), dial_state_process_dial_end(), dial_state_process_party_b(), and single_state_process_dial_begin().

◆ cdr_object_transition_state()

static void cdr_object_transition_state	(	struct cdr_object *	cdr,
		struct cdr_object_fn_table *	fn_table
	)

static

Transition a cdr_object to a new state.

Parameters

cdr	The cdr_object to transition
fn_table	The cdr_object_fn_table state to go to

Definition at line 865 of file cdr.c.

{
    cdr_object_transition_state_init(cdr, fn_table, 1);
}

References cdr_object_transition_state_init().

Referenced by ast_cdr_fork(), bridge_candidate_add_to_cdr(), bridge_state_process_bridge_leave(), bridge_state_process_party_b(), cdr_object_alloc(), cdr_object_check_party_a_hangup(), cdr_object_dispatch_all_cb(), dial_state_process_bridge_enter(), dial_state_process_dial_end(), dial_state_process_party_b(), dialed_pending_state_process_bridge_enter(), dialed_pending_state_process_dial_begin(), dialed_pending_state_process_parking_bridge_enter(), dialed_pending_state_process_party_a(), handle_parking_bridge_enter_message(), parked_state_process_bridge_leave(), single_state_process_bridge_enter(), single_state_process_dial_begin(), and single_state_process_parking_bridge_enter().

◆ cdr_object_transition_state_init()

static void cdr_object_transition_state_init	(	struct cdr_object *	cdr,
		struct cdr_object_fn_table *	fn_table,
		int	do_init
	)

static

Transition a cdr_object to a new state with initiation flag.

Parameters

cdr	The cdr_object to transition
fn_table	The cdr_object_fn_table state to go to
do_init

Definition at line 848 of file cdr.c.

{
    CDR_DEBUG("%p - Transitioning CDR for %s from state %s to %s\n",
        cdr, cdr->party_a.snapshot->base->name,
        cdr->fn_table ? cdr->fn_table->name : "NONE", fn_table->name);
    cdr->fn_table = fn_table;
 
    if (cdr->fn_table->init_function && do_init) {
        cdr->fn_table->init_function(cdr);
    }
}

References ast_channel_snapshot::base, CDR_DEBUG, cdr_object::fn_table, cdr_object_fn_table::init_function, ast_channel_snapshot_base::name, cdr_object_fn_table::name, cdr_object::party_a, and cdr_object_snapshot::snapshot.

Referenced by cdr_object_transition_state(), and dialed_pending_state_process_party_a().

◆ cdr_object_update_cid()

static void cdr_object_update_cid	(	struct cdr_object_snapshot *	old_snapshot,
		struct ast_channel_snapshot *	new_snapshot
	)

static

Set Caller ID information on a CDR.

Definition at line 1549 of file cdr.c.

{
    if (!old_snapshot->snapshot) {
        set_variable(&old_snapshot->variables, "dnid", new_snapshot->caller->dnid);
        set_variable(&old_snapshot->variables, "callingsubaddr", new_snapshot->caller->subaddr);
        set_variable(&old_snapshot->variables, "calledsubaddr", new_snapshot->caller->dialed_subaddr);
        return;
    }
    if (strcmp(old_snapshot->snapshot->caller->dnid, new_snapshot->caller->dnid)) {
        set_variable(&old_snapshot->variables, "dnid", new_snapshot->caller->dnid);
    }
    if (strcmp(old_snapshot->snapshot->caller->subaddr, new_snapshot->caller->subaddr)) {
        set_variable(&old_snapshot->variables, "callingsubaddr", new_snapshot->caller->subaddr);
    }
    if (strcmp(old_snapshot->snapshot->caller->dialed_subaddr, new_snapshot->caller->dialed_subaddr)) {
        set_variable(&old_snapshot->variables, "calledsubaddr", new_snapshot->caller->dialed_subaddr);
    }
}

References ast_channel_snapshot::caller, ast_channel_snapshot_caller::dialed_subaddr, ast_channel_snapshot_caller::dnid, set_variable(), cdr_object_snapshot::snapshot, ast_channel_snapshot_caller::subaddr, and cdr_object_snapshot::variables.

Referenced by cdr_object_swap_snapshot().

◆ cdr_object_update_party_b()

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

static

Definition at line 2276 of file cdr.c.

{
    struct cdr_object *cdr = obj;
 
    if (cdr->fn_table->process_party_b
        && !strcasecmp(cdr->party_b_name, arg)) {
        struct ast_channel_snapshot *party_b = data;
 
        /*
         * For sanity's sake we also check the party_b snapshot
         * for consistency with the key.  The callback needs and
         * asserts the snapshot to be this way.
         */
        if (!cdr->party_b.snapshot
            || strcasecmp(cdr->party_b.snapshot->base->name, party_b->base->name)) {
            ast_log(LOG_NOTICE,
                "CDR for Party A %s(%s) has inconsistent Party B %s name.  Message can be ignored but this shouldn't happen.\n",
                cdr->linkedid,
                cdr->party_a.snapshot->base->name,
                cdr->party_b_name);
            return 0;
        }
 
        cdr->fn_table->process_party_b(cdr, party_b);
    }
    return 0;
}

References ast_log, ast_channel_snapshot::base, cdr_object::fn_table, cdr_object::linkedid, LOG_NOTICE, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, cdr_object::party_b_name, cdr_object_fn_table::process_party_b, and cdr_object_snapshot::snapshot.

Referenced by handle_channel_snapshot_update_message().

◆ cdr_object_update_party_b_userfield_cb()

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

static

Callback used to update the userfield on Party B on all CDRs.

Definition at line 3534 of file cdr.c.

{
    struct cdr_object *cdr = obj;
 
    if ((cdr->fn_table != &finalized_state_fn_table || !cdr->next)
        && !strcasecmp(cdr->party_b_name, arg)) {
        struct party_b_userfield_update *info = 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, info->channel_name));
 
        ast_copy_string(cdr->party_b.userfield, info->userfield,
            sizeof(cdr->party_b.userfield));
    }
 
    return 0;
}

References ast_assert, ast_copy_string(), ast_channel_snapshot::base, finalized_state_fn_table, cdr_object::fn_table, sip_to_pjsip::info(), ast_channel_snapshot_base::name, cdr_object::next, cdr_object::party_b, cdr_object::party_b_name, cdr_object_snapshot::snapshot, and cdr_object_snapshot::userfield.

Referenced by ast_cdr_setuserfield().

◆ cdr_submit_batch()

static void cdr_submit_batch ( int shutdown )

static

Definition at line 3845 of file cdr.c.

{
    struct module_config *mod_cfg;
    struct cdr_batch_item *oldbatchitems = NULL;
    pthread_t batch_post_thread = AST_PTHREADT_NULL;
 
    /* if there's no batch, or no CDRs in the batch, then there's nothing to do */
    if (!batch || !batch->head) {
        return;
    }
 
    /* move the old CDRs aside, and prepare a new CDR batch */
    ast_mutex_lock(&cdr_batch_lock);
    oldbatchitems = batch->head;
    reset_batch();
    ast_mutex_unlock(&cdr_batch_lock);
 
    mod_cfg = ao2_global_obj_ref(module_configs);
 
    /* if configured, spawn a new thread to post these CDRs,
       also try to save as much as possible if we are shutting down safely */
    if (!mod_cfg
        || ast_test_flag(&mod_cfg->general->batch_settings.settings, BATCH_MODE_SCHEDULER_ONLY)
        || do_shutdown) {
        ast_debug(1, "CDR single-threaded batch processing begins now\n");
        do_batch_backend_process(oldbatchitems);
    } else {
        if (ast_pthread_create_detached_background(&batch_post_thread, NULL, do_batch_backend_process, oldbatchitems)) {
            ast_log(LOG_WARNING, "CDR processing thread could not detach, now trying in this thread\n");
            do_batch_backend_process(oldbatchitems);
        } else {
            ast_debug(1, "CDR multi-threaded batch processing begins now\n");
        }
    }
 
    ao2_cleanup(mod_cfg);
}

References ao2_cleanup, ao2_global_obj_ref, ast_debug, ast_log, ast_mutex_lock, ast_mutex_unlock, ast_pthread_create_detached_background, AST_PTHREADT_NULL, ast_test_flag, batch, BATCH_MODE_SCHEDULER_ONLY, ast_cdr_config::batch_settings, cdr_batch_lock, do_batch_backend_process(), module_config::general, cdr_batch::head, LOG_WARNING, NULL, reset_batch(), and ast_cdr_config::batch_settings::settings.

Referenced by ast_cdr_engine_term(), and submit_scheduled_batch().

◆ cdr_toggle_runtime_options()

static int cdr_toggle_runtime_options ( void )

static

Checks if CDRs are enabled and enables/disables the necessary options.

Definition at line 4569 of file cdr.c.

{
    struct module_config *mod_cfg;
 
    mod_cfg = ao2_global_obj_ref(module_configs);
    if (mod_cfg
        && ast_test_flag(&mod_cfg->general->settings, CDR_ENABLED)) {
        if (create_subscriptions()) {
            destroy_subscriptions();
            ast_log(AST_LOG_ERROR, "Failed to create Stasis subscriptions\n");
            ao2_cleanup(mod_cfg);
            return -1;
        }
        if (ast_test_flag(&mod_cfg->general->settings, CDR_BATCHMODE)) {
            cdr_enable_batch_mode(mod_cfg->general);
        } else {
            ast_log(LOG_NOTICE, "CDR simple logging enabled.\n");
        }
    } else {
        destroy_subscriptions();
        ast_log(LOG_NOTICE, "CDR logging disabled.\n");
    }
    ao2_cleanup(mod_cfg);
 
    return mod_cfg ? 0 : -1;
}

References ao2_cleanup, ao2_global_obj_ref, ast_log, AST_LOG_ERROR, ast_test_flag, CDR_BATCHMODE, cdr_enable_batch_mode(), CDR_ENABLED, create_subscriptions(), destroy_subscriptions(), module_config::general, LOG_NOTICE, and ast_cdr_config::settings.

Referenced by ast_cdr_set_config(), load_module(), and reload_module().

◆ check_new_cdr_needed()

static int check_new_cdr_needed	(	struct ast_channel_snapshot *	old_snapshot,
		struct ast_channel_snapshot *	new_snapshot
	)

static

Determine if we need to add a new CDR based on snapshots.

Definition at line 2305 of file cdr.c.

{
    /* If we're dead, we don't need a new CDR */
    if (!new_snapshot
        || (ast_test_flag(&new_snapshot->softhangup_flags, AST_SOFTHANGUP_HANGUP_EXEC)
            && is_cdr_flag_set(CDR_END_BEFORE_H_EXTEN))) {
        return 0;
    }
 
    /* Auto-fall through will increment the priority but have no application */
    if (ast_strlen_zero(new_snapshot->dialplan->appl)) {
        return 0;
    }
 
    if (old_snapshot && !snapshot_cep_changed(old_snapshot, new_snapshot)) {
        return 0;
    }
 
    return 1;
}

References ast_channel_snapshot_dialplan::appl, AST_SOFTHANGUP_HANGUP_EXEC, ast_strlen_zero(), ast_test_flag, CDR_END_BEFORE_H_EXTEN, ast_channel_snapshot::dialplan, is_cdr_flag_set(), snapshot_cep_changed(), and ast_channel_snapshot::softhangup_flags.

Referenced by handle_channel_snapshot_update_message().

◆ cli_complete_show()

static char * cli_complete_show ( struct ast_cli_args * a )

static

Complete user input for 'cdr show'.

Definition at line 4049 of file cdr.c.

{
    int wordlen = strlen(a->word);
    struct ao2_iterator it_cdrs;
    struct cdr_object *cdr;
 
    it_cdrs = ao2_iterator_init(active_cdrs_master, 0);
    while ((cdr = ao2_iterator_next(&it_cdrs))) {
        if (!strncasecmp(a->word, cdr->party_a.snapshot->base->name, wordlen)) {
            if (ast_cli_completion_add(ast_strdup(cdr->party_a.snapshot->base->name))) {
                ao2_ref(cdr, -1);
                break;
            }
        }
        ao2_ref(cdr, -1);
    }
    ao2_iterator_destroy(&it_cdrs);
 
    return NULL;
}

References a, active_cdrs_master, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_cli_completion_add(), ast_strdup, ast_channel_snapshot::base, ast_channel_snapshot_base::name, NULL, cdr_object::party_a, and cdr_object_snapshot::snapshot.

Referenced by handle_cli_show().

◆ cli_show_channel()

static void cli_show_channel ( struct ast_cli_args * a )

static

Definition at line 4134 of file cdr.c.

{
    struct cdr_object *it_cdr;
    char clid[64];
    char start_time_buffer[64];
    char answer_time_buffer[64];
    char end_time_buffer[64];
    const char *channel_name = a->argv[3];
    struct cdr_object *cdr;
 
#define TITLE_STRING "%-10.10s %-20.20s %-25.25s %-15.15s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\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"
 
    cdr = cdr_object_get_by_name(channel_name);
    if (!cdr) {
        ast_cli(a->fd, "Unknown channel: %s\n", channel_name);
        return;
    }
 
    ast_cli(a->fd, "\n");
    ast_cli(a->fd, "Call Detail Record (CDR) Information for %s\n", channel_name);
    ast_cli(a->fd, "--------------------------------------------------\n");
    ast_cli(a->fd, TITLE_STRING, "AccountCode", "CallerID", "Dst. Channel", "LastApp", "Data", "Start", "Answer", "End", "Billsec", "Duration");
 
    ao2_lock(cdr);
    for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
        struct timeval end;
 
        if (snapshot_is_dialed(it_cdr->party_a.snapshot)) {
            continue;
        }
        ast_callerid_merge(clid, sizeof(clid), it_cdr->party_a.snapshot->caller->name, it_cdr->party_a.snapshot->caller->number, "");
        if (ast_tvzero(it_cdr->end)) {
            end = ast_tvnow();
        } else {
            end = it_cdr->end;
        }
        cdr_get_tv(it_cdr->start, "%T", start_time_buffer, sizeof(start_time_buffer));
        cdr_get_tv(it_cdr->answer, "%T", answer_time_buffer, sizeof(answer_time_buffer));
        cdr_get_tv(end, "%T", end_time_buffer, sizeof(end_time_buffer));
        ast_cli(a->fd, FORMAT_STRING,
                it_cdr->party_a.snapshot->base->accountcode,
                clid,
                it_cdr->party_b.snapshot ? it_cdr->party_b.snapshot->base->name : "<none>",
                it_cdr->appl,
                it_cdr->data,
                start_time_buffer,
                answer_time_buffer,
                end_time_buffer,
                (long)ast_tvdiff_ms(end, it_cdr->answer) / 1000,
                (long)ast_tvdiff_ms(end, it_cdr->start) / 1000);
    }
    ao2_unlock(cdr);
 
    ao2_cleanup(cdr);
 
#undef FORMAT_STRING
#undef TITLE_STRING
}

References a, ast_channel_snapshot_base::accountcode, cdr_object::answer, ao2_cleanup, ao2_lock, ao2_unlock, cdr_object::appl, ast_callerid_merge(), ast_cli(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_channel_snapshot::base, ast_channel_snapshot::caller, cdr_get_tv(), cdr_object_get_by_name(), cdr_object::data, end, cdr_object::end, FORMAT_STRING, ast_channel_snapshot_caller::name, ast_channel_snapshot_base::name, cdr_object::next, ast_channel_snapshot_caller::number, cdr_object::party_a, cdr_object::party_b, cdr_object_snapshot::snapshot, snapshot_is_dialed(), cdr_object::start, and TITLE_STRING.

Referenced by handle_cli_show().

◆ cli_show_channels()

static void cli_show_channels ( struct ast_cli_args * a )

static

Definition at line 4070 of file cdr.c.

{
    struct ao2_iterator it_cdrs;
    struct cdr_object *cdr;
    char start_time_buffer[64];
    char answer_time_buffer[64];
    char end_time_buffer[64];
 
#define TITLE_STRING "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8s %-8.8s\n"
#define FORMAT_STRING "%-25.25s %-25.25s %-15.15s %-8.8s %-8.8s %-8.8s %-8.8ld %-8.8ld\n"
 
    ast_cli(a->fd, "\n");
    ast_cli(a->fd, "Channels with Call Detail Record (CDR) Information\n");
    ast_cli(a->fd, "--------------------------------------------------\n");
    ast_cli(a->fd, TITLE_STRING, "Channel", "Dst. Channel", "LastApp", "Start", "Answer", "End", "Billsec", "Duration");
 
    it_cdrs = ao2_iterator_init(active_cdrs_master, 0);
    for (; (cdr = ao2_iterator_next(&it_cdrs)); ao2_cleanup(cdr)) {
        struct cdr_object *it_cdr;
        struct timeval start_time = { 0, };
        struct timeval answer_time = { 0, };
        struct timeval end_time = { 0, };
 
        SCOPED_AO2LOCK(lock, cdr);
 
        /* Calculate the start, end, answer, billsec, and duration over the
         * life of all of the CDR entries
         */
        for (it_cdr = cdr; it_cdr; it_cdr = it_cdr->next) {
            if (snapshot_is_dialed(it_cdr->party_a.snapshot)) {
                continue;
            }
            if (ast_tvzero(start_time)) {
                start_time = it_cdr->start;
            }
            if (!ast_tvzero(it_cdr->answer) && ast_tvzero(answer_time)) {
                answer_time = it_cdr->answer;
            }
        }
 
        /* If there was no start time, then all CDRs were for a dialed channel; skip */
        if (ast_tvzero(start_time)) {
            continue;
        }
        it_cdr = cdr->last;
 
        end_time = ast_tvzero(it_cdr->end) ? ast_tvnow() : it_cdr->end;
        cdr_get_tv(start_time, "%T", start_time_buffer, sizeof(start_time_buffer));
        cdr_get_tv(answer_time, "%T", answer_time_buffer, sizeof(answer_time_buffer));
        cdr_get_tv(end_time, "%T", end_time_buffer, sizeof(end_time_buffer));
        ast_cli(a->fd, FORMAT_STRING, it_cdr->party_a.snapshot->base->name,
                it_cdr->party_b.snapshot ? it_cdr->party_b.snapshot->base->name : "<none>",
                it_cdr->appl,
                start_time_buffer,
                answer_time_buffer,
                end_time_buffer,
                ast_tvzero(answer_time) ? 0 : (long)ast_tvdiff_ms(end_time, answer_time) / 1000,
                (long)ast_tvdiff_ms(end_time, start_time) / 1000);
    }
    ao2_iterator_destroy(&it_cdrs);
#undef FORMAT_STRING
#undef TITLE_STRING
}

References a, active_cdrs_master, cdr_object::answer, ao2_cleanup, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, cdr_object::appl, ast_cli(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_channel_snapshot::base, cdr_get_tv(), cdr_object::end, FORMAT_STRING, cdr_object::last, lock, ast_channel_snapshot_base::name, cdr_object::next, cdr_object::party_a, cdr_object::party_b, SCOPED_AO2LOCK, cdr_object_snapshot::snapshot, snapshot_is_dialed(), cdr_object::start, and TITLE_STRING.

Referenced by handle_cli_show().

◆ CONFIG_INFO_CORE()

CONFIG_INFO_CORE	(	"cdr"	,
		cfg_info	,
		module_configs	,
		module_config_alloc	,
		.	files = `ACO_FILES(&module_file_conf)`,
		.	post_apply_config = `module_config_post_apply`
	)

◆ copy_variables()

static int copy_variables	(	struct varshead *	to_list,
		struct varshead *	from_list
	)

static

Copy variables from one list to another.

Parameters

to_list	destination
from_list	source

Returns: The number of copied variables

Definition at line 789 of file cdr.c.

{
    struct ast_var_t *variables;
    struct ast_var_t *newvariable;
    const char *var;
    const char *val;
    int x = 0;
 
    AST_LIST_TRAVERSE(from_list, variables, entries) {
        var = ast_var_name(variables);
        if (ast_strlen_zero(var)) {
            continue;
        }
        val = ast_var_value(variables);
        if (ast_strlen_zero(val)) {
            continue;
        }
        newvariable = ast_var_assign(var, val);
        if (newvariable) {
            AST_LIST_INSERT_HEAD(to_list, newvariable, entries);
            ++x;
        }
    }
 
    return x;
}

References AST_LIST_INSERT_HEAD, AST_LIST_TRAVERSE, ast_strlen_zero(), ast_var_assign, ast_var_name(), ast_var_value(), ast_var_t::entries, and var.

Referenced by ast_cdr_dup(), ast_cdr_fork(), cdr_object_create_public_records(), and cdr_object_snapshot_copy().

◆ create_subscriptions()

static int create_subscriptions ( void )

static

Create the Stasis subcriptions for CDRs.

Definition at line 4396 of file cdr.c.

{
    if (!cdr_topic) {
        return -1;
    }
 
    if (channel_subscription || bridge_subscription || parking_subscription) {
        return 0;
    }
 
    channel_subscription = stasis_forward_all(ast_channel_topic_all(), cdr_topic);
    if (!channel_subscription) {
        return -1;
    }
    bridge_subscription = stasis_forward_all(ast_bridge_topic_all(), cdr_topic);
    if (!bridge_subscription) {
        return -1;
    }
    parking_subscription = stasis_forward_all(ast_parking_topic(), cdr_topic);
    if (!parking_subscription) {
        return -1;
    }
 
    return 0;
}

References ast_bridge_topic_all(), ast_channel_topic_all(), ast_parking_topic(), bridge_subscription, cdr_topic, channel_subscription, parking_subscription, and stasis_forward_all().

Referenced by cdr_toggle_runtime_options().

◆ destroy_subscriptions()

static void destroy_subscriptions ( void )

static

Destroy the active Stasis subscriptions.

Definition at line 4386 of file cdr.c.

{
    channel_subscription = stasis_forward_cancel(channel_subscription);
    bridge_subscription = stasis_forward_cancel(bridge_subscription);
    parking_subscription = stasis_forward_cancel(parking_subscription);
}

References bridge_subscription, channel_subscription, parking_subscription, and stasis_forward_cancel().

Referenced by cdr_toggle_runtime_options(), and unload_module().

◆ dial_state_process_bridge_enter()

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

Definition at line 1923 of file cdr.c.

{
    int success = 0;
 
    ast_string_field_set(cdr, bridge, bridge->uniqueid);
 
    /* Get parties in the bridge */
    if (ao2_container_count(bridge->channels) == 1) {
        /* No one in the bridge yet but us! */
        cdr_object_transition_state(cdr, &bridge_state_fn_table);
        return BRIDGE_ENTER_ONLY_PARTY;
    }
 
    /* If we don't have a Party B (originated channel), skip it */
    if (cdr->party_b.snapshot) {
        struct ao2_iterator it_cdrs;
        char *channel_id;
 
        for (it_cdrs = ao2_iterator_init(bridge->channels, 0);
            !success && (channel_id = ao2_iterator_next(&it_cdrs));
            ao2_ref(channel_id, -1)) {
            struct cdr_object *cand_cdr_master;
            struct cdr_object *cand_cdr;
 
            cand_cdr_master = ao2_find(active_cdrs_master, channel_id, OBJ_SEARCH_KEY);
            if (!cand_cdr_master) {
                continue;
            }
 
            ao2_lock(cand_cdr_master);
            for (cand_cdr = cand_cdr_master; cand_cdr; cand_cdr = cand_cdr->next) {
                /* Skip any records that are not in a bridge or in this bridge.
                 * I'm not sure how that would happen, but it pays to be careful. */
                if (cand_cdr->fn_table != &bridge_state_fn_table
                    || strcmp(cdr->bridge, cand_cdr->bridge)) {
                    continue;
                }
 
                /* Skip any records that aren't our Party B */
                if (strcasecmp(cdr->party_b.snapshot->base->name, cand_cdr->party_a.snapshot->base->name)) {
                    continue;
                }
                cdr_object_snapshot_copy(&cdr->party_b, &cand_cdr->party_a);
                /* If they have a Party B, they joined up with someone else as their
                 * Party A. Don't finalize them as they're active. Otherwise, we
                 * have stolen them so they need to be finalized.
                 */
                if (!cand_cdr->party_b.snapshot) {
                    cdr_object_finalize(cand_cdr);
                }
                success = 1;
                break;
            }
            ao2_unlock(cand_cdr_master);
            ao2_cleanup(cand_cdr_master);
        }
        ao2_iterator_destroy(&it_cdrs);
    }
 
    /* We always transition state, even if we didn't get a peer */
    cdr_object_transition_state(cdr, &bridge_state_fn_table);
 
    /* Success implies that we have a Party B */
    if (success) {
        return BRIDGE_ENTER_OBTAINED_PARTY_B;
    }
    return BRIDGE_ENTER_NO_PARTY_B;
}

References active_cdrs_master, ao2_cleanup, ao2_container_count(), ao2_find, ao2_iterator_destroy(), ao2_iterator_init(), ao2_iterator_next, ao2_lock, ao2_ref, ao2_unlock, ast_string_field_set, ast_channel_snapshot::base, ast_channel_snapshot::bridge, cdr_object::bridge, BRIDGE_ENTER_NO_PARTY_B, BRIDGE_ENTER_OBTAINED_PARTY_B, BRIDGE_ENTER_ONLY_PARTY, bridge_state_fn_table, cdr_object_finalize(), cdr_object_snapshot_copy(), cdr_object_transition_state(), ast_bridge_snapshot::channels, cdr_object::fn_table, ast_channel_snapshot_base::name, cdr_object::next, OBJ_SEARCH_KEY, cdr_object::party_a, cdr_object::party_b, and cdr_object_snapshot::snapshot.

◆ dial_state_process_dial_begin()

static int dial_state_process_dial_begin	(	struct cdr_object *	cdr,
		struct ast_channel_snapshot *	caller,
		struct ast_channel_snapshot *	peer
	)

static

Definition at line 1859 of file cdr.c.

{
    /* Don't process a begin dial here. A party A already in the dial state will
     * who receives a dial begin for something else will be handled by the
     * message router callback and will add a new CDR for the party A */
    return 1;
}

◆ dial_state_process_dial_end()

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

Definition at line 1891 of file cdr.c.

{
    struct ast_channel_snapshot *party_a;
 
    if (caller) {
        party_a = caller;
    } else {
        party_a = peer;
    }
    ast_assert(!strcasecmp(cdr->party_a.snapshot->base->name, party_a->base->name));
    cdr_object_swap_snapshot(&cdr->party_a, party_a);
 
    if (cdr->party_b.snapshot) {
        if (strcasecmp(cdr->party_b.snapshot->base->name, peer->base->name)) {
            /* Not the status for this CDR - defer back to the message router */
            return 1;
        }
        cdr_object_swap_snapshot(&cdr->party_b, peer);
    }
 
    /* Set the disposition based on the dial string. */
    cdr->disposition = dial_status_to_disposition(dial_status);
    if (cdr->disposition == AST_CDR_ANSWERED) {
        /* Switch to dial pending to wait and see what the caller does */
        cdr_object_transition_state(cdr, &dialed_pending_state_fn_table);
    } else {
        cdr_object_transition_state(cdr, &finalized_state_fn_table);
    }
 
    return 0;
}

References ast_assert, AST_CDR_ANSWERED, ast_channel_snapshot::base, ast_channel_snapshot::caller, cdr_object_swap_snapshot(), cdr_object_transition_state(), dial_status_to_disposition(), dialed_pending_state_fn_table, cdr_object::disposition, finalized_state_fn_table, ast_channel_snapshot_base::name, cdr_object::party_a, cdr_object::party_b, ast_channel_snapshot::peer, and cdr_object_snapshot::snapshot.

◆ dial_state_process_party_b()

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

static

Definition at line 1845 of file cdr.c.

{
    ast_assert(snapshot != NULL);
    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);
    }
}

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

◆ dial_status_end()

static int dial_status_end ( const char * dialstatus )

static

Definition at line 2132 of file cdr.c.

{
    return (strcmp(dialstatus, "RINGING") &&
            strcmp(dialstatus, "PROCEEDING") &&
            strcmp(dialstatus, "PROGRESS"));
}

Referenced by handle_dial_message().

◆ dial_status_to_disposition()

static enum ast_cdr_disposition dial_status_to_disposition ( const char * dial_status )

static

Definition at line 1871 of file cdr.c.

{
    if (!strcmp(dial_status, "ANSWER")) {
        return AST_CDR_ANSWERED;
    } else if (!strcmp(dial_status, "BUSY")) {
        return AST_CDR_BUSY;
    } else if (!strcmp(dial_status, "CANCEL") || !strcmp(dial_status, "NOANSWER")) {
        return AST_CDR_NOANSWER;
    } else if (!strcmp(dial_status, "CONGESTION")) {
        if (!is_cdr_flag_set(CDR_CONGESTION)) {
            return AST_CDR_FAILED;
        } else {
            return AST_CDR_CONGESTION;
        }
    } else if (!strcmp(dial_status, "FAILED")) {
        return AST_CDR_FAILED;
    }
    return AST_CDR_FAILED;
}

References AST_CDR_ANSWERED, AST_CDR_BUSY, AST_CDR_CONGESTION, AST_CDR_FAILED, AST_CDR_NOANSWER, CDR_CONGESTION, and is_cdr_flag_set().

Referenced by dial_state_process_dial_end(), and handle_dial_message().

◆ dialed_pending_state_process_bridge_enter()

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

Definition at line 2019 of file cdr.c.

{
    cdr_object_transition_state(cdr, &dial_state_fn_table);
    return cdr->fn_table->process_bridge_enter(cdr, bridge, channel);
}

References cdr_object::bridge, cdr_object_transition_state(), dial_state_fn_table, cdr_object::fn_table, and cdr_object_fn_table::process_bridge_enter.

◆ dialed_pending_state_process_dial_begin()

static int dialed_pending_state_process_dial_begin	(	struct cdr_object *	cdr,
		struct ast_channel_snapshot *	caller,
		struct ast_channel_snapshot *	peer
	)

static

Definition at line 2035 of file cdr.c.

{
    cdr_object_transition_state(cdr, &finalized_state_fn_table);
 
    /* Ask for a new CDR */
    return 1;
}

References cdr_object_transition_state(), and finalized_state_fn_table.

◆ dialed_pending_state_process_parking_bridge_enter()

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

static

Defini

Data Structures

Macros

Enumerations

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ CDR_DEBUG

◆ cdr_set_debug_mode

◆ DEFAULT_BATCH_SAFE_SHUTDOWN

◆ DEFAULT_BATCH_SCHEDULER_ONLY

◆ DEFAULT_BATCH_SIZE

◆ DEFAULT_BATCH_TIME

◆ DEFAULT_BATCHMODE

◆ DEFAULT_CHANNEL_ENABLED

◆ DEFAULT_CONGESTION

◆ DEFAULT_ENABLED

◆ DEFAULT_END_BEFORE_H_EXTEN

◆ DEFAULT_IGNORE_DIAL_CHANGES

◆ DEFAULT_IGNORE_STATE_CHANGES

◆ DEFAULT_INITIATED_SECONDS

◆ DEFAULT_UNANSWERED

◆ FORMAT_STRING [1/2]

◆ FORMAT_STRING [2/2]

◆ MAX_BATCH_SIZE

◆ MAX_BATCH_TIME

◆ TITLE_STRING [1/2]

◆ TITLE_STRING [2/2]

Enumeration Type Documentation

◆ process_bridge_enter_results

Function Documentation

◆ __reg_module()

◆ __unreg_module()

◆ AO2_GLOBAL_OBJ_STATIC()

◆ ast_cdr_alloc()

◆ ast_cdr_backend_suspend()

◆ ast_cdr_backend_unsuspend()

◆ ast_cdr_clear_property()

◆ ast_cdr_disp2str()

◆ ast_cdr_dup()

◆ ast_cdr_engine_term()

◆ ast_cdr_fork()

◆ ast_cdr_format_var()

◆ ast_cdr_free()

◆ ast_cdr_generic_unregister()

◆ ast_cdr_get_config()

◆ ast_cdr_getvar()

◆ ast_cdr_is_enabled()

◆ ast_cdr_message_router()

◆ ast_cdr_modifier_register()

◆ ast_cdr_modifier_unregister()

◆ ast_cdr_register()

◆ ast_cdr_reset()

◆ ast_cdr_serialize_variables()

◆ ast_cdr_set_config()

◆ ast_cdr_set_property()

◆ ast_cdr_setuserfield()

◆ ast_cdr_setvar()

◆ ast_cdr_unregister()

◆ AST_MODULE_SELF_SYM()

◆ base_process_bridge_enter()

◆ base_process_bridge_leave()

◆ base_process_dial_end()

◆ base_process_parked_channel()

◆ base_process_party_a()

◆ bridge_candidate_add_to_cdr()

◆ bridge_candidate_process()

◆ bridge_state_process_bridge_leave()

◆ bridge_state_process_party_b()

◆ cdr_all_cmp_fn()

◆ cdr_all_hash_fn()

◆ cdr_all_print_fn()

◆ cdr_all_relink()

◆ cdr_all_unlink()

◆ cdr_detach()

◆ cdr_enable_batch_mode()

◆ cdr_engine_shutdown()

◆ cdr_format_var_internal()

◆ cdr_generic_register()

◆ cdr_get_tv()