bridge_channel_internal.h File Reference

Private Bridging Channel API. More...

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Enumerations
enum	bridge_channel_action_type {   BRIDGE_CHANNEL_ACTION_DTMF_STREAM, BRIDGE_CHANNEL_ACTION_TALKING_START, BRIDGE_CHANNEL_ACTION_TALKING_STOP, BRIDGE_CHANNEL_ACTION_PLAY_FILE,   BRIDGE_CHANNEL_ACTION_RUN_APP, BRIDGE_CHANNEL_ACTION_CALLBACK, BRIDGE_CHANNEL_ACTION_PARK, BRIDGE_CHANNEL_ACTION_BLIND_TRANSFER,   BRIDGE_CHANNEL_ACTION_ATTENDED_TRANSFER, BRIDGE_CHANNEL_ACTION_DEFERRED_TECH_DESTROY = 1000, BRIDGE_CHANNEL_ACTION_DEFERRED_DISSOLVING }

Functions
void	bridge_channel_impart_signal (struct ast_channel *chan)
	Signal imparting threads to wake up. More...
struct ast_bridge_channel *	bridge_channel_internal_alloc (struct ast_bridge *bridge)
int	bridge_channel_internal_allows_optimization (struct ast_bridge_channel *bridge_channel)
int	bridge_channel_internal_join (struct ast_bridge_channel *bridge_channel)
void	bridge_channel_internal_pull (struct ast_bridge_channel *bridge_channel)
int	bridge_channel_internal_push (struct ast_bridge_channel *bridge_channel)
int	bridge_channel_internal_push_full (struct ast_bridge_channel *bridge_channel, int optimized)
int	bridge_channel_internal_queue_attended_transfer (struct ast_channel *transferee, struct ast_channel *unbridged_chan)
int	bridge_channel_internal_queue_blind_transfer (struct ast_channel *transferee, const char *exten, const char *context, transfer_channel_cb new_channel_cb, void *user_data)
void	bridge_channel_internal_suspend_nolock (struct ast_bridge_channel *bridge_channel)
void	bridge_channel_internal_unsuspend_nolock (struct ast_bridge_channel *bridge_channel)
void	bridge_channel_queue_deferred_frames (struct ast_bridge_channel *bridge_channel)
void	bridge_channel_settle_owed_events (struct ast_bridge *orig_bridge, struct ast_bridge_channel *bridge_channel)

Detailed Description

Private Bridging Channel API.

Author

Matt Jordan mjord.nosp@m.an@d.nosp@m.igium.nosp@m..com

A private API to manipulate channels in a bridge. These can be called on a channel in a bridge by bridge.c. These functions should not be called elsewhere, including by other members of the Bridging API.

See Also:

• CREDITS
• Ast

Definition in file bridge_channel_internal.h.

Enumeration Type Documentation

bridge_channel_action_type

enum bridge_channel_action_type

Enumerator
BRIDGE_CHANNEL_ACTION_DTMF_STREAM	Bridged channel is to send a DTMF stream out
BRIDGE_CHANNEL_ACTION_TALKING_START	Bridged channel is to indicate talking start
BRIDGE_CHANNEL_ACTION_TALKING_STOP	Bridged channel is to indicate talking stop
BRIDGE_CHANNEL_ACTION_PLAY_FILE	Bridge channel is to play the indicated sound file.
BRIDGE_CHANNEL_ACTION_RUN_APP	Bridge channel is to run the indicated application.
BRIDGE_CHANNEL_ACTION_CALLBACK	Bridge channel is to run the custom callback routine.
BRIDGE_CHANNEL_ACTION_PARK	Bridge channel is to get parked.
BRIDGE_CHANNEL_ACTION_BLIND_TRANSFER	Bridge channel is to execute a blind transfer.
BRIDGE_CHANNEL_ACTION_ATTENDED_TRANSFER	Bridge channel is to execute an attended transfer
BRIDGE_CHANNEL_ACTION_DEFERRED_TECH_DESTROY	Bridge reconfiguration deferred technology destruction.
BRIDGE_CHANNEL_ACTION_DEFERRED_DISSOLVING	Bridge deferred dissolving.

Definition at line 41 of file bridge_channel_internal.h.

                                {
   /*! Bridged channel is to send a DTMF stream out */
   BRIDGE_CHANNEL_ACTION_DTMF_STREAM,
   /*! Bridged channel is to indicate talking start */
   BRIDGE_CHANNEL_ACTION_TALKING_START,
   /*! Bridged channel is to indicate talking stop */
   BRIDGE_CHANNEL_ACTION_TALKING_STOP,
   /*! Bridge channel is to play the indicated sound file. */
   BRIDGE_CHANNEL_ACTION_PLAY_FILE,
   /*! Bridge channel is to run the indicated application. */
   BRIDGE_CHANNEL_ACTION_RUN_APP,
   /*! Bridge channel is to run the custom callback routine. */
   BRIDGE_CHANNEL_ACTION_CALLBACK,
   /*! Bridge channel is to get parked. */
   BRIDGE_CHANNEL_ACTION_PARK,
   /*! Bridge channel is to execute a blind transfer. */
   BRIDGE_CHANNEL_ACTION_BLIND_TRANSFER,
   /*! Bridge channel is to execute an attended transfer */
   BRIDGE_CHANNEL_ACTION_ATTENDED_TRANSFER,

   /*
    * Bridge actions put after this comment must never be put onto
    * the bridge_channel wr_queue because they have other resources
    * that must be freed.
    */

   /*! Bridge reconfiguration deferred technology destruction. */
   BRIDGE_CHANNEL_ACTION_DEFERRED_TECH_DESTROY = 1000,
   /*! Bridge deferred dissolving. */
   BRIDGE_CHANNEL_ACTION_DEFERRED_DISSOLVING,
};

Function Documentation

bridge_channel_impart_signal()

void bridge_channel_impart_signal

(

struct ast_channel *

chan

)

Signal imparting threads to wake up.

Since

13.9.0

Parameters

chan	Channel imparted that we need to signal.

Returns

Nothing

Definition at line 1626 of file bridge.c.

References ast_channel_datastore_find(), ast_channel_lock, ast_channel_unlock, bridge_channel_impart_ds_head_signal(), ast_datastore::data, and NULL.

Referenced by ast_bridge_impart(), ast_bridge_join(), bridge_channel_depart_thread(), bridge_channel_ind_thread(), and bridge_channel_internal_join().

{
   struct ast_datastore *datastore;

   ast_channel_lock(chan);
   datastore = ast_channel_datastore_find(chan, &bridge_channel_impart_ds_info, NULL);
   if (datastore) {
      bridge_channel_impart_ds_head_signal(datastore->data);
   }
   ast_channel_unlock(chan);
}

bridge_channel_internal_alloc()

struct ast_bridge_channel* bridge_channel_internal_alloc

(

struct ast_bridge *

bridge

)

Definition at line 3151 of file bridge_channel.c.

References ast_bridge_channel::alert_pipe, ao2_alloc, ao2_ref, ast_alertpipe_init(), ast_cond_init, ast_bridge_channel::bridge, bridge_channel_destroy(), ast_bridge_channel::cond, and NULL.

Referenced by ast_bridge_join(), and bridge_impart_internal().

{
   struct ast_bridge_channel *bridge_channel;

   bridge_channel = ao2_alloc(sizeof(struct ast_bridge_channel), bridge_channel_destroy);
   if (!bridge_channel) {
      return NULL;
   }
   ast_cond_init(&bridge_channel->cond, NULL);
   if (ast_alertpipe_init(bridge_channel->alert_pipe)) {
      ao2_ref(bridge_channel, -1);
      return NULL;
   }
   if (bridge) {
      bridge_channel->bridge = bridge;
      ao2_ref(bridge_channel->bridge, +1);
   }

   /* The stream_map is initialized later - see ast_bridge_channel_stream_map */

   return bridge_channel;
}

bridge_channel_internal_allows_optimization()

int bridge_channel_internal_allows_optimization

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 3110 of file bridge_channel.c.

References AST_LIST_EMPTY, ast_bridge_channel::in_bridge, and ast_bridge_channel::wr_queue.

Referenced by optimize_lock_chan_stack(), and optimize_lock_peer_stack().

{
   return bridge_channel->in_bridge
      && AST_LIST_EMPTY(&bridge_channel->wr_queue);
}

bridge_channel_internal_join()

int bridge_channel_internal_join

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 2902 of file bridge_channel.c.

References ao2_bump, ao2_t_cleanup, AST_BRIDGE_CAPABILITY_MULTIMIX, ast_bridge_channel_feature_digit(), ast_bridge_channel_kick(), ast_bridge_channel_lock_bridge(), ast_bridge_channel_restore_formats(), ast_bridge_features_merge(), ast_bridge_features_remove(), AST_BRIDGE_HOOK_REMOVE_ON_PULL, AST_BRIDGE_HOOK_TYPE_JOIN, AST_BRIDGE_HOOK_TYPE_LEAVE, ast_bridge_lock, ast_bridge_remove_video_src(), ast_bridge_unlock, ast_channel_end_dtmf(), ast_channel_feature_hooks_get(), ast_channel_flags(), ast_channel_hold_state(), ast_channel_internal_bridge(), ast_channel_internal_bridge_set(), ast_channel_is_t38_active(), ast_channel_lock, ast_channel_name(), ast_channel_readformat(), ast_channel_sending_dtmf_digit(), ast_channel_sending_dtmf_tv(), ast_channel_unlock, ast_channel_writeformat(), AST_CONTROL_HOLD, AST_CONTROL_SRCCHANGE, AST_CONTROL_T38_PARAMETERS, AST_CONTROL_UNHOLD, ast_debug, AST_FLAG_BRIDGE_DUAL_REDIRECT_WAIT, AST_FLAG_ZOMBIE, ast_indicate(), ast_indicate_data(), ast_jb_enable_for_channel(), ast_read_threadstorage_callid(), AST_T38_TERMINATED, ast_test_flag, ast_bridge_channel::bridge, bridge_channel_dissolve_check(), bridge_channel_event_join_leave(), bridge_channel_impart_signal(), bridge_channel_internal_pull(), bridge_channel_internal_push(), bridge_channel_settle_owed_events(), BRIDGE_CHANNEL_STATE_WAIT, bridge_channel_wait(), bridge_reconfigured(), ast_bridge::callid, ast_bridge_technology::capabilities, ast_bridge::cause, ast_bridge_channel::chan, ast_bridge_channel::features, ast_bridge_channel::inhibit_colp, NULL, ast_bridge_channel::read_format, ast_control_t38_parameters::request_response, ast_bridge_channel::state, ast_bridge_channel::swap, ast_bridge::technology, ast_bridge::uniqueid, and ast_bridge_channel::write_format.

Referenced by ast_bridge_join(), bridge_channel_depart_thread(), and bridge_channel_ind_thread().

{
   int res = 0;
   uint8_t indicate_src_change = 0;
   struct ast_bridge_features *channel_features;
   struct ast_channel *swap;

   ast_debug(1, "Bridge %s: %p(%s) is joining\n",
      bridge_channel->bridge->uniqueid,
      bridge_channel, ast_channel_name(bridge_channel->chan));

   /*
    * Directly locking the bridge is safe here because nobody else
    * knows about this bridge_channel yet.
    */
   ast_bridge_lock(bridge_channel->bridge);

   ast_channel_lock(bridge_channel->chan);

   bridge_channel->read_format = ao2_bump(ast_channel_readformat(bridge_channel->chan));
   bridge_channel->write_format = ao2_bump(ast_channel_writeformat(bridge_channel->chan));

   /* Make sure we're still good to be put into a bridge */
   if (ast_channel_internal_bridge(bridge_channel->chan)
      || ast_test_flag(ast_channel_flags(bridge_channel->chan), AST_FLAG_ZOMBIE)) {
      ast_channel_unlock(bridge_channel->chan);
      ast_bridge_unlock(bridge_channel->bridge);
      ast_debug(1, "Bridge %s: %p(%s) failed to join Bridge\n",
         bridge_channel->bridge->uniqueid,
         bridge_channel,
         ast_channel_name(bridge_channel->chan));
      return -1;
   }
   ast_channel_internal_bridge_set(bridge_channel->chan, bridge_channel->bridge);

   /* Attach features requested by the channel */
   channel_features = ast_channel_feature_hooks_get(bridge_channel->chan);
   if (channel_features) {
      ast_bridge_features_merge(bridge_channel->features, channel_features);
   }
   ast_channel_unlock(bridge_channel->chan);

   /* Add the jitterbuffer if the channel requires it */
   ast_jb_enable_for_channel(bridge_channel->chan);

   if (!bridge_channel->bridge->callid) {
      bridge_channel->bridge->callid = ast_read_threadstorage_callid();
   }

   /* Take the swap channel ref from the bridge_channel struct. */
   swap = bridge_channel->swap;

   if (bridge_channel_internal_push(bridge_channel)) {
      int cause = bridge_channel->bridge->cause;

      ast_bridge_unlock(bridge_channel->bridge);
      ast_bridge_channel_kick(bridge_channel, cause);
      ast_bridge_channel_lock_bridge(bridge_channel);
      ast_bridge_features_remove(bridge_channel->features,
         AST_BRIDGE_HOOK_REMOVE_ON_PULL);
      bridge_channel_dissolve_check(bridge_channel);
      res = -1;
   }
   bridge_reconfigured(bridge_channel->bridge, !bridge_channel->inhibit_colp);

   if (bridge_channel->state == BRIDGE_CHANNEL_STATE_WAIT) {
      /*
       * Indicate a source change since this channel is entering the
       * bridge system only if the bridge technology is not MULTIMIX
       * capable.  The MULTIMIX technology has already done it.
       */
      if (!(bridge_channel->bridge->technology->capabilities
         & AST_BRIDGE_CAPABILITY_MULTIMIX)) {
         indicate_src_change = 1;
      }

      bridge_channel_impart_signal(bridge_channel->chan);
      ast_bridge_unlock(bridge_channel->bridge);

      /* Must release any swap ref after unlocking the bridge. */
      ao2_t_cleanup(swap, "Bridge push with swap successful");
      swap = NULL;

      if (indicate_src_change) {
         ast_indicate(bridge_channel->chan, AST_CONTROL_SRCCHANGE);
      }

      bridge_channel_event_join_leave(bridge_channel, AST_BRIDGE_HOOK_TYPE_JOIN);

      while (bridge_channel->state == BRIDGE_CHANNEL_STATE_WAIT) {
         /* Wait for something to do. */
         bridge_channel_wait(bridge_channel);
      }

      /* Force a timeout on any accumulated DTMF hook digits. */
      ast_bridge_channel_feature_digit(bridge_channel, 0);

      bridge_channel_event_join_leave(bridge_channel, AST_BRIDGE_HOOK_TYPE_LEAVE);
      ast_bridge_channel_lock_bridge(bridge_channel);
   }

   bridge_channel_internal_pull(bridge_channel);
   bridge_channel_settle_owed_events(bridge_channel->bridge, bridge_channel);
   bridge_reconfigured(bridge_channel->bridge, 1);

   /* Remove ourselves if we are the video source */
   ast_bridge_remove_video_src(bridge_channel->bridge, bridge_channel->chan);

   ast_bridge_unlock(bridge_channel->bridge);

   /* Must release any swap ref after unlocking the bridge. */
   ao2_t_cleanup(swap, "Bridge push with swap failed or exited immediately");

   /* Complete any active hold before exiting the bridge. */
   if (ast_channel_hold_state(bridge_channel->chan) == AST_CONTROL_HOLD) {
      ast_debug(1, "Channel %s simulating UNHOLD for bridge end.\n",
         ast_channel_name(bridge_channel->chan));
      ast_indicate(bridge_channel->chan, AST_CONTROL_UNHOLD);
   }

   /* Complete any partial DTMF digit before exiting the bridge. */
   if (ast_channel_sending_dtmf_digit(bridge_channel->chan)) {
      ast_channel_end_dtmf(bridge_channel->chan,
         ast_channel_sending_dtmf_digit(bridge_channel->chan),
         ast_channel_sending_dtmf_tv(bridge_channel->chan), "bridge end");
   }

   /* Complete any T.38 session before exiting the bridge. */
   if (ast_channel_is_t38_active(bridge_channel->chan)) {
      struct ast_control_t38_parameters t38_parameters = {
         .request_response = AST_T38_TERMINATED,
      };

      ast_debug(1, "Channel %s simulating T.38 terminate for bridge end.\n",
         ast_channel_name(bridge_channel->chan));
      ast_indicate_data(bridge_channel->chan, AST_CONTROL_T38_PARAMETERS,
         &t38_parameters, sizeof(t38_parameters));
   }

   /* Indicate a source change since this channel is leaving the bridge system. */
   ast_indicate(bridge_channel->chan, AST_CONTROL_SRCCHANGE);

   /*
    * Wait for any dual redirect to complete.
    *
    * Must be done while "still in the bridge" for ast_async_goto()
    * to work right.
    */
   while (ast_test_flag(ast_channel_flags(bridge_channel->chan), AST_FLAG_BRIDGE_DUAL_REDIRECT_WAIT)) {
      sched_yield();
   }
   ast_channel_lock(bridge_channel->chan);
   ast_channel_internal_bridge_set(bridge_channel->chan, NULL);
   ast_channel_unlock(bridge_channel->chan);

   ast_bridge_channel_restore_formats(bridge_channel);

   return res;
}

bridge_channel_internal_pull()

void bridge_channel_internal_pull

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 2178 of file bridge_channel.c.

References ast_bridge_channel_clear_roles(), AST_BRIDGE_CHANNEL_FLAG_LONELY, ast_bridge_publish_leave(), ast_channel_clear_flag(), ast_channel_flags(), ast_channel_is_leaving_bridge(), ast_channel_name(), ast_debug, AST_FLAG_OUTGOING, AST_LIST_REMOVE, ast_test_flag, ast_verb, ast_bridge_channel::bridge, bridge_channel_dissolve_check(), BRIDGE_CHANNEL_STATE_WAIT, ast_bridge_channel::chan, ast_bridge::channels, ast_bridge_features::feature_flags, ast_bridge_channel::features, ast_bridge_channel::in_bridge, ast_bridge_channel::just_joined, ast_bridge_technology::leave, ast_bridge_technology::name, ast_bridge_methods::name, ast_bridge::num_active, ast_bridge::num_channels, ast_bridge::num_lonely, ast_bridge_methods::pull, ast_bridge::reconfigured, ast_bridge_channel::state, ast_bridge_channel::suspended, ast_bridge::technology, ast_bridge::uniqueid, and ast_bridge::v_table.

Referenced by bridge_channel_internal_join(), bridge_channel_internal_push_full(), bridge_do_merge(), and bridge_do_move().

{
   struct ast_bridge *bridge = bridge_channel->bridge;

   if (!bridge_channel->in_bridge) {
      return;
   }
   bridge_channel->in_bridge = 0;

   ast_debug(1, "Bridge %s: pulling %p(%s)\n",
      bridge->uniqueid, bridge_channel, ast_channel_name(bridge_channel->chan));

   ast_verb(3, "Channel %s left '%s' %s-bridge <%s>\n",
      ast_channel_name(bridge_channel->chan),
      bridge->technology->name,
      bridge->v_table->name,
      bridge->uniqueid);

   if (!bridge_channel->just_joined) {
      /* Tell the bridge technology we are leaving so they tear us down */
      ast_debug(1, "Bridge %s: %p(%s) is leaving %s technology\n",
         bridge->uniqueid, bridge_channel, ast_channel_name(bridge_channel->chan),
         bridge->technology->name);
      if (bridge->technology->leave) {
         bridge->technology->leave(bridge, bridge_channel);
      }
   }

   /* Remove channel from the bridge */
   if (!bridge_channel->suspended) {
      --bridge->num_active;
   }
   if (ast_test_flag(&bridge_channel->features->feature_flags, AST_BRIDGE_CHANNEL_FLAG_LONELY)) {
      --bridge->num_lonely;
   }
   --bridge->num_channels;
   AST_LIST_REMOVE(&bridge->channels, bridge_channel, entry);

   bridge_channel_dissolve_check(bridge_channel);
   bridge->v_table->pull(bridge, bridge_channel);

   ast_bridge_channel_clear_roles(bridge_channel);

   /* If we are not going to be hung up after leaving a bridge, and we were an
    * outgoing channel, clear the outgoing flag.
    */
   if (ast_test_flag(ast_channel_flags(bridge_channel->chan), AST_FLAG_OUTGOING)
       && (ast_channel_is_leaving_bridge(bridge_channel->chan)
           || bridge_channel->state == BRIDGE_CHANNEL_STATE_WAIT)) {
      ast_debug(2, "Channel %s will survive this bridge; clearing outgoing (dialed) flag\n", ast_channel_name(bridge_channel->chan));
      ast_channel_clear_flag(bridge_channel->chan, AST_FLAG_OUTGOING);
   }

   bridge->reconfigured = 1;
   ast_bridge_publish_leave(bridge, bridge_channel->chan);
}

bridge_channel_internal_push()

int bridge_channel_internal_push

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 2315 of file bridge_channel.c.

References bridge_channel_internal_push_full().

Referenced by bridge_channel_internal_join(), bridge_do_merge(), and bridge_do_move().

{
   return bridge_channel_internal_push_full(bridge_channel, 0);
}

bridge_channel_internal_push_full()

int bridge_channel_internal_push_full	(	struct ast_bridge_channel *	bridge_channel,
		int	optimized
	)

Definition at line 2235 of file bridge_channel.c.

References ast_assert, ast_bridge_channel_establish_roles(), AST_BRIDGE_CHANNEL_FLAG_LONELY, ast_bridge_channel_leave_bridge(), AST_BRIDGE_FLAG_DISSOLVE_EMPTY, ast_bridge_publish_enter(), ast_channel_name(), ast_clear_flag, ast_debug, AST_LIST_INSERT_TAIL, ast_null_frame, ast_queue_frame(), ast_set2_flag, ast_test_flag, ast_verb, ast_bridge_channel::bridge, bridge_channel_cancel_owed_events(), bridge_channel_internal_pull(), BRIDGE_CHANNEL_STATE_END_NO_DISSOLVE, BRIDGE_CHANNEL_STATE_WAIT, bridge_find_channel(), ast_bridge_channel::chan, ast_bridge::channels, ast_bridge::dissolved, ast_bridge_features::feature_flags, ast_bridge::feature_flags, ast_bridge_channel::features, ast_bridge_channel::in_bridge, ast_bridge_channel::just_joined, ast_bridge_technology::name, ast_bridge_methods::name, NULL, ast_bridge::num_active, ast_bridge::num_channels, ast_bridge::num_lonely, pbx_builtin_setvar_helper(), ast_bridge_methods::push, ast_bridge::reconfigured, ast_bridge_channel::state, ast_bridge_channel::suspended, ast_bridge_channel::swap, ast_bridge::technology, ast_bridge::uniqueid, and ast_bridge::v_table.

Referenced by bridge_channel_internal_push(), and bridge_do_move().

{
   struct ast_bridge *bridge = bridge_channel->bridge;
   struct ast_bridge_channel *swap;

   ast_assert(!bridge_channel->in_bridge);

   swap = bridge_find_channel(bridge, bridge_channel->swap);
   bridge_channel->swap = NULL;

   if (swap) {
      ast_debug(1, "Bridge %s: pushing %p(%s) by swapping with %p(%s)\n",
         bridge->uniqueid, bridge_channel, ast_channel_name(bridge_channel->chan),
         swap, ast_channel_name(swap->chan));
   } else {
      ast_debug(1, "Bridge %s: pushing %p(%s)\n",
         bridge->uniqueid, bridge_channel, ast_channel_name(bridge_channel->chan));
   }

   /* Add channel to the bridge */
   if (bridge->dissolved
      || bridge_channel->state != BRIDGE_CHANNEL_STATE_WAIT
      || (swap && swap->state != BRIDGE_CHANNEL_STATE_WAIT)
      || bridge->v_table->push(bridge, bridge_channel, swap)) {
      ast_debug(1, "Bridge %s: pushing %p(%s) into bridge failed\n",
         bridge->uniqueid, bridge_channel, ast_channel_name(bridge_channel->chan));
      return -1;
   }

   ast_bridge_channel_establish_roles(bridge_channel);

   if (swap) {
      int dissolve = ast_test_flag(&bridge->feature_flags, AST_BRIDGE_FLAG_DISSOLVE_EMPTY);

      /* This flag is cleared so the act of this channel leaving does not cause it to dissolve if need be */
      ast_clear_flag(&bridge->feature_flags, AST_BRIDGE_FLAG_DISSOLVE_EMPTY);

      if (optimized) {
         bridge_channel_cancel_owed_events(swap);
      }
      ast_bridge_channel_leave_bridge(swap, BRIDGE_CHANNEL_STATE_END_NO_DISSOLVE, 0);
      bridge_channel_internal_pull(swap);

      ast_set2_flag(&bridge->feature_flags, dissolve, AST_BRIDGE_FLAG_DISSOLVE_EMPTY);
   }

   bridge_channel->in_bridge = 1;
   bridge_channel->just_joined = 1;
   AST_LIST_INSERT_TAIL(&bridge->channels, bridge_channel, entry);
   ++bridge->num_channels;
   if (ast_test_flag(&bridge_channel->features->feature_flags, AST_BRIDGE_CHANNEL_FLAG_LONELY)) {
      ++bridge->num_lonely;
   }
   if (!bridge_channel->suspended) {
      ++bridge->num_active;
   }

   ast_verb(3, "Channel %s %s%s%s '%s' %s-bridge <%s>\n",
      ast_channel_name(bridge_channel->chan),
      swap ? "swapped with " : "joined",
      swap ? ast_channel_name(swap->chan) : "",
      swap ? " into" : "",
      bridge->technology->name,
      bridge->v_table->name,
      bridge->uniqueid);

   ast_bridge_publish_enter(bridge, bridge_channel->chan, swap ? swap->chan : NULL);

   /* Clear any BLINDTRANSFER,ATTENDEDTRANSFER and FORWARDERNAME since the transfer has completed. */
   pbx_builtin_setvar_helper(bridge_channel->chan, "BLINDTRANSFER", NULL);
   pbx_builtin_setvar_helper(bridge_channel->chan, "ATTENDEDTRANSFER", NULL);
   pbx_builtin_setvar_helper(bridge_channel->chan, "FORWARDERNAME", NULL);

   /* Wake up the bridge channel thread to reevaluate any interval timers. */
   ast_queue_frame(bridge_channel->chan, &ast_null_frame);

   bridge->reconfigured = 1;
   return 0;
}

bridge_channel_internal_queue_attended_transfer()

int bridge_channel_internal_queue_attended_transfer	(	struct ast_channel *	transferee,
		struct ast_channel *	unbridged_chan
	)

Definition at line 3088 of file bridge_channel.c.

References ao2_cleanup, ast_channel_get_bridge_channel(), ast_channel_lock, AST_CHANNEL_NAME, ast_channel_name(), ast_channel_unlock, ast_copy_string(), BRIDGE_CHANNEL_ACTION_ATTENDED_TRANSFER, bridge_channel_queue_action_data(), NULL, and RAII_VAR.

Referenced by ast_bridge_transfer_attended().

{
   RAII_VAR(struct ast_bridge_channel *, transferee_bridge_channel, NULL, ao2_cleanup);
   char unbridged_chan_name[AST_CHANNEL_NAME];

   ast_channel_lock(transferee);
   transferee_bridge_channel = ast_channel_get_bridge_channel(transferee);
   ast_channel_unlock(transferee);

   if (!transferee_bridge_channel) {
      return -1;
   }

   ast_copy_string(unbridged_chan_name, ast_channel_name(unbridged_chan),
      sizeof(unbridged_chan_name));

   return bridge_channel_queue_action_data(transferee_bridge_channel,
      BRIDGE_CHANNEL_ACTION_ATTENDED_TRANSFER, unbridged_chan_name,
      sizeof(unbridged_chan_name));
}

bridge_channel_internal_queue_blind_transfer()

int bridge_channel_internal_queue_blind_transfer	(	struct ast_channel *	transferee,
		const char *	exten,
		const char *	context,
		transfer_channel_cb	new_channel_cb,
		void *	user_data
	)

Definition at line 3062 of file bridge_channel.c.

References ao2_cleanup, AST_BRIDGE_TRANSFER_SINGLE_PARTY, ast_channel_get_bridge_channel(), ast_channel_lock, ast_channel_unlock, ast_copy_string(), BRIDGE_CHANNEL_ACTION_BLIND_TRANSFER, bridge_channel_queue_action_data(), blind_transfer_data::context, blind_transfer_data::exten, NULL, and RAII_VAR.

Referenced by ast_bridge_transfer_blind().

{
   RAII_VAR(struct ast_bridge_channel *, transferee_bridge_channel, NULL, ao2_cleanup);
   struct blind_transfer_data blind_data;

   ast_channel_lock(transferee);
   transferee_bridge_channel = ast_channel_get_bridge_channel(transferee);
   ast_channel_unlock(transferee);

   if (!transferee_bridge_channel) {
      return -1;
   }

   if (new_channel_cb) {
      new_channel_cb(transferee, user_data, AST_BRIDGE_TRANSFER_SINGLE_PARTY);
   }

   ast_copy_string(blind_data.exten, exten, sizeof(blind_data.exten));
   ast_copy_string(blind_data.context, context, sizeof(blind_data.context));

   return bridge_channel_queue_action_data(transferee_bridge_channel,
      BRIDGE_CHANNEL_ACTION_BLIND_TRANSFER, &blind_data, sizeof(blind_data));
}

bridge_channel_internal_suspend_nolock()

void bridge_channel_internal_suspend_nolock

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 854 of file bridge_channel.c.

References ast_bridge_channel::bridge, ast_bridge_channel::in_bridge, ast_bridge::num_active, ast_bridge_technology::suspend, ast_bridge_channel::suspended, and ast_bridge::technology.

Referenced by ast_bridge_channel_feature_digit(), ast_bridge_suspend(), and bridge_channel_suspend().

{
   bridge_channel->suspended = 1;
   if (bridge_channel->in_bridge) {
      --bridge_channel->bridge->num_active;
   }

   /* Get technology bridge threads off of the channel. */
   if (bridge_channel->bridge->technology->suspend) {
      bridge_channel->bridge->technology->suspend(bridge_channel->bridge, bridge_channel);
   }
}

bridge_channel_internal_unsuspend_nolock()

void bridge_channel_internal_unsuspend_nolock

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 892 of file bridge_channel.c.

References ast_bridge_channel_lock, ast_bridge_channel_unlock, ast_cond_signal, ast_bridge_channel::bridge, ast_bridge_channel::cond, ast_bridge_channel::in_bridge, ast_bridge::num_active, ast_bridge_channel::suspended, ast_bridge::technology, and ast_bridge_technology::unsuspend.

Referenced by ast_bridge_unsuspend(), and bridge_channel_unsuspend().

{
   bridge_channel->suspended = 0;
   if (bridge_channel->in_bridge) {
      ++bridge_channel->bridge->num_active;
   }

   /* Wake technology bridge threads to take care of channel again. */
   if (bridge_channel->bridge->technology->unsuspend) {
      bridge_channel->bridge->technology->unsuspend(bridge_channel->bridge, bridge_channel);
   }

   /* Wake suspended channel. */
   ast_bridge_channel_lock(bridge_channel);
   ast_cond_signal(&bridge_channel->cond);
   ast_bridge_channel_unlock(bridge_channel);
}

bridge_channel_queue_deferred_frames()

void bridge_channel_queue_deferred_frames

(

struct ast_bridge_channel *

bridge_channel

)

Definition at line 830 of file bridge_channel.c.

References ast_bridge_channel_lock, ast_bridge_channel_unlock, ast_channel_lock, ast_channel_unlock, ast_frfree, AST_LIST_REMOVE_HEAD, ast_queue_frame_head(), ast_bridge_channel::chan, and ast_bridge_channel::deferred_queue.

Referenced by bridge_complete_join().

{
   struct ast_frame *frame;

   ast_bridge_channel_lock(bridge_channel);
   ast_channel_lock(bridge_channel->chan);
   while ((frame = AST_LIST_REMOVE_HEAD(&bridge_channel->deferred_queue, frame_list))) {
      ast_queue_frame_head(bridge_channel->chan, frame);
      ast_frfree(frame);
   }
   ast_channel_unlock(bridge_channel->chan);
   ast_bridge_channel_unlock(bridge_channel);
}

bridge_channel_settle_owed_events()

void bridge_channel_settle_owed_events	(	struct ast_bridge *	orig_bridge,
		struct ast_bridge_channel *	bridge_channel
	)

Definition at line 792 of file bridge_channel.c.

References ast_channel_name(), AST_CONTROL_T38_PARAMETERS, ast_debug, AST_FRAME_CONTROL, AST_FRAME_DTMF_END, ast_log, AST_T38_TERMINATED, ast_tvdiff_ms(), ast_tvnow(), ast_bridge_channel::chan, ast_bridge_channel::dtmf_digit, ast_bridge_channel::dtmf_tv, ast_frame::frametype, ast_frame::len, LOG_DTMF, NULL, option_dtmfminduration, ast_bridge_channel::owed, ast_control_t38_parameters::request_response, ast_frame::src, ast_bridge_channel::t38_terminate, ast_bridge::technology, ast_bridge::uniqueid, and ast_bridge_technology::write.

Referenced by bridge_channel_internal_join(), and bridge_do_move().

{
   if (bridge_channel->owed.dtmf_digit) {
      struct ast_frame frame = {
         .frametype = AST_FRAME_DTMF_END,
         .subclass.integer = bridge_channel->owed.dtmf_digit,
         .src = "Bridge channel owed DTMF",
      };

      frame.len = ast_tvdiff_ms(ast_tvnow(), bridge_channel->owed.dtmf_tv);
      if (frame.len < option_dtmfminduration) {
         frame.len = option_dtmfminduration;
      }
      ast_log(LOG_DTMF, "DTMF end '%c' simulated to bridge %s because %s left.  Duration %ld ms.\n",
         bridge_channel->owed.dtmf_digit, orig_bridge->uniqueid,
         ast_channel_name(bridge_channel->chan), frame.len);
      bridge_channel->owed.dtmf_digit = '\0';
      orig_bridge->technology->write(orig_bridge, NULL, &frame);
   }
   if (bridge_channel->owed.t38_terminate) {
      struct ast_control_t38_parameters t38_parameters = {
         .request_response = AST_T38_TERMINATED,
      };
      struct ast_frame frame = {
         .frametype = AST_FRAME_CONTROL,
         .subclass.integer = AST_CONTROL_T38_PARAMETERS,
         .data.ptr = &t38_parameters,
         .datalen = sizeof(t38_parameters),
         .src = "Bridge channel owed T.38 terminate",
      };

      ast_debug(1, "T.38 terminate simulated to bridge %s because %s left.\n",
         orig_bridge->uniqueid, ast_channel_name(bridge_channel->chan));
      bridge_channel->owed.t38_terminate = 0;
      orig_bridge->technology->write(orig_bridge, NULL, &frame);
   }
}