features.c File Reference

Routines implementing call features as call pickup, parking and transfer. More...

#include "asterisk.h"
#include "asterisk/_private.h"
#include <pthread.h>
#include <sys/time.h>
#include <sys/signal.h>
#include <netinet/in.h>
#include "asterisk/lock.h"
#include "asterisk/file.h"
#include "asterisk/channel.h"
#include "asterisk/pbx.h"
#include "asterisk/causes.h"
#include "asterisk/module.h"
#include "asterisk/translate.h"
#include "asterisk/app.h"
#include "asterisk/say.h"
#include "asterisk/features.h"
#include "asterisk/musiconhold.h"
#include "asterisk/config.h"
#include "asterisk/cli.h"
#include "asterisk/manager.h"
#include "asterisk/utils.h"
#include "asterisk/adsi.h"
#include "asterisk/devicestate.h"
#include "asterisk/monitor.h"
#include "asterisk/audiohook.h"
#include "asterisk/global_datastores.h"
#include "asterisk/astobj2.h"
#include "asterisk/cel.h"

Include dependency graph for features.c:

Go to the source code of this file.

Data Structures
struct	ast_bridge_thread_obj
struct	ast_dial_features
struct	ast_park_call_args
struct	ast_parkinglot
	Structure for parking lots which are put in a container. More...
struct	ast_parkinglot::parkinglot_parklist
struct	feature_group
struct	feature_group_exten
struct	feature_groups
struct	feature_list
struct	parkeduser
	Description of one parked call, added to a list while active, then removed. The list belongs to a parkinglot. More...
Defines
#define	AST_MAX_WATCHERS   256
#define	DEFAULT_ATXFER_CALLBACK_RETRIES   2
#define	DEFAULT_ATXFER_DROP_CALL   0
#define	DEFAULT_ATXFER_LOOP_DELAY   10000
#define	DEFAULT_FEATURE_DIGIT_TIMEOUT   1000
#define	DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER   15000
#define	DEFAULT_PARK_TIME   45000
#define	DEFAULT_PARKINGLOT   "default"
#define	DEFAULT_TRANSFER_DIGIT_TIMEOUT   3000
#define	FEATURES_COUNT   ARRAY_LEN(builtin_features)
#define	HFS_FORMAT   "%-25s %-7s %-7s\n"
#define	MAX_DIAL_FEATURE_OPTIONS   30
Enumerations
enum	{   BRIDGE_OPT_PLAYTONE = (1 << 0), OPT_CALLEE_HANGUP = (1 << 1), OPT_CALLER_HANGUP = (1 << 2), OPT_DURATION_LIMIT = (1 << 3),   OPT_DURATION_STOP = (1 << 4), OPT_CALLEE_TRANSFER = (1 << 5), OPT_CALLER_TRANSFER = (1 << 6), OPT_CALLEE_MONITOR = (1 << 7),   OPT_CALLER_MONITOR = (1 << 8), OPT_CALLEE_PARK = (1 << 9), OPT_CALLER_PARK = (1 << 10), OPT_CALLEE_KILL = (1 << 11) }
enum	{ OPT_ARG_DURATION_LIMIT = 0, OPT_ARG_DURATION_STOP, OPT_ARG_ARRAY_SIZE }
enum	ast_park_call_options { AST_PARK_OPT_RINGING = (1 << 0), AST_PARK_OPT_RANDOMIZE = (1 << 1), AST_PARK_OPT_SILENCE = (1 << 2) }
Functions
static void	__fini_feature_groups (void)
static void	__fini_feature_list (void)
static void	__init_feature_groups (void)
static void	__init_feature_list (void)
static int	action_bridge (struct mansession *s, const struct message *m)
	Bridge channels together.
static void	add_features_datastores (struct ast_channel *caller, struct ast_channel *callee, struct ast_bridge_config *config)
static int	adsi_announce_park (struct ast_channel *chan, char *parkingexten)
	Announce call parking by ADSI.
int	ast_bridge_call (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config)
	bridge the call and set CDR
int	ast_bridge_timelimit (struct ast_channel *chan, struct ast_bridge_config *config, char *parse, struct timeval *calldurationlimit)
void	ast_channel_log (char *title, struct ast_channel *chan)
int	ast_feature_detect (struct ast_channel *chan, struct ast_flags *features, const char *code, struct ast_call_feature *feature)
	detect a feature before bridging
int	ast_features_init (void)
int	ast_features_reload (void)
	Reload call features from features.conf.
struct ast_call_feature *	ast_find_call_feature (const char *name)
	look for a call feature entry by its sname
int	ast_masq_park_call (struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout)
	Park a call via a masqueraded channel.
int	ast_park_call (struct ast_channel *chan, struct ast_channel *peer, int timeout, int *extout)
	Park a call.
const char *	ast_parking_ext (void)
	Determine system parking extension.
int	ast_pickup_call (struct ast_channel *chan)
	Pickup a call.
const char *	ast_pickup_ext (void)
	Determine system call pickup extension.
void	ast_rdlock_call_features (void)
void	ast_register_feature (struct ast_call_feature *feature)
	register new feature into feature_list
void	ast_unlock_call_features (void)
void	ast_unregister_feature (struct ast_call_feature *feature)
	unregister feature from feature_set
static void	ast_unregister_features (void)
	Remove all features in the list.
static void	ast_unregister_groups (void)
	Remove all feature groups in the list.
static void *	bridge_call_thread (void *data)
	bridge the call
static void	bridge_call_thread_launch (void *data)
	create thread for the parked call
static int	bridge_exec (struct ast_channel *chan, const char *data)
	Bridge channels.
static struct ast_parkinglot *	build_parkinglot (char *name, struct ast_variable *var)
	Build parkinglot from configuration and chain it in.
static int	builtin_atxfer (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
	Attended transfer.
static int	builtin_automixmonitor (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
static int	builtin_automonitor (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
	Monitor a channel by DTMF.
static int	builtin_blindtransfer (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
	Blind transfer user to another extension.
static int	builtin_disconnect (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
static int	builtin_parkcall (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
	support routing for one touch call parking
static char *	callback_dialoptions (struct ast_flags *features_callee, struct ast_flags *features_caller, char *options, size_t len)
static int	check_compat (struct ast_channel *c, struct ast_channel *newchan)
	make channels compatible
static void	check_goto_on_transfer (struct ast_channel *chan)
	Check goto on transfer.
static struct ast_parkinglot *	create_parkinglot (char *name)
	Allocate parking lot structure.
static void	dial_features_destroy (void *data)
static void *	dial_features_duplicate (void *data)
static void	do_bridge_masquerade (struct ast_channel *chan, struct ast_channel *tmpchan)
	Actual bridge.
static void *	do_parking_thread (void *ignore)
	Take care of parked calls and unpark them if needed.
static int	feature_exec_app (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, void *data)
	exec an app by feature
static int	feature_interpret (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense)
	Check the dynamic features.
static int	feature_interpret_helper (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config, const char *code, int sense, char *dynamic_features_buf, struct ast_flags *features, int operation, struct ast_call_feature *feature)
	Helper function for feature_interpret and ast_feature_detect.
static struct ast_channel *	feature_request_and_dial (struct ast_channel *caller, struct ast_channel *transferee, const char *type, int format, void *data, int timeout, int *outstate, const char *cid_num, const char *cid_name, int igncallerstate, const char *language)
	Get feature and dial.
static int	find_channel_by_group (void *obj, void *arg, void *data, int flags)
static struct ast_call_feature *	find_dynamic_feature (const char *name)
	find a call feature by name
static struct feature_group *	find_group (const char *name)
	Find a group by name.
struct ast_parkinglot *	find_parkinglot (const char *name)
	Find parkinglot by name.
static const char *	findparkinglotname (struct ast_channel *chan)
	Find parking lot name from channel.
static int	finishup (struct ast_channel *chan)
static char *	handle_feature_show (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	CLI command to list configured features.
static char *	handle_features_reload (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
static char *	handle_parkedcalls (struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
	CLI command to list parked calls.
static int	load_config (void)
int	manage_parkinglot (struct ast_parkinglot *curlot, fd_set *rfds, fd_set *efds, fd_set *nrfds, fd_set *nefds, int *ms, int *max)
	Run management on parkinglots, called once per parkinglot.
static int	manager_park (struct mansession *s, const struct message *m)
	Create manager event for parked calls.
static int	manager_parking_status (struct mansession *s, const struct message *m)
	Dump parking lot status.
static int	masq_park_call (struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout, int play_announcement, struct ast_park_call_args *args)
static int	masq_park_call_announce (struct ast_channel *rchan, struct ast_channel *peer, int timeout, int *extout)
static int	masq_park_call_announce_args (struct ast_channel *rchan, struct ast_channel *peer, struct ast_park_call_args *args)
static enum ast_device_state	metermaidstate (const char *data)
	metermaids callback from devicestate.c
static void	notify_metermaids (const char *exten, char *context, enum ast_device_state state)
	Notify metermaids that we've changed an extension.
static void	park_add_hints (char *context, int start, int stop)
	Add parking hints for all defined parking lots.
static int	park_call_exec (struct ast_channel *chan, const char *data)
	Park a call.
static int	park_call_full (struct ast_channel *chan, struct ast_channel *peer, struct ast_park_call_args *args)
static int	park_exec (struct ast_channel *chan, const char *data)
static int	park_exec_full (struct ast_channel *chan, const char *data, struct ast_parkinglot *parkinglot)
	Pickup parked call.
static struct parkeduser *	park_space_reserve (struct ast_channel *chan, struct ast_channel *peer, struct ast_park_call_args *args)
static struct ast_parkinglot *	parkinglot_addref (struct ast_parkinglot *parkinglot)
static int	parkinglot_cmp_cb (void *obj, void *arg, int flags)
static void	parkinglot_destroy (void *obj)
	Destroy a parking lot.
static int	parkinglot_hash_cb (const void *obj, const int flags)
static void	parkinglot_unref (struct ast_parkinglot *parkinglot)
	Unreference parkinglot object. If no more references, then go ahead and delete it.
static struct ast_cdr *	pick_unlocked_cdr (struct ast_cdr *cdr)
	return the first unlocked cdr in a possible chain
static int	play_message_in_bridged_call (struct ast_channel *caller_chan, struct ast_channel *callee_chan, const char *audiofile)
	Play message to both caller and callee in bridged call, plays synchronously, autoservicing the other channel during the message, so please don't use this for very long messages.
static void	post_manager_event (const char *s, struct parkeduser *pu)
	Output parking event to manager.
static const char *	real_ctx (struct ast_channel *transferer, struct ast_channel *transferee)
	Find the context for the transfer.
static struct feature_group *	register_group (const char *fgname)
	Add new feature group.
static void	register_group_feature (struct feature_group *fg, const char *exten, struct ast_call_feature *feature)
	Add feature to group.
static int	remap_feature (const char *name, const char *value)
static void	set_bridge_features_on_config (struct ast_bridge_config *config, const char *features)
static void	set_c_e_p (struct ast_channel *chan, const char *context, const char *ext, int pri)
	store context, extension and priority
static void	set_config_flags (struct ast_channel *chan, struct ast_channel *peer, struct ast_bridge_config *config)
static void	set_peers (struct ast_channel **caller, struct ast_channel **callee, struct ast_channel *peer, struct ast_channel *chan, int sense)
	set caller and callee according to the direction
static void	unmap_features (void)
Variables
static int	adsipark
static char *	app_bridge = "Bridge"
static unsigned int	atxfercallbackretries
static unsigned int	atxferdropcall
static unsigned int	atxferloopdelay
static int	atxfernoanswertimeout
static struct ast_app_option	bridge_exec_options [128] = { [ 'p' ] = { .flag = BRIDGE_OPT_PLAYTONE }, [ 'h' ] = { .flag = OPT_CALLEE_HANGUP }, [ 'H' ] = { .flag = OPT_CALLER_HANGUP }, [ 'k' ] = { .flag = OPT_CALLEE_PARK }, [ 'K' ] = { .flag = OPT_CALLER_PARK }, [ 'L' ] = { .flag = OPT_DURATION_LIMIT , .arg_index = OPT_ARG_DURATION_LIMIT + 1 }, [ 'S' ] = { .flag = OPT_DURATION_STOP , .arg_index = OPT_ARG_DURATION_STOP + 1 }, [ 't' ] = { .flag = OPT_CALLEE_TRANSFER }, [ 'T' ] = { .flag = OPT_CALLER_TRANSFER }, [ 'w' ] = { .flag = OPT_CALLEE_MONITOR }, [ 'W' ] = { .flag = OPT_CALLER_MONITOR }, [ 'x' ] = { .flag = OPT_CALLEE_KILL }, }
static struct ast_call_feature	builtin_features []
static struct ast_cli_entry	cli_features []
static int	comebacktoorigin = 1
static char	courtesytone [256]
struct ast_parkinglot *	default_parkinglot
static struct ast_datastore_info	dial_features_info
static int	featuredigittimeout
static ast_rwlock_t	features_lock = { 0 }
static struct ast_app *	mixmonitor_app = NULL
static int	mixmonitor_ok = 1
static struct ast_app *	monitor_app = NULL
static int	monitor_ok = 1
static struct ast_app_option	park_call_options [128] = { [ 'r' ] = { .flag = AST_PARK_OPT_RINGING }, [ 'R' ] = { .flag = AST_PARK_OPT_RANDOMIZE }, [ 's' ] = { .flag = AST_PARK_OPT_SILENCE }, }
static char *	parkcall = PARK_APP_NAME
static char *	parkedcall = "ParkedCall"
static int	parkedplay = 0
char	parking_ext [AST_MAX_EXTENSION]
static pthread_t	parking_thread
static struct ao2_container *	parkinglots
	The list of parking lots configured. Always at least one - the default parking lot.
static char	pickup_ext [AST_MAX_EXTENSION]
static char	pickupfailsound [256]
static char	pickupsound [256]
static char *	registrar = "features"
static struct ast_app *	stopmixmonitor_app = NULL
static int	stopmixmonitor_ok = 1
static int	transferdigittimeout
static char	xferfailsound [256]
static char	xfersound [256]

---

Detailed Description

Routines implementing call features as call pickup, parking and transfer.

Author:

Mark Spencer <markster@digium.com>

Definition in file features.c.

---

Define Documentation

#define AST_MAX_WATCHERS   256

Definition at line 287 of file features.c.

#define DEFAULT_ATXFER_CALLBACK_RETRIES   2

Definition at line 285 of file features.c.

Referenced by load_config().

#define DEFAULT_ATXFER_DROP_CALL   0

Definition at line 283 of file features.c.

Referenced by load_config().

#define DEFAULT_ATXFER_LOOP_DELAY   10000

Definition at line 284 of file features.c.

Referenced by load_config().

#define DEFAULT_FEATURE_DIGIT_TIMEOUT   1000

Definition at line 280 of file features.c.

Referenced by load_config().

#define DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER   15000

Definition at line 281 of file features.c.

Referenced by load_config().

#define DEFAULT_PARK_TIME   45000

Definition at line 278 of file features.c.

Referenced by build_parkinglot(), and load_config().

#define DEFAULT_PARKINGLOT   "default"

Default parking lot

Definition at line 282 of file features.c.

Referenced by load_config().

#define DEFAULT_TRANSFER_DIGIT_TIMEOUT   3000

Definition at line 279 of file features.c.

Referenced by load_config().

#define FEATURES_COUNT   ARRAY_LEN(builtin_features)

Definition at line 1892 of file features.c.

Referenced by ast_find_call_feature(), feature_interpret_helper(), feature_request_and_dial(), handle_feature_show(), remap_feature(), set_config_flags(), and unmap_features().

#define HFS_FORMAT   "%-25s %-7s %-7s\n"

Referenced by handle_feature_show().

#define MAX_DIAL_FEATURE_OPTIONS   30

Definition at line 288 of file features.c.

Referenced by manage_parkinglot().

---

Enumeration Type Documentation

anonymous enum

Enumerator:

BRIDGE_OPT_PLAYTONE
OPT_CALLEE_HANGUP
OPT_CALLER_HANGUP
OPT_DURATION_LIMIT
OPT_DURATION_STOP
OPT_CALLEE_TRANSFER
OPT_CALLER_TRANSFER
OPT_CALLEE_MONITOR
OPT_CALLER_MONITOR
OPT_CALLEE_PARK
OPT_CALLER_PARK
OPT_CALLEE_KILL

Definition at line 4792 of file features.c.

     {
   BRIDGE_OPT_PLAYTONE = (1 << 0),
   OPT_CALLEE_HANGUP =  (1 << 1),
   OPT_CALLER_HANGUP =  (1 << 2),
   OPT_DURATION_LIMIT = (1 << 3),
   OPT_DURATION_STOP =  (1 << 4),
   OPT_CALLEE_TRANSFER = (1 << 5),
   OPT_CALLER_TRANSFER = (1 << 6),
   OPT_CALLEE_MONITOR = (1 << 7),
   OPT_CALLER_MONITOR = (1 << 8),
   OPT_CALLEE_PARK = (1 << 9),
   OPT_CALLER_PARK = (1 << 10),
   OPT_CALLEE_KILL = (1 << 11),
};

anonymous enum

Enumerator:

OPT_ARG_DURATION_LIMIT
OPT_ARG_DURATION_STOP
OPT_ARG_ARRAY_SIZE

Definition at line 4807 of file features.c.

     {
   OPT_ARG_DURATION_LIMIT = 0,
   OPT_ARG_DURATION_STOP,
   /* note: this entry _MUST_ be the last one in the enum */
   OPT_ARG_ARRAY_SIZE,
};

enum ast_park_call_options

Options to pass to park_call_full

Enumerator:

AST_PARK_OPT_RINGING	Provide ringing to the parked caller instead of music on hold
AST_PARK_OPT_RANDOMIZE	Randomly choose a parking spot for the caller instead of choosing the first one that is available.
AST_PARK_OPT_SILENCE	Do not announce the parking number

Definition at line 655 of file features.c.

                           {
   /*! Provide ringing to the parked caller instead of music on hold */
   AST_PARK_OPT_RINGING =   (1 << 0),
   /*! Randomly choose a parking spot for the caller instead of choosing
    *  the first one that is available. */
   AST_PARK_OPT_RANDOMIZE = (1 << 1),
   /*! Do not announce the parking number */
   AST_PARK_OPT_SILENCE = (1 << 2),
};

---

Function Documentation

static void __fini_feature_groups

(

void

)

[static]

Definition at line 306 of file features.c.

{

static void __fini_feature_list

(

void

)

[static]

Definition at line 1906 of file features.c.

{

static void __init_feature_groups

(

void

)

[static]

Definition at line 306 of file features.c.

{

static void __init_feature_list

(

void

)

[static]

Definition at line 1906 of file features.c.

{

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

Bridge channels together.

Parameters:

	s
	m	Make sure valid channels were specified, send errors if any of the channels could not be found/locked, answer channels if needed, create the placeholder channels and grab the other channels make the channels compatible, send error if we fail doing so setup the bridge thread object and start the bridge.

Return values:

	0	on success or on incorrect use.
	1	on failure to bridge channels.

Definition at line 4414 of file features.c.

References ast_channel::_state, ast_answer(), ast_calloc, ast_channel_alloc, ast_channel_get_by_name_prefix(), ast_channel_make_compatible(), ast_channel_unref, ast_hangup(), ast_log(), AST_STATE_DOWN, AST_STATE_UP, ast_streamfile(), ast_strlen_zero(), ast_true(), ast_waitstream(), astman_get_header(), astman_send_ack(), astman_send_error(), bridge_call_thread_launch(), buf, ast_bridge_thread_obj::chan, do_bridge_masquerade(), errno, ast_channel::linkedid, LOG_WARNING, ast_channel::name, ast_bridge_thread_obj::peer, playtone(), ast_bridge_thread_obj::return_to_pbx, and xfersound.

Referenced by ast_features_init().

{
   const char *channela = astman_get_header(m, "Channel1");
   const char *channelb = astman_get_header(m, "Channel2");
   const char *playtone = astman_get_header(m, "Tone");
   struct ast_channel *chana = NULL, *chanb = NULL;
   struct ast_channel *tmpchana = NULL, *tmpchanb = NULL;
   struct ast_bridge_thread_obj *tobj = NULL;

   /* make sure valid channels were specified */
   if (ast_strlen_zero(channela) || ast_strlen_zero(channelb)) {
      astman_send_error(s, m, "Missing channel parameter in request");
      return 0;
   }

   /* Start with chana */
   chana = ast_channel_get_by_name_prefix(channela, strlen(channela));

   /* send errors if any of the channels could not be found/locked */
   if (!chana) {
      char buf[256];
      snprintf(buf, sizeof(buf), "Channel1 does not exists: %s", channela);
      astman_send_error(s, m, buf);
      return 0;
   }

   /* Answer the channels if needed */
   if (chana->_state != AST_STATE_UP)
      ast_answer(chana);

   /* create the placeholder channels and grab the other channels */
   if (!(tmpchana = ast_channel_alloc(0, AST_STATE_DOWN, NULL, NULL, NULL, 
      NULL, NULL, chana->linkedid, 0, "Bridge/%s", chana->name))) {
      astman_send_error(s, m, "Unable to create temporary channel!");
      chana = ast_channel_unref(chana);
      return 1;
   }

   do_bridge_masquerade(chana, tmpchana);

   chana = ast_channel_unref(chana);

   /* now do chanb */
   chanb = ast_channel_get_by_name_prefix(channelb, strlen(channelb));
   /* send errors if any of the channels could not be found/locked */
   if (!chanb) {
      char buf[256];
      snprintf(buf, sizeof(buf), "Channel2 does not exists: %s", channelb);
      ast_hangup(tmpchana);
      astman_send_error(s, m, buf);
      return 0;
   }

   /* Answer the channels if needed */
   if (chanb->_state != AST_STATE_UP)
      ast_answer(chanb);

   /* create the placeholder channels and grab the other channels */
   if (!(tmpchanb = ast_channel_alloc(0, AST_STATE_DOWN, NULL, NULL, NULL, 
      NULL, NULL, chanb->linkedid, 0, "Bridge/%s", chanb->name))) {
      astman_send_error(s, m, "Unable to create temporary channels!");
      ast_hangup(tmpchana);
      chanb = ast_channel_unref(chanb);
      return 1;
   }

   do_bridge_masquerade(chanb, tmpchanb);

   chanb = ast_channel_unref(chanb);

   /* make the channels compatible, send error if we fail doing so */
   if (ast_channel_make_compatible(tmpchana, tmpchanb)) {
      ast_log(LOG_WARNING, "Could not make channels %s and %s compatible for manager bridge\n", tmpchana->name, tmpchanb->name);
      astman_send_error(s, m, "Could not make channels compatible for manager bridge");
      ast_hangup(tmpchana);
      ast_hangup(tmpchanb);
      return 1;
   }

   /* setup the bridge thread object and start the bridge */
   if (!(tobj = ast_calloc(1, sizeof(*tobj)))) {
      ast_log(LOG_WARNING, "Unable to spawn a new bridge thread on %s and %s: %s\n", tmpchana->name, tmpchanb->name, strerror(errno));
      astman_send_error(s, m, "Unable to spawn a new bridge thread");
      ast_hangup(tmpchana);
      ast_hangup(tmpchanb);
      return 1;
   }

   tobj->chan = tmpchana;
   tobj->peer = tmpchanb;
   tobj->return_to_pbx = 1;

   if (ast_true(playtone)) {
      if (!ast_strlen_zero(xfersound) && !ast_streamfile(tmpchanb, xfersound, tmpchanb->language)) {
         if (ast_waitstream(tmpchanb, "") < 0)
            ast_log(LOG_WARNING, "Failed to play a courtesy tone on chan %s\n", tmpchanb->name);
      }
   }

   bridge_call_thread_launch(tobj);

   astman_send_ack(s, m, "Launched bridge thread with success");

   return 0;
}

static void add_features_datastores	(	struct ast_channel *	caller,
		struct ast_channel *	callee,
		struct ast_bridge_config *	config
	)			[static]

Definition at line 2645 of file features.c.

References ast_calloc, ast_channel_datastore_add(), ast_channel_datastore_find(), ast_channel_lock, ast_channel_unlock, ast_copy_flags, ast_datastore_alloc, ast_datastore_free(), AST_FLAGS_ALL, ast_log(), ast_datastore::data, DATASTORE_INHERIT_FOREVER, ast_dial_features::features_callee, ast_bridge_config::features_callee, ast_dial_features::features_caller, ast_bridge_config::features_caller, ast_datastore::inheritance, ast_dial_features::is_caller, and LOG_WARNING.

Referenced by ast_bridge_call().

{
   struct ast_datastore *ds_callee_features = NULL, *ds_caller_features = NULL;
   struct ast_dial_features *callee_features = NULL, *caller_features = NULL;

   ast_channel_lock(caller);
   ds_caller_features = ast_channel_datastore_find(caller, &dial_features_info, NULL);
   ast_channel_unlock(caller);
   if (!ds_caller_features) {
      if (!(ds_caller_features = ast_datastore_alloc(&dial_features_info, NULL))) {
         ast_log(LOG_WARNING, "Unable to create channel datastore for caller features. Aborting!\n");
         return;
      }
      if (!(caller_features = ast_calloc(1, sizeof(*caller_features)))) {
         ast_log(LOG_WARNING, "Unable to allocate memory for callee feature flags. Aborting!\n");
         ast_datastore_free(ds_caller_features);
         return;
      }
      ds_caller_features->inheritance = DATASTORE_INHERIT_FOREVER;
      caller_features->is_caller = 1;
      ast_copy_flags(&(caller_features->features_callee), &(config->features_callee), AST_FLAGS_ALL);
      ast_copy_flags(&(caller_features->features_caller), &(config->features_caller), AST_FLAGS_ALL);
      ds_caller_features->data = caller_features;
      ast_channel_lock(caller);
      ast_channel_datastore_add(caller, ds_caller_features);
      ast_channel_unlock(caller);
   } else {
      /* If we don't return here, then when we do a builtin_atxfer we will copy the disconnect
       * flags over from the atxfer to the caller */
      return;
   }

   ast_channel_lock(callee);
   ds_callee_features = ast_channel_datastore_find(callee, &dial_features_info, NULL);
   ast_channel_unlock(callee);
   if (!ds_callee_features) {
      if (!(ds_callee_features = ast_datastore_alloc(&dial_features_info, NULL))) {
         ast_log(LOG_WARNING, "Unable to create channel datastore for callee features. Aborting!\n");
         return;
      }
      if (!(callee_features = ast_calloc(1, sizeof(*callee_features)))) {
         ast_log(LOG_WARNING, "Unable to allocate memory for callee feature flags. Aborting!\n");
         ast_datastore_free(ds_callee_features);
         return;
      }
      ds_callee_features->inheritance = DATASTORE_INHERIT_FOREVER;
      callee_features->is_caller = 0;
      ast_copy_flags(&(callee_features->features_callee), &(config->features_caller), AST_FLAGS_ALL);
      ast_copy_flags(&(callee_features->features_caller), &(config->features_callee), AST_FLAGS_ALL);
      ds_callee_features->data = callee_features;
      ast_channel_lock(callee);
      ast_channel_datastore_add(callee, ds_callee_features);
      ast_channel_unlock(callee);
   }

   return;
}

static int adsi_announce_park	(	struct ast_channel *	chan,
		char *	parkingexten
	)			[static]

Announce call parking by ADSI.

Parameters:

	chan	.
	parkingexten	. Create message to show for ADSI, display message.

Return values:

	0	on success.
	-1	on failure.

Definition at line 593 of file features.c.

References ADSI_JUST_CENT, ast_adsi_load_session, ast_adsi_print, and justify.

Referenced by park_call_full().

{
   int res;
   int justify[5] = {ADSI_JUST_CENT, ADSI_JUST_CENT, ADSI_JUST_CENT, ADSI_JUST_CENT};
   char tmp[256];
   char *message[5] = {NULL, NULL, NULL, NULL, NULL};

   snprintf(tmp, sizeof(tmp), "Parked on %s", parkingexten);
   message[0] = tmp;
   res = ast_adsi_load_session(chan, NULL, 0, 1);
   if (res == -1)
      return res;
   return ast_adsi_print(chan, message, justify, 1);
}

int ast_bridge_call	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config
	)

bridge the call and set CDR

Bridge a call, optionally allowing redirection.

Parameters:

chan,peer,config

Set start time, check for two channels,check if monitor on check for feature activation, create new CDR

Return values:

	res	on success.
	-1	on failure to bridge.

append the event to featurecode. we rely on the string being zero-filled, and not overflowing it.

Todo:

XXX how do we guarantee the latter ?

Definition at line 2712 of file features.c.

References ast_channel::_state, ast_channel::accountcode, ast_cdr::accountcode, add_features_datastores(), ast_channel::amaflags, ast_cdr::amaflags, ast_cdr::answer, ast_channel::appl, AST_BRIDGE_RETRY, ast_bridged_channel(), ast_cdr_alloc(), ast_cdr_answer(), AST_CDR_ANSWERED, ast_cdr_appenduserfield(), ast_cdr_detach(), ast_cdr_discard(), ast_cdr_dup(), ast_cdr_end(), AST_CDR_FLAG_BRIDGED, AST_CDR_FLAG_MAIN, AST_CDR_FLAG_POST_DISABLED, AST_CDR_NULL, ast_cdr_setcid(), ast_cdr_setuserfield(), ast_cdr_specialized_reset(), ast_cdr_start(), ast_cdr_update(), AST_CEL_BRIDGE_END, AST_CEL_BRIDGE_START, ast_cel_report_event(), ast_channel_bridge(), ast_channel_connected_line_macro(), ast_channel_get_by_name(), ast_channel_lock, ast_channel_log(), ast_channel_set_linkgroup(), ast_channel_setoption(), ast_channel_unlock, ast_channel_unref, ast_check_hangup(), ast_clear_flag, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_FLASH, AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_OPTION, AST_CONTROL_RINGING, AST_CONTROL_UNHOLD, ast_copy_string(), ast_debug, ast_default_amaflags, ast_dtmf_stream(), ast_exists_extension(), AST_FEATURE_NO_H_EXTEN, AST_FEATURE_RETURN_PASSDIGITS, AST_FEATURE_RETURN_SUCCESS, AST_FEATURE_WARNING_ACTIVE, AST_FLAG_BRIDGE_HANGUP_DONT, AST_FLAG_BRIDGE_HANGUP_RUN, AST_FLAG_IN_AUTOLOOP, AST_FLAG_ZOMBIE, AST_FRAME_CONTROL, AST_FRAME_DTMF, AST_FRAME_DTMF_BEGIN, AST_FRAME_DTMF_END, ast_free, ast_frfree, ast_indicate(), ast_indicate_data(), ast_log(), ast_opt_end_cdr_before_h_exten, AST_OPTION_FLAG_REQUEST, ast_raw_answer(), ast_set2_flag, ast_set_flag, ast_spawn_extension(), AST_STATE_RINGING, AST_STATE_UP, ast_strdupa, ast_strlen_zero(), ast_test_flag, ast_tvcmp(), ast_tvdiff_ms(), ast_tvnow(), ast_tvzero(), ast_verb, ast_channel::cdr, ast_cdr::channel, ast_channel::cid, ast_callerid::cid_num, ast_channel::context, ast_option_header::data, ast_frame::data, ast_channel::data, ast_frame::datalen, ast_cdr::dcontext, ast_cdr::disposition, ast_cdr::dst, ast_cdr::dstchannel, ast_bridge_config::end_bridge_callback, ast_bridge_config::end_bridge_callback_data, ast_channel::exten, f, feature_interpret(), FEATURE_MAX_LEN, FEATURE_SENSE_CHAN, FEATURE_SENSE_PEER, ast_bridge_config::feature_start_time, ast_bridge_config::feature_timer, featuredigittimeout, ast_bridge_config::features_caller, ast_frame::frametype, ast_cdr::lastapp, ast_cdr::lastdata, LOG_WARNING, monitor_app, monitor_ok, ast_channel::name, ast_cdr::next, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), pbx_exec(), pbx_findapp(), pick_unlocked_cdr(), ast_channel::priority, ast_frame::ptr, S_OR, set_bridge_features_on_config(), set_config_flags(), ast_cdr::start, ast_frame::subclass, ast_bridge_config::timelimit, ast_channel::uniqueid, ast_cdr::uniqueid, ast_cdr::userfield, and ast_channel::visible_indication.

Referenced by app_exec(), bridge_call_thread(), bridge_exec(), builtin_atxfer(), dial_exec_full(), park_exec_full(), and try_calling().

{
   /* Copy voice back and forth between the two channels.  Give the peer
      the ability to transfer calls with '#<extension' syntax. */
   struct ast_frame *f;
   struct ast_channel *who;
   char chan_featurecode[FEATURE_MAX_LEN + 1]="";
   char peer_featurecode[FEATURE_MAX_LEN + 1]="";
   char orig_channame[AST_MAX_EXTENSION];
   char orig_peername[AST_MAX_EXTENSION];
   int res;
   int diff;
   int hasfeatures=0;
   int hadfeatures=0;
   int autoloopflag;
   struct ast_option_header *aoh;
   struct ast_cdr *bridge_cdr = NULL;
   struct ast_cdr *orig_peer_cdr = NULL;
   struct ast_cdr *chan_cdr = pick_unlocked_cdr(chan->cdr); /* the proper chan cdr, if there are forked cdrs */
   struct ast_cdr *peer_cdr = pick_unlocked_cdr(peer->cdr); /* the proper chan cdr, if there are forked cdrs */
   struct ast_cdr *new_chan_cdr = NULL; /* the proper chan cdr, if there are forked cdrs */
   struct ast_cdr *new_peer_cdr = NULL; /* the proper chan cdr, if there are forked cdrs */

   if (chan && peer) {
      pbx_builtin_setvar_helper(chan, "BRIDGEPEER", peer->name);
      pbx_builtin_setvar_helper(peer, "BRIDGEPEER", chan->name);
   } else if (chan) {
      pbx_builtin_setvar_helper(chan, "BLINDTRANSFER", NULL);
   }

   set_bridge_features_on_config(config, pbx_builtin_getvar_helper(chan, "BRIDGE_FEATURES"));
   add_features_datastores(chan, peer, config);

   /* This is an interesting case.  One example is if a ringing channel gets redirected to
    * an extension that picks up a parked call.  This will make sure that the call taken
    * out of parking gets told that the channel it just got bridged to is still ringing. */
   if (chan->_state == AST_STATE_RINGING && peer->visible_indication != AST_CONTROL_RINGING) {
      ast_indicate(peer, AST_CONTROL_RINGING);
   }

   if (monitor_ok) {
      const char *monitor_exec;
      struct ast_channel *src = NULL;
      if (!monitor_app) {
         if (!(monitor_app = pbx_findapp("Monitor")))
            monitor_ok=0;
      }
      if ((monitor_exec = pbx_builtin_getvar_helper(chan, "AUTO_MONITOR"))) 
         src = chan;
      else if ((monitor_exec = pbx_builtin_getvar_helper(peer, "AUTO_MONITOR")))
         src = peer;
      if (monitor_app && src) {
         char *tmp = ast_strdupa(monitor_exec);
         pbx_exec(src, monitor_app, tmp);
      }
   }

   set_config_flags(chan, peer, config);

   /* Answer if need be */
   if (chan->_state != AST_STATE_UP) {
      if (ast_raw_answer(chan, 1)) {
         return -1;
      }
   }

#ifdef FOR_DEBUG
   /* show the two channels and cdrs involved in the bridge for debug & devel purposes */
   ast_channel_log("Pre-bridge CHAN Channel info", chan);
   ast_channel_log("Pre-bridge PEER Channel info", peer);
#endif
   /* two channels are being marked as linked here */
   ast_channel_set_linkgroup(chan,peer);

   /* copy the userfield from the B-leg to A-leg if applicable */
   if (chan->cdr && peer->cdr && !ast_strlen_zero(peer->cdr->userfield)) {
      char tmp[256];
      if (!ast_strlen_zero(chan->cdr->userfield)) {
         snprintf(tmp, sizeof(tmp), "%s;%s", chan->cdr->userfield, peer->cdr->userfield);
         ast_cdr_appenduserfield(chan, tmp);
      } else
         ast_cdr_setuserfield(chan, peer->cdr->userfield);
      /* free the peer's cdr without ast_cdr_free complaining */
      ast_free(peer->cdr);
      peer->cdr = NULL;
   }
   ast_copy_string(orig_channame,chan->name,sizeof(orig_channame));
   ast_copy_string(orig_peername,peer->name,sizeof(orig_peername));
   orig_peer_cdr = peer_cdr;
   
   if (!chan_cdr || (chan_cdr && !ast_test_flag(chan_cdr, AST_CDR_FLAG_POST_DISABLED))) {
      
      if (chan_cdr) {
         ast_set_flag(chan_cdr, AST_CDR_FLAG_MAIN);
         ast_cdr_update(chan);
         bridge_cdr = ast_cdr_dup(chan_cdr);
         ast_copy_string(bridge_cdr->lastapp, S_OR(chan->appl, ""), sizeof(bridge_cdr->lastapp));
         ast_copy_string(bridge_cdr->lastdata, S_OR(chan->data, ""), sizeof(bridge_cdr->lastdata));
      } else {
         /* better yet, in a xfer situation, find out why the chan cdr got zapped (pun unintentional) */
         bridge_cdr = ast_cdr_alloc(); /* this should be really, really rare/impossible? */
         ast_copy_string(bridge_cdr->channel, chan->name, sizeof(bridge_cdr->channel));
         ast_copy_string(bridge_cdr->dstchannel, peer->name, sizeof(bridge_cdr->dstchannel));
         ast_copy_string(bridge_cdr->uniqueid, chan->uniqueid, sizeof(bridge_cdr->uniqueid));
         ast_copy_string(bridge_cdr->lastapp, S_OR(chan->appl, ""), sizeof(bridge_cdr->lastapp));
         ast_copy_string(bridge_cdr->lastdata, S_OR(chan->data, ""), sizeof(bridge_cdr->lastdata));
         ast_cdr_setcid(bridge_cdr, chan);
         bridge_cdr->disposition = (chan->_state == AST_STATE_UP) ?  AST_CDR_ANSWERED : AST_CDR_NULL;
         bridge_cdr->amaflags = chan->amaflags ? chan->amaflags :  ast_default_amaflags;
         ast_copy_string(bridge_cdr->accountcode, chan->accountcode, sizeof(bridge_cdr->accountcode));
         /* Destination information */
         ast_copy_string(bridge_cdr->dst, chan->exten, sizeof(bridge_cdr->dst));
         ast_copy_string(bridge_cdr->dcontext, chan->context, sizeof(bridge_cdr->dcontext));
         if (peer_cdr) {
            bridge_cdr->start = peer_cdr->start;
            ast_copy_string(bridge_cdr->userfield, peer_cdr->userfield, sizeof(bridge_cdr->userfield));
         } else {
            ast_cdr_start(bridge_cdr);
         }
      }
      ast_debug(4,"bridge answer set, chan answer set\n");
      /* peer_cdr->answer will be set when a macro runs on the peer;
         in that case, the bridge answer will be delayed while the
         macro plays on the peer channel. The peer answered the call
         before the macro started playing. To the phone system,
         this is billable time for the call, even tho the caller
         hears nothing but ringing while the macro does its thing. */

      /* Another case where the peer cdr's time will be set, is when
         A self-parks by pickup up phone and dialing 700, then B
         picks up A by dialing its parking slot; there may be more 
         practical paths that get the same result, tho... in which
         case you get the previous answer time from the Park... which
         is before the bridge's start time, so I added in the 
         tvcmp check to the if below */

      if (peer_cdr && !ast_tvzero(peer_cdr->answer) && ast_tvcmp(peer_cdr->answer, bridge_cdr->start) >= 0) {
         bridge_cdr->answer = peer_cdr->answer;
         bridge_cdr->disposition = peer_cdr->disposition;
         if (chan_cdr) {
            chan_cdr->answer = peer_cdr->answer;
            chan_cdr->disposition = peer_cdr->disposition;
         }
      } else {
         ast_cdr_answer(bridge_cdr);
         if (chan_cdr) {
            ast_cdr_answer(chan_cdr); /* for the sake of cli status checks */
         }
      }
      if (ast_test_flag(chan,AST_FLAG_BRIDGE_HANGUP_DONT) && (chan_cdr || peer_cdr)) {
         if (chan_cdr) {
            ast_set_flag(chan_cdr, AST_CDR_FLAG_BRIDGED);
         }
         if (peer_cdr) {
            ast_set_flag(peer_cdr, AST_CDR_FLAG_BRIDGED);
         }
      }
   }
   ast_cel_report_event(chan, AST_CEL_BRIDGE_START, NULL, NULL, NULL);
   for (;;) {
      struct ast_channel *other; /* used later */
   
      res = ast_channel_bridge(chan, peer, config, &f, &who);
      
      /* When frame is not set, we are probably involved in a situation
         where we've timed out.
         When frame is set, we'll come this code twice; once for DTMF_BEGIN
         and also for DTMF_END. If we flow into the following 'if' for both, then 
         our wait times are cut in half, as both will subtract from the
         feature_timer. Not good!
      */
      if (config->feature_timer && (!f || f->frametype == AST_FRAME_DTMF_END)) {
         /* Update feature timer for next pass */
         diff = ast_tvdiff_ms(ast_tvnow(), config->feature_start_time);
         if (res == AST_BRIDGE_RETRY) {
            /* The feature fully timed out but has not been updated. Skip
             * the potential round error from the diff calculation and
             * explicitly set to expired. */
            config->feature_timer = -1;
         } else {
            config->feature_timer -= diff;
         }

         if (hasfeatures) {
            if (config->feature_timer <= 0) {
               /* Not *really* out of time, just out of time for
                  digits to come in for features. */
               ast_debug(1, "Timed out for feature!\n");
               if (!ast_strlen_zero(peer_featurecode)) {
                  ast_dtmf_stream(chan, peer, peer_featurecode, 0, 0);
                  memset(peer_featurecode, 0, sizeof(peer_featurecode));
               }
               if (!ast_strlen_zero(chan_featurecode)) {
                  ast_dtmf_stream(peer, chan, chan_featurecode, 0, 0);
                  memset(chan_featurecode, 0, sizeof(chan_featurecode));
               }
               if (f)
                  ast_frfree(f);
               hasfeatures = !ast_strlen_zero(chan_featurecode) || !ast_strlen_zero(peer_featurecode);
               if (!hasfeatures) {
                  /* No more digits expected - reset the timer */
                  config->feature_timer = 0;
               }
               hadfeatures = hasfeatures;
               /* Continue as we were */
               continue;
            } else if (!f) {
               /* The bridge returned without a frame and there is a feature in progress.
                * However, we don't think the feature has quite yet timed out, so just
                * go back into the bridge. */
               continue;
            }
         } else {
            if (config->feature_timer <=0) {
               /* We ran out of time */
               config->feature_timer = 0;
               who = chan;
               if (f)
                  ast_frfree(f);
               f = NULL;
               res = 0;
            }
         }
      }
      if (res < 0) {
         if (!ast_test_flag(chan, AST_FLAG_ZOMBIE) && !ast_test_flag(peer, AST_FLAG_ZOMBIE) && !ast_check_hangup(chan) && !ast_check_hangup(peer)) {
            ast_log(LOG_WARNING, "Bridge failed on channels %s and %s\n", chan->name, peer->name);
         }
         goto before_you_go;
      }
      
      if (!f || (f->frametype == AST_FRAME_CONTROL &&
            (f->subclass == AST_CONTROL_HANGUP || f->subclass == AST_CONTROL_BUSY ||
               f->subclass == AST_CONTROL_CONGESTION))) {
         res = -1;
         break;
      }
      /* many things should be sent to the 'other' channel */
      other = (who == chan) ? peer : chan;
      if (f->frametype == AST_FRAME_CONTROL) {
         switch (f->subclass) {
         case AST_CONTROL_RINGING:
         case AST_CONTROL_FLASH:
         case -1:
            ast_indicate(other, f->subclass);
            break;
         case AST_CONTROL_CONNECTED_LINE:
            if (!ast_channel_connected_line_macro(who, other, f, who != chan, 1)) {
               break;
            }
            /* The implied "else" falls through purposely */
         case AST_CONTROL_HOLD:
         case AST_CONTROL_UNHOLD:
            ast_indicate_data(other, f->subclass, f->data.ptr, f->datalen);
            break;
         case AST_CONTROL_OPTION:
            aoh = f->data.ptr;
            /* Forward option Requests */
            if (aoh && aoh->flag == AST_OPTION_FLAG_REQUEST) {
               ast_channel_setoption(other, ntohs(aoh->option), aoh->data, 
                  f->datalen - sizeof(struct ast_option_header), 0);
            }
            break;
         }
      } else if (f->frametype == AST_FRAME_DTMF_BEGIN) {
         /* eat it */
      } else if (f->frametype == AST_FRAME_DTMF) {
         char *featurecode;
         int sense;

         hadfeatures = hasfeatures;
         /* This cannot overrun because the longest feature is one shorter than our buffer */
         if (who == chan) {
            sense = FEATURE_SENSE_CHAN;
            featurecode = chan_featurecode;
         } else  {
            sense = FEATURE_SENSE_PEER;
            featurecode = peer_featurecode;
         }
         /*! append the event to featurecode. we rely on the string being zero-filled, and
          * not overflowing it. 
          * \todo XXX how do we guarantee the latter ?
          */
         featurecode[strlen(featurecode)] = f->subclass;
         /* Get rid of the frame before we start doing "stuff" with the channels */
         ast_frfree(f);
         f = NULL;
         config->feature_timer = 0;
         res = feature_interpret(chan, peer, config, featurecode, sense);
         switch(res) {
         case AST_FEATURE_RETURN_PASSDIGITS:
            ast_dtmf_stream(other, who, featurecode, 0, 0);
            /* Fall through */
         case AST_FEATURE_RETURN_SUCCESS:
            memset(featurecode, 0, sizeof(chan_featurecode));
            break;
         }
         if (res >= AST_FEATURE_RETURN_PASSDIGITS) {
            res = 0;
         } else {
            break;
         }
         hasfeatures = !ast_strlen_zero(chan_featurecode) || !ast_strlen_zero(peer_featurecode);
         if (hadfeatures && !hasfeatures) {
            /* Feature completed or timed out */
            config->feature_timer = 0;
         } else if (hasfeatures) {
            if (config->timelimit) {
               /* No warning next time - we are waiting for future */
               ast_set_flag(config, AST_FEATURE_WARNING_ACTIVE);
            }
            config->feature_start_time = ast_tvnow();
            config->feature_timer = featuredigittimeout;
            ast_debug(1, "Set feature timer to %ld\n", config->feature_timer);
         }
      }
      if (f)
         ast_frfree(f);

   }
   ast_cel_report_event(chan, AST_CEL_BRIDGE_END, NULL, NULL, NULL);
   before_you_go:

   if (ast_test_flag(chan,AST_FLAG_BRIDGE_HANGUP_DONT)) {
      ast_clear_flag(chan,AST_FLAG_BRIDGE_HANGUP_DONT); /* its job is done */
      if (bridge_cdr) {
         ast_cdr_discard(bridge_cdr);
         /* QUESTION: should we copy bridge_cdr fields to the peer before we throw it away? */
      }
      return res; /* if we shouldn't do the h-exten, we shouldn't do the bridge cdr, either! */
   }

   if (config->end_bridge_callback) {
      config->end_bridge_callback(config->end_bridge_callback_data);
   }

   /* run the hangup exten on the chan object IFF it was NOT involved in a parking situation 
    * if it were, then chan belongs to a different thread now, and might have been hung up long
     * ago.
    */
   if (!ast_test_flag(&(config->features_caller),AST_FEATURE_NO_H_EXTEN) &&
      ast_exists_extension(chan, chan->context, "h", 1, chan->cid.cid_num)) {
      struct ast_cdr *swapper = NULL;
      char savelastapp[AST_MAX_EXTENSION];
      char savelastdata[AST_MAX_EXTENSION];
      char save_exten[AST_MAX_EXTENSION];
      int  save_prio;
      int  found = 0;   /* set if we find at least one match */
      int  spawn_error = 0;
      
      autoloopflag = ast_test_flag(chan, AST_FLAG_IN_AUTOLOOP);
      ast_set_flag(chan, AST_FLAG_IN_AUTOLOOP);
      if (bridge_cdr && ast_opt_end_cdr_before_h_exten) {
         ast_cdr_end(bridge_cdr);
      }
      /* swap the bridge cdr and the chan cdr for a moment, and let the endbridge
         dialplan code operate on it */
      ast_channel_lock(chan);
      if (bridge_cdr) {
         swapper = chan->cdr;
         ast_copy_string(savelastapp, bridge_cdr->lastapp, sizeof(bridge_cdr->lastapp));
         ast_copy_string(savelastdata, bridge_cdr->lastdata, sizeof(bridge_cdr->lastdata));
         chan->cdr = bridge_cdr;
      }
      ast_copy_string(save_exten, chan->exten, sizeof(save_exten));
      save_prio = chan->priority;
      ast_copy_string(chan->exten, "h", sizeof(chan->exten));
      chan->priority = 1;
      ast_channel_unlock(chan);
      while ((spawn_error = ast_spawn_extension(chan, chan->context, chan->exten, chan->priority, chan->cid.cid_num, &found, 1)) == 0) {
         chan->priority++;
      }
      if (found && spawn_error) {
         /* Something bad happened, or a hangup has been requested. */
         ast_debug(1, "Spawn extension (%s,%s,%d) exited non-zero on '%s'\n", chan->context, chan->exten, chan->priority, chan->name);
         ast_verb(2, "Spawn extension (%s, %s, %d) exited non-zero on '%s'\n", chan->context, chan->exten, chan->priority, chan->name);
      }
      /* swap it back */
      ast_channel_lock(chan);
      ast_copy_string(chan->exten, save_exten, sizeof(chan->exten));
      chan->priority = save_prio;
      if (bridge_cdr) {
         if (chan->cdr == bridge_cdr) {
            chan->cdr = swapper;
         } else {
            bridge_cdr = NULL;
         }
      }
      if (chan->priority != 1 || !spawn_error) {
         ast_set_flag(chan, AST_FLAG_BRIDGE_HANGUP_RUN);
      }
      ast_channel_unlock(chan);
      /* protect the lastapp/lastdata against the effects of the hangup/dialplan code */
      if (bridge_cdr) {
         ast_copy_string(bridge_cdr->lastapp, savelastapp, sizeof(bridge_cdr->lastapp));
         ast_copy_string(bridge_cdr->lastdata, savelastdata, sizeof(bridge_cdr->lastdata));
      }
      ast_set2_flag(chan, autoloopflag, AST_FLAG_IN_AUTOLOOP);
   }
   
   /* obey the NoCDR() wishes. -- move the DISABLED flag to the bridge CDR if it was set on the channel during the bridge... */
   new_chan_cdr = pick_unlocked_cdr(chan->cdr); /* the proper chan cdr, if there are forked cdrs */
   if (bridge_cdr && new_chan_cdr && ast_test_flag(new_chan_cdr, AST_CDR_FLAG_POST_DISABLED))
      ast_set_flag(bridge_cdr, AST_CDR_FLAG_POST_DISABLED);

   /* we can post the bridge CDR at this point */
   if (bridge_cdr) {
      ast_cdr_end(bridge_cdr);
      ast_cdr_detach(bridge_cdr);
   }
   
   /* do a specialized reset on the beginning channel
      CDR's, if they still exist, so as not to mess up
      issues in future bridges;
      
      Here are the rules of the game:
      1. The chan and peer channel pointers will not change
         during the life of the bridge.
      2. But, in transfers, the channel names will change.
         between the time the bridge is started, and the
         time the channel ends. 
         Usually, when a channel changes names, it will
         also change CDR pointers.
      3. Usually, only one of the two channels (chan or peer)
         will change names.
      4. Usually, if a channel changes names during a bridge,
         it is because of a transfer. Usually, in these situations,
         it is normal to see 2 bridges running simultaneously, and
         it is not unusual to see the two channels that change
         swapped between bridges.
      5. After a bridge occurs, we have 2 or 3 channels' CDRs
         to attend to; if the chan or peer changed names,
         we have the before and after attached CDR's.
   */

   if (new_chan_cdr) {
      struct ast_channel *chan_ptr = NULL;

      if (strcasecmp(orig_channame, chan->name) != 0) { 
         /* old channel */
         if ((chan_ptr = ast_channel_get_by_name(orig_channame))) {
            ast_channel_lock(chan_ptr);
            if (!ast_bridged_channel(chan_ptr)) {
               struct ast_cdr *cur;
               for (cur = chan_ptr->cdr; cur; cur = cur->next) {
                  if (cur == chan_cdr) {
                     break;
                  }
               }
               if (cur) {
                  ast_cdr_specialized_reset(chan_cdr, 0);
               }
            }
            ast_channel_unlock(chan_ptr);
            chan_ptr = ast_channel_unref(chan_ptr);
         }
         /* new channel */
         ast_cdr_specialized_reset(new_chan_cdr, 0);
      } else {
         ast_cdr_specialized_reset(chan_cdr, 0); /* nothing changed, reset the chan_cdr  */
      }
   }

   {
      struct ast_channel *chan_ptr = NULL;
      new_peer_cdr = pick_unlocked_cdr(peer->cdr); /* the proper chan cdr, if there are forked cdrs */
      if (new_chan_cdr && ast_test_flag(new_chan_cdr, AST_CDR_FLAG_POST_DISABLED) && new_peer_cdr && !ast_test_flag(new_peer_cdr, AST_CDR_FLAG_POST_DISABLED))
         ast_set_flag(new_peer_cdr, AST_CDR_FLAG_POST_DISABLED); /* DISABLED is viral-- it will propagate across a bridge */
      if (strcasecmp(orig_peername, peer->name) != 0) { 
         /* old channel */
         if ((chan_ptr = ast_channel_get_by_name(orig_peername))) {
            ast_channel_lock(chan_ptr);
            if (!ast_bridged_channel(chan_ptr)) {
               struct ast_cdr *cur;
               for (cur = chan_ptr->cdr; cur; cur = cur->next) {
                  if (cur == peer_cdr) {
                     break;
                  }
               }
               if (cur) {
                  ast_cdr_specialized_reset(peer_cdr, 0);
               }
            }
            ast_channel_unlock(chan_ptr);
            chan_ptr = ast_channel_unref(chan_ptr);
         }
         /* new channel */
         if (new_peer_cdr) {
            ast_cdr_specialized_reset(new_peer_cdr, 0);
         }
      } else {
         ast_cdr_specialized_reset(peer_cdr, 0); /* nothing changed, reset the peer_cdr  */
      }
   }
   
   return res;
}

int ast_bridge_timelimit	(	struct ast_channel *	chan,
		struct ast_bridge_config *	config,
		char *	parse,
		struct timeval *	calldurationlimit
	)

Definition at line 4829 of file features.c.

References ast_channel_lock, ast_channel_unlock, AST_FEATURE_PLAY_WARNING, ast_log(), ast_set_flag, ast_strdup, ast_strdupa, ast_strlen_zero(), ast_true(), ast_verb, ast_bridge_config::end_sound, ast_bridge_config::features_callee, ast_bridge_config::features_caller, LOG_WARNING, pbx_builtin_getvar_helper(), ast_bridge_config::play_warning, S_OR, ast_bridge_config::start_sound, strsep(), ast_bridge_config::timelimit, var, ast_bridge_config::warning_freq, and ast_bridge_config::warning_sound.

Referenced by bridge_exec(), and dial_exec_full().

{
   char *stringp = ast_strdupa(parse);
   char *limit_str, *warning_str, *warnfreq_str;
   const char *var;
   int play_to_caller = 0, play_to_callee = 0;
   int delta;

   limit_str = strsep(&stringp, ":");
   warning_str = strsep(&stringp, ":");
   warnfreq_str = strsep(&stringp, ":");

   config->timelimit = atol(limit_str);
   if (warning_str)
      config->play_warning = atol(warning_str);
   if (warnfreq_str)
      config->warning_freq = atol(warnfreq_str);

   if (!config->timelimit) {
      ast_log(LOG_WARNING, "Bridge does not accept L(%s), hanging up.\n", limit_str);
      config->timelimit = config->play_warning = config->warning_freq = 0;
      config->warning_sound = NULL;
      return -1; /* error */
   } else if ( (delta = config->play_warning - config->timelimit) > 0) {
      int w = config->warning_freq;

      /* If the first warning is requested _after_ the entire call would end,
         and no warning frequency is requested, then turn off the warning. If
         a warning frequency is requested, reduce the 'first warning' time by
         that frequency until it falls within the call's total time limit.
         Graphically:
              timelim->|    delta        |<-playwarning
         0__________________|_________________|
                | w  |    |    |    |

         so the number of intervals to cut is 1+(delta-1)/w
      */

      if (w == 0) {
         config->play_warning = 0;
      } else {
         config->play_warning -= w * ( 1 + (delta-1)/w );
         if (config->play_warning < 1)
            config->play_warning = config->warning_freq = 0;
      }
   }
   
   ast_channel_lock(chan);

   var = pbx_builtin_getvar_helper(chan, "LIMIT_PLAYAUDIO_CALLER");
   play_to_caller = var ? ast_true(var) : 1;

   var = pbx_builtin_getvar_helper(chan, "LIMIT_PLAYAUDIO_CALLEE");
   play_to_callee = var ? ast_true(var) : 0;

   if (!play_to_caller && !play_to_callee)
      play_to_caller = 1;

   var = pbx_builtin_getvar_helper(chan, "LIMIT_WARNING_FILE");
   config->warning_sound = !ast_strlen_zero(var) ? ast_strdup(var) : ast_strdup("timeleft");

   /* The code looking at config wants a NULL, not just "", to decide
    * that the message should not be played, so we replace "" with NULL.
    * Note, pbx_builtin_getvar_helper _can_ return NULL if the variable is
    * not found.
    */

   var = pbx_builtin_getvar_helper(chan, "LIMIT_TIMEOUT_FILE");
   config->end_sound = !ast_strlen_zero(var) ? ast_strdup(var) : NULL;

   var = pbx_builtin_getvar_helper(chan, "LIMIT_CONNECT_FILE");
   config->start_sound = !ast_strlen_zero(var) ? ast_strdup(var) : NULL;

   ast_channel_unlock(chan);

   /* undo effect of S(x) in case they are both used */
   calldurationlimit->tv_sec = 0;
   calldurationlimit->tv_usec = 0;

   /* more efficient to do it like S(x) does since no advanced opts */
   if (!config->play_warning && !config->start_sound && !config->end_sound && config->timelimit) {
      calldurationlimit->tv_sec = config->timelimit / 1000;
      calldurationlimit->tv_usec = (config->timelimit % 1000) * 1000;
      ast_verb(3, "Setting call duration limit to %.3lf seconds.\n",
         calldurationlimit->tv_sec + calldurationlimit->tv_usec / 1000000.0);
      config->timelimit = play_to_caller = play_to_callee =
      config->play_warning = config->warning_freq = 0;
   } else {
      ast_verb(3, "Limit Data for this call:\n");
      ast_verb(4, "timelimit      = %ld\n", config->timelimit);
      ast_verb(4, "play_warning   = %ld\n", config->play_warning);
      ast_verb(4, "play_to_caller = %s\n", play_to_caller ? "yes" : "no");
      ast_verb(4, "play_to_callee = %s\n", play_to_callee ? "yes" : "no");
      ast_verb(4, "warning_freq   = %ld\n", config->warning_freq);
      ast_verb(4, "start_sound    = %s\n", S_OR(config->start_sound, ""));
      ast_verb(4, "warning_sound  = %s\n", config->warning_sound);
      ast_verb(4, "end_sound      = %s\n", S_OR(config->end_sound, ""));
   }
   if (play_to_caller)
      ast_set_flag(&(config->features_caller), AST_FEATURE_PLAY_WARNING);
   if (play_to_callee)
      ast_set_flag(&(config->features_callee), AST_FEATURE_PLAY_WARNING);
   return 0;
}

void ast_channel_log	(	char *	title,
		struct ast_channel *	chan
	)

Definition at line 2580 of file features.c.

References ast_log(), and LOG_NOTICE.

Referenced by ast_bridge_call().

{
       ast_log(LOG_NOTICE, "______ %s (%lx)______\n", title, (unsigned long)chan);
       ast_log(LOG_NOTICE, "CHAN: name: %s;  appl: %s; data: %s; contxt: %s;  exten: %s; pri: %d;\n",
                       chan->name, chan->appl, chan->data, chan->context, chan->exten, chan->priority);
       ast_log(LOG_NOTICE, "CHAN: acctcode: %s;  dialcontext: %s; amaflags: %x; maccontxt: %s;  macexten: %s; macpri: %d;\n",
                       chan->accountcode, chan->dialcontext, chan->amaflags, chan->macrocontext, chan->macroexten, chan->macropriority);
       ast_log(LOG_NOTICE, "CHAN: masq: %p;  masqr: %p; _bridge: %p; uniqueID: %s; linkedID:%s\n",
                       chan->masq, chan->masqr,
                       chan->_bridge, chan->uniqueid, chan->linkedid);
       if (chan->masqr)
               ast_log(LOG_NOTICE, "CHAN: masquerading as: %s;  cdr: %p;\n",
                               chan->masqr->name, chan->masqr->cdr);
       if (chan->_bridge)
               ast_log(LOG_NOTICE, "CHAN: Bridged to %s\n", chan->_bridge->name);

   ast_log(LOG_NOTICE, "===== done ====\n");
}

int ast_feature_detect	(	struct ast_channel *	chan,
		struct ast_flags *	features,
		const char *	code,
		struct ast_call_feature *	feature
	)

detect a feature before bridging

Parameters:

	chan
	ast_flags	ptr
	char	ptr of input code

Return values:

ast_call_feature

ptr to be set if found

Returns:

result, was feature found or not

Definition at line 2336 of file features.c.

References feature_interpret_helper().

Referenced by detect_disconnect().

                                                                                                                                 {

   return feature_interpret_helper(chan, NULL, NULL, code, 0, NULL, features, 0, feature);
}

int ast_features_init

(

void

)

Provided by features.c

Definition at line 5103 of file features.c.

References action_bridge(), ao2_container_alloc, ARRAY_LEN, ast_cli_register_multiple(), ast_devstate_prov_add(), ast_manager_register_xml, ast_pthread_create, ast_register_application2(), bridge_exec(), do_parking_thread(), EVENT_FLAG_CALL, load_config(), manager_park(), manager_parking_status(), metermaidstate(), park_call_exec(), park_exec(), parkcall, parkedcall, parking_thread, parkinglot_cmp_cb(), parkinglot_hash_cb(), and parkinglots.

Referenced by main().

{
   int res;

   ast_register_application2(app_bridge, bridge_exec, NULL, NULL, NULL);

   parkinglots = ao2_container_alloc(7, parkinglot_hash_cb, parkinglot_cmp_cb);

   if ((res = load_config()))
      return res;
   ast_cli_register_multiple(cli_features, ARRAY_LEN(cli_features));
   ast_pthread_create(&parking_thread, NULL, do_parking_thread, NULL);
   res = ast_register_application2(parkedcall, park_exec, NULL, NULL, NULL);
   if (!res)
      res = ast_register_application2(parkcall, park_call_exec, NULL, NULL, NULL);
   if (!res) {
      ast_manager_register_xml("ParkedCalls", 0, manager_parking_status);
      ast_manager_register_xml("Park", EVENT_FLAG_CALL, manager_park);
      ast_manager_register_xml("Bridge", EVENT_FLAG_CALL, action_bridge);
   }

   res |= ast_devstate_prov_add("Park", metermaidstate);

   return res;
}

int ast_features_reload

(

void

)

Reload call features from features.conf.

Definition at line 4343 of file features.c.

References load_config().

Referenced by handle_features_reload().

{
   int res;
   /* Release parking lot list */
   //ASTOBJ_CONTAINER_MARKALL(&parkinglots);
   // TODO: I don't think any marking is necessary

   /* Reload configuration */
   res = load_config();
   
   //ASTOBJ_CONTAINER_PRUNE_MARKED(&parkinglots, parkinglot_destroy);
   return res;
}

struct ast_call_feature* ast_find_call_feature

(

const char *

name

)

[read]

look for a call feature entry by its sname

Parameters:

name

a string ptr, should match "automon", "blindxfer", "atxfer", etc.

Definition at line 2082 of file features.c.

References FEATURES_COUNT, and ast_call_feature::sname.

Referenced by action_atxfer(), handle_request_info(), and load_config().

{
   int x;
   for (x = 0; x < FEATURES_COUNT; x++) {
      if (!strcasecmp(name, builtin_features[x].sname))
         return &builtin_features[x];
   }
   return NULL;
}

int ast_masq_park_call	(	struct ast_channel *	rchan,
		struct ast_channel *	host,
		int	timeout,
		int *	extout
	)

Park a call via a masqueraded channel.

Parameters:

	rchan	the real channel to be parked
	host	the channel to have the parking read to.
	timeout	is a timeout in milliseconds
	extout	is a parameter to an int that will hold the parked location, or NULL if you want.

Masquerade the channel rchan into a new, empty channel which is then parked with ast_park_call

Return values:

	0	on success.
	-1	on failure.

Definition at line 1010 of file features.c.

References masq_park_call().

Referenced by __analog_ss_thread(), analog_ss_thread(), handle_exec(), handle_soft_key_event_message(), handle_stimulus_message(), manager_park(), mgcp_ss(), parkandannounce_exec(), and rpt_exec().

{
   return masq_park_call(rchan, peer, timeout, extout, 0, NULL);
}

int ast_park_call	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		int	timeout,
		int *	extout
	)

Park a call.

Park a call and read back parked location.

Definition at line 944 of file features.c.

References park_call_full(), and ast_park_call_args::timeout.

Referenced by iax_park_thread(), and sip_park_thread().

{
   struct ast_park_call_args args = {
      .timeout = timeout,
      .extout = extout,
   };

   return park_call_full(chan, peer, &args);
}

const char* ast_parking_ext

(

void

)

Determine system parking extension.

Returns:

the call parking extension for drivers that provide special call parking help

Definition at line 431 of file features.c.

References parking_ext.

Referenced by __analog_ss_thread(), analog_ss_thread(), build_parkinglot(), builtin_atxfer(), builtin_blindtransfer(), dp_lookup(), handle_request_refer(), load_config(), mgcp_ss(), and socket_process().

{
   return parking_ext;
}

int ast_pickup_call

(

struct ast_channel *

chan

)

Pickup a call.

Parameters:

chan

channel that initiated pickup.

Walk list of channels, checking it is not itself, channel is pbx one, check that the callgroup for both channels are the same and the channel is ringing. Answer calling channel, flag channel as answered on queue, masq channels together.

Definition at line 4733 of file features.c.

References ast_answer(), ast_channel_callback(), ast_channel_connected_line_macro(), ast_channel_lock_both, ast_channel_masquerade(), ast_channel_queue_connected_line_update(), ast_channel_unlock, ast_channel_unref, ast_channel_update_connected_line(), AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER, AST_CONTROL_ANSWER, ast_debug, ast_log(), ast_party_connected_line_collect_caller(), ast_queue_control(), ast_strdupa, ast_stream_and_wait(), ast_strlen_zero(), ast_channel::cid, ast_channel::connected, find_channel_by_group(), LOG_WARNING, ast_channel::name, pickupfailsound, pickupsound, and ast_party_connected_line::source.

Referenced by __analog_ss_thread(), analog_ss_thread(), cb_events(), handle_request_invite(), mgcp_ss(), and pickup_exec().

{
   struct ast_channel *cur;
   struct ast_party_connected_line connected_caller;
   int res;
   const char *chan_name;
   const char *cur_name;

   if (!(cur = ast_channel_callback(find_channel_by_group, NULL, chan, 0))) {
      ast_debug(1, "No call pickup possible...\n");
      if (!ast_strlen_zero(pickupfailsound)) {
         ast_stream_and_wait(chan, pickupfailsound, "");
      }
      return -1;
   }

   ast_channel_lock_both(cur, chan);

   cur_name = ast_strdupa(cur->name);
   chan_name = ast_strdupa(chan->name);

   ast_debug(1, "Call pickup on chan '%s' by '%s'\n", cur_name, chan_name);

   connected_caller = cur->connected;
   connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
   if (ast_channel_connected_line_macro(NULL, chan, &connected_caller, 0, 0)) {
      ast_channel_update_connected_line(chan, &connected_caller);
   }

   ast_party_connected_line_collect_caller(&connected_caller, &chan->cid);
   connected_caller.source = AST_CONNECTED_LINE_UPDATE_SOURCE_ANSWER;
   ast_channel_queue_connected_line_update(chan, &connected_caller);

   ast_channel_unlock(cur);
   ast_channel_unlock(chan);

   if (ast_answer(chan)) {
      ast_log(LOG_WARNING, "Unable to answer '%s'\n", chan_name);
   }

   if (ast_queue_control(chan, AST_CONTROL_ANSWER)) {
      ast_log(LOG_WARNING, "Unable to queue answer on '%s'\n", chan_name);
   }

   if ((res = ast_channel_masquerade(cur, chan))) {
      ast_log(LOG_WARNING, "Unable to masquerade '%s' into '%s'\n", chan_name, cur_name);
   }

   if (!ast_strlen_zero(pickupsound)) {
      ast_stream_and_wait(cur, pickupsound, "");
   }

   cur = ast_channel_unref(cur);

   return res;
}

const char* ast_pickup_ext

(

void

)

Determine system call pickup extension.

Definition at line 436 of file features.c.

References pickup_ext.

Referenced by __analog_ss_thread(), analog_ss_thread(), cb_events(), get_destination(), handle_feature_show(), handle_request_invite(), and mgcp_ss().

{
   return pickup_ext;
}

void ast_rdlock_call_features

(

void

)

Definition at line 2072 of file features.c.

References ast_rwlock_rdlock(), and features_lock.

Referenced by handle_request_info().

{
   ast_rwlock_rdlock(&features_lock);
}

void ast_register_feature

(

struct ast_call_feature *

feature

)

register new feature into feature_list

register new feature into feature_set

Definition at line 1909 of file features.c.

References ast_log(), AST_RWLIST_INSERT_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_verb, ast_call_feature::feature_entry, LOG_NOTICE, and ast_call_feature::sname.

Referenced by load_config().

{
   if (!feature) {
      ast_log(LOG_NOTICE,"You didn't pass a feature!\n");
      return;
   }
  
   AST_RWLIST_WRLOCK(&feature_list);
   AST_RWLIST_INSERT_HEAD(&feature_list,feature,feature_entry);
   AST_RWLIST_UNLOCK(&feature_list);

   ast_verb(2, "Registered Feature '%s'\n",feature->sname);
}

void ast_unlock_call_features

(

void

)

Definition at line 2077 of file features.c.

References ast_rwlock_unlock(), and features_lock.

Referenced by handle_request_info().

{
   ast_rwlock_unlock(&features_lock);
}

void ast_unregister_feature

(

struct ast_call_feature *

feature

)

unregister feature from feature_set

Parameters:

feature

the ast_call_feature object which was registered before

Definition at line 1997 of file features.c.

References ast_free, AST_RWLIST_REMOVE, AST_RWLIST_UNLOCK, and AST_RWLIST_WRLOCK.

{
   if (!feature) {
      return;
   }

   AST_RWLIST_WRLOCK(&feature_list);
   AST_RWLIST_REMOVE(&feature_list, feature, feature_entry);
   AST_RWLIST_UNLOCK(&feature_list);

   ast_free(feature);
}

static void ast_unregister_features

(

void

)

[static]

Remove all features in the list.

Definition at line 2011 of file features.c.

References ast_free, AST_RWLIST_REMOVE_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, and ast_call_feature::feature_entry.

Referenced by load_config().

{
   struct ast_call_feature *feature;

   AST_RWLIST_WRLOCK(&feature_list);
   while ((feature = AST_RWLIST_REMOVE_HEAD(&feature_list, feature_entry))) {
      ast_free(feature);
   }
   AST_RWLIST_UNLOCK(&feature_list);
}

static void ast_unregister_groups

(

void

)

[static]

Remove all feature groups in the list.

Definition at line 2037 of file features.c.

References ast_free, AST_LIST_REMOVE_HEAD, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_string_field_free_memory, and feature_group::features.

Referenced by load_config().

{
   struct feature_group *fg;
   struct feature_group_exten *fge;

   AST_RWLIST_WRLOCK(&feature_groups);
   while ((fg = AST_LIST_REMOVE_HEAD(&feature_groups, entry))) {
      while ((fge = AST_LIST_REMOVE_HEAD(&fg->features, entry))) {
         ast_string_field_free_memory(fge);
         ast_free(fge);
      }

      ast_string_field_free_memory(fg);
      ast_free(fg);
   }
   AST_RWLIST_UNLOCK(&feature_groups);
}

static void* bridge_call_thread

(

void *

data

)

[static]

bridge the call

Parameters:

data

thread bridge.

Set Last Data for respective channels, reset cdr for channels bridge call, check if we're going back to dialplan if not hangup both legs of the call

Definition at line 528 of file features.c.

References ast_channel::appl, ast_bridge_call(), ast_check_hangup(), ast_free, ast_hangup(), ast_log(), ast_pbx_start(), AST_PBX_SUCCESS, ast_bridge_thread_obj::bconfig, ast_bridge_thread_obj::chan, ast_channel::data, LOG_VERBOSE, LOG_WARNING, ast_channel::name, ast_bridge_thread_obj::peer, and ast_bridge_thread_obj::return_to_pbx.

Referenced by bridge_call_thread_launch().

{
   struct ast_bridge_thread_obj *tobj = data;
   int res;

   tobj->chan->appl = !tobj->return_to_pbx ? "Transferred Call" : "ManagerBridge";
   tobj->chan->data = tobj->peer->name;
   tobj->peer->appl = !tobj->return_to_pbx ? "Transferred Call" : "ManagerBridge";
   tobj->peer->data = tobj->chan->name;

   ast_bridge_call(tobj->peer, tobj->chan, &tobj->bconfig);

   if (tobj->return_to_pbx) {
      if (!ast_check_hangup(tobj->peer)) {
         ast_log(LOG_VERBOSE, "putting peer %s into PBX again\n", tobj->peer->name);
         res = ast_pbx_start(tobj->peer);
         if (res != AST_PBX_SUCCESS)
            ast_log(LOG_WARNING, "FAILED continuing PBX on peer %s\n", tobj->peer->name);
      } else
         ast_hangup(tobj->peer);
      if (!ast_check_hangup(tobj->chan)) {
         ast_log(LOG_VERBOSE, "putting chan %s into PBX again\n", tobj->chan->name);
         res = ast_pbx_start(tobj->chan);
         if (res != AST_PBX_SUCCESS)
            ast_log(LOG_WARNING, "FAILED continuing PBX on chan %s\n", tobj->chan->name);
      } else
         ast_hangup(tobj->chan);
   } else {
      ast_hangup(tobj->chan);
      ast_hangup(tobj->peer);
   }

   ast_free(tobj);

   return NULL;
}

static void bridge_call_thread_launch

(

void *

data

)

[static]

create thread for the parked call

Parameters:

data

Create thread and attributes, call bridge_call_thread

Definition at line 571 of file features.c.

References ast_pthread_create, bridge_call_thread(), and thread.

Referenced by action_bridge(), and builtin_atxfer().

{
   pthread_t thread;
   pthread_attr_t attr;
   struct sched_param sched;

   pthread_attr_init(&attr);
   pthread_attr_setdetachstate(&attr, PTHREAD_CREATE_DETACHED);
   ast_pthread_create(&thread, &attr, bridge_call_thread, data);
   pthread_attr_destroy(&attr);
   memset(&sched, 0, sizeof(sched));
   pthread_setschedparam(thread, SCHED_RR, &sched);
}

static int bridge_exec	(	struct ast_channel *	chan,
		const char *	data
	)			[static]

Bridge channels.

Parameters:

	chan
	data	channel to bridge with.

Split data, check we aren't bridging with ourself, check valid channel, answer call if not already, check compatible channels, setup bridge config now bridge call, if transfered party hangs up return to PBX extension.

Definition at line 4945 of file features.c.

References ast_channel::_state, ast_answer(), AST_APP_ARG, ast_app_parse_options(), ast_bridge_call(), ast_bridge_timelimit(), ast_channel_alloc, ast_channel_get_by_name_prefix(), ast_channel_make_compatible(), ast_channel_unlock, ast_channel_unref, ast_check_hangup(), ast_debug, AST_DECLARE_APP_ARGS, AST_FEATURE_AUTOMON, AST_FEATURE_DISCONNECT, AST_FEATURE_PARKCALL, AST_FEATURE_REDIRECT, ast_free, ast_hangup(), ast_log(), ast_pbx_start(), AST_PBX_SUCCESS, ast_set_flag, AST_STANDARD_APP_ARGS, AST_STATE_DOWN, AST_STATE_UP, ast_strdupa, ast_streamfile(), ast_strlen_zero(), ast_test_flag, ast_waitstream(), bridge_exec_options, BRIDGE_OPT_PLAYTONE, ast_channel::context, do_bridge_masquerade(), ast_bridge_config::end_sound, EVENT_FLAG_CALL, ast_channel::exten, ast_bridge_config::features_callee, ast_bridge_config::features_caller, ast_channel::language, ast_channel::linkedid, LOG_WARNING, manager_event, ast_channel::name, OPT_ARG_ARRAY_SIZE, OPT_ARG_DURATION_LIMIT, OPT_CALLEE_HANGUP, OPT_CALLEE_KILL, OPT_CALLEE_MONITOR, OPT_CALLEE_PARK, OPT_CALLEE_TRANSFER, OPT_CALLER_HANGUP, OPT_CALLER_MONITOR, OPT_CALLER_PARK, OPT_CALLER_TRANSFER, OPT_DURATION_LIMIT, pbx_builtin_setvar_helper(), ast_channel::priority, ast_bridge_config::start_sound, ast_bridge_config::warning_sound, and xfersound.

Referenced by ast_features_init().

{
   struct ast_channel *current_dest_chan, *final_dest_chan;
   char *tmp_data  = NULL;
   struct ast_flags opts = { 0, };
   struct ast_bridge_config bconfig = { { 0, }, };
   char *opt_args[OPT_ARG_ARRAY_SIZE];
   struct timeval calldurationlimit = { 0, };

   AST_DECLARE_APP_ARGS(args,
      AST_APP_ARG(dest_chan);
      AST_APP_ARG(options);
   );
   
   if (ast_strlen_zero(data)) {
      ast_log(LOG_WARNING, "Bridge require at least 1 argument specifying the other end of the bridge\n");
      return -1;
   }

   tmp_data = ast_strdupa(data);
   AST_STANDARD_APP_ARGS(args, tmp_data);
   if (!ast_strlen_zero(args.options))
      ast_app_parse_options(bridge_exec_options, &opts, opt_args, args.options);

   /* avoid bridge with ourselves */
   if (!strncmp(chan->name, args.dest_chan, 
      strlen(chan->name) < strlen(args.dest_chan) ? 
      strlen(chan->name) : strlen(args.dest_chan))) {
      ast_log(LOG_WARNING, "Unable to bridge channel %s with itself\n", chan->name);
      manager_event(EVENT_FLAG_CALL, "BridgeExec",
               "Response: Failed\r\n"
               "Reason: Unable to bridge channel to itself\r\n"
               "Channel1: %s\r\n"
               "Channel2: %s\r\n",
               chan->name, args.dest_chan);
      pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "LOOP");
      return 0;
   }

   /* make sure we have a valid end point */
   if (!(current_dest_chan = ast_channel_get_by_name_prefix(args.dest_chan,
         strlen(args.dest_chan)))) {
      ast_log(LOG_WARNING, "Bridge failed because channel %s does not exists or we "
         "cannot get its lock\n", args.dest_chan);
      manager_event(EVENT_FLAG_CALL, "BridgeExec",
               "Response: Failed\r\n"
               "Reason: Cannot grab end point\r\n"
               "Channel1: %s\r\n"
               "Channel2: %s\r\n", chan->name, args.dest_chan);
      pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "NONEXISTENT");
      return 0;
   }

   /* answer the channel if needed */
   if (current_dest_chan->_state != AST_STATE_UP) {
      ast_answer(current_dest_chan);
   }

   /* try to allocate a place holder where current_dest_chan will be placed */
   if (!(final_dest_chan = ast_channel_alloc(0, AST_STATE_DOWN, NULL, NULL, NULL, 
      NULL, NULL, current_dest_chan->linkedid, 0, "Bridge/%s", current_dest_chan->name))) {
      ast_log(LOG_WARNING, "Cannot create placeholder channel for chan %s\n", args.dest_chan);
      manager_event(EVENT_FLAG_CALL, "BridgeExec",
               "Response: Failed\r\n"
               "Reason: cannot create placeholder\r\n"
               "Channel1: %s\r\n"
               "Channel2: %s\r\n", chan->name, args.dest_chan);
   }

   ast_channel_unlock(current_dest_chan);

   do_bridge_masquerade(current_dest_chan, final_dest_chan);

   /* now current_dest_chan is a ZOMBIE and with softhangup set to 1 and final_dest_chan is our end point */
   /* try to make compatible, send error if we fail */
   if (ast_channel_make_compatible(chan, final_dest_chan) < 0) {
      ast_log(LOG_WARNING, "Could not make channels %s and %s compatible for bridge\n", chan->name, final_dest_chan->name);
      manager_event(EVENT_FLAG_CALL, "BridgeExec",
               "Response: Failed\r\n"
               "Reason: Could not make channels compatible for bridge\r\n"
               "Channel1: %s\r\n"
               "Channel2: %s\r\n", chan->name, final_dest_chan->name);
      ast_hangup(final_dest_chan); /* may be we should return this channel to the PBX? */
      pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "INCOMPATIBLE");
      current_dest_chan = ast_channel_unref(current_dest_chan);
      return 0;
   }

   /* Report that the bridge will be successfull */
   manager_event(EVENT_FLAG_CALL, "BridgeExec",
            "Response: Success\r\n"
            "Channel1: %s\r\n"
            "Channel2: %s\r\n", chan->name, final_dest_chan->name);

   /* we have 2 valid channels to bridge, now it is just a matter of setting up the bridge config and starting the bridge */  
   if (ast_test_flag(&opts, BRIDGE_OPT_PLAYTONE) && !ast_strlen_zero(xfersound)) {
      if (!ast_streamfile(final_dest_chan, xfersound, final_dest_chan->language)) {
         if (ast_waitstream(final_dest_chan, "") < 0)
            ast_log(LOG_WARNING, "Failed to play courtesy tone on %s\n", final_dest_chan->name);
      }
   }
   
   current_dest_chan = ast_channel_unref(current_dest_chan);
   
   if (ast_test_flag(&opts, OPT_DURATION_LIMIT) && !ast_strlen_zero(opt_args[OPT_ARG_DURATION_LIMIT])) {
      if (ast_bridge_timelimit(chan, &bconfig, opt_args[OPT_ARG_DURATION_LIMIT], &calldurationlimit))
         goto done;
   }

   if (ast_test_flag(&opts, OPT_CALLEE_TRANSFER))
      ast_set_flag(&(bconfig.features_callee), AST_FEATURE_REDIRECT);
   if (ast_test_flag(&opts, OPT_CALLER_TRANSFER))
      ast_set_flag(&(bconfig.features_caller), AST_FEATURE_REDIRECT);
   if (ast_test_flag(&opts, OPT_CALLEE_HANGUP))
      ast_set_flag(&(bconfig.features_callee), AST_FEATURE_DISCONNECT);
   if (ast_test_flag(&opts, OPT_CALLER_HANGUP))
      ast_set_flag(&(bconfig.features_caller), AST_FEATURE_DISCONNECT);
   if (ast_test_flag(&opts, OPT_CALLEE_MONITOR))
      ast_set_flag(&(bconfig.features_callee), AST_FEATURE_AUTOMON);
   if (ast_test_flag(&opts, OPT_CALLER_MONITOR)) 
      ast_set_flag(&(bconfig.features_caller), AST_FEATURE_AUTOMON);
   if (ast_test_flag(&opts, OPT_CALLEE_PARK))
      ast_set_flag(&(bconfig.features_callee), AST_FEATURE_PARKCALL);
   if (ast_test_flag(&opts, OPT_CALLER_PARK))
      ast_set_flag(&(bconfig.features_caller), AST_FEATURE_PARKCALL);

   ast_bridge_call(chan, final_dest_chan, &bconfig);

   /* the bridge has ended, set BRIDGERESULT to SUCCESS. If the other channel has not been hung up, return it to the PBX */
   pbx_builtin_setvar_helper(chan, "BRIDGERESULT", "SUCCESS");
   if (!ast_check_hangup(final_dest_chan) && !ast_test_flag(&opts, OPT_CALLEE_KILL)) {
      ast_debug(1, "starting new PBX in %s,%s,%d for chan %s\n", 
         final_dest_chan->context, final_dest_chan->exten, 
         final_dest_chan->priority, final_dest_chan->name);

      if (ast_pbx_start(final_dest_chan) != AST_PBX_SUCCESS) {
         ast_log(LOG_WARNING, "FAILED continuing PBX on dest chan %s\n", final_dest_chan->name);
         ast_hangup(final_dest_chan);
      } else
         ast_debug(1, "SUCCESS continuing PBX on chan %s\n", final_dest_chan->name);
   } else {
      ast_debug(1, "hangup chan %s since the other endpoint has hung up or the x flag was passed\n", final_dest_chan->name);
      ast_hangup(final_dest_chan);
   }
done:
   if (bconfig.warning_sound) {
      ast_free((char *)bconfig.warning_sound);
   }
   if (bconfig.end_sound) {
      ast_free((char *)bconfig.end_sound);
   }
   if (bconfig.start_sound) {
      ast_free((char *)bconfig.start_sound);
   }

   return 0;
}

static struct ast_parkinglot* build_parkinglot	(	char *	name,
		struct ast_variable *	var
	)			[static, read]

Build parkinglot from configuration and chain it in.

Definition at line 3818 of file features.c.

References ao2_link, ao2_lock(), ao2_unlock(), ast_add_extension2(), ast_context_find_or_create(), ast_copy_string(), ast_free_ptr, ast_log(), ast_parking_ext(), ast_strlen_zero(), create_parkinglot(), DEFAULT_PARK_TIME, find_parkinglot(), ast_variable::lineno, LOG_DEBUG, LOG_ERROR, LOG_WARNING, ast_parkinglot::mohclass, ast_variable::name, ast_variable::next, option_debug, parkcall, ast_parkinglot::parkfindnext, ast_parkinglot::parking_con, ast_parkinglot::parking_con_dial, ast_parkinglot::parking_start, ast_parkinglot::parking_stop, parkinglot_destroy(), parkinglot_unref(), parkinglots, ast_parkinglot::parkingtime, registrar, strdup, and ast_variable::value.

Referenced by load_config().

{
   struct ast_parkinglot *parkinglot;
   struct ast_context *con = NULL;

   struct ast_variable *confvar = var;
   int error = 0;
   int start = 0, end = 0;
   int oldparkinglot = 0;

   parkinglot = find_parkinglot(name);
   if (parkinglot)
      oldparkinglot = 1;
   else
      parkinglot = create_parkinglot(name);

   if (!parkinglot)
      return NULL;

   ao2_lock(parkinglot);

   if (option_debug)
      ast_log(LOG_DEBUG, "Building parking lot %s\n", name);
   
   /* Do some config stuff */
   while(confvar) {
      if (!strcasecmp(confvar->name, "context")) {
         ast_copy_string(parkinglot->parking_con, confvar->value, sizeof(parkinglot->parking_con));
      } else if (!strcasecmp(confvar->name, "parkingtime")) {
         if ((sscanf(confvar->value, "%30d", &parkinglot->parkingtime) != 1) || (parkinglot->parkingtime < 1)) {
            ast_log(LOG_WARNING, "%s is not a valid parkingtime\n", confvar->value);
            parkinglot->parkingtime = DEFAULT_PARK_TIME;
         } else
            parkinglot->parkingtime = parkinglot->parkingtime * 1000;
      } else if (!strcasecmp(confvar->name, "parkpos")) {
         if (sscanf(confvar->value, "%30d-%30d", &start, &end) != 2) {
            ast_log(LOG_WARNING, "Format for parking positions is a-b, where a and b are numbers at line %d of parking.conf\n", confvar->lineno);
            error = 1;
         } else {
            parkinglot->parking_start = start;
            parkinglot->parking_stop = end;
         }
      } else if (!strcasecmp(confvar->name, "findslot")) {
         parkinglot->parkfindnext = (!strcasecmp(confvar->value, "next"));
      }
      confvar = confvar->next;
   }
   /* make sure parkingtime is set if not specified */
   if (parkinglot->parkingtime == 0) {
      parkinglot->parkingtime = DEFAULT_PARK_TIME;
   }

   if (!var) { /* Default parking lot */
      ast_copy_string(parkinglot->parking_con, "parkedcalls", sizeof(parkinglot->parking_con));
      ast_copy_string(parkinglot->parking_con_dial, "park-dial", sizeof(parkinglot->parking_con_dial));
      ast_copy_string(parkinglot->mohclass, "default", sizeof(parkinglot->mohclass));
   }

   /* Check for errors */
   if (ast_strlen_zero(parkinglot->parking_con)) {
      ast_log(LOG_WARNING, "Parking lot %s lacks context\n", name);
      error = 1;
   }

   /* Create context */
   if (!error && !(con = ast_context_find_or_create(NULL, NULL, parkinglot->parking_con, registrar))) {
      ast_log(LOG_ERROR, "Parking context '%s' does not exist and unable to create\n", parkinglot->parking_con);
      error = 1;
   }

   /* Add a parking extension into the context */
   if (!error && !oldparkinglot) {
      if (!ast_strlen_zero(ast_parking_ext())) {
         if (ast_add_extension2(con, 1, ast_parking_ext(), 1, NULL, NULL, parkcall, strdup(""), ast_free_ptr, registrar) == -1)
            error = 1;
      }
   }

   ao2_unlock(parkinglot);

   if (error) {
      ast_log(LOG_WARNING, "Parking %s not open for business. Configuration error.\n", name);
      parkinglot_destroy(parkinglot);
      return NULL;
   }
   if (option_debug)
      ast_log(LOG_DEBUG, "Parking %s now open for business. (start exten %d end %d)\n", name, start, end);


   /* Move it into the list, if it wasn't already there */
   if (!oldparkinglot) {
      ao2_link(parkinglots, parkinglot);
   }
   parkinglot_unref(parkinglot);

   return parkinglot;
}

static int builtin_atxfer	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

Attended transfer.

Parameters:

	chan	transfered user
	peer	person transfering call
	config
	code
	sense	feature options
	data	Get extension to transfer to, if you cannot generate channel (or find extension) return to host channel. After called channel answered wait for hangup of transferer, bridge call between transfer peer (taking them off hold) to attended transfer channel.

Returns:

-1 on failure

Definition at line 1513 of file features.c.

References ast_channel::_softhangup, ast_channel::_state, ast_app_dtget(), ast_autoservice_start(), ast_autoservice_stop(), ast_best_codec(), ast_bridge_call(), ast_calloc, AST_CEL_ATTENDEDTRANSFER, ast_cel_report_event(), ast_channel_alloc, ast_channel_connected_line_macro(), ast_channel_datastore_find(), ast_channel_lock, ast_channel_masquerade(), ast_channel_unlock, ast_channel_update_connected_line(), ast_check_hangup(), ast_clear_flag, ast_connected_line_copy_from_caller(), AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER, AST_CONTROL_BUSY, AST_CONTROL_HOLD, AST_CONTROL_UNHOLD, ast_copy_flags, ast_debug, AST_DIGIT_ANY, ast_exists_extension(), ast_explicit_goto(), AST_FEATURE_DISCONNECT, AST_FEATURE_RETURN_SUCCESS, AST_FLAGS_ALL, ast_frfree, ast_hangup(), ast_indicate(), ast_log(), ast_parking_ext(), ast_party_connected_line_copy(), ast_party_connected_line_free(), ast_party_connected_line_init(), ast_read(), ast_safe_sleep(), ast_set_flag, AST_STATE_DOWN, AST_STATE_UP, ast_strdupa, ast_stream_and_wait(), ast_strlen_zero(), ast_waitfordigit(), atxfercallbackretries, atxferdropcall, atxferloopdelay, atxfernoanswertimeout, ast_bridge_thread_obj::bconfig, bridge_call_thread_launch(), builtin_parkcall(), ast_bridge_thread_obj::chan, check_compat(), ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, ast_channel::connected, ast_channel::context, ast_datastore::data, ast_bridge_config::end_bridge_callback_data_fixup, ast_channel::exten, f, feature_request_and_dial(), ast_bridge_config::features_callee, ast_dial_features::features_caller, ast_bridge_config::features_caller, finishup(), ast_channel::language, ast_channel::linkedid, LOG_NOTICE, LOG_WARNING, ast_channel::name, ast_channel::nativeformats, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), ast_bridge_thread_obj::peer, ast_channel::priority, ast_channel::readformat, real_ctx(), set_peers(), ast_party_connected_line::source, strsep(), transferdigittimeout, ast_channel::visible_indication, ast_channel::writeformat, xferfailsound, and xfersound.

{
   struct ast_channel *transferer;
   struct ast_channel *transferee;
   const char *transferer_real_context;
   char xferto[256] = "";
   int res;
   int outstate=0;
   struct ast_channel *newchan;
   struct ast_channel *xferchan;
   struct ast_bridge_thread_obj *tobj;
   struct ast_bridge_config bconfig;
   struct ast_frame *f;
   int l;
   struct ast_party_connected_line connected_line;
   struct ast_datastore *features_datastore;
   struct ast_dial_features *dialfeatures = NULL;

   ast_debug(1, "Executing Attended Transfer %s, %s (sense=%d) \n", chan->name, peer->name, sense);
   set_peers(&transferer, &transferee, peer, chan, sense);
   transferer_real_context = real_ctx(transferer, transferee);
   /* Start autoservice on chan while we talk to the originator */
   ast_autoservice_start(transferee);
   ast_indicate(transferee, AST_CONTROL_HOLD);
   
   /* Transfer */
   res = ast_stream_and_wait(transferer, "pbx-transfer", AST_DIGIT_ANY);
   if (res < 0) {
      finishup(transferee);
      return res;
   }
   if (res > 0) /* If they've typed a digit already, handle it */
      xferto[0] = (char) res;

   /* this is specific of atxfer */
   res = ast_app_dtget(transferer, transferer_real_context, xferto, sizeof(xferto), 100, transferdigittimeout);
   if (res < 0) {  /* hangup, would be 0 for invalid and 1 for valid */
      finishup(transferee);
      return res;
   }
   if (res == 0) {
      ast_log(LOG_WARNING, "Did not read data.\n");
      finishup(transferee);
      if (ast_stream_and_wait(transferer, "beeperr", ""))
         return -1;
      return AST_FEATURE_RETURN_SUCCESS;
   }

   /* valid extension, res == 1 */
   if (!ast_exists_extension(transferer, transferer_real_context, xferto, 1, transferer->cid.cid_num)) {
      ast_log(LOG_WARNING, "Extension %s does not exist in context %s\n",xferto,transferer_real_context);
      finishup(transferee);
      if (ast_stream_and_wait(transferer, "beeperr", ""))
         return -1;
      return AST_FEATURE_RETURN_SUCCESS;
   }

   /* If we are attended transfering to parking, just use builtin_parkcall instead of trying to track all of
    * the different variables for handling this properly with a builtin_atxfer */
   if (!strcmp(xferto, ast_parking_ext())) {
      finishup(transferee);
      return builtin_parkcall(chan, peer, config, code, sense, data);
   }

   l = strlen(xferto);
   snprintf(xferto + l, sizeof(xferto) - l, "@%s/n", transferer_real_context);   /* append context */

   /* If we are performing an attended transfer and we have two channels involved then
      copy sound file information to play upon attended transfer completion */
   if (transferee) {
      const char *chan1_attended_sound = pbx_builtin_getvar_helper(transferer, "ATTENDED_TRANSFER_COMPLETE_SOUND");
      const char *chan2_attended_sound = pbx_builtin_getvar_helper(transferee, "ATTENDED_TRANSFER_COMPLETE_SOUND");

      if (!ast_strlen_zero(chan1_attended_sound)) {
         pbx_builtin_setvar_helper(transferer, "BRIDGE_PLAY_SOUND", chan1_attended_sound);
      }
      if (!ast_strlen_zero(chan2_attended_sound)) {
         pbx_builtin_setvar_helper(transferee, "BRIDGE_PLAY_SOUND", chan2_attended_sound);
      }
   }

   newchan = feature_request_and_dial(transferer, transferee, "Local", ast_best_codec(transferer->nativeformats),
      xferto, atxfernoanswertimeout, &outstate, transferer->cid.cid_num, transferer->cid.cid_name, 1, transferer->language);

   ast_party_connected_line_init(&connected_line);
   if (!ast_check_hangup(transferer)) {
      /* Transferer is up - old behaviour */
      ast_indicate(transferer, -1);
      if (!newchan) {
         finishup(transferee);
         /* any reason besides user requested cancel and busy triggers the failed sound */
         if (outstate != AST_CONTROL_UNHOLD && outstate != AST_CONTROL_BUSY &&
            ast_stream_and_wait(transferer, xferfailsound, ""))
            return -1;
         if (ast_stream_and_wait(transferer, xfersound, ""))
            ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
         return AST_FEATURE_RETURN_SUCCESS;
      }

      if (check_compat(transferer, newchan)) {
         /* we do mean transferee here, NOT transferer */
         finishup(transferee);
         return -1;
      }
      memset(&bconfig,0,sizeof(struct ast_bridge_config));
      ast_set_flag(&(bconfig.features_caller), AST_FEATURE_DISCONNECT);
      ast_set_flag(&(bconfig.features_callee), AST_FEATURE_DISCONNECT);
      /* We need to get the transferer's connected line information copied
       * at this point because he is likely to hang up during the bridge with
       * newchan. This info will be used down below before bridging the 
       * transferee and newchan
       *
       * As a result, we need to be sure to free this data before returning
       * or overwriting it.
       */
      ast_channel_lock(transferer);
      ast_party_connected_line_copy(&connected_line, &transferer->connected);
      ast_channel_unlock(transferer);
      res = ast_bridge_call(transferer, newchan, &bconfig);
      if (ast_check_hangup(newchan) || !ast_check_hangup(transferer)) {
         ast_hangup(newchan);
         if (ast_stream_and_wait(transferer, xfersound, ""))
            ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
         finishup(transferee);
         transferer->_softhangup = 0;
         ast_party_connected_line_free(&connected_line);
         return AST_FEATURE_RETURN_SUCCESS;
      }

      ast_cel_report_event(transferee, AST_CEL_ATTENDEDTRANSFER, NULL, NULL, newchan);

      if (check_compat(transferee, newchan)) {
         finishup(transferee);
         ast_party_connected_line_free(&connected_line);
         return -1;
      }
      ast_indicate(transferee, AST_CONTROL_UNHOLD);

      if ((ast_autoservice_stop(transferee) < 0)
       || (ast_waitfordigit(transferee, 100) < 0)
       || (ast_waitfordigit(newchan, 100) < 0)
       || ast_check_hangup(transferee)
       || ast_check_hangup(newchan)) {
         ast_hangup(newchan);
         ast_party_connected_line_free(&connected_line);
         return -1;
      }
      xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", transferee->linkedid, 0, "Transfered/%s", transferee->name);
      if (!xferchan) {
         ast_hangup(newchan);
         ast_party_connected_line_free(&connected_line);
         return -1;
      }
      /* Make formats okay */
      xferchan->visible_indication = transferer->visible_indication;
      xferchan->readformat = transferee->readformat;
      xferchan->writeformat = transferee->writeformat;
      ast_channel_masquerade(xferchan, transferee);
      ast_explicit_goto(xferchan, transferee->context, transferee->exten, transferee->priority);
      xferchan->_state = AST_STATE_UP;
      ast_clear_flag(xferchan, AST_FLAGS_ALL);
      xferchan->_softhangup = 0;
      if ((f = ast_read(xferchan)))
         ast_frfree(f);
      newchan->_state = AST_STATE_UP;
      ast_clear_flag(newchan, AST_FLAGS_ALL);
      newchan->_softhangup = 0;
      if (!(tobj = ast_calloc(1, sizeof(*tobj)))) {
         ast_hangup(xferchan);
         ast_hangup(newchan);
         ast_party_connected_line_free(&connected_line);
         return -1;
      }

      ast_channel_lock(newchan);
      if ((features_datastore = ast_channel_datastore_find(newchan, &dial_features_info, NULL))) {
            dialfeatures = features_datastore->data;
      }
      ast_channel_unlock(newchan);

      if (dialfeatures) {
         /* newchan should always be the callee and shows up as callee in dialfeatures, but for some reason
            I don't currently understand, the abilities of newchan seem to be stored on the caller side */
         ast_copy_flags(&(config->features_callee), &(dialfeatures->features_caller), AST_FLAGS_ALL);
         dialfeatures = NULL;
      }

      ast_channel_lock(xferchan);
      if ((features_datastore = ast_channel_datastore_find(xferchan, &dial_features_info, NULL))) {
         dialfeatures = features_datastore->data;
      }
      ast_channel_unlock(xferchan);
    
      if (dialfeatures) {
         ast_copy_flags(&(config->features_caller), &(dialfeatures->features_caller), AST_FLAGS_ALL);
      }
    
      tobj->chan = newchan;
      tobj->peer = xferchan;
      tobj->bconfig = *config;

      if (tobj->bconfig.end_bridge_callback_data_fixup) {
         tobj->bconfig.end_bridge_callback_data_fixup(&tobj->bconfig, tobj->peer, tobj->chan);
      }

      /* Due to a limitation regarding when callerID is set on a Local channel,
       * we use the transferer's connected line information here.
       */

      /* xferchan is transferee, and newchan is the transfer target
       * So...in a transfer, who is the caller and who is the callee?
       *
       * When the call is originally made, it is clear who is caller and callee.
       * When a transfer occurs, it is my humble opinion that the transferee becomes
       * the caller, and the transfer target is the callee.
       *
       * The problem is that these macros were set with the intention of the original
       * caller and callee taking those roles. A transfer can totally mess things up,
       * to be technical. What sucks even more is that you can't effectively change
       * the macros in the dialplan during the call from the transferer to the transfer
       * target because the transferee is stuck with whatever role he originally had.
       *
       * I think the answer here is just to make sure that it is well documented that
       * during a transfer, the transferee is the "caller" and the transfer target
       * is the "callee."
       *
       * This means that if party A calls party B, and party A transfers party B to
       * party C, then B has switched roles for the call. Now party B will have the
       * caller macro called on his channel instead of the callee macro.
       *
       * Luckily, the method by which the bridge is launched here ensures that the 
       * transferee is the "chan" on the bridge and the transfer target is the "peer,"
       * so my idea for the roles post-transfer does not require extensive code changes.
       */
      connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
      if (ast_channel_connected_line_macro(newchan, xferchan, &connected_line, 1, 0)) {
         ast_channel_update_connected_line(xferchan, &connected_line);
      }
      ast_channel_lock(xferchan);
      ast_connected_line_copy_from_caller(&connected_line, &xferchan->cid);
      ast_channel_unlock(xferchan);
      connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
      if (ast_channel_connected_line_macro(xferchan, newchan, &connected_line, 0, 0)) {
         ast_channel_update_connected_line(newchan, &connected_line);
      }
      ast_party_connected_line_free(&connected_line);

      if (ast_stream_and_wait(newchan, xfersound, ""))
         ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
      bridge_call_thread_launch(tobj);
      return -1;      /* XXX meaning the channel is bridged ? */
   } else if (!ast_check_hangup(transferee)) {
      /* act as blind transfer */
      if (ast_autoservice_stop(transferee) < 0) {
         ast_hangup(newchan);
         return -1;
      }

      if (!newchan) {
         unsigned int tries = 0;
         char *transferer_tech, *transferer_name = ast_strdupa(transferer->name);

         transferer_tech = strsep(&transferer_name, "/");
         transferer_name = strsep(&transferer_name, "-");

         if (ast_strlen_zero(transferer_name) || ast_strlen_zero(transferer_tech)) {
            ast_log(LOG_WARNING, "Transferer has invalid channel name: '%s'\n", transferer->name);
            if (ast_stream_and_wait(transferee, "beeperr", ""))
               return -1;
            return AST_FEATURE_RETURN_SUCCESS;
         }

         ast_log(LOG_NOTICE, "We're trying to call %s/%s\n", transferer_tech, transferer_name);
         newchan = feature_request_and_dial(transferee, NULL, transferer_tech, ast_best_codec(transferee->nativeformats),
            transferer_name, atxfernoanswertimeout, &outstate, transferee->cid.cid_num, transferee->cid.cid_name, 0, transferer->language);
         while (!newchan && !atxferdropcall && tries < atxfercallbackretries) {
            /* Trying to transfer again */
            ast_autoservice_start(transferee);
            ast_indicate(transferee, AST_CONTROL_HOLD);

            newchan = feature_request_and_dial(transferer, transferee, "Local", ast_best_codec(transferer->nativeformats),
               xferto, atxfernoanswertimeout, &outstate, transferer->cid.cid_num, transferer->cid.cid_name, 1, transferer->language);
            if (ast_autoservice_stop(transferee) < 0) {
               if (newchan)
                  ast_hangup(newchan);
               return -1;
            }
            if (!newchan) {
               /* Transfer failed, sleeping */
               ast_debug(1, "Sleeping for %d ms before callback.\n", atxferloopdelay);
               ast_safe_sleep(transferee, atxferloopdelay);
               ast_debug(1, "Trying to callback...\n");
               newchan = feature_request_and_dial(transferee, NULL, transferer_tech, ast_best_codec(transferee->nativeformats),
                  transferer_name, atxfernoanswertimeout, &outstate, transferee->cid.cid_num, transferee->cid.cid_name, 0, transferer->language);
            }
            tries++;
         }
      }
      if (!newchan)
         return -1;

      ast_cel_report_event(transferee, AST_CEL_ATTENDEDTRANSFER, NULL, NULL, newchan);

      /* newchan is up, we should prepare transferee and bridge them */
      if (check_compat(transferee, newchan)) {
         finishup(transferee);
         return -1;
      }
      ast_indicate(transferee, AST_CONTROL_UNHOLD);

      if ((ast_waitfordigit(transferee, 100) < 0)
         || (ast_waitfordigit(newchan, 100) < 0)
         || ast_check_hangup(transferee)
         || ast_check_hangup(newchan)) {
         ast_hangup(newchan);
         return -1;
      }

      xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", transferee->linkedid, 0, "Transfered/%s", transferee->name);
      if (!xferchan) {
         ast_hangup(newchan);
         return -1;
      }
      /* Make formats okay */
      xferchan->visible_indication = transferer->visible_indication;
      xferchan->readformat = transferee->readformat;
      xferchan->writeformat = transferee->writeformat;
      ast_channel_masquerade(xferchan, transferee);
      ast_explicit_goto(xferchan, transferee->context, transferee->exten, transferee->priority);
      xferchan->_state = AST_STATE_UP;
      ast_clear_flag(xferchan, AST_FLAGS_ALL);
      xferchan->_softhangup = 0;
      if ((f = ast_read(xferchan)))
         ast_frfree(f);
      newchan->_state = AST_STATE_UP;
      ast_clear_flag(newchan, AST_FLAGS_ALL);
      newchan->_softhangup = 0;
      if (!(tobj = ast_calloc(1, sizeof(*tobj)))) {
         ast_hangup(xferchan);
         ast_hangup(newchan);
         return -1;
      }
      tobj->chan = newchan;
      tobj->peer = xferchan;
      tobj->bconfig = *config;
      
      if (tobj->bconfig.end_bridge_callback_data_fixup) {
         tobj->bconfig.end_bridge_callback_data_fixup(&tobj->bconfig, tobj->peer, tobj->chan);
      }

      ast_channel_lock(newchan);
      ast_connected_line_copy_from_caller(&connected_line, &newchan->cid);
      ast_channel_unlock(newchan);
      connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
      if (ast_channel_connected_line_macro(newchan, xferchan, &connected_line, 1, 0)) {
         ast_channel_update_connected_line(xferchan, &connected_line);
      }
      ast_channel_lock(xferchan);
      ast_connected_line_copy_from_caller(&connected_line, &xferchan->cid);
      ast_channel_unlock(xferchan);
      connected_line.source = AST_CONNECTED_LINE_UPDATE_SOURCE_TRANSFER;
      if (ast_channel_connected_line_macro(xferchan, newchan, &connected_line, 0, 0)) {
         ast_channel_update_connected_line(newchan, &connected_line);
      }

      ast_party_connected_line_free(&connected_line);
      
      if (ast_stream_and_wait(newchan, xfersound, ""))
         ast_log(LOG_WARNING, "Failed to play transfer sound!\n");
      bridge_call_thread_launch(tobj);
      return -1;      /* XXX meaning the channel is bridged ? */
   } else {
      /* Transferee hung up */
      finishup(transferee);
      return -1;
   }
}

static int builtin_automixmonitor	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

Definition at line 1218 of file features.c.

References AST_AUDIOHOOK_TYPE_SPY, ast_autoservice_start(), ast_autoservice_stop(), ast_channel_audiohook_count_by_source(), ast_channel_audiohook_count_by_source_running(), ast_channel_lock, ast_channel_unlock, AST_FEATURE_RETURN_SUCCESS, ast_log(), ast_strdupa, ast_stream_and_wait(), ast_strlen_zero(), ast_verb, ast_channel::cid, ast_callerid::cid_num, courtesytone, len(), LOG_ERROR, LOG_NOTICE, LOG_WARNING, mixmonitor_app, mixmonitor_ok, mixmonitor_spy_type, ast_channel::name, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), pbx_exec(), pbx_findapp(), S_OR, set_peers(), stopmixmonitor_app, and stopmixmonitor_ok.

{
   char *caller_chan_id = NULL, *callee_chan_id = NULL, *args = NULL, *touch_filename = NULL;
   int x = 0;
   size_t len;
   struct ast_channel *caller_chan, *callee_chan;
   const char *mixmonitor_spy_type = "MixMonitor";
   int count = 0;

   if (!mixmonitor_ok) {
      ast_log(LOG_ERROR,"Cannot record the call. The mixmonitor application is disabled.\n");
      return -1;
   }

   if (!(mixmonitor_app = pbx_findapp("MixMonitor"))) {
      mixmonitor_ok = 0;
      ast_log(LOG_ERROR,"Cannot record the call. The mixmonitor application is disabled.\n");
      return -1;
   }

   set_peers(&caller_chan, &callee_chan, peer, chan, sense);

   if (!ast_strlen_zero(courtesytone)) {
      if (ast_autoservice_start(callee_chan))
         return -1;
      if (ast_stream_and_wait(caller_chan, courtesytone, "")) {
         ast_log(LOG_WARNING, "Failed to play courtesy tone!\n");
         ast_autoservice_stop(callee_chan);
         return -1;
      }
      if (ast_autoservice_stop(callee_chan))
         return -1;
   }

   ast_channel_lock(callee_chan);
   count = ast_channel_audiohook_count_by_source(callee_chan, mixmonitor_spy_type, AST_AUDIOHOOK_TYPE_SPY);
   ast_channel_unlock(callee_chan);

   /* This means a mixmonitor is attached to the channel, running or not is unknown. */
   if (count > 0) {
      
      ast_verb(3, "User hit '%s' to stop recording call.\n", code);

      /* Make sure they are running */
      ast_channel_lock(callee_chan);
      count = ast_channel_audiohook_count_by_source_running(callee_chan, mixmonitor_spy_type, AST_AUDIOHOOK_TYPE_SPY);
      ast_channel_unlock(callee_chan);
      if (count > 0) {
         if (!stopmixmonitor_ok) {
            ast_log(LOG_ERROR,"Cannot stop recording the call. The stopmixmonitor application is disabled.\n");
            return -1;
         }
         if (!(stopmixmonitor_app = pbx_findapp("StopMixMonitor"))) {
            stopmixmonitor_ok = 0;
            ast_log(LOG_ERROR,"Cannot stop recording the call. The stopmixmonitor application is disabled.\n");
            return -1;
         } else {
            pbx_exec(callee_chan, stopmixmonitor_app, "");
            return AST_FEATURE_RETURN_SUCCESS;
         }
      }
      
      ast_log(LOG_WARNING,"Stopped MixMonitors are attached to the channel.\n"); 
   }        

   if (caller_chan && callee_chan) {
      const char *touch_format = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MIXMONITOR_FORMAT");
      const char *touch_monitor = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MIXMONITOR");

      if (!touch_format)
         touch_format = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MIXMONITOR_FORMAT");

      if (!touch_monitor)
         touch_monitor = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MIXMONITOR");

      if (touch_monitor) {
         len = strlen(touch_monitor) + 50;
         args = alloca(len);
         touch_filename = alloca(len);
         snprintf(touch_filename, len, "auto-%ld-%s", (long)time(NULL), touch_monitor);
         snprintf(args, len, "%s.%s,b", touch_filename, (touch_format) ? touch_format : "wav");
      } else {
         caller_chan_id = ast_strdupa(S_OR(caller_chan->cid.cid_num, caller_chan->name));
         callee_chan_id = ast_strdupa(S_OR(callee_chan->cid.cid_num, callee_chan->name));
         len = strlen(caller_chan_id) + strlen(callee_chan_id) + 50;
         args = alloca(len);
         touch_filename = alloca(len);
         snprintf(touch_filename, len, "auto-%ld-%s-%s", (long)time(NULL), caller_chan_id, callee_chan_id);
         snprintf(args, len, "%s.%s,b", touch_filename, S_OR(touch_format, "wav"));
      }

      for( x = 0; x < strlen(args); x++) {
         if (args[x] == '/')
            args[x] = '-';
      }

      ast_verb(3, "User hit '%s' to record call. filename: %s\n", code, touch_filename);

      pbx_exec(callee_chan, mixmonitor_app, args);
      pbx_builtin_setvar_helper(callee_chan, "TOUCH_MIXMONITOR_OUTPUT", touch_filename);
      pbx_builtin_setvar_helper(caller_chan, "TOUCH_MIXMONITOR_OUTPUT", touch_filename);
      return AST_FEATURE_RETURN_SUCCESS;
   
   }

   ast_log(LOG_NOTICE,"Cannot record the call. One or both channels have gone away.\n");
   return -1;

}

static int builtin_automonitor	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

Monitor a channel by DTMF.

Parameters:

	chan	channel requesting monitor
	peer	channel to be monitored
	config
	code
	sense	feature options
	data	Check monitor app enabled, setup channels, both caller/callee chans not null get TOUCH_MONITOR variable for filename if exists, exec monitor app.

Return values:

	AST_FEATURE_RETURN_SUCCESS	on success.
	-1	on error.

Definition at line 1125 of file features.c.

References AST_FEATURE_RETURN_SUCCESS, ast_log(), ast_strdupa, ast_strlen_zero(), ast_verb, ast_channel::cid, ast_callerid::cid_num, courtesytone, len(), LOG_ERROR, LOG_NOTICE, ast_channel::monitor, monitor_app, monitor_ok, ast_channel::name, pbx_builtin_getvar_helper(), pbx_builtin_setvar_helper(), pbx_exec(), pbx_findapp(), play_message_in_bridged_call(), S_OR, set_peers(), and ast_channel_monitor::stop.

{
   char *caller_chan_id = NULL, *callee_chan_id = NULL, *args = NULL, *touch_filename = NULL;
   int x = 0;
   size_t len;
   struct ast_channel *caller_chan, *callee_chan;
   const char *automon_message_start = NULL;
   const char *automon_message_stop = NULL;

   if (!monitor_ok) {
      ast_log(LOG_ERROR,"Cannot record the call. The monitor application is disabled.\n");
      return -1;
   }

   if (!monitor_app && !(monitor_app = pbx_findapp("Monitor"))) {
      monitor_ok = 0;
      ast_log(LOG_ERROR,"Cannot record the call. The monitor application is disabled.\n");
      return -1;
   }

   set_peers(&caller_chan, &callee_chan, peer, chan, sense);
   if (caller_chan) {   /* Find extra messages */
      automon_message_start = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_MESSAGE_START");
      automon_message_stop = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_MESSAGE_STOP");
   }

   if (!ast_strlen_zero(courtesytone)) {  /* Play courtesy tone if configured */
      if(play_message_in_bridged_call(caller_chan, callee_chan, courtesytone) == -1) {
         return -1;
      }
   }
   
   if (callee_chan->monitor) {
      ast_verb(4, "User hit '%s' to stop recording call.\n", code);
      if (!ast_strlen_zero(automon_message_stop)) {
         play_message_in_bridged_call(caller_chan, callee_chan, automon_message_stop);
      }
      callee_chan->monitor->stop(callee_chan, 1);
      return AST_FEATURE_RETURN_SUCCESS;
   }

   if (caller_chan && callee_chan) {
      const char *touch_format = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_FORMAT");
      const char *touch_monitor = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR");
      const char *touch_monitor_prefix = pbx_builtin_getvar_helper(caller_chan, "TOUCH_MONITOR_PREFIX");

      if (!touch_format)
         touch_format = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR_FORMAT");

      if (!touch_monitor)
         touch_monitor = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR");
   
      if (!touch_monitor_prefix)
         touch_monitor_prefix = pbx_builtin_getvar_helper(callee_chan, "TOUCH_MONITOR_PREFIX");
   
      if (touch_monitor) {
         len = strlen(touch_monitor) + 50;
         args = alloca(len);
         touch_filename = alloca(len);
         snprintf(touch_filename, len, "%s-%ld-%s", S_OR(touch_monitor_prefix, "auto"), (long)time(NULL), touch_monitor);
         snprintf(args, len, "%s,%s,m", S_OR(touch_format, "wav"), touch_filename);
      } else {
         caller_chan_id = ast_strdupa(S_OR(caller_chan->cid.cid_num, caller_chan->name));
         callee_chan_id = ast_strdupa(S_OR(callee_chan->cid.cid_num, callee_chan->name));
         len = strlen(caller_chan_id) + strlen(callee_chan_id) + 50;
         args = alloca(len);
         touch_filename = alloca(len);
         snprintf(touch_filename, len, "%s-%ld-%s-%s", S_OR(touch_monitor_prefix, "auto"), (long)time(NULL), caller_chan_id, callee_chan_id);
         snprintf(args, len, "%s,%s,m", S_OR(touch_format, "wav"), touch_filename);
      }

      for(x = 0; x < strlen(args); x++) {
         if (args[x] == '/')
            args[x] = '-';
      }
      
      ast_verb(4, "User hit '%s' to record call. filename: %s\n", code, args);

      pbx_exec(callee_chan, monitor_app, args);
      pbx_builtin_setvar_helper(callee_chan, "TOUCH_MONITOR_OUTPUT", touch_filename);
      pbx_builtin_setvar_helper(caller_chan, "TOUCH_MONITOR_OUTPUT", touch_filename);

      if (!ast_strlen_zero(automon_message_start)) {  /* Play start message for both channels */
         play_message_in_bridged_call(caller_chan, callee_chan, automon_message_start);
      }
   
      return AST_FEATURE_RETURN_SUCCESS;
   }
   
   ast_log(LOG_NOTICE,"Cannot record the call. One or both channels have gone away.\n");  
   return -1;
}

static int builtin_blindtransfer	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

Blind transfer user to another extension.

Parameters:

	chan	channel to be transfered
	peer	channel initiated blind transfer
	config
	code
	data
	sense	feature options

Place chan on hold, check if transferred to parkinglot extension, otherwise check extension exists and transfer caller.

Return values:

	AST_FEATURE_RETURN_SUCCESS.
	-1	on failure.

Todo:

XXX Maybe we should have another message here instead of invalid extension XXX

Definition at line 1378 of file features.c.

References ast_app_dtget(), ast_async_goto(), ast_autoservice_start(), ast_cdr_alloc(), ast_cdr_init(), ast_cdr_start(), AST_CEL_BLINDTRANSFER, ast_cel_report_event(), ast_channel_connected_line_macro(), ast_channel_update_connected_line(), AST_CONTROL_HOLD, AST_DIGIT_ANY, ast_exists_extension(), AST_FEATURE_RETURN_PARKFAILED, AST_FEATURE_RETURN_SUCCESS, AST_FLAG_BRIDGE_HANGUP_DONT, ast_indicate(), ast_log(), ast_parking_ext(), ast_set_flag, ast_stopstream(), ast_stream_and_wait(), ast_verb, ast_channel::cdr, ast_cdr::channel, check_goto_on_transfer(), ast_channel::cid, ast_callerid::cid_num, ast_channel::connected, ast_cdr::dstchannel, finishup(), ast_cdr::lastapp, ast_cdr::lastdata, LOG_DEBUG, LOG_WARNING, masq_park_call_announce(), ast_channel::name, ast_channel::pbx, pbx_builtin_setvar_helper(), real_ctx(), set_c_e_p(), set_peers(), transferdigittimeout, and xferfailsound.

{
   struct ast_channel *transferer;
   struct ast_channel *transferee;
   const char *transferer_real_context;
   char xferto[256];
   int res, parkstatus = 0;

   set_peers(&transferer, &transferee, peer, chan, sense);
   transferer_real_context = real_ctx(transferer, transferee);
   /* Start autoservice on chan while we talk to the originator */
   ast_autoservice_start(transferee);
   ast_indicate(transferee, AST_CONTROL_HOLD);

   memset(xferto, 0, sizeof(xferto));

   /* Transfer */
   res = ast_stream_and_wait(transferer, "pbx-transfer", AST_DIGIT_ANY);
   if (res < 0) {
      finishup(transferee);
      return -1; /* error ? */
   }
   if (res > 0)   /* If they've typed a digit already, handle it */
      xferto[0] = (char) res;

   ast_stopstream(transferer);
   res = ast_app_dtget(transferer, transferer_real_context, xferto, sizeof(xferto), 100, transferdigittimeout);
   if (res < 0) {  /* hangup, would be 0 for invalid and 1 for valid */
      finishup(transferee);
      return res;
   }
   if (!strcmp(xferto, ast_parking_ext())) {
      res = finishup(transferee);
      if (res)
         res = -1;
      else if (!(parkstatus = masq_park_call_announce(transferee, transferer, 0, NULL))) {   /* success */
         /* We return non-zero, but tell the PBX not to hang the channel when
            the thread dies -- We have to be careful now though.  We are responsible for 
            hanging up the channel, else it will never be hung up! */

         return 0;
      } else {
         ast_log(LOG_WARNING, "Unable to park call %s, parkstatus = %d\n", transferee->name, parkstatus);
      }
      /*! \todo XXX Maybe we should have another message here instead of invalid extension XXX */
   } else if (ast_exists_extension(transferee, transferer_real_context, xferto, 1, transferer->cid.cid_num)) {
      ast_cel_report_event(transferer, AST_CEL_BLINDTRANSFER, NULL, xferto, transferee);
      pbx_builtin_setvar_helper(transferer, "BLINDTRANSFER", transferee->name);
      pbx_builtin_setvar_helper(transferee, "BLINDTRANSFER", transferer->name);
      res=finishup(transferee);
      if (!transferer->cdr) { /* this code should never get called (in a perfect world) */
         transferer->cdr=ast_cdr_alloc();
         if (transferer->cdr) {
            ast_cdr_init(transferer->cdr, transferer); /* initialize our channel's cdr */
            ast_cdr_start(transferer->cdr);
         }
      }
      if (transferer->cdr) {
         struct ast_cdr *swap = transferer->cdr;
         ast_log(LOG_DEBUG,"transferer=%s; transferee=%s; lastapp=%s; lastdata=%s; chan=%s; dstchan=%s\n",
               transferer->name, transferee->name, transferer->cdr->lastapp, transferer->cdr->lastdata, 
               transferer->cdr->channel, transferer->cdr->dstchannel);
         ast_log(LOG_DEBUG,"TRANSFEREE; lastapp=%s; lastdata=%s, chan=%s; dstchan=%s\n",
               transferee->cdr->lastapp, transferee->cdr->lastdata, transferee->cdr->channel, transferee->cdr->dstchannel);
         ast_log(LOG_DEBUG,"transferer_real_context=%s; xferto=%s\n", transferer_real_context, xferto);
         /* swap cdrs-- it will save us some time & work */
         transferer->cdr = transferee->cdr;
         transferee->cdr = swap;
      }
      if (!transferee->pbx) {
         /* Doh!  Use our handy async_goto functions */
         ast_verb(3, "Transferring %s to '%s' (context %s) priority 1\n"
                        ,transferee->name, xferto, transferer_real_context);
         if (ast_async_goto(transferee, transferer_real_context, xferto, 1))
            ast_log(LOG_WARNING, "Async goto failed :-(\n");
      } else {
         /* Set the channel's new extension, since it exists, using transferer context */
         ast_set_flag(transferee, AST_FLAG_BRIDGE_HANGUP_DONT); /* don't let the after-bridge code run the h-exten */
         ast_log(LOG_DEBUG,"ABOUT TO AST_ASYNC_GOTO, have a pbx... set HANGUP_DONT on chan=%s\n", transferee->name);
         if (ast_channel_connected_line_macro(transferee, transferer, &transferer->connected, 1, 0)) {
            ast_channel_update_connected_line(transferee, &transferer->connected);
         }
         set_c_e_p(transferee, transferer_real_context, xferto, 0);
      }
      check_goto_on_transfer(transferer);
      return res;
   } else {
      ast_verb(3, "Unable to find extension '%s' in context '%s'\n", xferto, transferer_real_context);
   }
   if (parkstatus != AST_FEATURE_RETURN_PARKFAILED && ast_stream_and_wait(transferer, xferfailsound, AST_DIGIT_ANY) < 0) {
      finishup(transferee);
      return -1;
   }
   ast_stopstream(transferer);
   res = finishup(transferee);
   if (res) {
      ast_verb(2, "Hungup during autoservice stop on '%s'\n", transferee->name);
      return res;
   }
   return AST_FEATURE_RETURN_SUCCESS;
}

static int builtin_disconnect	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

Definition at line 1328 of file features.c.

References AST_FEATURE_RETURN_HANGUP, and ast_verb.

{
   ast_verb(4, "User hit '%s' to disconnect call.\n", code);
   return AST_FEATURE_RETURN_HANGUP;
}

static int builtin_parkcall	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

support routing for one touch call parking

Parameters:

	chan	channel parking call
	peer	channel to be parked
	config	unsed
	code	unused
	sense	feature options
	data	Setup channel, set return exten,priority to 's,1' answer chan, sleep chan, park call

Definition at line 1055 of file features.c.

References ast_channel::_state, ast_answer(), ast_safe_sleep(), AST_STATE_UP, masq_park_call_announce(), and set_peers().

Referenced by builtin_atxfer().

{
   struct ast_channel *parker;
   struct ast_channel *parkee;
   int res = 0;

   set_peers(&parker, &parkee, peer, chan, sense);
   /* we used to set chan's exten and priority to "s" and 1
      here, but this generates (in some cases) an invalid
      extension, and if "s" exists, could errantly
      cause execution of extensions you don't expect. It
      makes more sense to let nature take its course
      when chan finishes, and let the pbx do its thing
      and hang up when the park is over.
   */
   if (chan->_state != AST_STATE_UP)
      res = ast_answer(chan);
   if (!res)
      res = ast_safe_sleep(chan, 1000);

   if (!res) { /* one direction used to call park_call.... */
      res = masq_park_call_announce(parkee, parker, 0, NULL);
      /* PBX should hangup zombie channel if a masquerade actually occurred (res=0) */
   }

   return res;
}

static char* callback_dialoptions	(	struct ast_flags *	features_callee,
		struct ast_flags *	features_caller,
		char *	options,
		size_t	len
	)			[static]

Definition at line 3229 of file features.c.

References AST_FEATURE_AUTOMON, AST_FEATURE_DISCONNECT, AST_FEATURE_PARKCALL, AST_FEATURE_REDIRECT, and ast_test_flag.

Referenced by manage_parkinglot().

{
   int i = 0;
   enum {
      OPT_CALLEE_REDIRECT   = 't',
      OPT_CALLER_REDIRECT   = 'T',
      OPT_CALLEE_AUTOMON    = 'w',
      OPT_CALLER_AUTOMON    = 'W',
      OPT_CALLEE_DISCONNECT = 'h',
      OPT_CALLER_DISCONNECT = 'H',
      OPT_CALLEE_PARKCALL   = 'k',
      OPT_CALLER_PARKCALL   = 'K',
   };

   memset(options, 0, len);
   if (ast_test_flag(features_caller, AST_FEATURE_REDIRECT) && i < len) {
      options[i++] = OPT_CALLER_REDIRECT;
   }
   if (ast_test_flag(features_caller, AST_FEATURE_AUTOMON) && i < len) {
      options[i++] = OPT_CALLER_AUTOMON;
   }
   if (ast_test_flag(features_caller, AST_FEATURE_DISCONNECT) && i < len) {
      options[i++] = OPT_CALLER_DISCONNECT;
   }
   if (ast_test_flag(features_caller, AST_FEATURE_PARKCALL) && i < len) {
      options[i++] = OPT_CALLER_PARKCALL;
   }

   if (ast_test_flag(features_callee, AST_FEATURE_REDIRECT) && i < len) {
      options[i++] = OPT_CALLEE_REDIRECT;
   }
   if (ast_test_flag(features_callee, AST_FEATURE_AUTOMON) && i < len) {
      options[i++] = OPT_CALLEE_AUTOMON;
   }
   if (ast_test_flag(features_callee, AST_FEATURE_DISCONNECT) && i < len) {
      options[i++] = OPT_CALLEE_DISCONNECT;
   }
   if (ast_test_flag(features_callee, AST_FEATURE_PARKCALL) && i < len) {
      options[i++] = OPT_CALLEE_PARKCALL;
   }

   return options;
}

static int check_compat	(	struct ast_channel *	c,
		struct ast_channel *	newchan
	)			[static]

make channels compatible

Parameters:

	c
	newchan

Return values:

	0	on success.
	-1	on failure.

Definition at line 1487 of file features.c.

References ast_channel_make_compatible(), ast_hangup(), ast_log(), LOG_WARNING, and ast_channel::name.

Referenced by builtin_atxfer().

{
   if (ast_channel_make_compatible(c, newchan) < 0) {
      ast_log(LOG_WARNING, "Had to drop call because I couldn't make %s compatible with %s\n",
         c->name, newchan->name);
      ast_hangup(newchan);
      return -1;
   }
   return 0;
}

static void check_goto_on_transfer

(

struct ast_channel *

chan

)

[static]

Check goto on transfer.

Parameters:

chan

Check if channel has 'GOTO_ON_BLINDXFR' set, if not exit. When found make sure the types are compatible. Check if channel is valid if so start the new channel else hangup the call.

Definition at line 482 of file features.c.

References ast_channel::_softhangup, ast_channel::_state, ast_channel_alloc, ast_channel_masquerade(), ast_clear_flag, AST_FLAGS_ALL, ast_frfree, ast_hangup(), ast_parseable_goto(), ast_pbx_start(), ast_read(), AST_STATE_DOWN, AST_STATE_UP, ast_strdupa, ast_strlen_zero(), f, ast_channel::linkedid, ast_channel::name, pbx_builtin_getvar_helper(), ast_channel::readformat, and ast_channel::writeformat.

Referenced by builtin_blindtransfer().

{
   struct ast_channel *xferchan;
   const char *val = pbx_builtin_getvar_helper(chan, "GOTO_ON_BLINDXFR");
   char *x, *goto_on_transfer;
   struct ast_frame *f;

   if (ast_strlen_zero(val))
      return;

   goto_on_transfer = ast_strdupa(val);

   if (!(xferchan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, "", "", "", chan->linkedid, 0, "%s", chan->name)))
      return;

   for (x = goto_on_transfer; x && *x; x++) {
      if (*x == '^')
         *x = '|';
   }
   /* Make formats okay */
   xferchan->readformat = chan->readformat;
   xferchan->writeformat = chan->writeformat;
   ast_channel_masquerade(xferchan, chan);
   ast_parseable_goto(xferchan, goto_on_transfer);
   xferchan->_state = AST_STATE_UP;
   ast_clear_flag(xferchan, AST_FLAGS_ALL);  
   xferchan->_softhangup = 0;
   if ((f = ast_read(xferchan))) {
      ast_frfree(f);
      f = NULL;
      ast_pbx_start(xferchan);
   } else {
      ast_hangup(xferchan);
   }
}

static struct ast_parkinglot* create_parkinglot

(

char *

name

)

[static, read]

Allocate parking lot structure.

Definition at line 3789 of file features.c.

References ao2_alloc, ast_copy_string(), AST_LIST_HEAD_INIT, ast_parkinglot::name, parkinglot_destroy(), and ast_parkinglot::parkings.

Referenced by build_parkinglot().

{
   struct ast_parkinglot *newlot = (struct ast_parkinglot *) NULL;

   if (!name)
      return NULL;

   newlot = ao2_alloc(sizeof(*newlot), parkinglot_destroy);
   if (!newlot)
      return NULL;
   
   ast_copy_string(newlot->name, name, sizeof(newlot->name));
   AST_LIST_HEAD_INIT(&newlot->parkings);

   return newlot;
}

static void dial_features_destroy

(

void *

data

)

[static]

Definition at line 409 of file features.c.

References ast_free.

{
   struct ast_dial_features *df = data;
   if (df) {
      ast_free(df);
   }
}

static void* dial_features_duplicate

(

void *

data

)

[static]

Definition at line 396 of file features.c.

References ast_calloc.

{
   struct ast_dial_features *df = data, *df_copy;
 
   if (!(df_copy = ast_calloc(1, sizeof(*df)))) {
      return NULL;
   }
 
   memcpy(df_copy, df, sizeof(*df));
 
   return df_copy;
}

static void do_bridge_masquerade	(	struct ast_channel *	chan,
		struct ast_channel *	tmpchan
	)			[static]

Actual bridge.

Parameters:

	chan
	tmpchan	Stop hold music, lock both channels, masq channels, after bridge return channel to next priority.

Definition at line 4382 of file features.c.

References ast_channel::_state, ast_channel_lock_both, ast_channel_masquerade(), ast_channel_unlock, ast_do_masquerade(), ast_explicit_goto(), ast_moh_stop(), ast_setstate(), ast_channel::context, ast_channel::exten, ast_channel::priority, ast_channel::readformat, and ast_channel::writeformat.

Referenced by action_bridge(), and bridge_exec().

{
   ast_moh_stop(chan);
   ast_channel_lock_both(chan, tmpchan);
   ast_setstate(tmpchan, chan->_state);
   tmpchan->readformat = chan->readformat;
   tmpchan->writeformat = chan->writeformat;
   ast_channel_masquerade(tmpchan, chan);
   ast_channel_unlock(chan);
   ast_channel_unlock(tmpchan);

   /* must be done without any channel locks held */
   ast_do_masquerade(tmpchan);

   /* when returning from bridge, the channel will continue at the next priority */
   ast_explicit_goto(tmpchan, chan->context, chan->exten, chan->priority + 1);
}

static void* do_parking_thread

(

void *

ignore

)

[static]

Take care of parked calls and unpark them if needed.

Parameters:

ignore

unused var.

Start inf loop, lock parking lot, check if any parked channels have gone above timeout if so, remove channel from parking lot and return it to the extension that parked it. Check if parked channel decided to hangup, wait until next FD via select().

Definition at line 3456 of file features.c.

References ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_samp2tv(), ast_select(), manage_parkinglot(), and parkinglots.

Referenced by ast_features_init().

{
   fd_set rfds, efds;   /* results from previous select, to be preserved across loops. */
   fd_set nrfds, nefds; /* args for the next select */
   FD_ZERO(&rfds);
   FD_ZERO(&efds);

   for (;;) {
      int res = 0;
      int ms = -1;   /* select timeout, uninitialized */
      int max = -1;  /* max fd, none there yet */
      struct ao2_iterator iter;
      struct ast_parkinglot *curlot;
      FD_ZERO(&nrfds);
      FD_ZERO(&nefds);
      iter = ao2_iterator_init(parkinglots, 0);

      while ((curlot = ao2_iterator_next(&iter))) {
         res = manage_parkinglot(curlot, &rfds, &efds, &nrfds, &nefds, &ms, &max);
         ao2_ref(curlot, -1);
      }

      rfds = nrfds;
      efds = nefds;
      {
         struct timeval wait = ast_samp2tv(ms, 1000);
         /* Wait for something to happen */
         ast_select(max + 1, &rfds, NULL, &efds, (ms > -1) ? &wait : NULL);
      }
      pthread_testcancel();
   }
   return NULL;   /* Never reached */
}

static int feature_exec_app	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		void *	data
	)			[static]

exec an app by feature

Parameters:

chan,peer,config,code,sense,data

Find a feature, determine which channel activated

Return values:

	AST_FEATURE_RETURN_NO_HANGUP_PEER
	-1	error.
	-2	when an application cannot be found.

Todo:

XXX should probably return res

Definition at line 2101 of file features.c.

References ast_call_feature::app, app, ast_call_feature::app_args, ast_autoservice_start(), ast_autoservice_stop(), AST_FEATURE_FLAG_BYCALLEE, AST_FEATURE_FLAG_BYCALLER, AST_FEATURE_FLAG_ONSELF, AST_FEATURE_RETURN_KEEPTRYING, AST_FEATURE_RETURN_SUCCESS, AST_FEATURE_RETURN_SUCCESSBREAK, ast_log(), ast_moh_start(), ast_moh_stop(), ast_strlen_zero(), ast_test_flag, FEATURE_SENSE_CHAN, LOG_NOTICE, LOG_WARNING, ast_call_feature::moh_class, ast_channel::name, pbx_builtin_setvar_helper(), pbx_exec(), pbx_findapp(), and ast_call_feature::sname.

Referenced by load_config().

{
   struct ast_app *app;
   struct ast_call_feature *feature = data;
   struct ast_channel *work, *idle;
   int res;

   if (!feature) { /* shouldn't ever happen! */
      ast_log(LOG_NOTICE, "Found feature before, but at execing we've lost it??\n");
      return -1; 
   }

   if (sense == FEATURE_SENSE_CHAN) {
      if (!ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLER))
         return AST_FEATURE_RETURN_KEEPTRYING;
      if (ast_test_flag(feature, AST_FEATURE_FLAG_ONSELF)) {
         work = chan;
         idle = peer;
      } else {
         work = peer;
         idle = chan;
      }
   } else {
      if (!ast_test_flag(feature, AST_FEATURE_FLAG_BYCALLEE))
         return AST_FEATURE_RETURN_KEEPTRYING;
      if (ast_test_flag(feature, AST_FEATURE_FLAG_ONSELF)) {
         work = peer;
         idle = chan;
      } else {
         work = chan;
         idle = peer;
      }
   }

   if (!(app = pbx_findapp(feature->app))) {
      ast_log(LOG_WARNING, "Could not find application (%s)\n", feature->app);
      return -2;
   }

   ast_autoservice_start(idle);
   
   if(work && idle) {
      pbx_builtin_setvar_helper(work, "DYNAMIC_PEERNAME", idle->name);
      pbx_builtin_setvar_helper(idle, "DYNAMIC_PEERNAME", work->name);
      pbx_builtin_setvar_helper(work, "DYNAMIC_FEATURENAME", feature->sname);
      pbx_builtin_setvar_helper(idle, "DYNAMIC_FEATURENAME", feature->sname);
   }

   if (!ast_strlen_zero(feature->moh_class))
      ast_moh_start(idle, feature->moh_class, NULL);

   res = pbx_exec(work, app, feature->app_args);

   if (!ast_strlen_zero(feature->moh_class))
      ast_moh_stop(idle);

   ast_autoservice_stop(idle);

   if (res) {
      return AST_FEATURE_RETURN_SUCCESSBREAK;
   }
   return AST_FEATURE_RETURN_SUCCESS;  /*! \todo XXX should probably return res */
}

static int feature_interpret	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense
	)			[static]

Check the dynamic features.

Parameters:

chan,peer,config,code,sense

Return values:

	res	on success.
	-1	on failure.

Definition at line 2307 of file features.c.

References ast_channel_lock, ast_channel_unlock, ast_copy_flags, ast_debug, AST_FLAGS_ALL, ast_strdupa, feature_interpret_helper(), FEATURE_SENSE_CHAN, ast_bridge_config::features_callee, ast_bridge_config::features_caller, ast_flags::flags, ast_channel::name, pbx_builtin_getvar_helper(), and S_OR.

Referenced by ast_bridge_call().

                                                                                                                                                {

   char dynamic_features_buf[128];
   const char *peer_dynamic_features, *chan_dynamic_features;
   struct ast_flags features;
   struct ast_call_feature feature;
   if (sense == FEATURE_SENSE_CHAN) {
      ast_copy_flags(&features, &(config->features_caller), AST_FLAGS_ALL);
   }
   else {
      ast_copy_flags(&features, &(config->features_callee), AST_FLAGS_ALL);
   }

   ast_channel_lock(peer);
   peer_dynamic_features = ast_strdupa(S_OR(pbx_builtin_getvar_helper(peer, "DYNAMIC_FEATURES"),""));
   ast_channel_unlock(peer);

   ast_channel_lock(chan);
   chan_dynamic_features = ast_strdupa(S_OR(pbx_builtin_getvar_helper(chan, "DYNAMIC_FEATURES"),""));
   ast_channel_unlock(chan);

   snprintf(dynamic_features_buf, sizeof(dynamic_features_buf), "%s%s%s", S_OR(chan_dynamic_features, ""), chan_dynamic_features && peer_dynamic_features ? "#" : "", S_OR(peer_dynamic_features,""));

   ast_debug(3, "Feature interpret: chan=%s, peer=%s, code=%s, sense=%d, features=%d, dynamic=%s\n", chan->name, peer->name, code, sense, features.flags, dynamic_features_buf);

   return feature_interpret_helper(chan, peer, config, code, sense, dynamic_features_buf, &features, 1, &feature);
}

static int feature_interpret_helper	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config,
		const char *	code,
		int	sense,
		char *	dynamic_features_buf,
		struct ast_flags *	features,
		int	operation,
		struct ast_call_feature *	feature
	)			[static]

Helper function for feature_interpret and ast_feature_detect.

Parameters:

chan,peer,config,code,sense,dynamic_features

char buf,feature flags,operation,feature

Lock features list, browse for code, unlock list If a feature is found and the operation variable is set, that feature's operation is executed. The first feature found is copied to the feature parameter.

Return values:

	res	on success.
	-1	on failure.

Definition at line 2203 of file features.c.

References ast_debug, AST_FEATURE_RETURN_KEEPTRYING, AST_FEATURE_RETURN_PASSDIGITS, AST_FEATURE_RETURN_STOREDIGITS, AST_LIST_TRAVERSE, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, ast_rwlock_rdlock(), ast_rwlock_unlock(), ast_strlen_zero(), ast_test_flag, ast_verb, ast_call_feature::exten, feature_group_exten::exten, feature_group_exten::feature, ast_call_feature::feature_mask, feature_group::features, FEATURES_COUNT, features_lock, find_dynamic_feature(), find_group(), ast_call_feature::fname, ast_call_feature::operation, ast_call_feature::sname, and strsep().

Referenced by ast_feature_detect(), and feature_interpret().

{
   int x;
   struct feature_group *fg = NULL;
   struct feature_group_exten *fge;
   struct ast_call_feature *tmpfeature;
   char *tmp, *tok;
   int res = AST_FEATURE_RETURN_PASSDIGITS;
   int feature_detected = 0;

   if (!(peer && chan && config) && operation) {
      return -1; /* can not run feature operation */
   }

   ast_rwlock_rdlock(&features_lock);
   for (x = 0; x < FEATURES_COUNT; x++) {
      if ((ast_test_flag(features, builtin_features[x].feature_mask)) &&
          !ast_strlen_zero(builtin_features[x].exten)) {
         /* Feature is up for consideration */
         if (!strcmp(builtin_features[x].exten, code)) {
            ast_debug(3, "Feature detected: fname=%s sname=%s exten=%s\n", builtin_features[x].fname, builtin_features[x].sname, builtin_features[x].exten);
            if (operation) {
               res = builtin_features[x].operation(chan, peer, config, code, sense, NULL);
            }
            memcpy(feature, &builtin_features[x], sizeof(feature));
            feature_detected = 1;
            break;
         } else if (!strncmp(builtin_features[x].exten, code, strlen(code))) {
            if (res == AST_FEATURE_RETURN_PASSDIGITS)
               res = AST_FEATURE_RETURN_STOREDIGITS;
         }
      }
   }
   ast_rwlock_unlock(&features_lock);

   if (ast_strlen_zero(dynamic_features_buf) || feature_detected) {
      return res;
   }

   tmp = dynamic_features_buf;

   while ((tok = strsep(&tmp, "#"))) {
      AST_RWLIST_RDLOCK(&feature_groups);

      fg = find_group(tok);

      if (fg) {
         AST_LIST_TRAVERSE(&fg->features, fge, entry) {
            if (strcasecmp(fge->exten, code))
               continue;
            if (operation) {
               res = fge->feature->operation(chan, peer, config, code, sense, fge->feature);
            }
            memcpy(feature, fge->feature, sizeof(feature));
            if (res != AST_FEATURE_RETURN_KEEPTRYING) {
               AST_RWLIST_UNLOCK(&feature_groups);
               break;
            }
            res = AST_FEATURE_RETURN_PASSDIGITS;
         }
         if (fge)
            break;
      }

      AST_RWLIST_UNLOCK(&feature_groups);

      AST_RWLIST_RDLOCK(&feature_list);

      if (!(tmpfeature = find_dynamic_feature(tok))) {
         AST_RWLIST_UNLOCK(&feature_list);
         continue;
      }

      /* Feature is up for consideration */
      if (!strcmp(tmpfeature->exten, code)) {
         ast_verb(3, " Feature Found: %s exten: %s\n",tmpfeature->sname, tok);
         if (operation) {
            res = tmpfeature->operation(chan, peer, config, code, sense, tmpfeature);
         }
         memcpy(feature, tmpfeature, sizeof(feature));
         if (res != AST_FEATURE_RETURN_KEEPTRYING) {
            AST_RWLIST_UNLOCK(&feature_list);
            break;
         }
         res = AST_FEATURE_RETURN_PASSDIGITS;
      } else if (!strncmp(tmpfeature->exten, code, strlen(code)))
         res = AST_FEATURE_RETURN_STOREDIGITS;

      AST_RWLIST_UNLOCK(&feature_list);
   }

   return res;
}

static struct ast_channel * feature_request_and_dial	(	struct ast_channel *	caller,
		struct ast_channel *	transferee,
		const char *	type,
		int	format,
		void *	data,
		int	timeout,
		int *	outstate,
		const char *	cid_num,
		const char *	cid_name,
		int	igncallerstate,
		const char *	language
	)			[static, read]

Get feature and dial.

Parameters:

caller,transferee,type,format,data,timeout,outstate,cid_num,cid_name,igncallerstate

Request channel, set channel variables, initiate call,check if they want to disconnect go into loop, check if timeout has elapsed, check if person to be transfered hung up, check for answer break loop, set cdr return channel.

Todo:

XXX Check - this is very similar to the code in channel.c

Returns:

always a channel

Definition at line 2394 of file features.c.

References ast_channel::_state, ast_call(), ast_call_forward(), AST_CAUSE_BUSY, AST_CAUSE_CONGESTION, ast_channel_connected_line_macro(), ast_channel_inherit_variables(), ast_channel_lock, ast_channel_unlock, ast_check_hangup(), ast_connected_line_copy_from_caller(), AST_CONTROL_ANSWER, AST_CONTROL_BUSY, AST_CONTROL_CONGESTION, AST_CONTROL_CONNECTED_LINE, AST_CONTROL_HANGUP, AST_CONTROL_PROGRESS, AST_CONTROL_RINGING, AST_CONTROL_UNHOLD, AST_FRAME_CONTROL, AST_FRAME_DTMF, AST_FRAME_TEXT, AST_FRAME_VIDEO, AST_FRAME_VOICE, ast_frfree, ast_hangup(), ast_indicate(), ast_indicate_data(), ast_log(), ast_poll_channel_add(), ast_poll_channel_del(), ast_read(), ast_request(), ast_rwlock_rdlock(), ast_rwlock_unlock(), ast_set_callerid(), AST_STATE_UP, ast_string_field_set, ast_strlen_zero(), ast_tvdiff_ms(), ast_tvnow(), ast_verb, ast_waitfor_n(), ast_write(), ast_channel::call_forward, cause, ast_channel::cid, ast_channel::connected, ast_frame::data, ast_frame::datalen, ast_call_feature::exten, f, FEATURES_COUNT, features_lock, ast_frame::frametype, len(), LOG_NOTICE, ast_channel::name, pbx_builtin_setvar_helper(), ast_frame::ptr, and ast_frame::subclass.

Referenced by builtin_atxfer().

{
   int state = 0;
   int cause = 0;
   int to;
   struct ast_channel *chan;
   struct ast_channel *monitor_chans[2];
   struct ast_channel *active_channel;
   int res = 0, ready = 0;
   struct timeval started;
   int x, len = 0;
   char *disconnect_code = NULL, *dialed_code = NULL;

   if (!(chan = ast_request(type, format, caller, data, &cause))) {
      ast_log(LOG_NOTICE, "Unable to request channel %s/%s\n", type, (char *)data);
      switch(cause) {
      case AST_CAUSE_BUSY:
         state = AST_CONTROL_BUSY;
         break;
      case AST_CAUSE_CONGESTION:
         state = AST_CONTROL_CONGESTION;
         break;
      }
      goto done;
   }

   ast_set_callerid(chan, cid_num, cid_name, cid_num);
   ast_string_field_set(chan, language, language);
   ast_channel_inherit_variables(caller, chan); 
   pbx_builtin_setvar_helper(chan, "TRANSFERERNAME", caller->name);
      
   ast_channel_lock(chan);
   ast_connected_line_copy_from_caller(&chan->connected, &caller->cid);
   ast_channel_unlock(chan);
   
   if (ast_call(chan, data, timeout)) {
      ast_log(LOG_NOTICE, "Unable to call channel %s/%s\n", type, (char *)data);
      goto done;
   }
   
   ast_indicate(caller, AST_CONTROL_RINGING);
   /* support dialing of the featuremap disconnect code while performing an attended tranfer */
   ast_rwlock_rdlock(&features_lock);
   for (x = 0; x < FEATURES_COUNT; x++) {
      if (strcasecmp(builtin_features[x].sname, "disconnect"))
         continue;

      disconnect_code = builtin_features[x].exten;
      len = strlen(disconnect_code) + 1;
      dialed_code = alloca(len);
      memset(dialed_code, 0, len);
      break;
   }
   ast_rwlock_unlock(&features_lock);
   x = 0;
   started = ast_tvnow();
   to = timeout;

   ast_poll_channel_add(caller, chan);

   while (!((transferee && ast_check_hangup(transferee)) && (!igncallerstate && ast_check_hangup(caller))) && timeout && (chan->_state != AST_STATE_UP)) {
      struct ast_frame *f = NULL;

      monitor_chans[0] = caller;
      monitor_chans[1] = chan;
      active_channel = ast_waitfor_n(monitor_chans, 2, &to);

      /* see if the timeout has been violated */
      if(ast_tvdiff_ms(ast_tvnow(), started) > timeout) {
         state = AST_CONTROL_UNHOLD;
         ast_log(LOG_NOTICE, "We exceeded our AT-timeout\n");
         break; /*doh! timeout*/
      }

      if (!active_channel)
         continue;

      if (chan && (chan == active_channel)){
         if (!ast_strlen_zero(chan->call_forward)) {
            if (!(chan = ast_call_forward(caller, chan, &to, format, NULL, outstate))) {
               return NULL;
            }
            continue;
         }
         f = ast_read(chan);
         if (f == NULL) { /*doh! where'd he go?*/
            state = AST_CONTROL_HANGUP;
            res = 0;
            break;
         }
         
         if (f->frametype == AST_FRAME_CONTROL || f->frametype == AST_FRAME_DTMF || f->frametype == AST_FRAME_TEXT) {
            if (f->subclass == AST_CONTROL_RINGING) {
               state = f->subclass;
               ast_verb(3, "%s is ringing\n", chan->name);
               ast_indicate(caller, AST_CONTROL_RINGING);
            } else if ((f->subclass == AST_CONTROL_BUSY) || (f->subclass == AST_CONTROL_CONGESTION)) {
               state = f->subclass;
               ast_verb(3, "%s is busy\n", chan->name);
               ast_indicate(caller, AST_CONTROL_BUSY);
               ast_frfree(f);
               f = NULL;
               break;
            } else if (f->subclass == AST_CONTROL_ANSWER) {
               /* This is what we are hoping for */
               state = f->subclass;
               ast_frfree(f);
               f = NULL;
               ready=1;
               break;
            } else if (f->subclass == AST_CONTROL_CONNECTED_LINE) {
               if (ast_channel_connected_line_macro(chan, caller, f, 1, 1)) {
                  ast_indicate_data(caller, AST_CONTROL_CONNECTED_LINE, f->data.ptr, f->datalen);
               }
            } else if (f->subclass != -1 && f->subclass != AST_CONTROL_PROGRESS) {
               ast_log(LOG_NOTICE, "Don't know what to do about control frame: %d\n", f->subclass);
            }
            /* else who cares */
         } else if (f->frametype == AST_FRAME_VOICE || f->frametype == AST_FRAME_VIDEO) {
            ast_write(caller, f);
         }

      } else if (caller && (active_channel == caller)) {
         f = ast_read(caller);
         if (f == NULL) { /*doh! where'd he go?*/
            if (!igncallerstate) {
               if (ast_check_hangup(caller) && !ast_check_hangup(chan)) {
                  /* make this a blind transfer */
                  ready = 1;
                  break;
               }
               state = AST_CONTROL_HANGUP;
               res = 0;
               break;
            }
         } else {
         
            if (f->frametype == AST_FRAME_DTMF) {
               dialed_code[x++] = f->subclass;
               dialed_code[x] = '\0';
               if (strlen(dialed_code) == len) {
                  x = 0;
               } else if (x && strncmp(dialed_code, disconnect_code, x)) {
                  x = 0;
                  dialed_code[x] = '\0';
               }
               if (*dialed_code && !strcmp(dialed_code, disconnect_code)) {
                  /* Caller Canceled the call */
                  state = AST_CONTROL_UNHOLD;
                  ast_frfree(f);
                  f = NULL;
                  break;
               }
            } else if (f->frametype == AST_FRAME_VOICE || f->frametype == AST_FRAME_VIDEO) {
               ast_write(chan, f);
            }
         }
      }
      if (f)
         ast_frfree(f);
   } /* end while */

   ast_poll_channel_del(caller, chan);
      
done:
   ast_indicate(caller, -1);
   if (chan && ready) {
      if (chan->_state == AST_STATE_UP) 
         state = AST_CONTROL_ANSWER;
      res = 0;
   } else if (chan) {
      res = -1;
      ast_hangup(chan);
      chan = NULL;
   } else {
      res = -1;
   }
   
   if (outstate)
      *outstate = state;

   return chan;
}

static int find_channel_by_group	(	void *	obj,
		void *	arg,
		void *	data,
		int	flags
	)			[static]

Definition at line 4709 of file features.c.

References ast_channel::_state, AST_STATE_RING, AST_STATE_RINGING, ast_channel::callgroup, CMP_MATCH, CMP_STOP, ast_channel::pbx, and ast_channel::pickupgroup.

Referenced by ast_pickup_call().

{
   struct ast_channel *c = data;
   struct ast_channel *chan = obj;

   int i = !chan->pbx &&
      /* Accessing 'chan' here is safe without locking, because there is no way for
         the channel do disappear from under us at this point.  pickupgroup *could*
         change while we're here, but that isn't a problem. */
      (c != chan) &&
      (chan->pickupgroup & c->callgroup) &&
      ((chan->_state == AST_STATE_RINGING) || (chan->_state == AST_STATE_RING));

   return i ? CMP_MATCH | CMP_STOP : 0;
}

static struct ast_call_feature* find_dynamic_feature

(

const char *

name

)

[static, read]

find a call feature by name

Definition at line 2023 of file features.c.

References AST_RWLIST_TRAVERSE, ast_call_feature::feature_entry, and ast_call_feature::sname.

Referenced by feature_interpret_helper(), load_config(), and set_config_flags().

{
   struct ast_call_feature *tmp;

   AST_RWLIST_TRAVERSE(&feature_list, tmp, feature_entry) {
      if (!strcasecmp(tmp->sname, name)) {
         break;
      }
   }

   return tmp;
}

static struct feature_group* find_group

(

const char *

name

)

[static, read]

Find a group by name.

Parameters:

name

feature name

Return values:

	feature	group on success.
	NULL	on failure.

Definition at line 2061 of file features.c.

References AST_LIST_TRAVERSE, and feature_group::gname.

Referenced by feature_interpret_helper().

                                                          {
   struct feature_group *fg = NULL;

   AST_LIST_TRAVERSE(&feature_groups, fg, entry) {
      if (!strcasecmp(fg->gname, name))
         break;
   }

   return fg;
}

struct ast_parkinglot * find_parkinglot

(

const char *

name

)

[read]

Find parkinglot by name.

Definition at line 3491 of file features.c.

References ao2_find, ast_copy_string(), ast_log(), ast_strlen_zero(), LOG_DEBUG, ast_parkinglot::name, OBJ_POINTER, option_debug, and parkinglots.

Referenced by build_parkinglot(), park_exec_full(), and park_space_reserve().

{
   struct ast_parkinglot *parkinglot = NULL;
   struct ast_parkinglot tmp_parkinglot;
   
   if (ast_strlen_zero(name))
      return NULL;

   ast_copy_string(tmp_parkinglot.name, name, sizeof(tmp_parkinglot.name));

   parkinglot = ao2_find(parkinglots, &tmp_parkinglot, OBJ_POINTER);

   if (parkinglot && option_debug)
      ast_log(LOG_DEBUG, "Found Parkinglot: %s\n", parkinglot->name);

   return parkinglot;
}

static const char* findparkinglotname

(

struct ast_channel *

chan

)

[static]

Find parking lot name from channel.

Definition at line 609 of file features.c.

References ast_strlen_zero(), ast_channel::parkinglot, and pbx_builtin_getvar_helper().

Referenced by park_exec_full(), and park_space_reserve().

{
   const char *temp, *parkinglot = NULL;

   /* Check if the channel has a parking lot */
   if (!ast_strlen_zero(chan->parkinglot))
      parkinglot = chan->parkinglot;

   /* Channel variables override everything */

   if ((temp  = pbx_builtin_getvar_helper(chan, "PARKINGLOT")))
      return temp;

   return parkinglot;
}

static int finishup

(

struct ast_channel *

chan

)

[static]

Definition at line 1334 of file features.c.

References ast_autoservice_stop(), AST_CONTROL_UNHOLD, and ast_indicate().

Referenced by builtin_atxfer(), and builtin_blindtransfer().

{
   ast_indicate(chan, AST_CONTROL_UNHOLD);

   return ast_autoservice_stop(chan);
}

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

CLI command to list configured features.

Parameters:

	e
	cmd
	a

Return values:

	CLI_SUCCESS	on success.
	NULL	when tab completion is used.

Definition at line 4283 of file features.c.

References ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_cli(), ast_pickup_ext(), AST_RWLIST_EMPTY, AST_RWLIST_RDLOCK, AST_RWLIST_TRAVERSE, AST_RWLIST_UNLOCK, ast_rwlock_rdlock(), ast_rwlock_unlock(), CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, ast_call_feature::default_exten, ast_call_feature::exten, ast_cli_args::fd, FEATURES_COUNT, features_lock, ast_call_feature::fname, HFS_FORMAT, ast_parkinglot::name, ast_parkinglot::parking_con, parking_ext, ast_parkinglot::parking_start, ast_parkinglot::parking_stop, parkinglots, ast_call_feature::sname, and ast_cli_entry::usage.

{
   int i;
   struct ast_call_feature *feature;
   struct ao2_iterator iter;
   struct ast_parkinglot *curlot;
#define HFS_FORMAT "%-25s %-7s %-7s\n"

   switch (cmd) {
   
   case CLI_INIT:
      e->command = "features show";
      e->usage =
         "Usage: features show\n"
         "       Lists configured features\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   ast_cli(a->fd, HFS_FORMAT, "Builtin Feature", "Default", "Current");
   ast_cli(a->fd, HFS_FORMAT, "---------------", "-------", "-------");

   ast_cli(a->fd, HFS_FORMAT, "Pickup", "*8", ast_pickup_ext());          /* default hardcoded above, so we'll hardcode it here */

   ast_rwlock_rdlock(&features_lock);
   for (i = 0; i < FEATURES_COUNT; i++)
      ast_cli(a->fd, HFS_FORMAT, builtin_features[i].fname, builtin_features[i].default_exten, builtin_features[i].exten);
   ast_rwlock_unlock(&features_lock);

   ast_cli(a->fd, "\n");
   ast_cli(a->fd, HFS_FORMAT, "Dynamic Feature", "Default", "Current");
   ast_cli(a->fd, HFS_FORMAT, "---------------", "-------", "-------");
   if (AST_RWLIST_EMPTY(&feature_list)) {
      ast_cli(a->fd, "(none)\n");
   } else {
      AST_RWLIST_RDLOCK(&feature_list);
      AST_RWLIST_TRAVERSE(&feature_list, feature, feature_entry) {
         ast_cli(a->fd, HFS_FORMAT, feature->sname, "no def", feature->exten);
      }
      AST_RWLIST_UNLOCK(&feature_list);
   }

   // loop through all the parking lots
   iter = ao2_iterator_init(parkinglots, 0);

   while ((curlot = ao2_iterator_next(&iter))) {
      ast_cli(a->fd, "\nCall parking (Parking lot: %s)\n", curlot->name);
      ast_cli(a->fd, "------------\n");
      ast_cli(a->fd,"%-22s:      %s\n", "Parking extension", parking_ext);
      ast_cli(a->fd,"%-22s:      %s\n", "Parking context", curlot->parking_con);
      ast_cli(a->fd,"%-22s:      %d-%d\n", "Parked call extensions", curlot->parking_start, curlot->parking_stop);
      ast_cli(a->fd,"\n");
      ao2_ref(curlot, -1);
   }


   return CLI_SUCCESS;
}

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

Definition at line 4357 of file features.c.

References ast_features_reload(), CLI_GENERATE, CLI_INIT, CLI_SUCCESS, ast_cli_entry::command, and ast_cli_entry::usage.

{
   switch (cmd) { 
   case CLI_INIT:
      e->command = "features reload";
      e->usage =
         "Usage: features reload\n"
         "       Reloads configured call features from features.conf\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }
   ast_features_reload();

   return CLI_SUCCESS;
}

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

CLI command to list parked calls.

Parameters:

	e
	cmd
	a	Check right usage, lock parking lot, display parked calls, unlock parking lot list.

Return values:

	CLI_SUCCESS	on success.
	CLI_SHOWUSAGE	on incorrect number of arguments.
	NULL	when tab completion is used.

Definition at line 4531 of file features.c.

References ao2_iterator_init(), ao2_iterator_next, ao2_ref, ast_cli_args::argc, ast_cli_entry::args, ast_cli(), AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, parkeduser::chan, CLI_GENERATE, CLI_INIT, CLI_SHOWUSAGE, CLI_SUCCESS, ast_cli_entry::command, parkeduser::context, ESS, parkeduser::exten, ast_cli_args::fd, ast_channel::name, ast_parkinglot::name, parkeduser::parkingexten, parkinglots, ast_parkinglot::parkings, parkeduser::parkingtime, parkeduser::priority, parkeduser::start, and ast_cli_entry::usage.

{
   struct parkeduser *cur;
   int numparked = 0;
   struct ao2_iterator iter;
   struct ast_parkinglot *curlot;

   switch (cmd) {
   case CLI_INIT:
      e->command = "parkedcalls show";
      e->usage =
         "Usage: parkedcalls show\n"
         "       List currently parked calls\n";
      return NULL;
   case CLI_GENERATE:
      return NULL;
   }

   if (a->argc > e->args)
      return CLI_SHOWUSAGE;

   ast_cli(a->fd, "%4s %25s (%-15s %-12s %-4s) %-6s \n", "Num", "Channel"
      , "Context", "Extension", "Pri", "Timeout");

   iter = ao2_iterator_init(parkinglots, 0);
   while ((curlot = ao2_iterator_next(&iter))) {
      int lotparked = 0;
      ast_cli(a->fd, "*** Parking lot: %s\n", curlot->name);

      AST_LIST_LOCK(&curlot->parkings);
      AST_LIST_TRAVERSE(&curlot->parkings, cur, list) {
         ast_cli(a->fd, "%-10.10s %25s (%-15s %-12s %-4d) %6lds\n"
            ,cur->parkingexten, cur->chan->name, cur->context, cur->exten
            ,cur->priority,
            (long)(cur->start.tv_sec + (cur->parkingtime/1000) - time(NULL)) );
         numparked++;
         numparked += lotparked;
      }
      AST_LIST_UNLOCK(&curlot->parkings);
      if (lotparked)
         ast_cli(a->fd, "   %d parked call%s in parking lot %s\n", lotparked, ESS(lotparked), curlot->name);

      ao2_ref(curlot, -1);
   }

   ast_cli(a->fd, "---\n%d parked call%s in total.\n", numparked, ESS(numparked));

   return CLI_SUCCESS;
}

static int load_config

(

void

)

[static]

Todo:

XXX var_name or app_args ?

Definition at line 3936 of file features.c.

References adsipark, ao2_lock(), ao2_unlock(), ast_call_feature::app, app, ast_call_feature::app_args, ARRAY_LEN, ast_add_extension2(), ast_calloc, ast_category_browse(), ast_config_destroy(), ast_config_load2(), ast_context_find(), ast_context_find_or_create(), ast_context_remove_extension2(), ast_copy_string(), ast_debug, AST_DEVICE_INUSE, AST_DEVICE_NOT_INUSE, AST_FEATURE_FLAG_BYBOTH, AST_FEATURE_FLAG_BYCALLEE, AST_FEATURE_FLAG_BYCALLER, AST_FEATURE_FLAG_NEEDSDTMF, AST_FEATURE_FLAG_ONPEER, AST_FEATURE_FLAG_ONSELF, ast_find_call_feature(), ast_log(), ast_parking_ext(), ast_register_feature(), AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, AST_RWLIST_WRLOCK, ast_set_flag, ast_strdupa, ast_strlen_zero(), ast_true(), ast_unregister_features(), ast_unregister_groups(), ast_variable_browse(), ast_verb, atxfercallbackretries, atxferdropcall, atxferloopdelay, atxfernoanswertimeout, build_parkinglot(), comebacktoorigin, CONFIG_STATUS_FILEINVALID, CONFIG_STATUS_FILEMISSING, CONFIG_STATUS_FILEUNCHANGED, courtesytone, DEFAULT_ATXFER_CALLBACK_RETRIES, DEFAULT_ATXFER_DROP_CALL, DEFAULT_ATXFER_LOOP_DELAY, DEFAULT_FEATURE_DIGIT_TIMEOUT, DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER, DEFAULT_PARK_TIME, DEFAULT_PARKINGLOT, default_parkinglot, DEFAULT_TRANSFER_DIGIT_TIMEOUT, ast_call_feature::exten, FEATURE_APP_ARGS_LEN, FEATURE_APP_LEN, feature_exec_app(), FEATURE_EXTEN_LEN, FEATURE_MOH_LEN, FEATURE_SNAME_LEN, featuredigittimeout, find_dynamic_feature(), ast_variable::lineno, LOG_DEBUG, LOG_ERROR, LOG_NOTICE, LOG_WARNING, ast_call_feature::moh_class, ast_variable::name, ast_variable::next, notify_metermaids(), ast_call_feature::operation, option_debug, park_add_hints(), parkcall, parkedplay, parking_ext, pickup_ext, pickupfailsound, pickupsound, register_group(), register_group_feature(), registrar, remap_feature(), ast_call_feature::sname, strsep(), transferdigittimeout, unmap_features(), ast_variable::value, var, xferfailsound, and xfersound.

{
   int start = 0, end = 0;
   int res;
   int i;
   struct ast_context *con = NULL;
   struct ast_config *cfg = NULL;
   struct ast_variable *var = NULL;
   struct feature_group *fg = NULL;
   struct ast_flags config_flags = { 0 };
   char old_parking_ext[AST_MAX_EXTENSION];
   char old_parking_con[AST_MAX_EXTENSION] = "";
   char *ctg; 
   static const char * const categories[] = { 
      /* Categories in features.conf that are not
       * to be parsed as group categories
       */
      "general",
      "featuremap",
      "applicationmap"
   };

   if (default_parkinglot) {
      strcpy(old_parking_con, default_parkinglot->parking_con);
      strcpy(old_parking_ext, parking_ext);
   } else {
      default_parkinglot = build_parkinglot(DEFAULT_PARKINGLOT, NULL);
      if (default_parkinglot) {
         ao2_lock(default_parkinglot);
         default_parkinglot->parking_start = 701;
         default_parkinglot->parking_stop = 750;
         default_parkinglot->parking_offset = 0;
         default_parkinglot->parkfindnext = 0;
         default_parkinglot->parkingtime = DEFAULT_PARK_TIME;
         ao2_unlock(default_parkinglot);
      }
   }
   if (default_parkinglot) {
      if (option_debug)
         ast_log(LOG_DEBUG, "Configuration of default parkinglot done.\n");
   } else {
      ast_log(LOG_ERROR, "Configuration of default parkinglot failed.\n");
      return -1;
   }
   

   /* Reset to defaults */
   strcpy(parking_ext, "700");
   strcpy(pickup_ext, "*8");
   courtesytone[0] = '\0';
   strcpy(xfersound, "beep");
   strcpy(xferfailsound, "pbx-invalid");
   pickupsound[0] = '\0';
   pickupfailsound[0] = '\0';
   adsipark = 0;
   comebacktoorigin = 1;

   default_parkinglot->parkaddhints = 0;
   default_parkinglot->parkedcalltransfers = 0;
   default_parkinglot->parkedcallreparking = 0;
   default_parkinglot->parkedcallrecording = 0;
   default_parkinglot->parkedcallhangup = 0;

   transferdigittimeout = DEFAULT_TRANSFER_DIGIT_TIMEOUT;
   featuredigittimeout = DEFAULT_FEATURE_DIGIT_TIMEOUT;
   atxfernoanswertimeout = DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER;
   atxferloopdelay = DEFAULT_ATXFER_LOOP_DELAY;
   atxferdropcall = DEFAULT_ATXFER_DROP_CALL;
   atxfercallbackretries = DEFAULT_ATXFER_CALLBACK_RETRIES;

   cfg = ast_config_load2("features.conf", "features", config_flags);
   if (cfg == CONFIG_STATUS_FILEMISSING || cfg == CONFIG_STATUS_FILEUNCHANGED || cfg == CONFIG_STATUS_FILEINVALID) {
      ast_log(LOG_WARNING,"Could not load features.conf\n");
      return 0;
   }
   for (var = ast_variable_browse(cfg, "general"); var; var = var->next) {
      if (!strcasecmp(var->name, "parkext")) {
         ast_copy_string(parking_ext, var->value, sizeof(parking_ext));
      } else if (!strcasecmp(var->name, "context")) {
         ast_copy_string(default_parkinglot->parking_con, var->value, sizeof(default_parkinglot->parking_con));
      } else if (!strcasecmp(var->name, "parkingtime")) {
         if ((sscanf(var->value, "%30d", &default_parkinglot->parkingtime) != 1) || (default_parkinglot->parkingtime < 1)) {
            ast_log(LOG_WARNING, "%s is not a valid parkingtime\n", var->value);
            default_parkinglot->parkingtime = DEFAULT_PARK_TIME;
         } else
            default_parkinglot->parkingtime = default_parkinglot->parkingtime * 1000;
      } else if (!strcasecmp(var->name, "parkpos")) {
         if (sscanf(var->value, "%30d-%30d", &start, &end) != 2) {
            ast_log(LOG_WARNING, "Format for parking positions is a-b, where a and b are numbers at line %d of features.conf\n", var->lineno);
         } else if (default_parkinglot) {
            default_parkinglot->parking_start = start;
            default_parkinglot->parking_stop = end;
         } else {
            ast_log(LOG_WARNING, "No default parking lot!\n");
         }
      } else if (!strcasecmp(var->name, "findslot")) {
         default_parkinglot->parkfindnext = (!strcasecmp(var->value, "next"));
      } else if (!strcasecmp(var->name, "parkinghints")) {
         default_parkinglot->parkaddhints = ast_true(var->value);
      } else if (!strcasecmp(var->name, "parkedcalltransfers")) {
         if (!strcasecmp(var->value, "both"))
            default_parkinglot->parkedcalltransfers = AST_FEATURE_FLAG_BYBOTH;
         else if (!strcasecmp(var->value, "caller"))
            default_parkinglot->parkedcalltransfers = AST_FEATURE_FLAG_BYCALLER;
         else if (!strcasecmp(var->value, "callee"))
            default_parkinglot->parkedcalltransfers = AST_FEATURE_FLAG_BYCALLEE;
      } else if (!strcasecmp(var->name, "parkedcallreparking")) {
         if (!strcasecmp(var->value, "both"))
            default_parkinglot->parkedcallreparking = AST_FEATURE_FLAG_BYBOTH;
         else if (!strcasecmp(var->value, "caller"))
            default_parkinglot->parkedcallreparking = AST_FEATURE_FLAG_BYCALLER;
         else if (!strcasecmp(var->value, "callee"))
            default_parkinglot->parkedcallreparking = AST_FEATURE_FLAG_BYCALLEE;
      } else if (!strcasecmp(var->name, "parkedcallhangup")) {
         if (!strcasecmp(var->value, "both"))
            default_parkinglot->parkedcallhangup = AST_FEATURE_FLAG_BYBOTH;
         else if (!strcasecmp(var->value, "caller"))
            default_parkinglot->parkedcallhangup = AST_FEATURE_FLAG_BYCALLER;
         else if (!strcasecmp(var->value, "callee"))
            default_parkinglot->parkedcallhangup = AST_FEATURE_FLAG_BYCALLEE;
      } else if (!strcasecmp(var->name, "parkedcallrecording")) {
         if (!strcasecmp(var->value, "both"))
            default_parkinglot->parkedcallrecording = AST_FEATURE_FLAG_BYBOTH;
         else if (!strcasecmp(var->value, "caller"))
            default_parkinglot->parkedcallrecording = AST_FEATURE_FLAG_BYCALLER;
         else if (!strcasecmp(var->value, "callee"))
            default_parkinglot->parkedcallrecording = AST_FEATURE_FLAG_BYCALLEE;
      } else if (!strcasecmp(var->name, "adsipark")) {
         adsipark = ast_true(var->value);
      } else if (!strcasecmp(var->name, "transferdigittimeout")) {
         if ((sscanf(var->value, "%30d", &transferdigittimeout) != 1) || (transferdigittimeout < 1)) {
            ast_log(LOG_WARNING, "%s is not a valid transferdigittimeout\n", var->value);
            transferdigittimeout = DEFAULT_TRANSFER_DIGIT_TIMEOUT;
         } else
            transferdigittimeout = transferdigittimeout * 1000;
      } else if (!strcasecmp(var->name, "featuredigittimeout")) {
         if ((sscanf(var->value, "%30d", &featuredigittimeout) != 1) || (featuredigittimeout < 1)) {
            ast_log(LOG_WARNING, "%s is not a valid featuredigittimeout\n", var->value);
            featuredigittimeout = DEFAULT_FEATURE_DIGIT_TIMEOUT;
         }
      } else if (!strcasecmp(var->name, "atxfernoanswertimeout")) {
         if ((sscanf(var->value, "%30d", &atxfernoanswertimeout) != 1) || (atxfernoanswertimeout < 1)) {
            ast_log(LOG_WARNING, "%s is not a valid atxfernoanswertimeout\n", var->value);
            atxfernoanswertimeout = DEFAULT_NOANSWER_TIMEOUT_ATTENDED_TRANSFER;
         } else
            atxfernoanswertimeout = atxfernoanswertimeout * 1000;
      } else if (!strcasecmp(var->name, "atxferloopdelay")) {
         if ((sscanf(var->value, "%30u", &atxferloopdelay) != 1)) {
            ast_log(LOG_WARNING, "%s is not a valid atxferloopdelay\n", var->value);
            atxferloopdelay = DEFAULT_ATXFER_LOOP_DELAY;
         } else 
            atxferloopdelay *= 1000;
      } else if (!strcasecmp(var->name, "atxferdropcall")) {
         atxferdropcall = ast_true(var->value);
      } else if (!strcasecmp(var->name, "atxfercallbackretries")) {
         if ((sscanf(var->value, "%30u", &atxferloopdelay) != 1)) {
            ast_log(LOG_WARNING, "%s is not a valid atxfercallbackretries\n", var->value);
            atxfercallbackretries = DEFAULT_ATXFER_CALLBACK_RETRIES;
         }
      } else if (!strcasecmp(var->name, "courtesytone")) {
         ast_copy_string(courtesytone, var->value, sizeof(courtesytone));
      }  else if (!strcasecmp(var->name, "parkedplay")) {
         if (!strcasecmp(var->value, "both"))
            parkedplay = 2;
         else if (!strcasecmp(var->value, "parked"))
            parkedplay = 1;
         else
            parkedplay = 0;
      } else if (!strcasecmp(var->name, "xfersound")) {
         ast_copy_string(xfersound, var->value, sizeof(xfersound));
      } else if (!strcasecmp(var->name, "xferfailsound")) {
         ast_copy_string(xferfailsound, var->value, sizeof(xferfailsound));
      } else if (!strcasecmp(var->name, "pickupexten")) {
         ast_copy_string(pickup_ext, var->value, sizeof(pickup_ext));
      } else if (!strcasecmp(var->name, "pickupsound")) {
         ast_copy_string(pickupsound, var->value, sizeof(pickupsound));
      } else if (!strcasecmp(var->name, "pickupfailsound")) {
         ast_copy_string(pickupfailsound, var->value, sizeof(pickupfailsound));
      } else if (!strcasecmp(var->name, "comebacktoorigin")) {
         comebacktoorigin = ast_true(var->value);
      } else if (!strcasecmp(var->name, "parkedmusicclass")) {
         ast_copy_string(default_parkinglot->mohclass, var->value, sizeof(default_parkinglot->mohclass));
      }
   }

   unmap_features();
   for (var = ast_variable_browse(cfg, "featuremap"); var; var = var->next) {
      if (remap_feature(var->name, var->value))
         ast_log(LOG_NOTICE, "Unknown feature '%s'\n", var->name);
   }

   /* Map a key combination to an application*/
   ast_unregister_features();
   for (var = ast_variable_browse(cfg, "applicationmap"); var; var = var->next) {
      char *tmp_val = ast_strdupa(var->value);
      char *exten, *activateon, *activatedby, *app, *app_args, *moh_class; 
      struct ast_call_feature *feature;

      /* strsep() sets the argument to NULL if match not found, and it
       * is safe to use it with a NULL argument, so we don't check
       * between calls.
       */
      exten = strsep(&tmp_val,",");
      activatedby = strsep(&tmp_val,",");
      app = strsep(&tmp_val,",");
      app_args = strsep(&tmp_val,",");
      moh_class = strsep(&tmp_val,",");

      activateon = strsep(&activatedby, "/");   

      /*! \todo XXX var_name or app_args ? */
      if (ast_strlen_zero(app) || ast_strlen_zero(exten) || ast_strlen_zero(activateon) || ast_strlen_zero(var->name)) {
         ast_log(LOG_NOTICE, "Please check the feature Mapping Syntax, either extension, name, or app aren't provided %s %s %s %s\n",
            app, exten, activateon, var->name);
         continue;
      }

      AST_RWLIST_RDLOCK(&feature_list);
      if ((feature = find_dynamic_feature(var->name))) {
         AST_RWLIST_UNLOCK(&feature_list);
         ast_log(LOG_WARNING, "Dynamic Feature '%s' specified more than once!\n", var->name);
         continue;
      }
      AST_RWLIST_UNLOCK(&feature_list);
            
      if (!(feature = ast_calloc(1, sizeof(*feature))))
         continue;               

      ast_copy_string(feature->sname, var->name, FEATURE_SNAME_LEN);
      ast_copy_string(feature->app, app, FEATURE_APP_LEN);
      ast_copy_string(feature->exten, exten, FEATURE_EXTEN_LEN);
      
      if (app_args) 
         ast_copy_string(feature->app_args, app_args, FEATURE_APP_ARGS_LEN);

      if (moh_class)
         ast_copy_string(feature->moh_class, moh_class, FEATURE_MOH_LEN);
         
      ast_copy_string(feature->exten, exten, sizeof(feature->exten));
      feature->operation = feature_exec_app;
      ast_set_flag(feature, AST_FEATURE_FLAG_NEEDSDTMF);

      /* Allow caller and calle to be specified for backwards compatability */
      if (!strcasecmp(activateon, "self") || !strcasecmp(activateon, "caller"))
         ast_set_flag(feature, AST_FEATURE_FLAG_ONSELF);
      else if (!strcasecmp(activateon, "peer") || !strcasecmp(activateon, "callee"))
         ast_set_flag(feature, AST_FEATURE_FLAG_ONPEER);
      else {
         ast_log(LOG_NOTICE, "Invalid 'ActivateOn' specification for feature '%s',"
            " must be 'self', or 'peer'\n", var->name);
         continue;
      }

      if (ast_strlen_zero(activatedby))
         ast_set_flag(feature, AST_FEATURE_FLAG_BYBOTH);
      else if (!strcasecmp(activatedby, "caller"))
         ast_set_flag(feature, AST_FEATURE_FLAG_BYCALLER);
      else if (!strcasecmp(activatedby, "callee"))
         ast_set_flag(feature, AST_FEATURE_FLAG_BYCALLEE);
      else if (!strcasecmp(activatedby, "both"))
         ast_set_flag(feature, AST_FEATURE_FLAG_BYBOTH);
      else {
         ast_log(LOG_NOTICE, "Invalid 'ActivatedBy' specification for feature '%s',"
            " must be 'caller', or 'callee', or 'both'\n", var->name);
         continue;
      }

      ast_register_feature(feature);
         
      ast_verb(2, "Mapping Feature '%s' to app '%s(%s)' with code '%s'\n", var->name, app, app_args, exten);
   }

   ast_unregister_groups();
   AST_RWLIST_WRLOCK(&feature_groups);

   ctg = NULL;
   while ((ctg = ast_category_browse(cfg, ctg))) {
      /* Is this a parkinglot definition ? */
      if (!strncasecmp(ctg, "parkinglot_", strlen("parkinglot_"))) {
         ast_debug(2, "Found configuration section %s, assume parking context\n", ctg);
         if(!build_parkinglot(ctg, ast_variable_browse(cfg, ctg)))
            ast_log(LOG_ERROR, "Could not build parking lot %s. Configuration error.\n", ctg);
         else
            ast_debug(1, "Configured parking context %s\n", ctg);
         continue;   
      }
      /* No, check if it's a group */
      for (i = 0; i < ARRAY_LEN(categories); i++) {
         if (!strcasecmp(categories[i], ctg))
            break;
      }

      if (i < ARRAY_LEN(categories)) 
         continue;

      if (!(fg = register_group(ctg)))
         continue;

      for (var = ast_variable_browse(cfg, ctg); var; var = var->next) {
         struct ast_call_feature *feature;

         AST_RWLIST_RDLOCK(&feature_list);
         if (!(feature = find_dynamic_feature(var->name)) && 
             !(feature = ast_find_call_feature(var->name))) {
            AST_RWLIST_UNLOCK(&feature_list);
            ast_log(LOG_WARNING, "Feature '%s' was not found.\n", var->name);
            continue;
         }
         AST_RWLIST_UNLOCK(&feature_list);

         register_group_feature(fg, var->value, feature);
      }
   }

   AST_RWLIST_UNLOCK(&feature_groups);

   ast_config_destroy(cfg);

   /* Remove the old parking extension */
   if (!ast_strlen_zero(old_parking_con) && (con = ast_context_find(old_parking_con))) {
      if(ast_context_remove_extension2(con, old_parking_ext, 1, registrar, 0))
            notify_metermaids(old_parking_ext, old_parking_con, AST_DEVICE_NOT_INUSE);
      ast_debug(1, "Removed old parking extension %s@%s\n", old_parking_ext, old_parking_con);
   }
   
   if (!(con = ast_context_find_or_create(NULL, NULL, default_parkinglot->parking_con, registrar))) {
      ast_log(LOG_ERROR, "Parking context '%s' does not exist and unable to create\n", default_parkinglot->parking_con);
      return -1;
   }
   res = ast_add_extension2(con, 1, ast_parking_ext(), 1, NULL, NULL, parkcall, NULL, NULL, registrar);
   if (default_parkinglot->parkaddhints)
      park_add_hints(default_parkinglot->parking_con, default_parkinglot->parking_start, default_parkinglot->parking_stop);
   if (!res)
      notify_metermaids(ast_parking_ext(), default_parkinglot->parking_con, AST_DEVICE_INUSE);
   return res;

}

int manage_parkinglot	(	struct ast_parkinglot *	curlot,
		fd_set *	rfds,
		fd_set *	efds,
		fd_set *	nrfds,
		fd_set *	nefds,
		int *	fs,
		int *	max
	)

Run management on parkinglots, called once per parkinglot.

Definition at line 3274 of file features.c.

References ast_add_extension2(), AST_CEL_PARK_END, ast_cel_report_event(), ast_channel_datastore_find(), ast_channel_lock, ast_channel_unlock, ast_clear_flag, ast_context_find(), ast_context_find_or_create(), ast_context_remove_extension2(), AST_CONTROL_HANGUP, AST_CONTROL_HOLD, AST_CONTROL_UNHOLD, ast_copy_string(), ast_debug, AST_DEVICE_NOT_INUSE, AST_FLAG_EXCEPTION, AST_FRAME_CONTROL, ast_free_ptr, ast_frfree, ast_hangup(), ast_indicate(), ast_indicate_data(), AST_LIST_LOCK, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_LIST_UNLOCK, ast_log(), AST_MAX_FDS, ast_pbx_start(), ast_read(), ast_set_flag, ast_strdup, ast_strdupa, ast_strlen_zero(), ast_tvdiff_ms(), ast_tvnow(), ast_verb, buf, callback_dialoptions(), parkeduser::chan, comebacktoorigin, ast_channel::context, parkeduser::context, ast_datastore::data, ast_channel::exten, parkeduser::exten, f, ast_channel::fdno, ast_channel::fds, ast_dial_features::features_callee, ast_dial_features::features_caller, ast_frame::frametype, free, ast_channel::generatordata, LOG_ERROR, LOG_WARNING, MAX_DIAL_FEATURE_OPTIONS, parkeduser::moh_trys, ast_parkinglot::mohclass, ast_parkinglot::name, ast_channel::name, notify_metermaids(), parkeduser::notquiteyet, parkeduser::options_specified, ast_parkinglot::parking_con, ast_parkinglot::parking_con_dial, parkeduser::parkingexten, parkeduser::parkinglot, parkeduser::parkingnum, ast_parkinglot::parkings, parkeduser::parkingtime, pbx_builtin_setvar_helper(), parkeduser::peername, post_manager_event(), ast_channel::priority, parkeduser::priority, registrar, S_OR, set_c_e_p(), parkeduser::start, and ast_frame::subclass.

Referenced by do_parking_thread().

{

   struct parkeduser *pu;
   int res = 0;
   char parkingslot[AST_MAX_EXTENSION];

   /* Lock parking list */
   AST_LIST_LOCK(&curlot->parkings);
   AST_LIST_TRAVERSE_SAFE_BEGIN(&curlot->parkings, pu, list) {
      struct ast_channel *chan = pu->chan;   /* shorthand */
      int tms;        /* timeout for this item */
      int x;          /* fd index in channel */
      struct ast_context *con;

      if (pu->notquiteyet) { /* Pretend this one isn't here yet */
         continue;
      }
      tms = ast_tvdiff_ms(ast_tvnow(), pu->start);
      if (tms > pu->parkingtime) {
         /* Stop music on hold */
         ast_indicate(pu->chan, AST_CONTROL_UNHOLD);
         /* Get chan, exten from derived kludge */
         if (pu->peername[0]) {
            char *peername = ast_strdupa(pu->peername);
            char *cp = strrchr(peername, '-');
            char peername_flat[AST_MAX_EXTENSION]; /* using something like DAHDI/52 for an extension name is NOT a good idea */
            int i;

            if (cp) 
               *cp = 0;
            ast_copy_string(peername_flat,peername,sizeof(peername_flat));
            for(i=0; peername_flat[i] && i < AST_MAX_EXTENSION; i++) {
               if (peername_flat[i] == '/') 
                  peername_flat[i]= '0';
            }
            con = ast_context_find_or_create(NULL, NULL, pu->parkinglot->parking_con_dial, registrar);
            if (!con) {
               ast_log(LOG_ERROR, "Parking dial context '%s' does not exist and unable to create\n", pu->parkinglot->parking_con_dial);
            }
            if (con) {
               char returnexten[AST_MAX_EXTENSION];
               struct ast_datastore *features_datastore;
               struct ast_dial_features *dialfeatures = NULL;

               ast_channel_lock(chan);

               if ((features_datastore = ast_channel_datastore_find(chan, &dial_features_info, NULL)))
                  dialfeatures = features_datastore->data;

               ast_channel_unlock(chan);

               if (!strncmp(peername, "Parked/", 7)) {
                  peername += 7;
               }

               if (dialfeatures) {
                  char buf[MAX_DIAL_FEATURE_OPTIONS] = {0,};
                  snprintf(returnexten, sizeof(returnexten), "%s,30,%s", peername, callback_dialoptions(&(dialfeatures->features_callee), &(dialfeatures->features_caller), buf, sizeof(buf)));
               } else { /* Existing default */
                  ast_log(LOG_WARNING, "Dialfeatures not found on %s, using default!\n", chan->name);
                  snprintf(returnexten, sizeof(returnexten), "%s,30,t", peername);
               }

               ast_add_extension2(con, 1, peername_flat, 1, NULL, NULL, "Dial", ast_strdup(returnexten), ast_free_ptr, registrar);
            }
            if (pu->options_specified == 1) {
               /* Park() was called with overriding return arguments, respect those arguments */
               set_c_e_p(chan, pu->context, pu->exten, pu->priority);
            } else {
               if (comebacktoorigin) {
                  set_c_e_p(chan, pu->parkinglot->parking_con_dial, peername_flat, 1);
               } else {
                  ast_log(LOG_WARNING, "now going to parkedcallstimeout,s,1 | ps is %d\n",pu->parkingnum);
                  snprintf(parkingslot, sizeof(parkingslot), "%d", pu->parkingnum);
                  pbx_builtin_setvar_helper(chan, "PARKINGSLOT", parkingslot);
                  set_c_e_p(chan, "parkedcallstimeout", peername_flat, 1);
               }
            }
         } else {
            /* They've been waiting too long, send them back to where they came.  Theoretically they
               should have their original extensions and such, but we copy to be on the safe side */
            set_c_e_p(chan, pu->context, pu->exten, pu->priority);
         }
         post_manager_event("ParkedCallTimeOut", pu);
         ast_cel_report_event(pu->chan, AST_CEL_PARK_END, NULL, "ParkedCallTimeOut", NULL);

         ast_verb(2, "Timeout for %s parked on %d (%s). Returning to %s,%s,%d\n", pu->chan->name, pu->parkingnum, pu->parkinglot->name, pu->chan->context, pu->chan->exten, pu->chan->priority);
         /* Start up the PBX, or hang them up */
         if (ast_pbx_start(chan))  {
            ast_log(LOG_WARNING, "Unable to restart the PBX for user on '%s', hanging them up...\n", pu->chan->name);
            ast_hangup(chan);
         }
         /* And take them out of the parking lot */
         con = ast_context_find(pu->parkinglot->parking_con);
         if (con) {
            if (ast_context_remove_extension2(con, pu->parkingexten, 1, NULL, 0))
               ast_log(LOG_WARNING, "Whoa, failed to remove the parking extension!\n");
            else
               notify_metermaids(pu->parkingexten, curlot->parking_con, AST_DEVICE_NOT_INUSE);
         } else
            ast_log(LOG_WARNING, "Whoa, no parking context?\n");
         AST_LIST_REMOVE_CURRENT(list);
         free(pu);
      } else { /* still within parking time, process descriptors */
         for (x = 0; x < AST_MAX_FDS; x++) {
            struct ast_frame *f;

            if ((chan->fds[x] == -1) || (!FD_ISSET(chan->fds[x], rfds) && !FD_ISSET(pu->chan->fds[x], efds))) 
               continue;
            
            if (FD_ISSET(chan->fds[x], efds))
               ast_set_flag(chan, AST_FLAG_EXCEPTION);
            else
               ast_clear_flag(chan, AST_FLAG_EXCEPTION);
            chan->fdno = x;

            /* See if they need servicing */
            f = ast_read(pu->chan);
            /* Hangup? */
            if (!f || ((f->frametype == AST_FRAME_CONTROL) && (f->subclass ==  AST_CONTROL_HANGUP))) {
               if (f)
                  ast_frfree(f);
               post_manager_event("ParkedCallGiveUp", pu);
               ast_cel_report_event(pu->chan, AST_CEL_PARK_END, NULL, "ParkedCallGiveUp", NULL);

               /* There's a problem, hang them up*/
               ast_verb(2, "%s got tired of being parked\n", chan->name);
               ast_hangup(chan);
               /* And take them out of the parking lot */
               con = ast_context_find(curlot->parking_con);
               if (con) {
                  if (ast_context_remove_extension2(con, pu->parkingexten, 1, NULL, 0))
                     ast_log(LOG_WARNING, "Whoa, failed to remove the extension!\n");
                  else
                     notify_metermaids(pu->parkingexten, curlot->parking_con, AST_DEVICE_NOT_INUSE);
               } else
                  ast_log(LOG_WARNING, "Whoa, no parking context for parking lot %s?\n", curlot->name);
               AST_LIST_REMOVE_CURRENT(list);
               free(pu);
               break;
            } else {
               /* XXX Maybe we could do something with packets, like dial "0" for operator or something XXX */
               ast_frfree(f);
               if (pu->moh_trys < 3 && !chan->generatordata) {
                  ast_debug(1, "MOH on parked call stopped by outside source.  Restarting on channel %s.\n", chan->name);
                  ast_indicate_data(chan, AST_CONTROL_HOLD, 
                     S_OR(curlot->mohclass, NULL),
                     (!ast_strlen_zero(curlot->mohclass) ? strlen(curlot->mohclass) + 1 : 0));
                  pu->moh_trys++;
               }
               goto std;   /* XXX Ick: jumping into an else statement??? XXX */
            }
         } /* End for */
         if (x >= AST_MAX_FDS) {
std:           for (x=0; x<AST_MAX_FDS; x++) {  /* mark fds for next round */
               if (chan->fds[x] > -1) {
                  FD_SET(chan->fds[x], nrfds);
                  FD_SET(chan->fds[x], nefds);
                  if (chan->fds[x] > *max)
                     *max = chan->fds[x];
               }
            }
            /* Keep track of our shortest wait */
            if (tms < *ms || *ms < 0)
               *ms = tms;
         }
      }
   }
   AST_LIST_TRAVERSE_SAFE_END;
   AST_LIST_UNLOCK(&curlot->parkings);
   return res;
}

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

Create manager event for parked calls.

Parameters:

	s
	m	Get channels involved in park, create event.

Returns:

Always 0

Definition at line 4649 of file features.c.

References ast_channel_get_by_name(), ast_channel_lock, ast_channel_trylock, ast_channel_unlock, ast_channel_unref, ast_masq_park_call(), ast_softhangup(), AST_SOFTHANGUP_EXPLICIT, ast_strlen_zero(), astman_get_header(), astman_send_ack(), astman_send_error(), buf, and CHANNEL_DEADLOCK_AVOIDANCE.

Referenced by ast_features_init().

{
   const char *channel = astman_get_header(m, "Channel");
   const char *channel2 = astman_get_header(m, "Channel2");
   const char *timeout = astman_get_header(m, "Timeout");
   char buf[BUFSIZ];
   int to = 0;
   int res = 0;
   int parkExt = 0;
   struct ast_channel *ch1, *ch2;

   if (ast_strlen_zero(channel)) {
      astman_send_error(s, m, "Channel not specified");
      return 0;
   }

   if (ast_strlen_zero(channel2)) {
      astman_send_error(s, m, "Channel2 not specified");
      return 0;
   }

   if (!(ch1 = ast_channel_get_by_name(channel))) {
      snprintf(buf, sizeof(buf), "Channel does not exist: %s", channel);
      astman_send_error(s, m, buf);
      return 0;
   }

   if (!(ch2 = ast_channel_get_by_name(channel2))) {
      snprintf(buf, sizeof(buf), "Channel does not exist: %s", channel2);
      astman_send_error(s, m, buf);
      ast_channel_unref(ch1);
      return 0;
   }

   ast_channel_lock(ch1);
   while (ast_channel_trylock(ch2)) {
      CHANNEL_DEADLOCK_AVOIDANCE(ch1);
   }

   if (!ast_strlen_zero(timeout)) {
      sscanf(timeout, "%30d", &to);
   }

   res = ast_masq_park_call(ch1, ch2, to, &parkExt);
   if (!res) {
      ast_softhangup(ch2, AST_SOFTHANGUP_EXPLICIT);
      astman_send_ack(s, m, "Park successful");
   } else {
      astman_send_error(s, m, "Park failure");
   }

   ast_channel_unlock(ch1);
   ast_channel_unlock(ch2);

   ch1 = ast_channel_unref(ch1);
   ch2 = ast_channel_unref(ch2);

   return 0;
}

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

Dump parking lot status.

Parameters:

	s
	m	Lock parking lot, iterate list and append parked calls status, unlock parking lot.

Returns:

Always RESULT_SUCCESS

Definition at line 4595 of file features.c.

References ao2_iterator_init(), ao2_iterator_next, ao2_ref, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_strlen_zero(), astman_append(), astman_get_header(), astman_send_ack(), parkeduser::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, ast_channel::name, parkinglots, parkeduser::parkingnum, ast_parkinglot::parkings, parkeduser::parkingtime, parkeduser::peername, RESULT_SUCCESS, S_OR, and parkeduser::start.

Referenced by ast_features_init().

{
   struct parkeduser *cur;
   const char *id = astman_get_header(m, "ActionID");
   char idText[256] = "";
   struct ao2_iterator iter;
   struct ast_parkinglot *curlot;

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

   astman_send_ack(s, m, "Parked calls will follow");

   iter = ao2_iterator_init(parkinglots, 0);
   while ((curlot = ao2_iterator_next(&iter))) {

      AST_LIST_LOCK(&curlot->parkings);
      AST_LIST_TRAVERSE(&curlot->parkings, cur, list) {
         astman_append(s, "Event: ParkedCall\r\n"
            "Exten: %d\r\n"
            "Channel: %s\r\n"
            "From: %s\r\n"
            "Timeout: %ld\r\n"
            "CallerIDNum: %s\r\n"
            "CallerIDName: %s\r\n"
            "%s"
            "\r\n",
            cur->parkingnum, cur->chan->name, cur->peername,
            (long) cur->start.tv_sec + (long) (cur->parkingtime / 1000) - (long) time(NULL),
            S_OR(cur->chan->cid.cid_num, ""),   /* XXX in other places it is <unknown> */
            S_OR(cur->chan->cid.cid_name, ""),
            idText);
      }
      AST_LIST_UNLOCK(&curlot->parkings);
      ao2_ref(curlot, -1);
   }

   astman_append(s,
      "Event: ParkedCallsComplete\r\n"
      "%s"
      "\r\n",idText);


   return RESULT_SUCCESS;
}

static int masq_park_call	(	struct ast_channel *	rchan,
		struct ast_channel *	peer,
		int	timeout,
		int *	extout,
		int	play_announcement,
		struct ast_park_call_args *	args
	)			[static]

Definition at line 954 of file features.c.

References ast_channel::accountcode, ast_channel::amaflags, ast_channel_alloc, ast_channel_masquerade(), AST_FEATURE_RETURN_PARKFAILED, ast_frfree, ast_hangup(), ast_log(), ast_read(), AST_STATE_DOWN, ast_strdupa, ast_stream_and_wait(), ast_channel::context, ast_channel::exten, ast_park_call_args::extout, f, ast_channel::linkedid, LOG_WARNING, ast_channel::name, ast_park_call_args::orig_chan_name, park_call_full(), park_space_reserve(), ast_channel::priority, ast_park_call_args::pu, ast_channel::readformat, set_c_e_p(), ast_park_call_args::timeout, and ast_channel::writeformat.

Referenced by ast_masq_park_call(), masq_park_call_announce(), and masq_park_call_announce_args().

{
   struct ast_channel *chan;
   struct ast_frame *f;
   int park_status;
   struct ast_park_call_args park_args = {0,};

   if (!args) {
      args = &park_args;
      args->timeout = timeout;
      args->extout = extout;
   }

   if ((args->pu = park_space_reserve(rchan, peer, args)) == NULL) {
      if (peer)
         ast_stream_and_wait(peer, "beeperr", "");
      return AST_FEATURE_RETURN_PARKFAILED;
   }

   /* Make a new, fake channel that we'll use to masquerade in the real one */
   if (!(chan = ast_channel_alloc(0, AST_STATE_DOWN, 0, 0, rchan->accountcode, rchan->exten, rchan->context, rchan->linkedid, rchan->amaflags, "Parked/%s",rchan->name))) {
      ast_log(LOG_WARNING, "Unable to create parked channel\n");
      return -1;
   }

   /* Make formats okay */
   chan->readformat = rchan->readformat;
   chan->writeformat = rchan->writeformat;
   ast_channel_masquerade(chan, rchan);

   /* Setup the extensions and such */
   set_c_e_p(chan, rchan->context, rchan->exten, rchan->priority);

   /* Make the masq execute */
   if ((f = ast_read(chan)))
      ast_frfree(f);

   if (peer == rchan) {
      peer = chan;
   }

   if (!play_announcement && args == &park_args) {
      args->orig_chan_name = ast_strdupa(chan->name);
   }

   park_status = park_call_full(chan, peer, args);
   if (park_status == 1) {
   /* would be nice to play "invalid parking extension" */
      ast_hangup(chan);
      return -1;
   }

   return 0;
}

static int masq_park_call_announce	(	struct ast_channel *	rchan,
		struct ast_channel *	peer,
		int	timeout,
		int *	extout
	)			[static]

Definition at line 1020 of file features.c.

References masq_park_call().

Referenced by builtin_blindtransfer(), and builtin_parkcall().

{
   return masq_park_call(rchan, peer, timeout, extout, 1, NULL);
}

static int masq_park_call_announce_args	(	struct ast_channel *	rchan,
		struct ast_channel *	peer,
		struct ast_park_call_args *	args
	)			[static]

Definition at line 1015 of file features.c.

References masq_park_call().

Referenced by park_call_exec().

{
   return masq_park_call(rchan, peer, 0, NULL, 1, args);
}

static enum ast_device_state metermaidstate

(

const char *

data

)

[static]

metermaids callback from devicestate.c

Definition at line 635 of file features.c.

References ast_debug, AST_DEVICE_INUSE, AST_DEVICE_INVALID, AST_DEVICE_NOT_INUSE, ast_exists_extension(), ast_strdupa, and strsep().

Referenced by ast_features_init().

{
   char *context;
   char *exten;

   context = ast_strdupa(data);

   exten = strsep(&context, "@");
   if (!context)
      return AST_DEVICE_INVALID;
   
   ast_debug(4, "Checking state of exten %s in context %s\n", exten, context);

   if (!ast_exists_extension(NULL, context, exten, 1, NULL))
      return AST_DEVICE_NOT_INUSE;

   return AST_DEVICE_INUSE;
}

static void notify_metermaids	(	const char *	exten,
		char *	context,
		enum ast_device_state	state
	)			[static]

Notify metermaids that we've changed an extension.

Definition at line 626 of file features.c.

References ast_debug, ast_devstate2str(), and ast_devstate_changed().

Referenced by load_config(), manage_parkinglot(), park_call_full(), and park_exec_full().

{
   ast_debug(4, "Notification of state change to metermaids %s@%s\n to state '%s'", 
      exten, context, ast_devstate2str(state));

   ast_devstate_changed(state, "park:%s@%s", exten, context);
}

static void park_add_hints	(	char *	context,
		int	start,
		int	stop
	)			[static]

Add parking hints for all defined parking lots.

Parameters:

	context
	start	starting parkinglot number
	stop	ending parkinglot number

Definition at line 3923 of file features.c.

References ast_add_extension(), PRIORITY_HINT, and registrar.

Referenced by load_config().

{
   int numext;
   char device[AST_MAX_EXTENSION];
   char exten[10];

   for (numext = start; numext <= stop; numext++) {
      snprintf(exten, sizeof(exten), "%d", numext);
      snprintf(device, sizeof(device), "park:%s@%s", exten, context);
      ast_add_extension(context, 1, exten, PRIORITY_HINT, NULL, NULL, device, NULL, NULL, registrar);
   }
}

static int park_call_exec	(	struct ast_channel *	chan,
		const char *	data
	)			[static]

Park a call.

Definition at line 3516 of file features.c.

References ast_channel::_state, ast_answer(), AST_APP_ARG, ast_app_parse_options(), ast_copy_string(), AST_DECLARE_APP_ARGS, ast_log(), ast_safe_sleep(), AST_STANDARD_APP_ARGS, AST_STATE_UP, ast_strdupa, ast_strlen_zero(), ast_channel::exten, ast_flags::flags, ast_park_call_args::flags, LOG_WARNING, masq_park_call_announce_args(), ast_channel::name, ast_park_call_args::orig_chan_name, orig_exten(), park_call_options, parse(), ast_channel::priority, ast_park_call_args::return_con, ast_park_call_args::return_ext, ast_park_call_args::return_pri, and ast_park_call_args::timeout.

Referenced by ast_features_init().

{
   /* Cache the original channel name in case we get masqueraded in the middle
    * of a park--it is still theoretically possible for a transfer to happen before
    * we get here, but it is _really_ unlikely */
   char *orig_chan_name = ast_strdupa(chan->name);
   char orig_exten[AST_MAX_EXTENSION];
   int orig_priority = chan->priority;

   /* Data is unused at the moment but could contain a parking
      lot context eventually */
   int res = 0;

   char *parse = NULL;
   AST_DECLARE_APP_ARGS(app_args,
      AST_APP_ARG(timeout);
      AST_APP_ARG(return_con);
      AST_APP_ARG(return_ext);
      AST_APP_ARG(return_pri);
      AST_APP_ARG(options);
   );

   parse = ast_strdupa(data);
   AST_STANDARD_APP_ARGS(app_args, parse);

   ast_copy_string(orig_exten, chan->exten, sizeof(orig_exten));

   /* Setup the exten/priority to be s/1 since we don't know
      where this call should return */
   strcpy(chan->exten, "s");
   chan->priority = 1;

   /* Answer if call is not up */
   if (chan->_state != AST_STATE_UP)
      res = ast_answer(chan);

   /* Sleep to allow VoIP streams to settle down */
   if (!res)
      res = ast_safe_sleep(chan, 1000);

   /* Park the call */
   if (!res) {
      struct ast_park_call_args args = {
         .orig_chan_name = orig_chan_name,
      };
      struct ast_flags flags = { 0 };

      if (parse) {
         if (!ast_strlen_zero(app_args.timeout)) {
            if (sscanf(app_args.timeout, "%30d", &args.timeout) != 1) {
               ast_log(LOG_WARNING, "Invalid timeout '%s' provided\n", app_args.timeout);
               args.timeout = 0;
            }
         }
         if (!ast_strlen_zero(app_args.return_con)) {
            args.return_con = app_args.return_con;
         }
         if (!ast_strlen_zero(app_args.return_ext)) {
            args.return_ext = app_args.return_ext;
         }
         if (!ast_strlen_zero(app_args.return_pri)) {
            if (sscanf(app_args.return_pri, "%30d", &args.return_pri) != 1) {
               ast_log(LOG_WARNING, "Invalid priority '%s' specified\n", app_args.return_pri);
               args.return_pri = 0;
            }
         }
      }

      ast_app_parse_options(park_call_options, &flags, NULL, app_args.options);
      args.flags = flags.flags;

      res = masq_park_call_announce_args(chan, chan, &args);
      /* Continue on in the dialplan */
      if (res == 1) {
         ast_copy_string(chan->exten, orig_exten, sizeof(chan->exten));
         chan->priority = orig_priority;
         res = 0;
      } else if (!res) {
         res = 1;
      }
   }

   return res;
}

static int park_call_full	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_park_call_args *	args
	)			[static]

Definition at line 795 of file features.c.

References adsi_announce_park(), adsipark, ast_channel::appl, ast_add_extension2(), ast_adsi_available, ast_adsi_unload_session, ast_bridged_channel(), AST_CEL_PARK_START, ast_cel_report_event(), ast_channel_get_by_name(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_unlock, ast_channel_unref, ast_clear_flag, ast_context_find_or_create(), AST_CONTROL_HOLD, AST_CONTROL_RINGING, ast_copy_string(), AST_DEVICE_INUSE, AST_FLAG_MASQ_NOSTREAM, ast_free_ptr, ast_indicate(), ast_indicate_data(), AST_LIST_UNLOCK, ast_log(), AST_PARK_OPT_RINGING, AST_PARK_OPT_SILENCE, ast_say_digits(), ast_set_flag, ast_strdup, ast_strlen_zero(), ast_test_flag, ast_tvnow(), ast_verb, parkeduser::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, ast_channel::context, parkeduser::context, ast_channel::data, EVENT_FLAG_CALL, ast_channel::exten, parkeduser::exten, ast_park_call_args::extout, ast_channel::language, LOG_ERROR, ast_channel::macrocontext, ast_channel::macroexten, ast_channel::macropriority, manager_event, ast_parkinglot::mohclass, ast_parkinglot::name, ast_channel::name, notify_metermaids(), parkeduser::notquiteyet, parkeduser::options_specified, ast_park_call_args::orig_chan_name, park_space_reserve(), parkedcall, ast_parkinglot::parking_con, parking_thread, parkeduser::parkingexten, parkeduser::parkinglot, parkeduser::parkingnum, ast_parkinglot::parkings, ast_parkinglot::parkingtime, parkeduser::parkingtime, pbx_builtin_getvar_helper(), parkeduser::peername, ast_channel::priority, parkeduser::priority, ast_park_call_args::pu, registrar, ast_park_call_args::return_con, ast_park_call_args::return_ext, ast_park_call_args::return_pri, S_OR, parkeduser::start, ast_channel::tech, ast_park_call_args::timeout, ast_channel_tech::type, and ast_channel::uniqueid.

Referenced by ast_park_call(), and masq_park_call().

{
   struct ast_context *con;
   int parkingnum_copy;
   struct parkeduser *pu = args->pu;
   const char *event_from;

   if (pu == NULL)
      pu = park_space_reserve(chan, peer, args);
   if (pu == NULL)
      return 1; /* Continue execution if possible */

   snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", pu->parkingnum);
   
   chan->appl = "Parked Call";
   chan->data = NULL; 

   pu->chan = chan;
   
   /* Put the parked channel on hold if we have two different channels */
   if (chan != peer) {
      if (ast_test_flag(args, AST_PARK_OPT_RINGING)) {
         ast_indicate(pu->chan, AST_CONTROL_RINGING);
      } else {
         ast_indicate_data(pu->chan, AST_CONTROL_HOLD, 
            S_OR(pu->parkinglot->mohclass, NULL),
            !ast_strlen_zero(pu->parkinglot->mohclass) ? strlen(pu->parkinglot->mohclass) + 1 : 0);
      }
   }
   
   pu->start = ast_tvnow();
   pu->parkingtime = (args->timeout > 0) ? args->timeout : pu->parkinglot->parkingtime;
   parkingnum_copy = pu->parkingnum;
   if (args->extout)
      *(args->extout) = pu->parkingnum;

   if (peer) { 
      /* This is so ugly that it hurts, but implementing get_base_channel() on local channels
         could have ugly side effects.  We could have transferer<->local,1<->local,2<->parking
         and we need the callback name to be that of transferer.  Since local,1/2 have the same
         name we can be tricky and just grab the bridged channel from the other side of the local
      */
      if (!strcasecmp(peer->tech->type, "Local")) {
         struct ast_channel *tmpchan, *base_peer;
         char other_side[AST_CHANNEL_NAME];
         char *c;
         ast_copy_string(other_side, S_OR(args->orig_chan_name, peer->name), sizeof(other_side));
         if ((c = strrchr(other_side, ';'))) {
            *++c = '1';
         }
         if ((tmpchan = ast_channel_get_by_name(other_side))) {
            ast_channel_lock(tmpchan);
            if ((base_peer = ast_bridged_channel(tmpchan))) {
               ast_copy_string(pu->peername, base_peer->name, sizeof(pu->peername));
            }
            ast_channel_unlock(tmpchan);
            tmpchan = ast_channel_unref(tmpchan);
         }
      } else {
         ast_copy_string(pu->peername, S_OR(args->orig_chan_name, peer->name), sizeof(pu->peername));
      }
   }

   /* Remember what had been dialed, so that if the parking
      expires, we try to come back to the same place */

   pu->options_specified = (!ast_strlen_zero(args->return_con) || !ast_strlen_zero(args->return_ext) || args->return_pri);

   /* If extension has options specified, they override all other possibilities
   such as the returntoorigin flag and transferred context. Information on
   extension options is lost here, so we set a flag */

   ast_copy_string(pu->context, 
      S_OR(args->return_con, S_OR(chan->macrocontext, chan->context)), 
      sizeof(pu->context));
   ast_copy_string(pu->exten, 
      S_OR(args->return_ext, S_OR(chan->macroexten, chan->exten)), 
      sizeof(pu->exten));
   pu->priority = args->return_pri ? args->return_pri : 
      (chan->macropriority ? chan->macropriority : chan->priority);

   /* If parking a channel directly, don't quiet yet get parking running on it.
    * All parking lot entries are put into the parking lot with notquiteyet on. */
   if (peer != chan) 
      pu->notquiteyet = 0;

   /* Wake up the (presumably select()ing) thread */
   pthread_kill(parking_thread, SIGURG);
   ast_verb(2, "Parked %s on %d (lot %s). Will timeout back to extension [%s] %s, %d in %d seconds\n", pu->chan->name, pu->parkingnum, pu->parkinglot->name, pu->context, pu->exten, pu->priority, (pu->parkingtime/1000));

   ast_cel_report_event(pu->chan, AST_CEL_PARK_START, NULL, pu->parkinglot->name, peer);

   if (peer) {
      event_from = peer->name;
   } else {
      event_from = pbx_builtin_getvar_helper(chan, "BLINDTRANSFER");
   }

   manager_event(EVENT_FLAG_CALL, "ParkedCall",
      "Exten: %s\r\n"
      "Channel: %s\r\n"
      "Parkinglot: %s\r\n"
      "From: %s\r\n"
      "Timeout: %ld\r\n"
      "CallerIDNum: %s\r\n"
      "CallerIDName: %s\r\n"
      "Uniqueid: %s\r\n",
      pu->parkingexten, pu->chan->name, pu->parkinglot->name, event_from ? event_from : "",
      (long)pu->start.tv_sec + (long)(pu->parkingtime/1000) - (long)time(NULL),
      S_OR(pu->chan->cid.cid_num, "<unknown>"),
      S_OR(pu->chan->cid.cid_name, "<unknown>"),
      pu->chan->uniqueid
      );

   if (peer && adsipark && ast_adsi_available(peer)) {
      adsi_announce_park(peer, pu->parkingexten);  /* Only supports parking numbers */
      ast_adsi_unload_session(peer);
   }

   con = ast_context_find_or_create(NULL, NULL, pu->parkinglot->parking_con, registrar);
   if (!con)   /* Still no context? Bad */
      ast_log(LOG_ERROR, "Parking context '%s' does not exist and unable to create\n", pu->parkinglot->parking_con);
   if (con) {
      if (!ast_add_extension2(con, 1, pu->parkingexten, 1, NULL, NULL, parkedcall, ast_strdup(pu->parkingexten), ast_free_ptr, registrar))
         notify_metermaids(pu->parkingexten, pu->parkinglot->parking_con, AST_DEVICE_INUSE);
   }

   AST_LIST_UNLOCK(&pu->parkinglot->parkings);

   /* Only say number if it's a number and the channel hasn't been masqueraded away */
   if (peer && !ast_test_flag(args, AST_PARK_OPT_SILENCE) && (ast_strlen_zero(args->orig_chan_name) || !strcasecmp(peer->name, args->orig_chan_name))) {
      /* If a channel is masqueraded into peer while playing back the parking slot number do not continue playing it back. This is the case if an attended transfer occurs. */
      ast_set_flag(peer, AST_FLAG_MASQ_NOSTREAM);
      /* Tell the peer channel the number of the parking space */
      ast_say_digits(peer, pu->parkingnum, "", peer->language);
      ast_clear_flag(peer, AST_FLAG_MASQ_NOSTREAM);
   }
   if (peer == chan) { /* pu->notquiteyet = 1 */
      /* Wake up parking thread if we're really done */
      ast_indicate_data(pu->chan, AST_CONTROL_HOLD, 
         S_OR(pu->parkinglot->mohclass, NULL),
         !ast_strlen_zero(pu->parkinglot->mohclass) ? strlen(pu->parkinglot->mohclass) + 1 : 0);
      pu->notquiteyet = 0;
      pthread_kill(parking_thread, SIGURG);
   }
   return 0;
}

static int park_exec	(	struct ast_channel *	chan,
		const char *	data
	)			[static]

Definition at line 3766 of file features.c.

References default_parkinglot, and park_exec_full().

Referenced by ast_features_init().

{
   return park_exec_full(chan, data, default_parkinglot);
}

static int park_exec_full	(	struct ast_channel *	chan,
		const char *	data,
		struct ast_parkinglot *	parkinglot
	)			[static]

Pickup parked call.

Todo:

XXX we would like to wait on both!

Todo:

XXX Play a message XXX

Definition at line 3602 of file features.c.

References ast_channel::_state, ast_answer(), ast_bridge_call(), ast_cdr_setdestchan(), AST_CEL_PARK_END, ast_cel_report_event(), ast_channel_datastore_find(), ast_channel_lock, ast_channel_make_compatible(), ast_channel_unlock, ast_context_find(), ast_context_remove_extension2(), AST_CONTROL_UNHOLD, ast_copy_flags, AST_DEVICE_NOT_INUSE, AST_FEATURE_AUTOMON, AST_FEATURE_DISCONNECT, AST_FEATURE_FLAG_BYBOTH, AST_FEATURE_FLAG_BYCALLEE, AST_FEATURE_FLAG_BYCALLER, AST_FEATURE_PARKCALL, AST_FEATURE_REDIRECT, AST_FLAGS_ALL, ast_free, ast_hangup(), ast_indicate(), AST_LIST_LOCK, AST_LIST_REMOVE_CURRENT, AST_LIST_TRAVERSE_SAFE_BEGIN, AST_LIST_TRAVERSE_SAFE_END, AST_LIST_UNLOCK, ast_log(), ast_set_flag, AST_STATE_UP, ast_stream_and_wait(), ast_streamfile(), ast_strlen_zero(), ast_verb, ast_waitstream(), ast_channel::cdr, parkeduser::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, courtesytone, ast_datastore::data, default_parkinglot, EVENT_FLAG_CALL, ast_dial_features::features_callee, ast_bridge_config::features_callee, ast_bridge_config::features_caller, ast_dial_features::features_caller, find_parkinglot(), findparkinglotname(), ast_dial_features::is_caller, ast_channel::language, LOG_WARNING, manager_event, ast_channel::name, notify_metermaids(), ast_parkinglot::parkedcallhangup, ast_parkinglot::parkedcallrecording, ast_parkinglot::parkedcallreparking, ast_parkinglot::parkedcalltransfers, parkedplay, ast_parkinglot::parking_con, parkeduser::parkingexten, parkeduser::parkingnum, ast_parkinglot::parkings, ast_channel::pbx, pbx_builtin_setvar_helper(), and S_OR.

Referenced by park_exec().

{
   int res = 0;
   struct ast_channel *peer=NULL;
   struct parkeduser *pu;
   struct ast_context *con;
   int park = 0;
   struct ast_bridge_config config;

   if (data)
      park = atoi((char *) data);

   parkinglot = find_parkinglot(findparkinglotname(chan));  
   if (!parkinglot)
      parkinglot = default_parkinglot;

   AST_LIST_LOCK(&parkinglot->parkings);
   AST_LIST_TRAVERSE_SAFE_BEGIN(&parkinglot->parkings, pu, list) {
      if (!data || pu->parkingnum == park) {
         if (pu->chan->pbx) { /* do not allow call to be picked up until the PBX thread is finished */
            AST_LIST_UNLOCK(&parkinglot->parkings);
            return -1;
         }
         AST_LIST_REMOVE_CURRENT(list);
         break;
      }
   }
   AST_LIST_TRAVERSE_SAFE_END;
   AST_LIST_UNLOCK(&parkinglot->parkings);

   if (pu) {
      peer = pu->chan;
      con = ast_context_find(parkinglot->parking_con);
      if (con) {
         if (ast_context_remove_extension2(con, pu->parkingexten, 1, NULL, 0))
            ast_log(LOG_WARNING, "Whoa, failed to remove the extension!\n");
         else
            notify_metermaids(pu->parkingexten, parkinglot->parking_con, AST_DEVICE_NOT_INUSE);
      } else
         ast_log(LOG_WARNING, "Whoa, no parking context?\n");

      ast_cel_report_event(pu->chan, AST_CEL_PARK_END, NULL, "UnParkedCall", chan);
      manager_event(EVENT_FLAG_CALL, "UnParkedCall",
         "Exten: %s\r\n"
         "Channel: %s\r\n"
         "From: %s\r\n"
         "CallerIDNum: %s\r\n"
         "CallerIDName: %s\r\n",
         pu->parkingexten, pu->chan->name, chan->name,
         S_OR(pu->chan->cid.cid_num, "<unknown>"),
         S_OR(pu->chan->cid.cid_name, "<unknown>")
         );

      ast_free(pu);
   }
   /* JK02: it helps to answer the channel if not already up */
   if (chan->_state != AST_STATE_UP)
      ast_answer(chan);

   //XXX Why do we unlock here ?
   // uncomment it for now, till my setup with debug_threads and detect_deadlocks starts to complain
   //ASTOBJ_UNLOCK(parkinglot);

   if (peer) {
      struct ast_datastore *features_datastore;
      struct ast_dial_features *dialfeatures = NULL;

      /* Play a courtesy to the source(s) configured to prefix the bridge connecting */

      if (!ast_strlen_zero(courtesytone)) {
         int error = 0;
         ast_indicate(peer, AST_CONTROL_UNHOLD);
         if (parkedplay == 0) {
            error = ast_stream_and_wait(chan, courtesytone, "");
         } else if (parkedplay == 1) {
            error = ast_stream_and_wait(peer, courtesytone, "");
         } else if (parkedplay == 2) {
            if (!ast_streamfile(chan, courtesytone, chan->language) &&
                  !ast_streamfile(peer, courtesytone, chan->language)) {
               /*! \todo XXX we would like to wait on both! */
               res = ast_waitstream(chan, "");
               if (res >= 0)
                  res = ast_waitstream(peer, "");
               if (res < 0)
                  error = 1;
            }
         }
         if (error) {
            ast_log(LOG_WARNING, "Failed to play courtesy tone!\n");
            ast_hangup(peer);
            return -1;
         }
      } else
         ast_indicate(peer, AST_CONTROL_UNHOLD);

      res = ast_channel_make_compatible(chan, peer);
      if (res < 0) {
         ast_log(LOG_WARNING, "Could not make channels %s and %s compatible for bridge\n", chan->name, peer->name);
         ast_hangup(peer);
         return -1;
      }
      /* This runs sorta backwards, since we give the incoming channel control, as if it
         were the person called. */
      ast_verb(3, "Channel %s connected to parked call %d\n", chan->name, park);

      pbx_builtin_setvar_helper(chan, "PARKEDCHANNEL", peer->name);
      ast_cdr_setdestchan(chan->cdr, peer->name);
      memset(&config, 0, sizeof(struct ast_bridge_config));

      /* Get datastore for peer and apply it's features to the callee side of the bridge config */
      ast_channel_lock(peer);
      if ((features_datastore = ast_channel_datastore_find(peer, &dial_features_info, NULL))) {
         dialfeatures = features_datastore->data;
      }
      ast_channel_unlock(peer);

      if (dialfeatures) {
         ast_copy_flags(&(config.features_callee), dialfeatures->is_caller ? &(dialfeatures->features_caller) : &(dialfeatures->features_callee), AST_FLAGS_ALL);
      }

      if ((parkinglot->parkedcalltransfers == AST_FEATURE_FLAG_BYCALLEE) || (parkinglot->parkedcalltransfers == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_callee), AST_FEATURE_REDIRECT);
      }
      if ((parkinglot->parkedcalltransfers == AST_FEATURE_FLAG_BYCALLER) || (parkinglot->parkedcalltransfers == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_caller), AST_FEATURE_REDIRECT);
      }
      if ((parkinglot->parkedcallreparking == AST_FEATURE_FLAG_BYCALLEE) || (parkinglot->parkedcallreparking == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_callee), AST_FEATURE_PARKCALL);
      }
      if ((parkinglot->parkedcallreparking == AST_FEATURE_FLAG_BYCALLER) || (parkinglot->parkedcallreparking == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_caller), AST_FEATURE_PARKCALL);
      }
      if ((parkinglot->parkedcallhangup == AST_FEATURE_FLAG_BYCALLEE) || (parkinglot->parkedcallhangup == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_callee), AST_FEATURE_DISCONNECT);
      }
      if ((parkinglot->parkedcallhangup == AST_FEATURE_FLAG_BYCALLER) || (parkinglot->parkedcallhangup == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_caller), AST_FEATURE_DISCONNECT);
      }
      if ((parkinglot->parkedcallrecording == AST_FEATURE_FLAG_BYCALLEE) || (parkinglot->parkedcallrecording == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_callee), AST_FEATURE_AUTOMON);
      }
      if ((parkinglot->parkedcallrecording == AST_FEATURE_FLAG_BYCALLER) || (parkinglot->parkedcallrecording == AST_FEATURE_FLAG_BYBOTH)) {
         ast_set_flag(&(config.features_caller), AST_FEATURE_AUTOMON);
      }

      res = ast_bridge_call(chan, peer, &config);

      pbx_builtin_setvar_helper(chan, "PARKEDCHANNEL", peer->name);
      ast_cdr_setdestchan(chan->cdr, peer->name);

      /* Simulate the PBX hanging up */
      ast_hangup(peer);
      return -1;
   } else {
      /*! \todo XXX Play a message XXX */
      if (ast_stream_and_wait(chan, "pbx-invalidpark", ""))
         ast_log(LOG_WARNING, "ast_streamfile of %s failed on %s\n", "pbx-invalidpark", chan->name);
      ast_verb(3, "Channel %s tried to talk to nonexistent parked call %d\n", chan->name, park);
      res = -1;
   }

   return -1;
}

static struct parkeduser* park_space_reserve	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_park_call_args *	args
	)			[static, read]

Note:

The API forces us to specify a numeric parking slot, even though the architecture would tend to support non-numeric extensions (as are possible with SIP, for example). Hence, we enforce that limitation here. If extout was not numeric, we could permit arbitrary non-numeric extensions.

Definition at line 682 of file features.c.

References ast_calloc, ast_channel_lock, ast_channel_unlock, ast_exists_extension(), ast_free, AST_LIST_INSERT_TAIL, AST_LIST_LOCK, AST_LIST_TRAVERSE, AST_LIST_UNLOCK, ast_log(), AST_PARK_OPT_RANDOMIZE, ast_random(), ast_strlen_zero(), ast_test_flag, default_parkinglot, find_parkinglot(), findparkinglotname(), free, LOG_DEBUG, LOG_WARNING, ast_parkinglot::name, parkeduser::notquiteyet, option_debug, ast_parkinglot::parkfindnext, ast_parkinglot::parking_con, ast_parkinglot::parking_offset, ast_parkinglot::parking_start, ast_parkinglot::parking_stop, parkeduser::parkingexten, parkeduser::parkinglot, parkinglot_addref(), parkinglot_unref(), parkeduser::parkingnum, ast_parkinglot::parkings, and pbx_builtin_getvar_helper().

Referenced by masq_park_call(), and park_call_full().

{
   struct parkeduser *pu;
   int i, parking_space = -1, parking_range;
   const char *parkinglotname = NULL;
   const char *parkingexten;
   struct ast_parkinglot *parkinglot = NULL;
   
   if (peer)
      parkinglotname = findparkinglotname(peer);

   if (parkinglotname) {
      if (option_debug)
         ast_log(LOG_DEBUG, "Found chanvar Parkinglot: %s\n", parkinglotname);
      parkinglot = find_parkinglot(parkinglotname);   
   }
   if (!parkinglot)
      parkinglot = default_parkinglot;

   parkinglot_addref(parkinglot);
   if (option_debug)
      ast_log(LOG_DEBUG, "Parkinglot: %s\n", parkinglot->name);

   /* Allocate memory for parking data */
   if (!(pu = ast_calloc(1, sizeof(*pu)))) {
      parkinglot_unref(parkinglot);
      return NULL;
   }

   /* Lock parking list */
   AST_LIST_LOCK(&parkinglot->parkings);
   /* Check for channel variable PARKINGEXTEN */
   ast_channel_lock(chan);
   parkingexten = pbx_builtin_getvar_helper(chan, "PARKINGEXTEN");
   ast_channel_unlock(chan);
   if (!ast_strlen_zero(parkingexten)) {
      /*!\note The API forces us to specify a numeric parking slot, even
       * though the architecture would tend to support non-numeric extensions
       * (as are possible with SIP, for example).  Hence, we enforce that
       * limitation here.  If extout was not numeric, we could permit
       * arbitrary non-numeric extensions.
       */
        if (sscanf(parkingexten, "%30d", &parking_space) != 1 || parking_space < 0) {
         AST_LIST_UNLOCK(&parkinglot->parkings);
         parkinglot_unref(parkinglot);
            free(pu);
            ast_log(LOG_WARNING, "PARKINGEXTEN does not indicate a valid parking slot: '%s'.\n", parkingexten);
            return NULL;
        }
        snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", parking_space);

      if (ast_exists_extension(NULL, parkinglot->parking_con, pu->parkingexten, 1, NULL)) {
         AST_LIST_UNLOCK(&parkinglot->parkings);
         parkinglot_unref(parkinglot);
         ast_free(pu);
         ast_log(LOG_WARNING, "Requested parking extension already exists: %s@%s\n", parkingexten, parkinglot->parking_con);
         return NULL;
      }
   } else {
      int start;
      struct parkeduser *cur = NULL;

      /* Select parking space within range */
      parking_range = parkinglot->parking_stop - parkinglot->parking_start + 1;

      if (ast_test_flag(args, AST_PARK_OPT_RANDOMIZE)) {
         start = ast_random() % (parkinglot->parking_stop - parkinglot->parking_start + 1);
      } else {
         start = parkinglot->parking_start;
      }

      for (i = start; 1; i++) {
         if (i == parkinglot->parking_stop + 1) {
            i = parkinglot->parking_start - 1;
            continue;
         }

         AST_LIST_TRAVERSE(&parkinglot->parkings, cur, list) {
            if (cur->parkingnum == i) {
               break;
            }
         }

         if (!cur || i == start - 1) {
            parking_space = i;
            break;
         }
      }

      if (i == start - 1 && cur) {
         ast_log(LOG_WARNING, "No more parking spaces\n");
         ast_free(pu);
         AST_LIST_UNLOCK(&parkinglot->parkings);
         parkinglot_unref(parkinglot);
         return NULL;
      }
      /* Set pointer for next parking */
      if (parkinglot->parkfindnext) 
         parkinglot->parking_offset = parking_space - parkinglot->parking_start + 1;
      snprintf(pu->parkingexten, sizeof(pu->parkingexten), "%d", parking_space);
   }

   pu->notquiteyet = 1;
   pu->parkingnum = parking_space;
   pu->parkinglot = parkinglot;
   AST_LIST_INSERT_TAIL(&parkinglot->parkings, pu, list);
   parkinglot_unref(parkinglot);

   return pu;
}

static struct ast_parkinglot * parkinglot_addref

(

struct ast_parkinglot *

parkinglot

)

[static, read]

Definition at line 3780 of file features.c.

References ao2_ref, ast_log(), LOG_DEBUG, ast_parkinglot::name, and option_debug.

Referenced by park_space_reserve().

{
   int refcount = ao2_ref(parkinglot, +1);
   if (option_debug > 2)
      ast_log(LOG_DEBUG, "Multiparking: %s refcount now %d\n", parkinglot->name, refcount + 1);
   return parkinglot;
}

static int parkinglot_cmp_cb	(	void *	obj,
		void *	arg,
		int	flags
	)			[static]

Definition at line 456 of file features.c.

References CMP_MATCH, CMP_STOP, and ast_parkinglot::name.

Referenced by ast_features_init().

{
   struct ast_parkinglot *parkinglot = obj, *parkinglot2 = arg;

   return !strcasecmp(parkinglot->name, parkinglot2->name) ? CMP_MATCH | CMP_STOP : 0;
}

static void parkinglot_destroy

(

void *

obj

)

[static]

Destroy a parking lot.

Definition at line 3807 of file features.c.

References ao2_unlink, ast_context_destroy(), ast_context_find(), ast_parkinglot::parking_con, parkinglots, and registrar.

Referenced by build_parkinglot(), and create_parkinglot().

{
   struct ast_parkinglot *ruin = obj;
   struct ast_context *con;
   con = ast_context_find(ruin->parking_con);
   if (con)
      ast_context_destroy(con, registrar);
   ao2_unlink(parkinglots, ruin);
}

static int parkinglot_hash_cb	(	const void *	obj,
		const int	flags
	)			[static]

Definition at line 449 of file features.c.

References ast_str_case_hash(), and ast_parkinglot::name.

Referenced by ast_features_init().

{
   const struct ast_parkinglot *parkinglot = obj;

   return ast_str_case_hash(parkinglot->name);
}

static void parkinglot_unref

(

struct ast_parkinglot *

parkinglot

)

[static]

Unreference parkinglot object. If no more references, then go ahead and delete it.

Definition at line 3773 of file features.c.

References ao2_ref, ast_log(), LOG_DEBUG, ast_parkinglot::name, and option_debug.

Referenced by build_parkinglot(), and park_space_reserve().

{
   int refcount = ao2_ref(parkinglot, -1);
   if (option_debug > 2)
      ast_log(LOG_DEBUG, "Multiparking: %s refcount now %d\n", parkinglot->name, refcount - 1);
}

static struct ast_cdr* pick_unlocked_cdr

(

struct ast_cdr *

cdr

)

[static, read]

return the first unlocked cdr in a possible chain

Definition at line 2602 of file features.c.

References AST_CDR_FLAG_LOCKED, ast_test_flag, and ast_cdr::next.

Referenced by ast_bridge_call().

{
   struct ast_cdr *cdr_orig = cdr;
   while (cdr) {
      if (!ast_test_flag(cdr,AST_CDR_FLAG_LOCKED))
         return cdr;
      cdr = cdr->next;
   }
   return cdr_orig; /* everybody LOCKED or some other weirdness, like a NULL */
}

static int play_message_in_bridged_call	(	struct ast_channel *	caller_chan,
		struct ast_channel *	callee_chan,
		const char *	audiofile
	)			[static]

Play message to both caller and callee in bridged call, plays synchronously, autoservicing the other channel during the message, so please don't use this for very long messages.

Definition at line 1086 of file features.c.

References ast_autoservice_start(), ast_autoservice_stop(), ast_log(), ast_stream_and_wait(), and LOG_WARNING.

Referenced by builtin_automonitor().

{
   /* First play for caller, put other channel on auto service */
   if (ast_autoservice_start(callee_chan))
      return -1;
   if (ast_stream_and_wait(caller_chan, audiofile, "")) {
      ast_log(LOG_WARNING, "Failed to play automon message!\n");
      ast_autoservice_stop(callee_chan);
      return -1;
   }
   if (ast_autoservice_stop(callee_chan))
      return -1;
   /* Then play for callee, put other channel on auto service */
   if (ast_autoservice_start(caller_chan))
      return -1;
   if (ast_stream_and_wait(callee_chan, audiofile, "")) {
      ast_log(LOG_WARNING, "Failed to play automon message !\n");
      ast_autoservice_stop(caller_chan);
      return -1;
   }
   if (ast_autoservice_stop(caller_chan))
      return -1;
   return(0);
}

static void post_manager_event	(	const char *	s,
		struct parkeduser *	pu
	)			[static]

Output parking event to manager.

Definition at line 3211 of file features.c.

References parkeduser::chan, ast_channel::cid, ast_callerid::cid_name, ast_callerid::cid_num, EVENT_FLAG_CALL, manager_event, ast_parkinglot::name, ast_channel::name, parkeduser::parkingexten, parkeduser::parkinglot, S_OR, and ast_channel::uniqueid.

Referenced by manage_parkinglot().

{
   manager_event(EVENT_FLAG_CALL, s,
      "Exten: %s\r\n"
      "Channel: %s\r\n"
      "Parkinglot: %s\r\n"
      "CallerIDNum: %s\r\n"
      "CallerIDName: %s\r\n"
      "UniqueID: %s\r\n\r\n",
      pu->parkingexten, 
      pu->chan->name,
      pu->parkinglot->name,
      S_OR(pu->chan->cid.cid_num, "<unknown>"),
      S_OR(pu->chan->cid.cid_name, "<unknown>"),
      pu->chan->uniqueid
      );
}

static const char* real_ctx	(	struct ast_channel *	transferer,
		struct ast_channel *	transferee
	)			[static]

Find the context for the transfer.

Parameters:

	transferer
	transferee	Grab the TRANSFER_CONTEXT, if fails try grabbing macrocontext.

Returns:

a context string

Definition at line 1349 of file features.c.

References ast_strlen_zero(), ast_channel::context, ast_channel::macrocontext, pbx_builtin_getvar_helper(), and s.

Referenced by builtin_atxfer(), and builtin_blindtransfer().

{
   const char *s = pbx_builtin_getvar_helper(transferer, "TRANSFER_CONTEXT");
   if (ast_strlen_zero(s)) {
      s = pbx_builtin_getvar_helper(transferee, "TRANSFER_CONTEXT");
   }
   if (ast_strlen_zero(s)) { /* Use the non-macro context to transfer the call XXX ? */
      s = transferer->macrocontext;
   }
   if (ast_strlen_zero(s)) {
      s = transferer->context;
   }
   return s;  
}

static struct feature_group* register_group

(

const char *

fgname

)

[static, read]

Add new feature group.

Parameters:

fgname

feature group name.

Add new feature group to the feature group list insert at head of list.

Note:

This function MUST be called while feature_groups is locked.

Definition at line 1930 of file features.c.

References ast_calloc, ast_free, AST_LIST_INSERT_HEAD, ast_log(), ast_string_field_init, ast_string_field_set, ast_verb, feature_group::gname, and LOG_NOTICE.

Referenced by load_config().

{
   struct feature_group *fg;

   if (!fgname) {
      ast_log(LOG_NOTICE, "You didn't pass a new group name!\n");
      return NULL;
   }

   if (!(fg = ast_calloc(1, sizeof(*fg))))
      return NULL;

   if (ast_string_field_init(fg, 128)) {
      ast_free(fg);
      return NULL;
   }

   ast_string_field_set(fg, gname, fgname);

   AST_LIST_INSERT_HEAD(&feature_groups, fg, entry);

   ast_verb(2, "Registered group '%s'\n", fg->gname);

   return fg;
}

static void register_group_feature	(	struct feature_group *	fg,
		const char *	exten,
		struct ast_call_feature *	feature
	)			[static]

Add feature to group.

Parameters:

	fg	feature group
	exten
	feature	feature to add.

Check fg and feature specified, add feature to list

Note:

This function MUST be called while feature_groups is locked.

Definition at line 1965 of file features.c.

References ast_calloc, ast_free, AST_LIST_INSERT_HEAD, ast_log(), ast_string_field_init, ast_string_field_set, ast_verb, ast_call_feature::exten, feature_group_exten::feature, feature_group::features, feature_group::gname, LOG_NOTICE, S_OR, and ast_call_feature::sname.

Referenced by load_config().

{
   struct feature_group_exten *fge;

   if (!fg) {
      ast_log(LOG_NOTICE, "You didn't pass a group!\n");
      return;
   }

   if (!feature) {
      ast_log(LOG_NOTICE, "You didn't pass a feature!\n");
      return;
   }

   if (!(fge = ast_calloc(1, sizeof(*fge))))
      return;

   if (ast_string_field_init(fge, 128)) {
      ast_free(fge);
      return;
   }

   ast_string_field_set(fge, exten, S_OR(exten, feature->exten));

   fge->feature = feature;

   AST_LIST_INSERT_HEAD(&fg->features, fge, entry);      

   ast_verb(2, "Registered feature '%s' for group '%s' at exten '%s'\n",
               feature->sname, fg->gname, exten);
}

static int remap_feature	(	const char *	name,
		const char *	value
	)			[static]

Definition at line 2175 of file features.c.

References ast_copy_string(), ast_rwlock_unlock(), ast_rwlock_wrlock(), FEATURES_COUNT, and features_lock.

Referenced by load_config().

{
   int x, res = -1;

   ast_rwlock_wrlock(&features_lock);
   for (x = 0; x < FEATURES_COUNT; x++) {
      if (strcasecmp(builtin_features[x].sname, name))
         continue;

      ast_copy_string(builtin_features[x].exten, value, sizeof(builtin_features[x].exten));
      res = 0;
      break;
   }
   ast_rwlock_unlock(&features_lock);

   return res;
}

static void set_bridge_features_on_config	(	struct ast_bridge_config *	config,
		const char *	features
	)			[static]

Definition at line 2613 of file features.c.

References AST_FEATURE_AUTOMON, AST_FEATURE_DISCONNECT, AST_FEATURE_PARKCALL, AST_FEATURE_REDIRECT, ast_log(), ast_set_flag, ast_strlen_zero(), ast_bridge_config::features_caller, and LOG_WARNING.

Referenced by ast_bridge_call().

{
   const char *feature;

   if (ast_strlen_zero(features)) {
      return;
   }

   for (feature = features; *feature; feature++) {
      switch (*feature) {
      case 'T' :
      case 't' :
         ast_set_flag(&(config->features_caller), AST_FEATURE_REDIRECT);
         break;
      case 'K' :
      case 'k' :
         ast_set_flag(&(config->features_caller), AST_FEATURE_PARKCALL);
         break;
      case 'H' :
      case 'h' :
         ast_set_flag(&(config->features_caller), AST_FEATURE_DISCONNECT);
         break;
      case 'W' :
      case 'w' :
         ast_set_flag(&(config->features_caller), AST_FEATURE_AUTOMON);
         break;
      default :
         ast_log(LOG_WARNING, "Skipping unknown feature code '%c'\n", *feature);
      }
   }
}

static void set_c_e_p	(	struct ast_channel *	chan,
		const char *	context,
		const char *	ext,
		int	pri
	)			[static]

store context, extension and priority

Parameters:

chan,context,ext,pri

Definition at line 467 of file features.c.

References ast_copy_string(), ast_channel::context, ast_channel::exten, and ast_channel::priority.

Referenced by builtin_blindtransfer(), manage_parkinglot(), and masq_park_call().

{
   ast_copy_string(chan->context, context, sizeof(chan->context));
   ast_copy_string(chan->exten, ext, sizeof(chan->exten));
   chan->priority = pri;
}

static void set_config_flags	(	struct ast_channel *	chan,
		struct ast_channel *	peer,
		struct ast_bridge_config *	config
	)			[static]

Definition at line 2341 of file features.c.

References AST_BRIDGE_DTMF_CHANNEL_0, AST_BRIDGE_DTMF_CHANNEL_1, ast_clear_flag, AST_FEATURE_FLAG_BYCALLEE, AST_FEATURE_FLAG_BYCALLER, AST_FEATURE_FLAG_NEEDSDTMF, AST_FLAGS_ALL, AST_RWLIST_RDLOCK, AST_RWLIST_UNLOCK, ast_rwlock_rdlock(), ast_rwlock_unlock(), ast_set_flag, ast_strdupa, ast_test_flag, ast_call_feature::feature_mask, ast_bridge_config::features_callee, ast_bridge_config::features_caller, FEATURES_COUNT, features_lock, find_dynamic_feature(), pbx_builtin_getvar_helper(), and strsep()<