Merge "ARI: Run 'make ari-stubs'"
[asterisk/asterisk.git] / apps / app_meetme.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2007, Digium, Inc.
5  *
6  * Mark Spencer <markster@digium.com>
7  *
8  * SLA Implementation by:
9  * Russell Bryant <russell@digium.com>
10  *
11  * See http://www.asterisk.org for more information about
12  * the Asterisk project. Please do not directly contact
13  * any of the maintainers of this project for assistance;
14  * the project provides a web site, mailing lists and IRC
15  * channels for your use.
16  *
17  * This program is free software, distributed under the terms of
18  * the GNU General Public License Version 2. See the LICENSE file
19  * at the top of the source tree.
20  */
21
22 /*! \file
23  *
24  * \brief Meet me conference bridge and Shared Line Appearances
25  *
26  * \author Mark Spencer <markster@digium.com>
27  * \author (SLA) Russell Bryant <russell@digium.com>
28  *
29  * \ingroup applications
30  */
31
32 /*! \li \ref app_meetme.c uses configuration file \ref meetme.conf
33  * \addtogroup configuration_file Configuration Files
34  */
35
36 /*!
37  * \page meetme.conf meetme.conf
38  * \verbinclude meetme.conf.sample
39  */
40
41 /*** MODULEINFO
42         <depend>dahdi</depend>
43         <defaultenabled>no</defaultenabled>
44         <support_level>extended</support_level>
45         <replacement>app_confbridge</replacement>
46  ***/
47
48 #include "asterisk.h"
49
50 #include <dahdi/user.h>
51
52 #include "asterisk/lock.h"
53 #include "asterisk/file.h"
54 #include "asterisk/channel.h"
55 #include "asterisk/pbx.h"
56 #include "asterisk/module.h"
57 #include "asterisk/config.h"
58 #include "asterisk/app.h"
59 #include "asterisk/dsp.h"
60 #include "asterisk/musiconhold.h"
61 #include "asterisk/manager.h"
62 #include "asterisk/cli.h"
63 #include "asterisk/say.h"
64 #include "asterisk/utils.h"
65 #include "asterisk/translate.h"
66 #include "asterisk/ulaw.h"
67 #include "asterisk/astobj2.h"
68 #include "asterisk/devicestate.h"
69 #include "asterisk/dial.h"
70 #include "asterisk/causes.h"
71 #include "asterisk/paths.h"
72 #include "asterisk/test.h"
73 #include "asterisk/stasis.h"
74 #include "asterisk/stasis_channels.h"
75 #include "asterisk/stasis_message_router.h"
76 #include "asterisk/json.h"
77 #include "asterisk/format_compatibility.h"
78
79 #include "enter.h"
80 #include "leave.h"
81
82 /*** DOCUMENTATION
83         <application name="MeetMe" language="en_US">
84                 <synopsis>
85                         MeetMe conference bridge.
86                 </synopsis>
87                 <syntax>
88                         <parameter name="confno">
89                                 <para>The conference number</para>
90                         </parameter>
91                         <parameter name="options">
92                                 <optionlist>
93                                         <option name="a">
94                                                 <para>Set admin mode.</para>
95                                         </option>
96                                         <option name="A">
97                                                 <para>Set marked mode.</para>
98                                         </option>
99                                         <option name="b">
100                                                 <para>Run AGI script specified in <variable>MEETME_AGI_BACKGROUND</variable>
101                                                 Default: <literal>conf-background.agi</literal>.</para>
102                                                 <note><para>This does not work with non-DAHDI channels in the same
103                                                 conference).</para></note>
104                                         </option>
105                                         <option name="c">
106                                                 <para>Announce user(s) count on joining a conference.</para>
107                                         </option>
108                                         <option name="C">
109                                                 <para>Continue in dialplan when kicked out of conference.</para>
110                                         </option>
111                                         <option name="d">
112                                                 <para>Dynamically add conference.</para>
113                                         </option>
114                                         <option name="D">
115                                                 <para>Dynamically add conference, prompting for a PIN.</para>
116                                         </option>
117                                         <option name="e">
118                                                 <para>Select an empty conference.</para>
119                                         </option>
120                                         <option name="E">
121                                                 <para>Select an empty pinless conference.</para>
122                                         </option>
123                                         <option name="F">
124                                                 <para>Pass DTMF through the conference.</para>
125                                         </option>
126                                         <option name="G">
127                                                 <argument name="x" required="true">
128                                                         <para>The file to playback</para>
129                                                 </argument>
130                                                 <para>Play an intro announcement in conference.</para>
131                                         </option>
132                                         <option name="i">
133                                                 <para>Announce user join/leave with review.</para>
134                                         </option>
135                                         <option name="I">
136                                                 <para>Announce user join/leave without review.</para>
137                                         </option>
138                                         <option name="k">
139                                                 <para>Close the conference if there's only one active participant left at exit.</para>
140                                         </option>
141                                         <option name="l">
142                                                 <para>Set listen only mode (Listen only, no talking).</para>
143                                         </option>
144                                         <option name="m">
145                                                 <para>Set initially muted.</para>
146                                         </option>
147                                         <option name="M" hasparams="optional">
148                                                 <para>Enable music on hold when the conference has a single caller. Optionally,
149                                                 specify a musiconhold class to use. If one is not provided, it will use the
150                                                 channel's currently set music class, or <literal>default</literal>.</para>
151                                                 <argument name="class" required="true" />
152                                         </option>
153                                         <option name="n">
154                                                 <para>Disable the denoiser. By default, if <literal>func_speex</literal> is loaded, Asterisk
155                                                 will apply a denoiser to channels in the MeetMe conference. However, channel
156                                                 drivers that present audio with a varying rate will experience degraded
157                                                 performance with a denoiser attached. This parameter allows a channel joining
158                                                 the conference to choose not to have a denoiser attached without having to
159                                                 unload <literal>func_speex</literal>.</para>
160                                         </option>
161                                         <option name="o">
162                                                 <para>Set talker optimization - treats talkers who aren't speaking as
163                                                 being muted, meaning (a) No encode is done on transmission and (b)
164                                                 Received audio that is not registered as talking is omitted causing no
165                                                 buildup in background noise.</para>
166                                         </option>
167                                         <option name="p" hasparams="optional">
168                                                 <para>Allow user to exit the conference by pressing <literal>#</literal> (default)
169                                                 or any of the defined keys. Dial plan execution will continue at the next
170                                                 priority following MeetMe. The key used is set to channel variable
171                                                 <variable>MEETME_EXIT_KEY</variable>.</para>
172                                                 <argument name="keys" required="true" />
173                                                 <note>
174                                                         <para>Option <literal>s</literal> has priority for <literal>*</literal>
175                                                         since it cannot change its activation code.</para>
176                                                 </note>
177                                         </option>
178                                         <option name="P">
179                                                 <para>Always prompt for the pin even if it is specified.</para>
180                                         </option>
181                                         <option name="q">
182                                                 <para>Quiet mode (don't play enter/leave sounds).</para>
183                                         </option>
184                                         <option name="r">
185                                                 <para>Record conference (records as <variable>MEETME_RECORDINGFILE</variable>
186                                                 using format <variable>MEETME_RECORDINGFORMAT</variable>. Default filename is
187                                                 <literal>meetme-conf-rec-${CONFNO}-${UNIQUEID}</literal> and the default format is
188                                                 wav.</para>
189                                         </option>
190                                         <option name="s">
191                                                 <para>Present menu (user or admin) when <literal>*</literal> is received
192                                                 (send to menu).</para>
193                                         </option>
194                                         <option name="t">
195                                                 <para>Set talk only mode. (Talk only, no listening).</para>
196                                         </option>
197                                         <option name="T">
198                                                 <para>Set talker detection (sent to manager interface and meetme list).</para>
199                                         </option>
200                                         <option name="v" hasparams="optional">
201                                                 <para>Announce when a user is joining or leaving the conference.  Use the voicemail greeting as the announcement.
202                                                  If the i or I options are set, the application will fall back to them if no voicemail greeting can be found.</para>
203                                                 <argument name="mailbox@[context]" required="true">
204                                                         <para>The mailbox and voicemail context to play from.  If no context provided, assumed context is default.</para>
205                                                 </argument>
206                                         </option>
207                                         <option name="w" hasparams="optional">
208                                                 <para>Wait until the marked user enters the conference.</para>
209                                                 <argument name="secs" required="true" />
210                                         </option>
211                                         <option name="x">
212                                                 <para>Leave the conference when the last marked user leaves.</para>
213                                         </option>
214                                         <option name="X">
215                                                 <para>Allow user to exit the conference by entering a valid single digit
216                                                 extension <variable>MEETME_EXIT_CONTEXT</variable> or the current context
217                                                 if that variable is not defined.</para>
218                                                 <note>
219                                                         <para>Option <literal>s</literal> has priority for <literal>*</literal>
220                                                         since it cannot change its activation code.</para>
221                                                 </note>
222                                         </option>
223                                         <option name="1">
224                                                 <para>Do not play message when first person enters</para>
225                                         </option>
226                                         <option name="S">
227                                                 <para>Kick the user <replaceable>x</replaceable> seconds <emphasis>after</emphasis> he entered into
228                                                 the conference.</para>
229                                                 <argument name="x" required="true" />
230                                         </option>
231                                         <option name="L" argsep=":">
232                                                 <para>Limit the conference to <replaceable>x</replaceable> ms. Play a warning when
233                                                 <replaceable>y</replaceable> ms are left. Repeat the warning every <replaceable>z</replaceable> ms.
234                                                 The following special variables can be used with this option:</para>
235                                                 <variablelist>
236                                                         <variable name="CONF_LIMIT_TIMEOUT_FILE">
237                                                                 <para>File to play when time is up.</para>
238                                                         </variable>
239                                                         <variable name="CONF_LIMIT_WARNING_FILE">
240                                                                 <para>File to play as warning if <replaceable>y</replaceable> is defined. The
241                                                                 default is to say the time remaining.</para>
242                                                         </variable>
243                                                 </variablelist>
244                                                 <argument name="x" />
245                                                 <argument name="y" />
246                                                 <argument name="z" />
247                                         </option>
248                                 </optionlist>
249                         </parameter>
250                         <parameter name="pin" />
251                 </syntax>
252                 <description>
253                         <para>Enters the user into a specified MeetMe conference.  If the <replaceable>confno</replaceable>
254                         is omitted, the user will be prompted to enter one.  User can exit the conference by hangup, or
255                         if the <literal>p</literal> option is specified, by pressing <literal>#</literal>.</para>
256                         <note><para>The DAHDI kernel modules and a functional DAHDI timing source (see dahdi_test)
257                         must be present for conferencing to operate properly. In addition, the chan_dahdi channel driver
258                         must be loaded for the <literal>i</literal> and <literal>r</literal> options to operate at
259                         all.</para></note>
260                 </description>
261                 <see-also>
262                         <ref type="application">MeetMeCount</ref>
263                         <ref type="application">MeetMeAdmin</ref>
264                         <ref type="application">MeetMeChannelAdmin</ref>
265                 </see-also>
266         </application>
267         <application name="MeetMeCount" language="en_US">
268                 <synopsis>
269                         MeetMe participant count.
270                 </synopsis>
271                 <syntax>
272                         <parameter name="confno" required="true">
273                                 <para>Conference number.</para>
274                         </parameter>
275                         <parameter name="var" />
276                 </syntax>
277                 <description>
278                         <para>Plays back the number of users in the specified MeetMe conference.
279                         If <replaceable>var</replaceable> is specified, playback will be skipped and the value
280                         will be returned in the variable. Upon application completion, MeetMeCount will hangup
281                         the channel, unless priority <literal>n+1</literal> exists, in which case priority progress will
282                         continue.</para>
283                 </description>
284                 <see-also>
285                         <ref type="application">MeetMe</ref>
286                 </see-also>
287         </application>
288         <application name="MeetMeAdmin" language="en_US">
289                 <synopsis>
290                         MeetMe conference administration.
291                 </synopsis>
292                 <syntax>
293                         <parameter name="confno" required="true" />
294                         <parameter name="command" required="true">
295                                 <optionlist>
296                                         <option name="e">
297                                                 <para>Eject last user that joined.</para>
298                                         </option>
299                                         <option name="E">
300                                                 <para>Extend conference end time, if scheduled.</para>
301                                         </option>
302                                         <option name="k">
303                                                 <para>Kick one user out of conference.</para>
304                                         </option>
305                                         <option name="K">
306                                                 <para>Kick all users out of conference.</para>
307                                         </option>
308                                         <option name="l">
309                                                 <para>Unlock conference.</para>
310                                         </option>
311                                         <option name="L">
312                                                 <para>Lock conference.</para>
313                                         </option>
314                                         <option name="m">
315                                                 <para>Unmute one user.</para>
316                                         </option>
317                                         <option name="M">
318                                                 <para>Mute one user.</para>
319                                         </option>
320                                         <option name="n">
321                                                 <para>Unmute all users in the conference.</para>
322                                         </option>
323                                         <option name="N">
324                                                 <para>Mute all non-admin users in the conference.</para>
325                                         </option>
326                                         <option name="r">
327                                                 <para>Reset one user's volume settings.</para>
328                                         </option>
329                                         <option name="R">
330                                                 <para>Reset all users volume settings.</para>
331                                         </option>
332                                         <option name="s">
333                                                 <para>Lower entire conference speaking volume.</para>
334                                         </option>
335                                         <option name="S">
336                                                 <para>Raise entire conference speaking volume.</para>
337                                         </option>
338                                         <option name="t">
339                                                 <para>Lower one user's talk volume.</para>
340                                         </option>
341                                         <option name="T">
342                                                 <para>Raise one user's talk volume.</para>
343                                         </option>
344                                         <option name="u">
345                                                 <para>Lower one user's listen volume.</para>
346                                         </option>
347                                         <option name="U">
348                                                 <para>Raise one user's listen volume.</para>
349                                         </option>
350                                         <option name="v">
351                                                 <para>Lower entire conference listening volume.</para>
352                                         </option>
353                                         <option name="V">
354                                                 <para>Raise entire conference listening volume.</para>
355                                         </option>
356                                 </optionlist>
357                         </parameter>
358                         <parameter name="user" />
359                 </syntax>
360                 <description>
361                         <para>Run admin <replaceable>command</replaceable> for conference <replaceable>confno</replaceable>.</para>
362                         <para>Will additionally set the variable <variable>MEETMEADMINSTATUS</variable> with one of
363                         the following values:</para>
364                         <variablelist>
365                                 <variable name="MEETMEADMINSTATUS">
366                                         <value name="NOPARSE">
367                                                 Invalid arguments.
368                                         </value>
369                                         <value name="NOTFOUND">
370                                                 User specified was not found.
371                                         </value>
372                                         <value name="FAILED">
373                                                 Another failure occurred.
374                                         </value>
375                                         <value name="OK">
376                                                 The operation was completed successfully.
377                                         </value>
378                                 </variable>
379                         </variablelist>
380                 </description>
381                 <see-also>
382                         <ref type="application">MeetMe</ref>
383                 </see-also>
384         </application>
385         <application name="MeetMeChannelAdmin" language="en_US">
386                 <synopsis>
387                         MeetMe conference Administration (channel specific).
388                 </synopsis>
389                 <syntax>
390                         <parameter name="channel" required="true" />
391                         <parameter name="command" required="true">
392                                 <optionlist>
393                                         <option name="k">
394                                                 <para>Kick the specified user out of the conference he is in.</para>
395                                         </option>
396                                         <option name="m">
397                                                 <para>Unmute the specified user.</para>
398                                         </option>
399                                         <option name="M">
400                                                 <para>Mute the specified user.</para>
401                                         </option>
402                                 </optionlist>
403                         </parameter>
404                 </syntax>
405                 <description>
406                         <para>Run admin <replaceable>command</replaceable> for a specific
407                         <replaceable>channel</replaceable> in any conference.</para>
408                 </description>
409         </application>
410         <application name="SLAStation" language="en_US">
411                 <synopsis>
412                         Shared Line Appearance Station.
413                 </synopsis>
414                 <syntax>
415                         <parameter name="station" required="true">
416                                 <para>Station name</para>
417                         </parameter>
418                 </syntax>
419                 <description>
420                         <para>This application should be executed by an SLA station. The argument depends
421                         on how the call was initiated. If the phone was just taken off hook, then the argument
422                         <replaceable>station</replaceable> should be just the station name. If the call was
423                         initiated by pressing a line key, then the station name should be preceded by an underscore
424                         and the trunk name associated with that line button.</para>
425                         <para>For example: <literal>station1_line1</literal></para>
426                         <para>On exit, this application will set the variable <variable>SLASTATION_STATUS</variable> to
427                         one of the following values:</para>
428                         <variablelist>
429                                 <variable name="SLASTATION_STATUS">
430                                         <value name="FAILURE" />
431                                         <value name="CONGESTION" />
432                                         <value name="SUCCESS" />
433                                 </variable>
434                         </variablelist>
435                 </description>
436         </application>
437         <application name="SLATrunk" language="en_US">
438                 <synopsis>
439                         Shared Line Appearance Trunk.
440                 </synopsis>
441                 <syntax>
442                         <parameter name="trunk" required="true">
443                                 <para>Trunk name</para>
444                         </parameter>
445                         <parameter name="options">
446                                 <optionlist>
447                                         <option name="M" hasparams="optional">
448                                                 <para>Play back the specified MOH <replaceable>class</replaceable>
449                                                 instead of ringing</para>
450                                                 <argument name="class" required="true" />
451                                         </option>
452                                 </optionlist>
453                         </parameter>
454                 </syntax>
455                 <description>
456                         <para>This application should be executed by an SLA trunk on an inbound call. The channel calling
457                         this application should correspond to the SLA trunk with the name <replaceable>trunk</replaceable>
458                         that is being passed as an argument.</para>
459                         <para>On exit, this application will set the variable <variable>SLATRUNK_STATUS</variable> to
460                         one of the following values:</para>
461                         <variablelist>
462                                 <variable name="SLATRUNK_STATUS">
463                                         <value name="FAILURE" />
464                                         <value name="SUCCESS" />
465                                         <value name="UNANSWERED" />
466                                         <value name="RINGTIMEOUT" />
467                                 </variable>
468                         </variablelist>
469                 </description>
470         </application>
471         <function name="MEETME_INFO" language="en_US">
472                 <synopsis>
473                         Query a given conference of various properties.
474                 </synopsis>
475                 <syntax>
476                         <parameter name="keyword" required="true">
477                                 <para>Options:</para>
478                                 <enumlist>
479                                         <enum name="lock">
480                                                 <para>Boolean of whether the corresponding conference is locked.</para>
481                                         </enum>
482                                         <enum name="parties">
483                                                 <para>Number of parties in a given conference</para>
484                                         </enum>
485                                         <enum name="activity">
486                                                 <para>Duration of conference in seconds.</para>
487                                         </enum>
488                                         <enum name="dynamic">
489                                                 <para>Boolean of whether the corresponding conference is dynamic.</para>
490                                         </enum>
491                                 </enumlist>
492                         </parameter>
493                         <parameter name="confno" required="true">
494                                 <para>Conference number to retrieve information from.</para>
495                         </parameter>
496                 </syntax>
497                 <description />
498                 <see-also>
499                         <ref type="application">MeetMe</ref>
500                         <ref type="application">MeetMeCount</ref>
501                         <ref type="application">MeetMeAdmin</ref>
502                         <ref type="application">MeetMeChannelAdmin</ref>
503                 </see-also>
504         </function>
505         <manager name="MeetmeMute" language="en_US">
506                 <synopsis>
507                         Mute a Meetme user.
508                 </synopsis>
509                 <syntax>
510                         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
511                         <parameter name="Meetme" required="true" />
512                         <parameter name="Usernum" required="true" />
513                 </syntax>
514                 <description>
515                 </description>
516         </manager>
517         <manager name="MeetmeUnmute" language="en_US">
518                 <synopsis>
519                         Unmute a Meetme user.
520                 </synopsis>
521                 <syntax>
522                         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
523                         <parameter name="Meetme" required="true" />
524                         <parameter name="Usernum" required="true" />
525                 </syntax>
526                 <description>
527                 </description>
528         </manager>
529         <manager name="MeetmeList" language="en_US">
530                 <synopsis>
531                         List participants in a conference.
532                 </synopsis>
533                 <syntax>
534                         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
535                         <parameter name="Conference" required="false">
536                                 <para>Conference number.</para>
537                         </parameter>
538                 </syntax>
539                 <description>
540                         <para>Lists all users in a particular MeetMe conference.
541                         MeetmeList will follow as separate events, followed by a final event called
542                         MeetmeListComplete.</para>
543                 </description>
544         </manager>
545         <manager name="MeetmeListRooms" language="en_US">
546                 <synopsis>
547                         List active conferences.
548                 </synopsis>
549                 <syntax>
550                         <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
551                 </syntax>
552                 <description>
553                         <para>Lists data about all active conferences.
554                                 MeetmeListRooms will follow as separate events, followed by a final event called
555                                 MeetmeListRoomsComplete.</para>
556                 </description>
557         </manager>
558         <managerEvent language="en_US" name="MeetmeJoin">
559                 <managerEventInstance class="EVENT_FLAG_CALL">
560                         <synopsis>Raised when a user joins a MeetMe conference.</synopsis>
561                         <syntax>
562                                 <parameter name="Meetme">
563                                         <para>The identifier for the MeetMe conference.</para>
564                                 </parameter>
565                                 <parameter name="User">
566                                         <para>The identifier of the MeetMe user who joined.</para>
567                                 </parameter>
568                                 <channel_snapshot/>
569                         </syntax>
570                         <see-also>
571                                 <ref type="managerEvent">MeetmeLeave</ref>
572                                 <ref type="application">MeetMe</ref>
573                         </see-also>
574                 </managerEventInstance>
575         </managerEvent>
576         <managerEvent language="en_US" name="MeetmeLeave">
577                 <managerEventInstance class="EVENT_FLAG_CALL">
578                         <synopsis>Raised when a user leaves a MeetMe conference.</synopsis>
579                         <syntax>
580                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
581                                 <channel_snapshot/>
582                                 <parameter name="Duration">
583                                         <para>The length of time in seconds that the Meetme user was in the conference.</para>
584                                 </parameter>
585                         </syntax>
586                         <see-also>
587                                 <ref type="managerEvent">MeetmeJoin</ref>
588                         </see-also>
589                 </managerEventInstance>
590         </managerEvent>
591         <managerEvent language="en_US" name="MeetmeEnd">
592                 <managerEventInstance class="EVENT_FLAG_CALL">
593                         <synopsis>Raised when a MeetMe conference ends.</synopsis>
594                         <syntax>
595                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter[@name='Meetme'])" />
596                         </syntax>
597                         <see-also>
598                                 <ref type="managerEvent">MeetmeJoin</ref>
599                         </see-also>
600                 </managerEventInstance>
601         </managerEvent>
602         <managerEvent language="en_US" name="MeetmeTalkRequest">
603                 <managerEventInstance class="EVENT_FLAG_CALL">
604                         <synopsis>Raised when a MeetMe user has started talking.</synopsis>
605                         <syntax>
606                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
607                                 <channel_snapshot/>
608                                 <parameter name="Duration">
609                                         <para>The length of time in seconds that the Meetme user has been in the conference at the time of this event.</para>
610                                 </parameter>
611                                 <parameter name="Status">
612                                         <enumlist>
613                                                 <enum name="on"/>
614                                                 <enum name="off"/>
615                                         </enumlist>
616                                 </parameter>
617                         </syntax>
618                 </managerEventInstance>
619         </managerEvent>
620         <managerEvent language="en_US" name="MeetmeTalking">
621                 <managerEventInstance class="EVENT_FLAG_CALL">
622                         <synopsis>Raised when a MeetMe user begins or ends talking.</synopsis>
623                         <syntax>
624                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
625                                 <channel_snapshot/>
626                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeTalkRequest']/managerEventInstance/syntax/parameter)" />
627                         </syntax>
628                 </managerEventInstance>
629         </managerEvent>
630         <managerEvent language="en_US" name="MeetmeMute">
631                 <managerEventInstance class="EVENT_FLAG_CALL">
632                         <synopsis>Raised when a MeetMe user is muted or unmuted.</synopsis>
633                         <syntax>
634                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)" />
635                                 <channel_snapshot/>
636                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='MeetmeTalkRequest']/managerEventInstance/syntax/parameter)" />
637                         </syntax>
638                 </managerEventInstance>
639         </managerEvent>
640  ***/
641
642 #define CONFIG_FILE_NAME        "meetme.conf"
643 #define SLA_CONFIG_FILE         "sla.conf"
644 #define STR_CONCISE                     "concise"
645
646 /*! each buffer is 20ms, so this is 640ms total */
647 #define DEFAULT_AUDIO_BUFFERS  32
648
649 /*! String format for scheduled conferences */
650 #define DATE_FORMAT "%Y-%m-%d %H:%M:%S"
651
652 enum {
653         ADMINFLAG_MUTED =     (1 << 1), /*!< User is muted */
654         ADMINFLAG_SELFMUTED = (1 << 2), /*!< User muted self */
655         ADMINFLAG_KICKME =    (1 << 3),  /*!< User has been kicked */
656         /*! User has requested to speak */
657         ADMINFLAG_T_REQUEST = (1 << 4),
658         ADMINFLAG_HANGUP = (1 << 5),    /*!< User will be leaving the conference */
659 };
660
661 #define MEETME_DELAYDETECTTALK     300
662 #define MEETME_DELAYDETECTENDTALK  1000
663
664 #define AST_FRAME_BITS  32
665
666 enum volume_action {
667         VOL_UP,
668         VOL_DOWN
669 };
670
671 enum entrance_sound {
672         ENTER,
673         LEAVE
674 };
675
676 enum recording_state {
677         MEETME_RECORD_OFF,
678         MEETME_RECORD_STARTED,
679         MEETME_RECORD_ACTIVE,
680         MEETME_RECORD_TERMINATE
681 };
682
683 #define CONF_SIZE  320
684
685 enum {
686         /*! user has admin access on the conference */
687         CONFFLAG_ADMIN = (1 << 0),
688         /*! If set the user can only receive audio from the conference */
689         CONFFLAG_MONITOR = (1 << 1),
690         /*! If set asterisk will exit conference when key defined in p() option is pressed */
691         CONFFLAG_KEYEXIT = (1 << 2),
692         /*! If set asterisk will provide a menu to the user when '*' is pressed */
693         CONFFLAG_STARMENU = (1 << 3),
694         /*! If set the use can only send audio to the conference */
695         CONFFLAG_TALKER = (1 << 4),
696         /*! If set there will be no enter or leave sounds */
697         CONFFLAG_QUIET = (1 << 5),
698         /*! If set, when user joins the conference, they will be told the number
699          *  of users that are already in */
700         CONFFLAG_ANNOUNCEUSERCOUNT = (1 << 6),
701         /*! Set to run AGI Script in Background */
702         CONFFLAG_AGI = (1 << 7),
703         /*! Set to have music on hold when user is alone in conference */
704         CONFFLAG_MOH = (1 << 8),
705         /*! If set, the channel will leave the conference if all marked users leave */
706         CONFFLAG_MARKEDEXIT = (1 << 9),
707         /*! If set, the MeetMe will wait until a marked user enters */
708         CONFFLAG_WAITMARKED = (1 << 10),
709         /*! If set, the MeetMe will exit to the specified context */
710         CONFFLAG_EXIT_CONTEXT = (1 << 11),
711         /*! If set, the user will be marked */
712         CONFFLAG_MARKEDUSER = (1 << 12),
713         /*! If set, user will be ask record name on entry of conference */
714         CONFFLAG_INTROUSER = (1 << 13),
715         /*! If set, the MeetMe will be recorded */
716         CONFFLAG_RECORDCONF = (1<< 14),
717         /*! If set, the user will be monitored if the user is talking or not */
718         CONFFLAG_MONITORTALKER = (1 << 15),
719         CONFFLAG_DYNAMIC = (1 << 16),
720         CONFFLAG_DYNAMICPIN = (1 << 17),
721         CONFFLAG_EMPTY = (1 << 18),
722         CONFFLAG_EMPTYNOPIN = (1 << 19),
723         CONFFLAG_ALWAYSPROMPT = (1 << 20),
724         /*! If set, treat talking users as muted users */
725         CONFFLAG_OPTIMIZETALKER = (1 << 21),
726         /*! If set, won't speak the extra prompt when the first person
727          *  enters the conference */
728         CONFFLAG_NOONLYPERSON = (1 << 22),
729         /*! If set, user will be asked to record name on entry of conference
730          *  without review */
731         CONFFLAG_INTROUSERNOREVIEW = (1 << 23),
732         /*! If set, the user will be initially self-muted */
733         CONFFLAG_STARTMUTED = (1 << 24),
734         /*! Pass DTMF through the conference */
735         CONFFLAG_PASS_DTMF = (1 << 25),
736         CONFFLAG_SLA_STATION = (1 << 26),
737         CONFFLAG_SLA_TRUNK = (1 << 27),
738         /*! If set, the user should continue in the dialplan if kicked out */
739         CONFFLAG_KICK_CONTINUE = (1 << 28),
740         CONFFLAG_DURATION_STOP = (1 << 29),
741         CONFFLAG_DURATION_LIMIT = (1 << 30),
742 };
743
744 /* These flags are defined separately because we ran out of bits that an enum can be used to represent.
745    If you add new flags, be sure to do it in the same way that these are. */
746 /*! Do not write any audio to this channel until the state is up. */
747 #define CONFFLAG_NO_AUDIO_UNTIL_UP  (1ULL << 31)
748 #define CONFFLAG_INTROMSG           (1ULL << 32) /*!< If set play an intro announcement at start of conference */
749 #define CONFFLAG_INTROUSER_VMREC    (1ULL << 33)
750 /*! If there's only one person left in a conference when someone leaves, kill the conference */
751 #define CONFFLAG_KILL_LAST_MAN_STANDING (1ULL << 34)
752 /*! If set, don't enable a denoiser for the channel */
753 #define CONFFLAG_DONT_DENOISE       (1ULL << 35)
754
755 enum {
756         OPT_ARG_WAITMARKED = 0,
757         OPT_ARG_EXITKEYS   = 1,
758         OPT_ARG_DURATION_STOP = 2,
759         OPT_ARG_DURATION_LIMIT = 3,
760         OPT_ARG_MOH_CLASS = 4,
761         OPT_ARG_INTROMSG = 5,
762         OPT_ARG_INTROUSER_VMREC = 6,
763         OPT_ARG_ARRAY_SIZE = 7,
764 };
765
766 AST_APP_OPTIONS(meetme_opts, BEGIN_OPTIONS
767         AST_APP_OPTION('A', CONFFLAG_MARKEDUSER ),
768         AST_APP_OPTION('a', CONFFLAG_ADMIN ),
769         AST_APP_OPTION('b', CONFFLAG_AGI ),
770         AST_APP_OPTION('c', CONFFLAG_ANNOUNCEUSERCOUNT ),
771         AST_APP_OPTION('C', CONFFLAG_KICK_CONTINUE),
772         AST_APP_OPTION('D', CONFFLAG_DYNAMICPIN ),
773         AST_APP_OPTION('d', CONFFLAG_DYNAMIC ),
774         AST_APP_OPTION('E', CONFFLAG_EMPTYNOPIN ),
775         AST_APP_OPTION('e', CONFFLAG_EMPTY ),
776         AST_APP_OPTION('F', CONFFLAG_PASS_DTMF ),
777         AST_APP_OPTION_ARG('G', CONFFLAG_INTROMSG, OPT_ARG_INTROMSG ),
778         AST_APP_OPTION_ARG('v', CONFFLAG_INTROUSER_VMREC , OPT_ARG_INTROUSER_VMREC),
779         AST_APP_OPTION('i', CONFFLAG_INTROUSER ),
780         AST_APP_OPTION('I', CONFFLAG_INTROUSERNOREVIEW ),
781         AST_APP_OPTION('k', CONFFLAG_KILL_LAST_MAN_STANDING ),
782         AST_APP_OPTION_ARG('M', CONFFLAG_MOH, OPT_ARG_MOH_CLASS ),
783         AST_APP_OPTION('m', CONFFLAG_STARTMUTED ),
784         AST_APP_OPTION('n', CONFFLAG_DONT_DENOISE ),
785         AST_APP_OPTION('o', CONFFLAG_OPTIMIZETALKER ),
786         AST_APP_OPTION('P', CONFFLAG_ALWAYSPROMPT ),
787         AST_APP_OPTION_ARG('p', CONFFLAG_KEYEXIT, OPT_ARG_EXITKEYS ),
788         AST_APP_OPTION('q', CONFFLAG_QUIET ),
789         AST_APP_OPTION('r', CONFFLAG_RECORDCONF ),
790         AST_APP_OPTION('s', CONFFLAG_STARMENU ),
791         AST_APP_OPTION('T', CONFFLAG_MONITORTALKER ),
792         AST_APP_OPTION('l', CONFFLAG_MONITOR ),
793         AST_APP_OPTION('t', CONFFLAG_TALKER ),
794         AST_APP_OPTION_ARG('w', CONFFLAG_WAITMARKED, OPT_ARG_WAITMARKED ),
795         AST_APP_OPTION('X', CONFFLAG_EXIT_CONTEXT ),
796         AST_APP_OPTION('x', CONFFLAG_MARKEDEXIT ),
797         AST_APP_OPTION('1', CONFFLAG_NOONLYPERSON ),
798         AST_APP_OPTION_ARG('S', CONFFLAG_DURATION_STOP, OPT_ARG_DURATION_STOP),
799         AST_APP_OPTION_ARG('L', CONFFLAG_DURATION_LIMIT, OPT_ARG_DURATION_LIMIT),
800 END_OPTIONS );
801
802 static const char * const app = "MeetMe";
803 static const char * const app2 = "MeetMeCount";
804 static const char * const app3 = "MeetMeAdmin";
805 static const char * const app4 = "MeetMeChannelAdmin";
806 static const char * const slastation_app = "SLAStation";
807 static const char * const slatrunk_app = "SLATrunk";
808
809 /* Lookup RealTime conferences based on confno and current time */
810 static int rt_schedule;
811 static int fuzzystart;
812 static int earlyalert;
813 static int endalert;
814 static int extendby;
815
816 /*! Log participant count to the RealTime backend */
817 static int rt_log_members;
818
819 #define MAX_CONFNUM 80
820 #define MAX_PIN     80
821 #define OPTIONS_LEN 100
822
823 /* Enough space for "<conference #>,<pin>,<admin pin>" followed by a 0 byte. */
824 #define MAX_SETTINGS (MAX_CONFNUM + MAX_PIN + MAX_PIN + 3)
825
826 enum announcetypes {
827         CONF_HASJOIN,
828         CONF_HASLEFT
829 };
830
831 struct announce_listitem {
832         AST_LIST_ENTRY(announce_listitem) entry;
833         char namerecloc[PATH_MAX];                              /*!< Name Recorded file Location */
834         char language[MAX_LANGUAGE];
835         struct ast_channel *confchan;
836         int confusers;
837         int vmrec;
838         enum announcetypes announcetype;
839 };
840
841 /*! \brief The MeetMe Conference object */
842 struct ast_conference {
843         ast_mutex_t playlock;                   /*!< Conference specific lock (players) */
844         ast_mutex_t listenlock;                 /*!< Conference specific lock (listeners) */
845         char confno[MAX_CONFNUM];               /*!< Conference */
846         struct ast_channel *chan;               /*!< Announcements channel */
847         struct ast_channel *lchan;              /*!< Listen/Record channel */
848         int fd;                                 /*!< Announcements fd */
849         int dahdiconf;                            /*!< DAHDI Conf # */
850         int users;                              /*!< Number of active users */
851         int markedusers;                        /*!< Number of marked users */
852         int maxusers;                           /*!< Participant limit if scheduled */
853         int endalert;                           /*!< When to play conf ending message */
854         time_t start;                           /*!< Start time (s) */
855         int refcount;                           /*!< reference count of usage */
856         enum recording_state recording:2;       /*!< recording status */
857         unsigned int isdynamic:1;               /*!< Created on the fly? */
858         unsigned int locked:1;                  /*!< Is the conference locked? */
859         unsigned int gmuted:1;                  /*!< Is the conference globally muted? (all non-admins) */
860         pthread_t recordthread;                 /*!< thread for recording */
861         ast_mutex_t recordthreadlock;           /*!< control threads trying to start recordthread */
862         pthread_attr_t attr;                    /*!< thread attribute */
863         char *recordingfilename;                /*!< Filename to record the Conference into */
864         char *recordingformat;                  /*!< Format to record the Conference in */
865         char pin[MAX_PIN];                      /*!< If protected by a PIN */
866         char pinadmin[MAX_PIN];                 /*!< If protected by a admin PIN */
867         char uniqueid[32];
868         long endtime;                           /*!< When to end the conf if scheduled */
869         const char *useropts;                   /*!< RealTime user flags */
870         const char *adminopts;                  /*!< RealTime moderator flags */
871         const char *bookid;                     /*!< RealTime conference id */
872         struct ast_frame *transframe[32];
873         struct ast_frame *origframe;
874         struct ast_trans_pvt *transpath[32];
875         struct ao2_container *usercontainer;
876         AST_LIST_ENTRY(ast_conference) list;
877         /* announce_thread related data */
878         pthread_t announcethread;
879         ast_mutex_t announcethreadlock;
880         unsigned int announcethread_stop:1;
881         ast_cond_t announcelist_addition;
882         AST_LIST_HEAD_NOLOCK(, announce_listitem) announcelist;
883         ast_mutex_t announcelistlock;
884 };
885
886 static AST_LIST_HEAD_STATIC(confs, ast_conference);
887
888 static unsigned int conf_map[1024] = {0, };
889
890 struct volume {
891         int desired;                            /*!< Desired volume adjustment */
892         int actual;                             /*!< Actual volume adjustment (for channels that can't adjust) */
893 };
894
895 /*! \brief The MeetMe User object */
896 struct ast_conf_user {
897         int user_no;                            /*!< User Number */
898         struct ast_flags64 userflags;           /*!< Flags as set in the conference */
899         int adminflags;                         /*!< Flags set by the Admin */
900         struct ast_channel *chan;               /*!< Connected channel */
901         int talking;                            /*!< Is user talking */
902         int dahdichannel;                       /*!< Is a DAHDI channel */
903         char usrvalue[50];                      /*!< Custom User Value */
904         char namerecloc[PATH_MAX];              /*!< Name Recorded file Location */
905         time_t jointime;                        /*!< Time the user joined the conference */
906         time_t kicktime;                        /*!< Time the user will be kicked from the conference */
907         struct timeval start_time;              /*!< Time the user entered into the conference */
908         long timelimit;                         /*!< Time limit for the user to be in the conference L(x:y:z) */
909         long play_warning;                      /*!< Play a warning when 'y' ms are left */
910         long warning_freq;                      /*!< Repeat the warning every 'z' ms */
911         const char *warning_sound;              /*!< File to play as warning if 'y' is defined */
912         const char *end_sound;                  /*!< File to play when time is up. */
913         struct volume talk;
914         struct volume listen;
915         AST_LIST_ENTRY(ast_conf_user) list;
916 };
917
918 enum sla_which_trunk_refs {
919         ALL_TRUNK_REFS,
920         INACTIVE_TRUNK_REFS,
921 };
922
923 enum sla_trunk_state {
924         SLA_TRUNK_STATE_IDLE,
925         SLA_TRUNK_STATE_RINGING,
926         SLA_TRUNK_STATE_UP,
927         SLA_TRUNK_STATE_ONHOLD,
928         SLA_TRUNK_STATE_ONHOLD_BYME,
929 };
930
931 enum sla_hold_access {
932         /*! This means that any station can put it on hold, and any station
933          * can retrieve the call from hold. */
934         SLA_HOLD_OPEN,
935         /*! This means that only the station that put the call on hold may
936          * retrieve it from hold. */
937         SLA_HOLD_PRIVATE,
938 };
939
940 struct sla_trunk_ref;
941
942 struct sla_station {
943         AST_RWLIST_ENTRY(sla_station) entry;
944         AST_DECLARE_STRING_FIELDS(
945                 AST_STRING_FIELD(name);
946                 AST_STRING_FIELD(device);
947                 AST_STRING_FIELD(autocontext);
948         );
949         AST_LIST_HEAD_NOLOCK(, sla_trunk_ref) trunks;
950         struct ast_dial *dial;
951         /*! Ring timeout for this station, for any trunk.  If a ring timeout
952          *  is set for a specific trunk on this station, that will take
953          *  priority over this value. */
954         unsigned int ring_timeout;
955         /*! Ring delay for this station, for any trunk.  If a ring delay
956          *  is set for a specific trunk on this station, that will take
957          *  priority over this value. */
958         unsigned int ring_delay;
959         /*! This option uses the values in the sla_hold_access enum and sets the
960          * access control type for hold on this station. */
961         unsigned int hold_access:1;
962         /*! Mark used during reload processing */
963         unsigned int mark:1;
964 };
965
966 /*!
967  * \brief A reference to a station
968  *
969  * This struct looks near useless at first glance.  However, its existence
970  * in the list of stations in sla_trunk means that this station references
971  * that trunk.  We use the mark to keep track of whether it needs to be
972  * removed from the sla_trunk's list of stations during a reload.
973  */
974 struct sla_station_ref {
975         AST_LIST_ENTRY(sla_station_ref) entry;
976         struct sla_station *station;
977         /*! Mark used during reload processing */
978         unsigned int mark:1;
979 };
980
981 struct sla_trunk {
982         AST_DECLARE_STRING_FIELDS(
983                 AST_STRING_FIELD(name);
984                 AST_STRING_FIELD(device);
985                 AST_STRING_FIELD(autocontext);
986         );
987         AST_LIST_HEAD_NOLOCK(, sla_station_ref) stations;
988         /*! Number of stations that use this trunk */
989         unsigned int num_stations;
990         /*! Number of stations currently on a call with this trunk */
991         unsigned int active_stations;
992         /*! Number of stations that have this trunk on hold. */
993         unsigned int hold_stations;
994         struct ast_channel *chan;
995         unsigned int ring_timeout;
996         /*! If set to 1, no station will be able to join an active call with
997          *  this trunk. */
998         unsigned int barge_disabled:1;
999         /*! This option uses the values in the sla_hold_access enum and sets the
1000          * access control type for hold on this trunk. */
1001         unsigned int hold_access:1;
1002         /*! Whether this trunk is currently on hold, meaning that once a station
1003          *  connects to it, the trunk channel needs to have UNHOLD indicated to it. */
1004         unsigned int on_hold:1;
1005         /*! Mark used during reload processing */
1006         unsigned int mark:1;
1007 };
1008
1009 /*!
1010  * \brief A station's reference to a trunk
1011  *
1012  * An sla_station keeps a list of trunk_refs.  This holds metadata about the
1013  * stations usage of the trunk.
1014  */
1015 struct sla_trunk_ref {
1016         AST_LIST_ENTRY(sla_trunk_ref) entry;
1017         struct sla_trunk *trunk;
1018         enum sla_trunk_state state;
1019         struct ast_channel *chan;
1020         /*! Ring timeout to use when this trunk is ringing on this specific
1021          *  station.  This takes higher priority than a ring timeout set at
1022          *  the station level. */
1023         unsigned int ring_timeout;
1024         /*! Ring delay to use when this trunk is ringing on this specific
1025          *  station.  This takes higher priority than a ring delay set at
1026          *  the station level. */
1027         unsigned int ring_delay;
1028         /*! Mark used during reload processing */
1029         unsigned int mark:1;
1030 };
1031
1032 static struct ao2_container *sla_stations;
1033 static struct ao2_container *sla_trunks;
1034
1035 static const char sla_registrar[] = "SLA";
1036
1037 /*! \brief Event types that can be queued up for the SLA thread */
1038 enum sla_event_type {
1039         /*! A station has put the call on hold */
1040         SLA_EVENT_HOLD,
1041         /*! The state of a dial has changed */
1042         SLA_EVENT_DIAL_STATE,
1043         /*! The state of a ringing trunk has changed */
1044         SLA_EVENT_RINGING_TRUNK,
1045 };
1046
1047 struct sla_event {
1048         enum sla_event_type type;
1049         struct sla_station *station;
1050         struct sla_trunk_ref *trunk_ref;
1051         AST_LIST_ENTRY(sla_event) entry;
1052 };
1053
1054 /*! \brief A station that failed to be dialed
1055  * \note Only used by the SLA thread. */
1056 struct sla_failed_station {
1057         struct sla_station *station;
1058         struct timeval last_try;
1059         AST_LIST_ENTRY(sla_failed_station) entry;
1060 };
1061
1062 /*! \brief A trunk that is ringing */
1063 struct sla_ringing_trunk {
1064         struct sla_trunk *trunk;
1065         /*! The time that this trunk started ringing */
1066         struct timeval ring_begin;
1067         AST_LIST_HEAD_NOLOCK(, sla_station_ref) timed_out_stations;
1068         AST_LIST_ENTRY(sla_ringing_trunk) entry;
1069 };
1070
1071 enum sla_station_hangup {
1072         SLA_STATION_HANGUP_NORMAL,
1073         SLA_STATION_HANGUP_TIMEOUT,
1074 };
1075
1076 /*! \brief A station that is ringing */
1077 struct sla_ringing_station {
1078         struct sla_station *station;
1079         /*! The time that this station started ringing */
1080         struct timeval ring_begin;
1081         AST_LIST_ENTRY(sla_ringing_station) entry;
1082 };
1083
1084 /*!
1085  * \brief A structure for data used by the sla thread
1086  */
1087 static struct {
1088         /*! The SLA thread ID */
1089         pthread_t thread;
1090         ast_cond_t cond;
1091         ast_mutex_t lock;
1092         AST_LIST_HEAD_NOLOCK(, sla_ringing_trunk) ringing_trunks;
1093         AST_LIST_HEAD_NOLOCK(, sla_ringing_station) ringing_stations;
1094         AST_LIST_HEAD_NOLOCK(, sla_failed_station) failed_stations;
1095         AST_LIST_HEAD_NOLOCK(, sla_event) event_q;
1096         unsigned int stop:1;
1097         /*! Attempt to handle CallerID, even though it is known not to work
1098          *  properly in some situations. */
1099         unsigned int attempt_callerid:1;
1100 } sla = {
1101         .thread = AST_PTHREADT_NULL,
1102 };
1103
1104 /*! \brief The number of audio buffers to be allocated on pseudo channels
1105  *  when in a conference */
1106 static int audio_buffers;
1107
1108 /*! \brief Map 'volume' levels from -5 through +5 into decibel (dB)
1109  *    settings for channel drivers.
1110  *
1111  *  \note these are not a straight linear-to-dB
1112  *  conversion... the numbers have been modified
1113  *  to give the user a better level of adjustability.
1114  */
1115 static const char gain_map[] = {
1116         -15,
1117         -13,
1118         -10,
1119         -6,
1120         0,
1121         0,
1122         0,
1123         6,
1124         10,
1125         13,
1126         15,
1127 };
1128
1129 /* Routes the various meetme message types to the meetme stasis callback function to turn them into events */
1130 static struct stasis_message_router *meetme_event_message_router;
1131
1132 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_join_type);
1133 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_leave_type);
1134 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_end_type);
1135 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_mute_type);
1136 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_talking_type);
1137 STASIS_MESSAGE_TYPE_DEFN_LOCAL(meetme_talk_request_type);
1138
1139 static void meetme_stasis_cb(void *data, struct stasis_subscription *sub,
1140         struct stasis_message *message);
1141
1142 static void meetme_stasis_cleanup(void)
1143 {
1144         if (meetme_event_message_router) {
1145                 stasis_message_router_unsubscribe(meetme_event_message_router);
1146                 meetme_event_message_router = NULL;
1147         }
1148
1149         STASIS_MESSAGE_TYPE_CLEANUP(meetme_join_type);
1150         STASIS_MESSAGE_TYPE_CLEANUP(meetme_leave_type);
1151         STASIS_MESSAGE_TYPE_CLEANUP(meetme_end_type);
1152         STASIS_MESSAGE_TYPE_CLEANUP(meetme_mute_type);
1153         STASIS_MESSAGE_TYPE_CLEANUP(meetme_talking_type);
1154         STASIS_MESSAGE_TYPE_CLEANUP(meetme_talk_request_type);
1155 }
1156
1157 static int meetme_stasis_init(void)
1158 {
1159
1160         STASIS_MESSAGE_TYPE_INIT(meetme_join_type);
1161         STASIS_MESSAGE_TYPE_INIT(meetme_leave_type);
1162         STASIS_MESSAGE_TYPE_INIT(meetme_end_type);
1163         STASIS_MESSAGE_TYPE_INIT(meetme_mute_type);
1164         STASIS_MESSAGE_TYPE_INIT(meetme_talking_type);
1165         STASIS_MESSAGE_TYPE_INIT(meetme_talk_request_type);
1166
1167         meetme_event_message_router = stasis_message_router_create(
1168                 ast_channel_topic_all_cached());
1169
1170         if (!meetme_event_message_router) {
1171                 meetme_stasis_cleanup();
1172                 return -1;
1173         }
1174
1175         if (stasis_message_router_add(meetme_event_message_router,
1176                         meetme_join_type(),
1177                         meetme_stasis_cb,
1178                         NULL)) {
1179                 meetme_stasis_cleanup();
1180                 return -1;
1181         }
1182
1183         if (stasis_message_router_add(meetme_event_message_router,
1184                         meetme_leave_type(),
1185                         meetme_stasis_cb,
1186                         NULL)) {
1187                 meetme_stasis_cleanup();
1188                 return -1;
1189         }
1190
1191         if (stasis_message_router_add(meetme_event_message_router,
1192                         meetme_end_type(),
1193                         meetme_stasis_cb,
1194                         NULL)) {
1195                 meetme_stasis_cleanup();
1196                 return -1;
1197         }
1198
1199         if (stasis_message_router_add(meetme_event_message_router,
1200                         meetme_mute_type(),
1201                         meetme_stasis_cb,
1202                         NULL)) {
1203                 meetme_stasis_cleanup();
1204                 return -1;
1205         }
1206
1207         if (stasis_message_router_add(meetme_event_message_router,
1208                         meetme_talking_type(),
1209                         meetme_stasis_cb,
1210                         NULL)) {
1211                 meetme_stasis_cleanup();
1212                 return -1;
1213         }
1214
1215         if (stasis_message_router_add(meetme_event_message_router,
1216                         meetme_talk_request_type(),
1217                         meetme_stasis_cb,
1218                         NULL)) {
1219                 meetme_stasis_cleanup();
1220                 return -1;
1221         }
1222
1223         return 0;
1224 }
1225
1226 static void meetme_stasis_cb(void *data, struct stasis_subscription *sub,
1227         struct stasis_message *message)
1228 {
1229         struct ast_channel_blob *channel_blob = stasis_message_data(message);
1230         struct stasis_message_type *message_type;
1231         const char *event;
1232         const char *conference_num;
1233         const char *status;
1234         struct ast_json *json_cur;
1235         RAII_VAR(struct ast_str *, channel_text, NULL, ast_free);
1236         RAII_VAR(struct ast_str *, extra_text, NULL, ast_free);
1237
1238         if (!channel_blob) {
1239                 ast_assert(0);
1240                 return;
1241         }
1242
1243         message_type = stasis_message_type(message);
1244
1245         if (!message_type) {
1246                 ast_assert(0);
1247                 return;
1248         }
1249
1250         if (message_type == meetme_join_type()) {
1251                 event = "MeetmeJoin";
1252         } else if (message_type == meetme_leave_type()) {
1253                 event = "MeetmeLeave";
1254         } else if (message_type == meetme_end_type()) {
1255                 event = "MeetmeEnd";
1256         } else if (message_type == meetme_mute_type()) {
1257                 event = "MeetmeMute";
1258         } else if (message_type == meetme_talking_type()) {
1259                 event = "MeetmeTalking";
1260         } else if (message_type == meetme_talk_request_type()) {
1261                 event = "MeetmeTalkRequest";
1262         } else {
1263                 ast_assert(0);
1264                 return;
1265         }
1266
1267         if (!event) {
1268                 ast_assert(0);
1269                 return;
1270         }
1271
1272         conference_num = ast_json_string_get(ast_json_object_get(channel_blob->blob, "Meetme"));
1273         if (!conference_num) {
1274                 ast_assert(0);
1275                 return;
1276         }
1277
1278         status = ast_json_string_get(ast_json_object_get(channel_blob->blob, "status"));
1279         if (status) {
1280                 ast_str_append_event_header(&extra_text, "Status", status);
1281         }
1282
1283         if (channel_blob->snapshot) {
1284                 channel_text = ast_manager_build_channel_state_string(channel_blob->snapshot);
1285         }
1286
1287         if ((json_cur = ast_json_object_get(channel_blob->blob, "user"))) {
1288                 int user_number = ast_json_integer_get(json_cur);
1289                 RAII_VAR(struct ast_str *, user_prop_str, ast_str_create(32), ast_free);
1290                 if (!user_prop_str) {
1291                         return;
1292                 }
1293
1294                 ast_str_set(&user_prop_str, 0, "%d", user_number);
1295                 ast_str_append_event_header(&extra_text, "User", ast_str_buffer(user_prop_str));
1296
1297                 if ((json_cur = ast_json_object_get(channel_blob->blob, "duration"))) {
1298                         int duration = ast_json_integer_get(json_cur);
1299                         ast_str_set(&user_prop_str, 0, "%d", duration);
1300                         ast_str_append_event_header(&extra_text, "Duration", ast_str_buffer(user_prop_str));
1301                 }
1302
1303                 json_cur = NULL;
1304         }
1305
1306         manager_event(EVENT_FLAG_CALL, event,
1307                 "Meetme: %s\r\n"
1308                 "%s"
1309                 "%s",
1310                 conference_num,
1311                 channel_text ? ast_str_buffer(channel_text) : "",
1312                 extra_text ? ast_str_buffer(extra_text) : "");
1313 }
1314
1315 /*!
1316  * \internal
1317  * \brief Build a json object from a status value for inclusion in json extras for meetme_stasis_generate_msg
1318  * \since 12.0.0
1319  *
1320  * \param on if true, then status is on. Otherwise status is off
1321  * \retval NULL on failure to allocate the JSON blob.
1322  * \retval pointer to the JSON blob if successful.
1323  */
1324 static struct ast_json *status_to_json(int on)
1325 {
1326         struct ast_json *json_object = ast_json_pack("{s: s}",
1327                 "status", on ? "on" : "off");
1328
1329         return json_object;
1330 }
1331
1332 /*!
1333  * \internal
1334  * \brief Generate a stasis message associated with a meetme event
1335  * \since 12.0.0
1336  *
1337  * \param meetme_confere The conference responsible for generating this message
1338  * \param chan The channel involved in the message (NULL allowed)
1339  * \param user The conference user involved in the message (NULL allowed)
1340  * \param message_type the type the stasis message being generated
1341  * \param extras Additional json fields desired for inclusion
1342  */
1343 static void meetme_stasis_generate_msg(struct ast_conference *meetme_conference, struct ast_channel *chan,
1344         struct ast_conf_user *user, struct stasis_message_type *message_type, struct ast_json *extras)
1345 {
1346         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
1347         RAII_VAR(struct ast_json *, json_object, NULL, ast_json_unref);
1348
1349         json_object = ast_json_pack("{s: s}",
1350                 "Meetme", meetme_conference->confno);
1351
1352         if (!json_object) {
1353                 return;
1354         }
1355
1356         if (extras) {
1357                 ast_json_object_update(json_object, extras);
1358         }
1359
1360         if (user) {
1361                 struct timeval now = ast_tvnow();
1362                 long duration = (long)(now.tv_sec - user->jointime);
1363                 struct ast_json *json_user;
1364                 struct ast_json *json_user_duration;
1365
1366                 json_user = ast_json_integer_create(user->user_no);
1367                 if (!json_user || ast_json_object_set(json_object, "user", json_user)) {
1368                         return;
1369                 }
1370
1371                 if (duration > 0) {
1372                         json_user_duration = ast_json_integer_create(duration);
1373                         if (!json_user_duration
1374                                 || ast_json_object_set(json_object, "duration", json_user_duration)) {
1375                                 return;
1376                         }
1377                 }
1378         }
1379
1380         if (chan) {
1381                 ast_channel_lock(chan);
1382         }
1383         msg = ast_channel_blob_create(chan, message_type, json_object);
1384         if (chan) {
1385                 ast_channel_unlock(chan);
1386         }
1387
1388         if (!msg) {
1389                 return;
1390         }
1391
1392         stasis_publish(ast_channel_topic(chan), msg);
1393 }
1394
1395 static int admin_exec(struct ast_channel *chan, const char *data);
1396 static void *recordthread(void *args);
1397
1398 static const char *istalking(int x)
1399 {
1400         if (x > 0)
1401                 return "(talking)";
1402         else if (x < 0)
1403                 return "(unmonitored)";
1404         else
1405                 return "(not talking)";
1406 }
1407
1408 static int careful_write(int fd, unsigned char *data, int len, int block)
1409 {
1410         int res;
1411         int x;
1412
1413         while (len) {
1414                 if (block) {
1415                         x = DAHDI_IOMUX_WRITE | DAHDI_IOMUX_SIGEVENT;
1416                         res = ioctl(fd, DAHDI_IOMUX, &x);
1417                 } else
1418                         res = 0;
1419                 if (res >= 0)
1420                         res = write(fd, data, len);
1421                 if (res < 1) {
1422                         if (errno != EAGAIN) {
1423                                 ast_log(LOG_WARNING, "Failed to write audio data to conference: %s\n", strerror(errno));
1424                                 return -1;
1425                         } else
1426                                 return 0;
1427                 }
1428                 len -= res;
1429                 data += res;
1430         }
1431
1432         return 0;
1433 }
1434
1435 static int set_talk_volume(struct ast_conf_user *user, int volume)
1436 {
1437         char gain_adjust;
1438
1439         /* attempt to make the adjustment in the channel driver;
1440            if successful, don't adjust in the frame reading routine
1441         */
1442         gain_adjust = gain_map[volume + 5];
1443
1444         return ast_channel_setoption(user->chan, AST_OPTION_RXGAIN, &gain_adjust, sizeof(gain_adjust), 0);
1445 }
1446
1447 static int set_listen_volume(struct ast_conf_user *user, int volume)
1448 {
1449         char gain_adjust;
1450
1451         /* attempt to make the adjustment in the channel driver;
1452            if successful, don't adjust in the frame reading routine
1453         */
1454         gain_adjust = gain_map[volume + 5];
1455
1456         return ast_channel_setoption(user->chan, AST_OPTION_TXGAIN, &gain_adjust, sizeof(gain_adjust), 0);
1457 }
1458
1459 static void tweak_volume(struct volume *vol, enum volume_action action)
1460 {
1461         switch (action) {
1462         case VOL_UP:
1463                 switch (vol->desired) {
1464                 case 5:
1465                         break;
1466                 case 0:
1467                         vol->desired = 2;
1468                         break;
1469                 case -2:
1470                         vol->desired = 0;
1471                         break;
1472                 default:
1473                         vol->desired++;
1474                         break;
1475                 }
1476                 break;
1477         case VOL_DOWN:
1478                 switch (vol->desired) {
1479                 case -5:
1480                         break;
1481                 case 2:
1482                         vol->desired = 0;
1483                         break;
1484                 case 0:
1485                         vol->desired = -2;
1486                         break;
1487                 default:
1488                         vol->desired--;
1489                         break;
1490                 }
1491         }
1492 }
1493
1494 static void tweak_talk_volume(struct ast_conf_user *user, enum volume_action action)
1495 {
1496         tweak_volume(&user->talk, action);
1497         /* attempt to make the adjustment in the channel driver;
1498            if successful, don't adjust in the frame reading routine
1499         */
1500         if (!set_talk_volume(user, user->talk.desired))
1501                 user->talk.actual = 0;
1502         else
1503                 user->talk.actual = user->talk.desired;
1504 }
1505
1506 static void tweak_listen_volume(struct ast_conf_user *user, enum volume_action action)
1507 {
1508         tweak_volume(&user->listen, action);
1509         /* attempt to make the adjustment in the channel driver;
1510            if successful, don't adjust in the frame reading routine
1511         */
1512         if (!set_listen_volume(user, user->listen.desired))
1513                 user->listen.actual = 0;
1514         else
1515                 user->listen.actual = user->listen.desired;
1516 }
1517
1518 static void reset_volumes(struct ast_conf_user *user)
1519 {
1520         signed char zero_volume = 0;
1521
1522         ast_channel_setoption(user->chan, AST_OPTION_TXGAIN, &zero_volume, sizeof(zero_volume), 0);
1523         ast_channel_setoption(user->chan, AST_OPTION_RXGAIN, &zero_volume, sizeof(zero_volume), 0);
1524 }
1525
1526 static void conf_play(struct ast_channel *chan, struct ast_conference *conf, enum entrance_sound sound)
1527 {
1528         unsigned char *data;
1529         int len;
1530         int res = -1;
1531
1532         ast_test_suite_event_notify("CONFPLAY", "Channel: %s\r\n"
1533                 "Conference: %s\r\n"
1534                 "Marked: %d",
1535                 ast_channel_name(chan),
1536                 conf->confno,
1537                 conf->markedusers);
1538
1539         if (!ast_check_hangup(chan))
1540                 res = ast_autoservice_start(chan);
1541
1542         AST_LIST_LOCK(&confs);
1543
1544         switch(sound) {
1545         case ENTER:
1546                 data = enter;
1547                 len = sizeof(enter);
1548                 break;
1549         case LEAVE:
1550                 data = leave;
1551                 len = sizeof(leave);
1552                 break;
1553         default:
1554                 data = NULL;
1555                 len = 0;
1556         }
1557         if (data) {
1558                 careful_write(conf->fd, data, len, 1);
1559         }
1560
1561         AST_LIST_UNLOCK(&confs);
1562
1563         if (!res)
1564                 ast_autoservice_stop(chan);
1565 }
1566
1567 static int user_no_cmp(void *obj, void *arg, int flags)
1568 {
1569         struct ast_conf_user *user = obj;
1570         int *user_no = arg;
1571
1572         if (user->user_no == *user_no) {
1573                 return (CMP_MATCH | CMP_STOP);
1574         }
1575
1576         return 0;
1577 }
1578
1579 static int user_max_cmp(void *obj, void *arg, int flags)
1580 {
1581         struct ast_conf_user *user = obj;
1582         int *max_no = arg;
1583
1584         if (user->user_no > *max_no) {
1585                 *max_no = user->user_no;
1586         }
1587
1588         return 0;
1589 }
1590
1591 /*!
1592  * \brief Find or create a conference
1593  *
1594  * \param confno The conference name/number
1595  * \param pin The regular user pin
1596  * \param pinadmin The admin pin
1597  * \param make Make the conf if it doesn't exist
1598  * \param dynamic Mark the newly created conference as dynamic
1599  * \param refcount How many references to mark on the conference
1600  * \param chan The asterisk channel
1601  * \param test
1602  *
1603  * \return A pointer to the conference struct, or NULL if it wasn't found and
1604  *         make or dynamic were not set.
1605  */
1606 static struct ast_conference *build_conf(const char *confno, const char *pin,
1607         const char *pinadmin, int make, int dynamic, int refcount,
1608         const struct ast_channel *chan, struct ast_test *test)
1609 {
1610         struct ast_conference *cnf;
1611         struct dahdi_confinfo dahdic = { 0, };
1612         int confno_int = 0;
1613         struct ast_format_cap *cap_slin = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1614
1615         AST_LIST_LOCK(&confs);
1616
1617         AST_LIST_TRAVERSE(&confs, cnf, list) {
1618                 if (!strcmp(confno, cnf->confno))
1619                         break;
1620         }
1621
1622         if (cnf || (!make && !dynamic) || !cap_slin)
1623                 goto cnfout;
1624
1625         ast_format_cap_append(cap_slin, ast_format_slin, 0);
1626         /* Make a new one */
1627         cnf = ast_calloc(1, sizeof(*cnf));
1628         if (!cnf) {
1629                 goto cnfout;
1630         }
1631
1632         cnf->usercontainer = ao2_container_alloc_list(AO2_ALLOC_OPT_LOCK_MUTEX, 0,
1633                 NULL, user_no_cmp);
1634         if (!cnf->usercontainer) {
1635                 goto cnfout;
1636         }
1637
1638         ast_mutex_init(&cnf->playlock);
1639         ast_mutex_init(&cnf->listenlock);
1640         cnf->recordthread = AST_PTHREADT_NULL;
1641         ast_mutex_init(&cnf->recordthreadlock);
1642         cnf->announcethread = AST_PTHREADT_NULL;
1643         ast_mutex_init(&cnf->announcethreadlock);
1644         ast_copy_string(cnf->confno, confno, sizeof(cnf->confno));
1645         ast_copy_string(cnf->pin, pin, sizeof(cnf->pin));
1646         ast_copy_string(cnf->pinadmin, pinadmin, sizeof(cnf->pinadmin));
1647         ast_copy_string(cnf->uniqueid, ast_channel_uniqueid(chan), sizeof(cnf->uniqueid));
1648
1649         /* Setup a new dahdi conference */
1650         dahdic.confno = -1;
1651         dahdic.confmode = DAHDI_CONF_CONFANN | DAHDI_CONF_CONFANNMON;
1652         cnf->fd = open("/dev/dahdi/pseudo", O_RDWR);
1653         if (cnf->fd < 0 || ioctl(cnf->fd, DAHDI_SETCONF, &dahdic)) {
1654                 if (test) {
1655                         /* if we are creating a conference for a unit test, it is not neccesary
1656                          * to open a pseudo channel, so, if we fail continue creating
1657                          * the conference. */
1658                         ast_test_status_update(test, "Unable to open DAHDI pseudo device\n");
1659                 } else {
1660                         ast_log(LOG_WARNING, "Unable to open DAHDI pseudo device\n");
1661                         if (cnf->fd >= 0)
1662                                 close(cnf->fd);
1663                         ao2_ref(cnf->usercontainer, -1);
1664                         ast_mutex_destroy(&cnf->playlock);
1665                         ast_mutex_destroy(&cnf->listenlock);
1666                         ast_mutex_destroy(&cnf->recordthreadlock);
1667                         ast_mutex_destroy(&cnf->announcethreadlock);
1668                         ast_free(cnf);
1669                         cnf = NULL;
1670                         goto cnfout;
1671                 }
1672         }
1673
1674         cnf->dahdiconf = dahdic.confno;
1675
1676         /* Setup a new channel for playback of audio files */
1677         cnf->chan = ast_request("DAHDI", cap_slin, NULL, chan, "pseudo", NULL);
1678         if (cnf->chan) {
1679                 ast_set_read_format(cnf->chan, ast_format_slin);
1680                 ast_set_write_format(cnf->chan, ast_format_slin);
1681                 dahdic.chan = 0;
1682                 dahdic.confno = cnf->dahdiconf;
1683                 dahdic.confmode = DAHDI_CONF_CONFANN | DAHDI_CONF_CONFANNMON;
1684                 if (ioctl(ast_channel_fd(cnf->chan, 0), DAHDI_SETCONF, &dahdic)) {
1685                         if (test) {
1686                                 ast_test_status_update(test, "Error setting conference on pseudo channel\n");
1687                         }
1688                         ast_log(LOG_WARNING, "Error setting conference\n");
1689                         if (cnf->chan)
1690                                 ast_hangup(cnf->chan);
1691                         else
1692                                 close(cnf->fd);
1693                         ao2_ref(cnf->usercontainer, -1);
1694                         ast_mutex_destroy(&cnf->playlock);
1695                         ast_mutex_destroy(&cnf->listenlock);
1696                         ast_mutex_destroy(&cnf->recordthreadlock);
1697                         ast_mutex_destroy(&cnf->announcethreadlock);
1698                         ast_free(cnf);
1699                         cnf = NULL;
1700                         goto cnfout;
1701                 }
1702         }
1703
1704         /* Fill the conference struct */
1705         cnf->start = time(NULL);
1706         cnf->maxusers = 0x7fffffff;
1707         cnf->isdynamic = dynamic ? 1 : 0;
1708         ast_verb(3, "Created MeetMe conference %d for conference '%s'\n", cnf->dahdiconf, cnf->confno);
1709         AST_LIST_INSERT_HEAD(&confs, cnf, list);
1710
1711         /* Reserve conference number in map */
1712         if ((sscanf(cnf->confno, "%30d", &confno_int) == 1) && (confno_int >= 0 && confno_int < 1024))
1713                 conf_map[confno_int] = 1;
1714
1715 cnfout:
1716         ao2_cleanup(cap_slin);
1717         if (cnf)
1718                 ast_atomic_fetchadd_int(&cnf->refcount, refcount);
1719
1720         AST_LIST_UNLOCK(&confs);
1721
1722         return cnf;
1723 }
1724
1725 static char *complete_confno(const char *word, int state)
1726 {
1727         struct ast_conference *cnf;
1728         char *ret = NULL;
1729         int which = 0;
1730         int len = strlen(word);
1731
1732         AST_LIST_LOCK(&confs);
1733         AST_LIST_TRAVERSE(&confs, cnf, list) {
1734                 if (!strncmp(word, cnf->confno, len) && ++which > state) {
1735                         /* dup before releasing the lock */
1736                         ret = ast_strdup(cnf->confno);
1737                         break;
1738                 }
1739         }
1740         AST_LIST_UNLOCK(&confs);
1741         return ret;
1742 }
1743
1744 static char *complete_userno(struct ast_conference *cnf, const char *word, int state)
1745 {
1746         char usrno[50];
1747         struct ao2_iterator iter;
1748         struct ast_conf_user *usr;
1749         char *ret = NULL;
1750         int which = 0;
1751         int len = strlen(word);
1752
1753         iter = ao2_iterator_init(cnf->usercontainer, 0);
1754         for (; (usr = ao2_iterator_next(&iter)); ao2_ref(usr, -1)) {
1755                 snprintf(usrno, sizeof(usrno), "%d", usr->user_no);
1756                 if (!strncmp(word, usrno, len) && ++which > state) {
1757                         ao2_ref(usr, -1);
1758                         ret = ast_strdup(usrno);
1759                         break;
1760                 }
1761         }
1762         ao2_iterator_destroy(&iter);
1763         return ret;
1764 }
1765
1766 static char *complete_meetmecmd_mute_kick(const char *line, const char *word, int pos, int state)
1767 {
1768         if (pos == 2) {
1769                 return complete_confno(word, state);
1770         }
1771         if (pos == 3) {
1772                 int len = strlen(word);
1773                 char *ret = NULL;
1774                 char *saved = NULL;
1775                 char *myline;
1776                 char *confno;
1777                 struct ast_conference *cnf;
1778
1779                 if (!strncasecmp(word, "all", len)) {
1780                         if (state == 0) {
1781                                 return ast_strdup("all");
1782                         }
1783                         --state;
1784                 }
1785
1786                 /* Extract the confno from the command line. */
1787                 myline = ast_strdupa(line);
1788                 strtok_r(myline, " ", &saved);
1789                 strtok_r(NULL, " ", &saved);
1790                 confno = strtok_r(NULL, " ", &saved);
1791
1792                 AST_LIST_LOCK(&confs);
1793                 AST_LIST_TRAVERSE(&confs, cnf, list) {
1794                         if (!strcmp(confno, cnf->confno)) {
1795                                 ret = complete_userno(cnf, word, state);
1796                                 break;
1797                         }
1798                 }
1799                 AST_LIST_UNLOCK(&confs);
1800
1801                 return ret;
1802         }
1803         return NULL;
1804 }
1805
1806 static char *complete_meetmecmd_lock(const char *word, int pos, int state)
1807 {
1808         if (pos == 2) {
1809                 return complete_confno(word, state);
1810         }
1811         return NULL;
1812 }
1813
1814 static char *complete_meetmecmd_list(const char *line, const char *word, int pos, int state)
1815 {
1816         int len;
1817
1818         if (pos == 2) {
1819                 len = strlen(word);
1820                 if (!strncasecmp(word, STR_CONCISE, len)) {
1821                         if (state == 0) {
1822                                 return ast_strdup(STR_CONCISE);
1823                         }
1824                         --state;
1825                 }
1826
1827                 return complete_confno(word, state);
1828         }
1829         if (pos == 3 && state == 0) {
1830                 char *saved = NULL;
1831                 char *myline;
1832                 char *confno;
1833
1834                 /* Extract the confno from the command line. */
1835                 myline = ast_strdupa(line);
1836                 strtok_r(myline, " ", &saved);
1837                 strtok_r(NULL, " ", &saved);
1838                 confno = strtok_r(NULL, " ", &saved);
1839
1840                 if (!strcasecmp(confno, STR_CONCISE)) {
1841                         /* There is nothing valid in this position now. */
1842                         return NULL;
1843                 }
1844
1845                 len = strlen(word);
1846                 if (!strncasecmp(word, STR_CONCISE, len)) {
1847                         return ast_strdup(STR_CONCISE);
1848                 }
1849         }
1850         return NULL;
1851 }
1852
1853 static char *meetme_show_cmd(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
1854 {
1855         /* Process the command */
1856         struct ast_conf_user *user;
1857         struct ast_conference *cnf;
1858         int hr, min, sec;
1859         int total = 0;
1860         time_t now;
1861 #define MC_HEADER_FORMAT "%-14s %-14s %-10s %-8s  %-8s  %-6s\n"
1862 #define MC_DATA_FORMAT "%-12.12s   %4.4d              %4.4s       %02d:%02d:%02d  %-8s  %-6s\n"
1863
1864         switch (cmd) {
1865         case CLI_INIT:
1866                 e->command = "meetme list";
1867                 e->usage =
1868                         "Usage: meetme list [<confno>] [" STR_CONCISE "]\n"
1869                         "       List all conferences or a specific conference.\n";
1870                 return NULL;
1871         case CLI_GENERATE:
1872                 return complete_meetmecmd_list(a->line, a->word, a->pos, a->n);
1873         }
1874
1875         if (a->argc == 2 || (a->argc == 3 && !strcasecmp(a->argv[2], STR_CONCISE))) {
1876                 /* List all the conferences */
1877                 int concise = (a->argc == 3);
1878                 struct ast_str *marked_users;
1879
1880                 if (!(marked_users = ast_str_create(30))) {
1881                         return CLI_FAILURE;
1882                 }
1883
1884                 now = time(NULL);
1885                 AST_LIST_LOCK(&confs);
1886                 if (AST_LIST_EMPTY(&confs)) {
1887                         if (!concise) {
1888                                 ast_cli(a->fd, "No active MeetMe conferences.\n");
1889                         }
1890                         AST_LIST_UNLOCK(&confs);
1891                         ast_free(marked_users);
1892                         return CLI_SUCCESS;
1893                 }
1894                 if (!concise) {
1895                         ast_cli(a->fd, MC_HEADER_FORMAT, "Conf Num", "Parties", "Marked", "Activity", "Creation", "Locked");
1896                 }
1897                 AST_LIST_TRAVERSE(&confs, cnf, list) {
1898                         hr = (now - cnf->start) / 3600;
1899                         min = ((now - cnf->start) % 3600) / 60;
1900                         sec = (now - cnf->start) % 60;
1901                         if (!concise) {
1902                                 if (cnf->markedusers == 0) {
1903                                         ast_str_set(&marked_users, 0, "N/A ");
1904                                 } else {
1905                                         ast_str_set(&marked_users, 0, "%4.4d", cnf->markedusers);
1906                                 }
1907                                 ast_cli(a->fd, MC_DATA_FORMAT, cnf->confno, cnf->users,
1908                                         ast_str_buffer(marked_users), hr, min, sec,
1909                                         cnf->isdynamic ? "Dynamic" : "Static", cnf->locked ? "Yes" : "No");
1910                         } else {
1911                                 ast_cli(a->fd, "%s!%d!%d!%02d:%02d:%02d!%d!%d\n",
1912                                         cnf->confno,
1913                                         cnf->users,
1914                                         cnf->markedusers,
1915                                         hr, min, sec,
1916                                         cnf->isdynamic,
1917                                         cnf->locked);
1918                         }
1919
1920                         total += cnf->users;
1921                 }
1922                 AST_LIST_UNLOCK(&confs);
1923                 if (!concise) {
1924                         ast_cli(a->fd, "* Total number of MeetMe users: %d\n", total);
1925                 }
1926                 ast_free(marked_users);
1927                 return CLI_SUCCESS;
1928         }
1929         if (a->argc == 3 || (a->argc == 4 && !strcasecmp(a->argv[3], STR_CONCISE))) {
1930                 struct ao2_iterator user_iter;
1931                 int concise = (a->argc == 4);
1932
1933                 /* List all the users in a conference */
1934                 if (AST_LIST_EMPTY(&confs)) {
1935                         if (!concise) {
1936                                 ast_cli(a->fd, "No active MeetMe conferences.\n");
1937                         }
1938                         return CLI_SUCCESS;
1939                 }
1940                 /* Find the right conference */
1941                 AST_LIST_LOCK(&confs);
1942                 AST_LIST_TRAVERSE(&confs, cnf, list) {
1943                         if (strcmp(cnf->confno, a->argv[2]) == 0) {
1944                                 break;
1945                         }
1946                 }
1947                 if (!cnf) {
1948                         if (!concise)
1949                                 ast_cli(a->fd, "No such conference: %s.\n", a->argv[2]);
1950                         AST_LIST_UNLOCK(&confs);
1951                         return CLI_SUCCESS;
1952                 }
1953                 /* Show all the users */
1954                 time(&now);
1955                 user_iter = ao2_iterator_init(cnf->usercontainer, 0);
1956                 while((user = ao2_iterator_next(&user_iter))) {
1957                         hr = (now - user->jointime) / 3600;
1958                         min = ((now - user->jointime) % 3600) / 60;
1959                         sec = (now - user->jointime) % 60;
1960                         if (!concise) {
1961                                 ast_cli(a->fd, "User #: %-2.2d %12.12s %-20.20s Channel: %s %s %s %s %s %s %02d:%02d:%02d\n",
1962                                         user->user_no,
1963                                         S_COR(ast_channel_caller(user->chan)->id.number.valid, ast_channel_caller(user->chan)->id.number.str, "<unknown>"),
1964                                         S_COR(ast_channel_caller(user->chan)->id.name.valid, ast_channel_caller(user->chan)->id.name.str, "<no name>"),
1965                                         ast_channel_name(user->chan),
1966                                         ast_test_flag64(&user->userflags, CONFFLAG_ADMIN) ? "(Admin)" : "",
1967                                         ast_test_flag64(&user->userflags, CONFFLAG_MONITOR) ? "(Listen only)" : "",
1968                                         user->adminflags & ADMINFLAG_MUTED ? "(Admin Muted)" : user->adminflags & ADMINFLAG_SELFMUTED ? "(Muted)" : "",
1969                                         user->adminflags & ADMINFLAG_T_REQUEST ? "(Request to Talk)" : "",
1970                                         istalking(user->talking), hr, min, sec);
1971                         } else {
1972                                 ast_cli(a->fd, "%d!%s!%s!%s!%s!%s!%s!%s!%d!%02d:%02d:%02d\n",
1973                                         user->user_no,
1974                                         S_COR(ast_channel_caller(user->chan)->id.number.valid, ast_channel_caller(user->chan)->id.number.str, ""),
1975                                         S_COR(ast_channel_caller(user->chan)->id.name.valid, ast_channel_caller(user->chan)->id.name.str, ""),
1976                                         ast_channel_name(user->chan),
1977                                         ast_test_flag64(&user->userflags, CONFFLAG_ADMIN) ? "1" : "",
1978                                         ast_test_flag64(&user->userflags, CONFFLAG_MONITOR) ? "1" : "",
1979                                         user->adminflags & (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED) ? "1" : "",
1980                                         user->adminflags & ADMINFLAG_T_REQUEST ? "1" : "",
1981                                         user->talking, hr, min, sec);
1982                         }
1983                         ao2_ref(user, -1);
1984                 }
1985                 ao2_iterator_destroy(&user_iter);
1986                 if (!concise) {
1987                         ast_cli(a->fd, "%d users in that conference.\n", cnf->users);
1988                 }
1989                 AST_LIST_UNLOCK(&confs);
1990                 return CLI_SUCCESS;
1991         }
1992         return CLI_SHOWUSAGE;
1993 }
1994
1995
1996 static char *meetme_cmd_helper(struct ast_cli_args *a)
1997 {
1998         /* Process the command */
1999         struct ast_str *cmdline;
2000
2001         /* Max confno length */
2002         if (!(cmdline = ast_str_create(MAX_CONFNUM))) {
2003                 return CLI_FAILURE;
2004         }
2005
2006         ast_str_set(&cmdline, 0, "%s", a->argv[2]);     /* Argv 2: conference number */
2007         if (strcasestr(a->argv[1], "lock")) {
2008                 if (strcasecmp(a->argv[1], "lock") == 0) {
2009                         /* Lock */
2010                         ast_str_append(&cmdline, 0, ",L");
2011                 } else {
2012                         /* Unlock */
2013                         ast_str_append(&cmdline, 0, ",l");
2014                 }
2015         } else if (strcasestr(a->argv[1], "mute")) {
2016                 if (strcasecmp(a->argv[1], "mute") == 0) {
2017                         /* Mute */
2018                         if (strcasecmp(a->argv[3], "all") == 0) {
2019                                 ast_str_append(&cmdline, 0, ",N");
2020                         } else {
2021                                 ast_str_append(&cmdline, 0, ",M,%s", a->argv[3]);
2022                         }
2023                 } else {
2024                         /* Unmute */
2025                         if (strcasecmp(a->argv[3], "all") == 0) {
2026                                 ast_str_append(&cmdline, 0, ",n");
2027                         } else {
2028                                 ast_str_append(&cmdline, 0, ",m,%s", a->argv[3]);
2029                         }
2030                 }
2031         } else if (strcasecmp(a->argv[1], "kick") == 0) {
2032                 if (strcasecmp(a->argv[3], "all") == 0) {
2033                         /* Kick all */
2034                         ast_str_append(&cmdline, 0, ",K");
2035                 } else {
2036                         /* Kick a single user */
2037                         ast_str_append(&cmdline, 0, ",k,%s", a->argv[3]);
2038                 }
2039         } else {
2040                 /*
2041                  * Should never get here because it is already filtered by the
2042                  * callers.
2043                  */
2044                 ast_free(cmdline);
2045                 return CLI_SHOWUSAGE;
2046         }
2047
2048         ast_debug(1, "Cmdline: %s\n", ast_str_buffer(cmdline));
2049
2050         admin_exec(NULL, ast_str_buffer(cmdline));
2051         ast_free(cmdline);
2052
2053         return CLI_SUCCESS;
2054 }
2055
2056 static char *meetme_lock_cmd(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
2057 {
2058         switch (cmd) {
2059         case CLI_INIT:
2060                 e->command = "meetme {lock|unlock}";
2061                 e->usage =
2062                         "Usage: meetme lock|unlock <confno>\n"
2063                         "       Lock or unlock a conference to new users.\n";
2064                 return NULL;
2065         case CLI_GENERATE:
2066                 return complete_meetmecmd_lock(a->word, a->pos, a->n);
2067         }
2068
2069         if (a->argc != 3) {
2070                 return CLI_SHOWUSAGE;
2071         }
2072
2073         return meetme_cmd_helper(a);
2074 }
2075
2076 static char *meetme_kick_cmd(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
2077 {
2078         switch (cmd) {
2079         case CLI_INIT:
2080                 e->command = "meetme kick";
2081                 e->usage =
2082                         "Usage: meetme kick <confno> all|<userno>\n"
2083                         "       Kick a conference or a user in a conference.\n";
2084                 return NULL;
2085         case CLI_GENERATE:
2086                 return complete_meetmecmd_mute_kick(a->line, a->word, a->pos, a->n);
2087         }
2088
2089         if (a->argc != 4) {
2090                 return CLI_SHOWUSAGE;
2091         }
2092
2093         return meetme_cmd_helper(a);
2094 }
2095
2096 static char *meetme_mute_cmd(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
2097 {
2098         switch (cmd) {
2099         case CLI_INIT:
2100                 e->command = "meetme {mute|unmute}";
2101                 e->usage =
2102                         "Usage: meetme mute|unmute <confno> all|<userno>\n"
2103                         "       Mute or unmute a conference or a user in a conference.\n";
2104                 return NULL;
2105         case CLI_GENERATE:
2106                 return complete_meetmecmd_mute_kick(a->line, a->word, a->pos, a->n);
2107         }
2108
2109         if (a->argc != 4) {
2110                 return CLI_SHOWUSAGE;
2111         }
2112
2113         return meetme_cmd_helper(a);
2114 }
2115
2116 static const char *sla_hold_str(unsigned int hold_access)
2117 {
2118         const char *hold = "Unknown";
2119
2120         switch (hold_access) {
2121         case SLA_HOLD_OPEN:
2122                 hold = "Open";
2123                 break;
2124         case SLA_HOLD_PRIVATE:
2125                 hold = "Private";
2126         default:
2127                 break;
2128         }
2129
2130         return hold;
2131 }
2132
2133 static char *sla_show_trunks(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
2134 {
2135         struct ao2_iterator i;
2136         struct sla_trunk *trunk;
2137
2138         switch (cmd) {
2139         case CLI_INIT:
2140                 e->command = "sla show trunks";
2141                 e->usage =
2142                         "Usage: sla show trunks\n"
2143                         "       This will list all trunks defined in sla.conf\n";
2144                 return NULL;
2145         case CLI_GENERATE:
2146                 return NULL;
2147         }
2148
2149         ast_cli(a->fd, "\n"
2150                     "=============================================================\n"
2151                     "=== Configured SLA Trunks ===================================\n"
2152                     "=============================================================\n"
2153                     "===\n");
2154         i = ao2_iterator_init(sla_trunks, 0);
2155         for (; (trunk = ao2_iterator_next(&i)); ao2_ref(trunk, -1)) {
2156                 struct sla_station_ref *station_ref;
2157                 char ring_timeout[16] = "(none)";
2158
2159                 ao2_lock(trunk);
2160
2161                 if (trunk->ring_timeout) {
2162                         snprintf(ring_timeout, sizeof(ring_timeout), "%u Seconds", trunk->ring_timeout);
2163                 }
2164
2165                 ast_cli(a->fd, "=== ---------------------------------------------------------\n"
2166                             "=== Trunk Name:       %s\n"
2167                             "=== ==> Device:       %s\n"
2168                             "=== ==> AutoContext:  %s\n"
2169                             "=== ==> RingTimeout:  %s\n"
2170                             "=== ==> BargeAllowed: %s\n"
2171                             "=== ==> HoldAccess:   %s\n"
2172                             "=== ==> Stations ...\n",
2173                             trunk->name, trunk->device,
2174                             S_OR(trunk->autocontext, "(none)"),
2175                             ring_timeout,
2176                             trunk->barge_disabled ? "No" : "Yes",
2177                             sla_hold_str(trunk->hold_access));
2178
2179                 AST_LIST_TRAVERSE(&trunk->stations, station_ref, entry) {
2180                         ast_cli(a->fd, "===    ==> Station name: %s\n", station_ref->station->name);
2181                 }
2182
2183                 ast_cli(a->fd, "=== ---------------------------------------------------------\n===\n");
2184
2185                 ao2_unlock(trunk);
2186         }
2187         ao2_iterator_destroy(&i);
2188         ast_cli(a->fd, "=============================================================\n\n");
2189
2190         return CLI_SUCCESS;
2191 }
2192
2193 static const char *trunkstate2str(enum sla_trunk_state state)
2194 {
2195 #define S(e) case e: return # e;
2196         switch (state) {
2197         S(SLA_TRUNK_STATE_IDLE)
2198         S(SLA_TRUNK_STATE_RINGING)
2199         S(SLA_TRUNK_STATE_UP)
2200         S(SLA_TRUNK_STATE_ONHOLD)
2201         S(SLA_TRUNK_STATE_ONHOLD_BYME)
2202         }
2203         return "Uknown State";
2204 #undef S
2205 }
2206
2207 static char *sla_show_stations(struct ast_cli_entry *e, int cmd, struct ast_cli_args *a)
2208 {
2209         struct ao2_iterator i;
2210         struct sla_station *station;
2211
2212         switch (cmd) {
2213         case CLI_INIT:
2214                 e->command = "sla show stations";
2215                 e->usage =
2216                         "Usage: sla show stations\n"
2217                         "       This will list all stations defined in sla.conf\n";
2218                 return NULL;
2219         case CLI_GENERATE:
2220                 return NULL;
2221         }
2222
2223         ast_cli(a->fd, "\n"
2224                     "=============================================================\n"
2225                     "=== Configured SLA Stations =================================\n"
2226                     "=============================================================\n"
2227                     "===\n");
2228         i = ao2_iterator_init(sla_stations, 0);
2229         for (; (station = ao2_iterator_next(&i)); ao2_ref(station, -1)) {
2230                 struct sla_trunk_ref *trunk_ref;
2231                 char ring_timeout[16] = "(none)";
2232                 char ring_delay[16] = "(none)";
2233
2234                 ao2_lock(station);
2235
2236                 if (station->ring_timeout) {
2237                         snprintf(ring_timeout, sizeof(ring_timeout),
2238                                 "%u", station->ring_timeout);
2239                 }
2240                 if (station->ring_delay) {
2241                         snprintf(ring_delay, sizeof(ring_delay),
2242                                 "%u", station->ring_delay);
2243                 }
2244                 ast_cli(a->fd, "=== ---------------------------------------------------------\n"
2245                             "=== Station Name:    %s\n"
2246                             "=== ==> Device:      %s\n"
2247                             "=== ==> AutoContext: %s\n"
2248                             "=== ==> RingTimeout: %s\n"
2249                             "=== ==> RingDelay:   %s\n"
2250                             "=== ==> HoldAccess:  %s\n"
2251                             "=== ==> Trunks ...\n",
2252                             station->name, station->device,
2253                             S_OR(station->autocontext, "(none)"),
2254                             ring_timeout, ring_delay,
2255                             sla_hold_str(station->hold_access));
2256                 AST_LIST_TRAVERSE(&station->trunks, trunk_ref, entry) {
2257                         if (trunk_ref->ring_timeout) {
2258                                 snprintf(ring_timeout, sizeof(ring_timeout),
2259                                         "%u", trunk_ref->ring_timeout);
2260                         } else {
2261                                 strcpy(ring_timeout, "(none)");
2262                         }
2263                         if (trunk_ref->ring_delay) {
2264                                 snprintf(ring_delay, sizeof(ring_delay),
2265                                         "%u", trunk_ref->ring_delay);
2266                         } else {
2267                                 strcpy(ring_delay, "(none)");
2268                         }
2269
2270                         ast_cli(a->fd, "===    ==> Trunk Name: %s\n"
2271                     "===       ==> State:       %s\n"
2272                     "===       ==> RingTimeout: %s\n"
2273                     "===       ==> RingDelay:   %s\n",
2274                     trunk_ref->trunk->name,
2275                     trunkstate2str(trunk_ref->state),
2276                     ring_timeout, ring_delay);
2277                 }
2278                 ast_cli(a->fd, "=== ---------------------------------------------------------\n"
2279                             "===\n");
2280
2281                 ao2_unlock(station);
2282         }
2283         ao2_iterator_destroy(&i);
2284         ast_cli(a->fd, "============================================================\n"
2285                     "\n");
2286
2287         return CLI_SUCCESS;
2288 }
2289
2290 static struct ast_cli_entry cli_meetme[] = {
2291         AST_CLI_DEFINE(meetme_kick_cmd, "Kick a conference or a user in a conference."),
2292         AST_CLI_DEFINE(meetme_show_cmd, "List all conferences or a specific conference."),
2293         AST_CLI_DEFINE(meetme_lock_cmd, "Lock or unlock a conference to new users."),
2294         AST_CLI_DEFINE(meetme_mute_cmd, "Mute or unmute a conference or a user in a conference."),
2295         AST_CLI_DEFINE(sla_show_trunks, "Show SLA Trunks"),
2296         AST_CLI_DEFINE(sla_show_stations, "Show SLA Stations"),
2297 };
2298
2299 static void conf_flush(int fd, struct ast_channel *chan)
2300 {
2301         int x;
2302
2303         /* read any frames that may be waiting on the channel
2304            and throw them away
2305         */
2306         if (chan) {
2307                 struct ast_frame *f;
2308
2309                 /* when no frames are available, this will wait
2310                    for 1 millisecond maximum
2311                 */
2312                 while (ast_waitfor(chan, 1) > 0) {
2313                         f = ast_read(chan);
2314                         if (f)
2315                                 ast_frfree(f);
2316                         else /* channel was hung up or something else happened */
2317                                 break;
2318                 }
2319         }
2320
2321         /* flush any data sitting in the pseudo channel */
2322         x = DAHDI_FLUSH_ALL;
2323         if (ioctl(fd, DAHDI_FLUSH, &x))
2324                 ast_log(LOG_WARNING, "Error flushing channel\n");
2325
2326 }
2327
2328 /*! \brief Remove the conference from the list and free it.
2329
2330    We assume that this was called while holding conflock. */
2331 static int conf_free(struct ast_conference *conf)
2332 {
2333         int x;
2334         struct announce_listitem *item;
2335
2336         AST_LIST_REMOVE(&confs, conf, list);
2337
2338         meetme_stasis_generate_msg(conf, NULL, NULL, meetme_end_type(), NULL);
2339
2340         if (conf->recording == MEETME_RECORD_ACTIVE) {
2341                 conf->recording = MEETME_RECORD_TERMINATE;
2342                 AST_LIST_UNLOCK(&confs);
2343                 while (1) {
2344                         usleep(1);
2345                         AST_LIST_LOCK(&confs);
2346                         if (conf->recording == MEETME_RECORD_OFF)
2347                                 break;
2348                         AST_LIST_UNLOCK(&confs);
2349                 }
2350         }
2351
2352         for (x = 0; x < AST_FRAME_BITS; x++) {
2353                 if (conf->transframe[x])
2354                         ast_frfree(conf->transframe[x]);
2355                 if (conf->transpath[x])
2356                         ast_translator_free_path(conf->transpath[x]);
2357         }
2358         if (conf->announcethread != AST_PTHREADT_NULL) {
2359                 ast_mutex_lock(&conf->announcelistlock);
2360                 conf->announcethread_stop = 1;
2361                 ast_softhangup(conf->chan, AST_SOFTHANGUP_EXPLICIT);
2362                 ast_cond_signal(&conf->announcelist_addition);
2363                 ast_mutex_unlock(&conf->announcelistlock);
2364                 pthread_join(conf->announcethread, NULL);
2365
2366                 while ((item = AST_LIST_REMOVE_HEAD(&conf->announcelist, entry))) {
2367                         /* If it's a voicemail greeting file we don't want to remove it */
2368                         if (!item->vmrec){
2369                                 ast_filedelete(item->namerecloc, NULL);
2370                         }
2371                         ao2_ref(item, -1);
2372                 }
2373                 ast_mutex_destroy(&conf->announcelistlock);
2374         }
2375
2376         if (conf->origframe)
2377                 ast_frfree(conf->origframe);
2378         ast_hangup(conf->lchan);
2379         ast_hangup(conf->chan);
2380         if (conf->fd >= 0)
2381                 close(conf->fd);
2382         if (conf->recordingfilename) {
2383                 ast_free(conf->recordingfilename);
2384         }
2385         if (conf->usercontainer) {
2386                 ao2_ref(conf->usercontainer, -1);
2387         }
2388         if (conf->recordingformat) {
2389                 ast_free(conf->recordingformat);
2390         }
2391         ast_mutex_destroy(&conf->playlock);
2392         ast_mutex_destroy(&conf->listenlock);
2393         ast_mutex_destroy(&conf->recordthreadlock);
2394         ast_mutex_destroy(&conf->announcethreadlock);
2395         ast_free(conf);
2396
2397         return 0;
2398 }
2399
2400 static void conf_queue_dtmf(const struct ast_conference *conf,
2401         const struct ast_conf_user *sender, struct ast_frame *f)
2402 {
2403         struct ast_conf_user *user;
2404         struct ao2_iterator user_iter;
2405
2406         user_iter = ao2_iterator_init(conf->usercontainer, 0);
2407         while ((user = ao2_iterator_next(&user_iter))) {
2408                 if (user == sender) {
2409                         ao2_ref(user, -1);
2410                         continue;
2411                 }
2412                 if (ast_write(user->chan, f) < 0)
2413                         ast_log(LOG_WARNING, "Error writing frame to channel %s\n", ast_channel_name(user->chan));
2414                 ao2_ref(user, -1);
2415         }
2416         ao2_iterator_destroy(&user_iter);
2417 }
2418
2419 static void sla_queue_event_full(enum sla_event_type type,
2420         struct sla_trunk_ref *trunk_ref, struct sla_station *station, int lock)
2421 {
2422         struct sla_event *event;
2423
2424         if (sla.thread == AST_PTHREADT_NULL) {
2425                 ao2_ref(station, -1);
2426                 ao2_ref(trunk_ref, -1);
2427                 return;
2428         }
2429
2430         if (!(event = ast_calloc(1, sizeof(*event)))) {
2431                 ao2_ref(station, -1);
2432                 ao2_ref(trunk_ref, -1);
2433                 return;
2434         }
2435
2436         event->type = type;
2437         event->trunk_ref = trunk_ref;
2438         event->station = station;
2439
2440         if (!lock) {
2441                 AST_LIST_INSERT_TAIL(&sla.event_q, event, entry);
2442                 return;
2443         }
2444
2445         ast_mutex_lock(&sla.lock);
2446         AST_LIST_INSERT_TAIL(&sla.event_q, event, entry);
2447         ast_cond_signal(&sla.cond);
2448         ast_mutex_unlock(&sla.lock);
2449 }
2450
2451 static void sla_queue_event_nolock(enum sla_event_type type)
2452 {
2453         sla_queue_event_full(type, NULL, NULL, 0);
2454 }
2455
2456 static void sla_queue_event(enum sla_event_type type)
2457 {
2458         sla_queue_event_full(type, NULL, NULL, 1);
2459 }
2460
2461 /*! \brief Queue a SLA event from the conference */
2462 static void sla_queue_event_conf(enum sla_event_type type, struct ast_channel *chan,
2463         struct ast_conference *conf)
2464 {
2465         struct sla_station *station;
2466         struct sla_trunk_ref *trunk_ref = NULL;
2467         char *trunk_name;
2468         struct ao2_iterator i;
2469
2470         trunk_name = ast_strdupa(conf->confno);
2471         strsep(&trunk_name, "_");
2472         if (ast_strlen_zero(trunk_name)) {
2473                 ast_log(LOG_ERROR, "Invalid conference name for SLA - '%s'!\n", conf->confno);
2474                 return;
2475         }
2476
2477         i = ao2_iterator_init(sla_stations, 0);
2478         while ((station = ao2_iterator_next(&i))) {
2479                 ao2_lock(station);
2480                 AST_LIST_TRAVERSE(&station->trunks, trunk_ref, entry) {
2481                         if (trunk_ref->chan == chan && !strcmp(trunk_ref->trunk->name, trunk_name)) {
2482                                 ao2_ref(trunk_ref, 1);
2483                                 break;
2484                         }
2485                 }
2486                 ao2_unlock(station);
2487                 if (trunk_ref) {
2488                         /* station reference given to sla_queue_event_full() */
2489                         break;
2490                 }
2491                 ao2_ref(station, -1);
2492         }
2493         ao2_iterator_destroy(&i);
2494
2495         if (!trunk_ref) {
2496                 ast_debug(1, "Trunk not found for event!\n");
2497                 return;
2498         }
2499
2500         sla_queue_event_full(type, trunk_ref, station, 1);
2501 }
2502
2503 /*! \brief Decrement reference counts, as incremented by find_conf() */
2504 static int dispose_conf(struct ast_conference *conf)
2505 {
2506         int res = 0;
2507         int confno_int = 0;
2508
2509         AST_LIST_LOCK(&confs);
2510         if (ast_atomic_dec_and_test(&conf->refcount)) {
2511                 /* Take the conference room number out of an inuse state */
2512                 if ((sscanf(conf->confno, "%4d", &confno_int) == 1) && (confno_int >= 0 && confno_int < 1024)) {
2513                         conf_map[confno_int] = 0;
2514                 }
2515                 conf_free(conf);
2516                 res = 1;
2517         }
2518         AST_LIST_UNLOCK(&confs);
2519
2520         return res;
2521 }
2522
2523 static int rt_extend_conf(const char *confno)
2524 {
2525         char currenttime[32];
2526         char endtime[32];
2527         struct timeval now;
2528         struct ast_tm tm;
2529         struct ast_variable *var, *orig_var;
2530         char bookid[51];
2531
2532         if (!extendby) {
2533                 return 0;
2534         }
2535
2536         now = ast_tvnow();
2537
2538         ast_localtime(&now, &tm, NULL);
2539         ast_strftime(currenttime, sizeof(currenttime), DATE_FORMAT, &tm);
2540
2541         var = ast_load_realtime("meetme", "confno",
2542                 confno, "startTime<= ", currenttime,
2543                 "endtime>= ", currenttime, NULL);
2544
2545         orig_var = var;
2546
2547         /* Identify the specific RealTime conference */
2548         while (var) {
2549                 if (!strcasecmp(var->name, "bookid")) {
2550                         ast_copy_string(bookid, var->value, sizeof(bookid));
2551                 }
2552                 if (!strcasecmp(var->name, "endtime")) {
2553                         ast_copy_string(endtime, var->value, sizeof(endtime));
2554                 }
2555
2556                 var = var->next;
2557         }
2558         ast_variables_destroy(orig_var);
2559
2560         ast_strptime(endtime, DATE_FORMAT, &tm);
2561         now = ast_mktime(&tm, NULL);
2562
2563         now.tv_sec += extendby;
2564
2565         ast_localtime(&now, &tm, NULL);
2566         ast_strftime(currenttime, sizeof(currenttime), DATE_FORMAT, &tm);
2567         strcat(currenttime, "0"); /* Seconds needs to be 00 */
2568
2569         var = ast_load_realtime("meetme", "confno",
2570                 confno, "startTime<= ", currenttime,
2571                 "endtime>= ", currenttime, NULL);
2572
2573         /* If there is no conflict with extending the conference, update the DB */
2574         if (!var) {
2575                 ast_debug(3, "Trying to update the endtime of Conference %s to %s\n", confno, currenttime);
2576                 ast_update_realtime("meetme", "bookid", bookid, "endtime", currenttime, NULL);
2577                 return 0;
2578
2579         }
2580
2581         ast_variables_destroy(var);
2582         return -1;
2583 }
2584
2585 static void conf_start_moh(struct ast_channel *chan, const char *musicclass)
2586 {
2587         char *original_moh;
2588
2589         ast_channel_lock(chan);
2590         original_moh = ast_strdupa(ast_channel_musicclass(chan));
2591         ast_channel_musicclass_set(chan, musicclass);
2592         ast_channel_unlock(chan);
2593
2594         ast_moh_start(chan, original_moh, NULL);
2595
2596         ast_channel_lock(chan);
2597         ast_channel_musicclass_set(chan, original_moh);
2598         ast_channel_unlock(chan);
2599 }
2600
2601 static const char *get_announce_filename(enum announcetypes type)
2602 {
2603         switch (type) {
2604         case CONF_HASLEFT:
2605                 return "conf-hasleft";
2606                 break;
2607         case CONF_HASJOIN:
2608                 return "conf-hasjoin";
2609                 break;
2610         default:
2611                 return "";
2612         }
2613 }
2614
2615 static void *announce_thread(void *data)
2616 {
2617         struct announce_listitem *current;
2618         struct ast_conference *conf = data;
2619         int res;
2620         char filename[PATH_MAX] = "";
2621         AST_LIST_HEAD_NOLOCK(, announce_listitem) local_list;
2622         AST_LIST_HEAD_INIT_NOLOCK(&local_list);
2623
2624         while (!conf->announcethread_stop) {
2625                 ast_mutex_lock(&conf->announcelistlock);
2626                 if (conf->announcethread_stop) {
2627                         ast_mutex_unlock(&conf->announcelistlock);
2628                         break;
2629                 }
2630                 if (AST_LIST_EMPTY(&conf->announcelist))
2631                         ast_cond_wait(&conf->announcelist_addition, &conf->announcelistlock);
2632
2633                 AST_LIST_APPEND_LIST(&local_list, &conf->announcelist, entry);
2634                 AST_LIST_HEAD_INIT_NOLOCK(&conf->announcelist);
2635
2636                 ast_mutex_unlock(&conf->announcelistlock);
2637                 if (conf->announcethread_stop) {
2638                         break;
2639                 }
2640
2641                 for (res = 1; !conf->announcethread_stop && (current = AST_LIST_REMOVE_HEAD(&local_list, entry)); ao2_ref(current, -1)) {
2642                         ast_debug(1, "About to play %s\n", current->namerecloc);
2643                         if (!ast_fileexists(current->namerecloc, NULL, NULL))
2644                                 continue;
2645                         if ((current->confchan) && (current->confusers > 1) && !ast_check_hangup(current->confchan)) {
2646                                 if (!ast_streamfile(current->confchan, current->namerecloc, current->language))
2647                                         res = ast_waitstream(current->confchan, "");
2648                                 if (!res) {
2649                                         ast_copy_string(filename, get_announce_filename(current->announcetype), sizeof(filename));
2650                                         if (!ast_streamfile(current->confchan, filename, current->language))
2651                                                 ast_waitstream(current->confchan, "");
2652                                 }
2653                         }
2654                         if (current->announcetype == CONF_HASLEFT && current->announcetype && !current->vmrec) {
2655                                 /* only remove it if it isn't a VM recording file */
2656                                 ast_filedelete(current->namerecloc, NULL);
2657                         }
2658                 }
2659         }
2660
2661         /* thread marked to stop, clean up */
2662         while ((current = AST_LIST_REMOVE_HEAD(&local_list, entry))) {
2663                 /* only delete if it's a vm rec */
2664                 if (!current->vmrec) {
2665                         ast_filedelete(current->namerecloc, NULL);
2666                 }
2667                 ao2_ref(current, -1);
2668         }
2669         return NULL;
2670 }
2671
2672 static int can_write(struct ast_channel *chan, struct ast_flags64 *confflags)
2673 {
2674         if (!ast_test_flag64(confflags, CONFFLAG_NO_AUDIO_UNTIL_UP)) {
2675                 return 1;
2676         }
2677
2678         return (ast_channel_state(chan) == AST_STATE_UP);
2679 }
2680
2681 static void send_talking_event(struct ast_channel *chan, struct ast_conference *conf, struct ast_conf_user *user, int talking)
2682 {
2683         RAII_VAR(struct ast_json *, status_blob, status_to_json(talking), ast_json_unref);
2684         meetme_stasis_generate_msg(conf, chan, user, meetme_talking_type(), status_blob);
2685 }
2686
2687 static void set_user_talking(struct ast_channel *chan, struct ast_conference *conf, struct ast_conf_user *user, int talking, int monitor)
2688 {
2689         int last_talking = user->talking;
2690         if (last_talking == talking)
2691                 return;
2692
2693         user->talking = talking;
2694
2695         if (monitor) {
2696                 /* Check if talking state changed. Take care of -1 which means unmonitored */
2697                 int was_talking = (last_talking > 0);
2698                 int now_talking = (talking > 0);
2699                 if (was_talking != now_talking) {
2700                         send_talking_event(chan, conf, user, now_talking);
2701                 }
2702         }
2703 }
2704
2705 static int user_set_hangup_cb(void *obj, void *check_admin_arg, int flags)
2706 {
2707         struct ast_conf_user *user = obj;
2708         /* actual pointer contents of check_admin_arg is irrelevant */
2709
2710         if (!check_admin_arg || (check_admin_arg && !ast_test_flag64(&user->userflags, CONFFLAG_ADMIN))) {
2711                 user->adminflags |= ADMINFLAG_HANGUP;
2712         }
2713         return 0;
2714 }
2715
2716 static int user_set_kickme_cb(void *obj, void *check_admin_arg, int flags)
2717 {
2718         struct ast_conf_user *user = obj;
2719         /* actual pointer contents of check_admin_arg is irrelevant */
2720
2721         if (!check_admin_arg || (check_admin_arg && !ast_test_flag64(&user->userflags, CONFFLAG_ADMIN))) {
2722                 user->adminflags |= ADMINFLAG_KICKME;
2723         }
2724         return 0;
2725 }
2726
2727 static int user_set_unmuted_cb(void *obj, void *check_admin_arg, int flags)
2728 {
2729         struct ast_conf_user *user = obj;
2730         /* actual pointer contents of check_admin_arg is irrelevant */
2731
2732         if (!check_admin_arg || !ast_test_flag64(&user->userflags, CONFFLAG_ADMIN)) {
2733                 user->adminflags &= ~(ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED | ADMINFLAG_T_REQUEST);
2734         }
2735         return 0;
2736 }
2737
2738 static int user_set_muted_cb(void *obj, void *check_admin_arg, int flags)
2739 {
2740         struct ast_conf_user *user = obj;
2741         /* actual pointer contents of check_admin_arg is irrelevant */
2742
2743         if (!check_admin_arg || !ast_test_flag64(&user->userflags, CONFFLAG_ADMIN)) {
2744                 user->adminflags |= ADMINFLAG_MUTED;
2745         }
2746         return 0;
2747 }
2748
2749 enum menu_modes {
2750         MENU_DISABLED = 0,
2751         MENU_NORMAL,
2752         MENU_ADMIN,
2753         MENU_ADMIN_EXTENDED,
2754 };
2755
2756 /*! \internal
2757  * \brief Processes menu options for the standard menu (accessible through the 's' option for app_meetme)
2758  *
2759  * \param menu_mode a pointer to the currently active menu_mode.
2760  * \param dtmf a pointer to the dtmf value currently being processed against the menu.
2761  * \param conf the active conference for which the user has called the menu from.
2762  * \param confflags flags used by conf for various options
2763  * \param chan ast_channel belonging to the user who called the menu
2764  * \param user which meetme conference user invoked the menu
2765  */
2766 static void meetme_menu_normal(enum menu_modes *menu_mode, int *dtmf, struct ast_conference *conf, struct ast_flags64 *confflags, struct ast_channel *chan, struct ast_conf_user *user)
2767 {
2768         switch (*dtmf) {
2769         case '1': /* Un/Mute */
2770                 *menu_mode = MENU_DISABLED;
2771
2772                 /* user can only toggle the self-muted state */
2773                 user->adminflags ^= ADMINFLAG_SELFMUTED;
2774
2775                 /* they can't override the admin mute state */
2776                 if (ast_test_flag64(confflags, CONFFLAG_MONITOR) || (user->adminflags & (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED))) {
2777                         if (!ast_streamfile(chan, "conf-muted", ast_channel_language(chan))) {
2778                                 ast_waitstream(chan, "");
2779                         }
2780                 } else {
2781                         if (!ast_streamfile(chan, "conf-unmuted", ast_channel_language(chan))) {
2782                                 ast_waitstream(chan, "");
2783                         }
2784                 }
2785                 break;
2786
2787         case '2':
2788                 *menu_mode = MENU_DISABLED;
2789                 if (user->adminflags & (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED)) {
2790                         user->adminflags |= ADMINFLAG_T_REQUEST;
2791                 }
2792
2793                 if (user->adminflags & ADMINFLAG_T_REQUEST) {
2794                         if (!ast_streamfile(chan, "beep", ast_channel_language(chan))) {
2795                                 ast_waitstream(chan, "");
2796                         }
2797                 }
2798                 break;
2799
2800         case '4':
2801                 tweak_listen_volume(user, VOL_DOWN);
2802                 break;
2803         case '5':
2804                 /* Extend RT conference */
2805                 if (rt_schedule) {
2806                         rt_extend_conf(conf->confno);
2807                 }
2808                 *menu_mode = MENU_DISABLED;
2809                 break;
2810
2811         case '6':
2812                 tweak_listen_volume(user, VOL_UP);
2813                 break;
2814
2815         case '7':
2816                 tweak_talk_volume(user, VOL_DOWN);
2817                 break;
2818
2819         case '8':
2820                 *menu_mode = MENU_DISABLED;
2821                 break;
2822
2823         case '9':
2824                 tweak_talk_volume(user, VOL_UP);
2825                 break;
2826
2827         default:
2828                 *menu_mode = MENU_DISABLED;
2829                 if (!ast_streamfile(chan, "conf-errormenu", ast_channel_language(chan))) {
2830                         ast_waitstream(chan, "");
2831                 }
2832                 break;
2833         }
2834 }
2835
2836 /*! \internal
2837  * \brief Processes menu options for the adminstrator menu (accessible through the 's' option for app_meetme)
2838  *
2839  * \param menu_mode a pointer to the currently active menu_mode.
2840  * \param dtmf a pointer to the dtmf value currently being processed against the menu.
2841  * \param conf the active conference for which the user has called the menu from.
2842  * \param confflags flags used by conf for various options
2843  * \param chan ast_channel belonging to the user who called the menu
2844  * \param user which meetme conference user invoked the menu
2845  */
2846 static void meetme_menu_admin(enum menu_modes *menu_mode, int *dtmf, struct ast_conference *conf, struct ast_flags64 *confflags, struct ast_channel *chan, struct ast_conf_user *user)
2847 {
2848         switch(*dtmf) {
2849         case '1': /* Un/Mute */
2850                 *menu_mode = MENU_DISABLED;
2851                 /* for admin, change both admin and use flags */
2852                 if (user->adminflags & (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED)) {
2853                         user->adminflags &= ~(ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED);
2854                 } else {
2855                         user->adminflags |= (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED);
2856                 }
2857
2858                 if (ast_test_flag64(confflags, CONFFLAG_MONITOR) || (user->adminflags & (ADMINFLAG_MUTED | ADMINFLAG_SELFMUTED))) {
2859                         if (!ast_streamfile(chan, "conf-muted", ast_channel_language(chan))) {
2860                                 ast_waitstream(chan, "");
2861                         }
2862                 } else {
2863                         if (!ast_streamfile(chan, "conf-unmuted", ast_channel_language(chan))) {
2864                                 ast_waitstream(chan, "");
2865                         }
2866                 }
2867                 break;
2868
2869         case '2': /* Un/Lock the Conference */
2870                 *menu_mode = MENU_DISABLED;
2871                 if (conf->locked) {
2872                         conf->locked = 0;
2873                         if (!ast_streamfile(chan, "conf-unlockednow", ast_channel_language(chan))) {
2874                                 ast_waitstream(chan, "");
2875                         }
2876                 } else {
2877                         conf->locked = 1;
2878                         if (!ast_streamfile(chan, "conf-lockednow", ast_channel_language(chan))) {
2879                                 ast_waitstream(chan, "");
2880                         }
2881                 }
2882                 break;
2883
2884         case '3': /* Eject last user */
2885         {
2886                 struct ast_conf_user *usr = NULL;
2887                 int max_no = 0;
2888                 ao2_callback(conf->usercontainer, OBJ_NODATA, user_max_cmp, &max_no);
2889                 *menu_mode = MENU_DISABLED;
2890                 usr = ao2_find(conf->usercontainer, &max_no, 0);
2891                 if ((ast_channel_name(usr->chan) == ast_channel_name(chan)) || ast_test_flag64(&usr->userflags, CONFFLAG_ADMIN)) {
2892                         if (!ast_streamfile(chan, "conf-errormenu", ast_channel_language(chan))) {
2893                                 ast_waitstream(chan, "");
2894                         }
2895                 } else {
2896                         usr->adminflags |= ADMINFLAG_KICKME;
2897                 }
2898                 ao2_ref(usr, -1);
2899                 ast_stopstream(chan);
2900                 break;
2901         }
2902
2903         case '4':
2904                 tweak_listen_volume(user, VOL_DOWN);
2905                 break;
2906
2907         case '5':
2908                 /* Extend RT conference */
2909                 if (rt_schedule) {
2910                         if (!rt_extend_conf(conf->confno)) {
2911                                 if (!ast_streamfile(chan, "conf-extended", ast_channel_language(chan))) {
2912                                         ast_waitstream(chan, "");
2913                                 }
2914                         } else {
2915                                 if (!ast_streamfile(chan, "conf-nonextended", ast_channel_language(chan))) {
2916                                         ast_waitstream(chan, "");
2917                                 }
2918                         }
2919                         ast_stopstream(chan);
2920                 }
2921                 *menu_mode = MENU_DISABLED;
2922                 break;
2923
2924         case '6':
2925                 tweak_listen_volume(user, VOL_UP);
2926                 break;
2927
2928         case '7':
2929                 tweak_talk_volume(user, VOL_DOWN);
2930                 break;
2931
2932         case '8':
2933                 if (!ast_streamfile(chan, "conf-adminmenu-menu8", ast_channel_language(chan))) {
2934                         /* If the user provides DTMF while playing the sound, we want to drop right into the extended menu function with new DTMF once we get out of here. */
2935                         *dtmf = ast_waitstream(chan, AST_DIGIT_ANY);
2936                         ast_stopstream(chan);
2937                 }
2938                 *menu_mode = MENU_ADMIN_EXTENDED;
2939                 break;
2940
2941         case '9':
2942                 tweak_talk_volume(user, VOL_UP);
2943                 break;
2944         default:
2945                 *menu_mode = MENU_DISABLED;
2946                 /* Play an error message! */
2947                 if (!ast_streamfile(chan, "conf-errormenu", ast_channel_language(chan))) {
2948                         ast_waitstream(chan, "");
2949                 }
2950                 break;
2951         }
2952
2953 }
2954
2955 /*! \internal
2956  * \brief Processes menu options for the extended administrator menu (accessible through option 8 on the administrator menu)
2957  *
2958  * \param menu_mode a pointer to the currently active menu_mode.
2959  * \param dtmf a pointer to the dtmf value currently being processed against the menu.
2960  * \param conf the active conference for which the user has called the menu from.
2961  * \param confflags flags used by conf for various options
2962  * \param chan ast_channel belonging to the user who called the menu
2963  * \param user which meetme conference user invoked the menu
2964  * \param recordingtmp character buffer which may hold the name of the conference recording file
2965  */
2966 static void meetme_menu_admin_extended(enum menu_modes *menu_mode, int *dtmf,
2967         struct ast_conference *conf, struct ast_flags64 *confflags, struct ast_channel *chan,
2968         struct ast_conf_user *user, char *recordingtmp, int recordingtmp_size,
2969         struct ast_format_cap *cap_slin)
2970 {