Merged revisions 264997 via svnmerge from

https://origsvn.digium.com/svn/asterisk/trunk

................
  r264997 | mmichelson | 2010-05-21 11:44:27 -0500 (Fri, 21 May 2010) | 38 lines
  
  Merged revisions 264996 via svnmerge from 
  https://origsvn.digium.com/svn/asterisk/branches/1.4
  
  ........
    r264996 | mmichelson | 2010-05-21 11:28:34 -0500 (Fri, 21 May 2010) | 32 lines
    
    Allow ast_safe_sleep to defer specific frames until after the sleep has concluded.
    
    From reviewboard
    
    Background:
    A Digium customer discovered a somewhat odd bug. The setup is that parties A
    and B are bridged, and party A places party B on hold. While party B is 
    listening to hold music, he mashes a bunch of DTMF. Party A takes party
    B off hold while this is happening, but party B continues to hear hold
    music. I could reproduce this about 1 in 5 times.
    
    The issue:
    When DTMF features are enabled and a user presses keys, the channel that
    the DTMF is streamed to is placed in an ast_safe_sleep for 100 ms, the
    duration of the emulated tone. If an AST_CONTROL_UNHOLD frame is read
    from the channel during the sleep, the frame is dropped. Thus the
    unhold indication is never made to the channel that was originally placed
    on hold.
    
    The fix:
    Originally, I discussed with Kevin possible ways of fixing the specific
    problem reported. However, we determined that the same type of problem
    could happen in other situations where ast_safe_sleep() is used. Using
    autoservice as a model, I modified ast_safe_sleep_conditional() to
    defer specific frame types so they can be re-queued once the sleep has
    finished. I made a common function for determining if a frame should
    be deferred so that there are not two identical switch blocks to
    maintain.
    
    Review: https://reviewboard.asterisk.org/r/674/
  ........
................


git-svn-id: http://svn.digium.com/svn/asterisk/branches/1.6.2@264998 f38db490-d61c-443f-a65b-d21fe96a405b

1 files changed, 18 insertions, 1 deletions

diff --git a/include/asterisk/channel.h b/include/asterisk/channel.h
index 3d58c83f6..821ed09b0 100644
--- a/include/asterisk/channel.h
+++ b/include/asterisk/channel.h
@@ -1135,7 +1135,24 @@ int ast_indicate_data(struct ast_channel *chan, int condition, const void *data,
   \return Returns < 0 on  failure, 0 if nothing ever arrived, and the # of ms remaining otherwise */
 int ast_waitfor(struct ast_channel *chan, int ms);
 
-/*! \brief Wait for a specified amount of time, looking for hangups
+/*!
+ * \brief Should we keep this frame for later?
+ *
+ * There are functions such as ast_safe_sleep which will
+ * service a channel to ensure that it does not have a
+ * have a large backlog of queued frames. When this happens,
+ * we want to hold on to specific frame types and just drop
+ * others. This function will tell if the frame we just
+ * read should be held onto.
+ *
+ * \param frame The frame we just read
+ * \retval 1 frame should be kept
+ * \retval 0 frame should be dropped
+ */
+int ast_is_deferrable_frame(const struct ast_frame *frame);
+
+/*!
+ * \brief Wait for a specified amount of time, looking for hangups
  * \param chan channel to wait for
  * \param ms length of time in milliseconds to sleep
  * Waits for a specified amount of time, servicing the channel as required.