Fix a crash caused by muting and unmuting a channel in ARI without specifying a direc...
[asterisk/asterisk.git] / res / ari / resource_channels.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 2012 - 2013, Digium, Inc.
5  *
6  * David M. Lee, II <dlee@digium.com>
7  *
8  * See http://www.asterisk.org for more information about
9  * the Asterisk project. Please do not directly contact
10  * any of the maintainers of this project for assistance;
11  * the project provides a web site, mailing lists and IRC
12  * channels for your use.
13  *
14  * This program is free software, distributed under the terms of
15  * the GNU General Public License Version 2. See the LICENSE file
16  * at the top of the source tree.
17  */
18
19 /*! \file
20  *
21  * \brief Implementation for ARI stubs.
22  *
23  * \author David M. Lee, II <dlee@digium.com>
24  */
25
26 /*** MODULEINFO
27         <depend type="module">res_stasis_app_playback</depend>
28         <support_level>core</support_level>
29  ***/
30
31 #include "asterisk.h"
32
33 ASTERISK_FILE_VERSION(__FILE__, "$Revision$")
34
35 #include "asterisk/file.h"
36 #include "asterisk/pbx.h"
37 #include "asterisk/dial.h"
38 #include "asterisk/bridge.h"
39 #include "asterisk/callerid.h"
40 #include "asterisk/stasis_app.h"
41 #include "asterisk/stasis_app_playback.h"
42 #include "asterisk/stasis_app_recording.h"
43 #include "asterisk/stasis_channels.h"
44 #include "resource_channels.h"
45
46 #include <limits.h>
47
48 /*!
49  * \brief Finds the control object for a channel, filling the response with an
50  * error, if appropriate.
51  * \param[out] response Response to fill with an error if control is not found.
52  * \param channel_id ID of the channel to lookup.
53  * \return Channel control object.
54  * \return \c NULL if control object does not exist.
55  */
56 static struct stasis_app_control *find_control(
57         struct ast_ari_response *response,
58         const char *channel_id)
59 {
60         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
61
62         ast_assert(response != NULL);
63
64         control = stasis_app_control_find_by_channel_id(channel_id);
65         if (control == NULL) {
66                 /* Distinguish between 404 and 409 errors */
67                 RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
68                 chan = ast_channel_get_by_name(channel_id);
69                 if (chan == NULL) {
70                         ast_ari_response_error(response, 404, "Not Found",
71                                    "Channel not found");
72                         return NULL;
73                 }
74
75                 ast_ari_response_error(response, 409, "Conflict",
76                            "Channel not in Stasis application");
77                 return NULL;
78         }
79
80         ao2_ref(control, +1);
81         return control;
82 }
83
84 void ast_ari_dial(struct ast_variable *headers, struct ast_dial_args *args, struct ast_ari_response *response)
85 {
86         struct stasis_app_control *control;
87
88         control = find_control(response, args->channel_id);
89         if (control == NULL) {
90                 return;
91         }
92
93         if (stasis_app_control_dial(control, args->endpoint, args->extension, args->context, args->timeout)) {
94                 ast_ari_response_alloc_failed(response);
95                 return;
96         }
97
98         ast_ari_response_no_content(response);
99 }
100
101 void ast_ari_continue_in_dialplan(
102         struct ast_variable *headers,
103         struct ast_continue_in_dialplan_args *args,
104         struct ast_ari_response *response)
105 {
106         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
107
108         ast_assert(response != NULL);
109
110         control = find_control(response, args->channel_id);
111         if (control == NULL) {
112                 return;
113         }
114
115         if (stasis_app_control_continue(control, args->context, args->extension, args->priority)) {
116                 ast_ari_response_alloc_failed(response);
117                 return;
118         }
119
120         ast_ari_response_no_content(response);
121 }
122
123 void ast_ari_answer_channel(struct ast_variable *headers,
124                                 struct ast_answer_channel_args *args,
125                                 struct ast_ari_response *response)
126 {
127         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
128
129         control = find_control(response, args->channel_id);
130         if (control == NULL) {
131                 return;
132         }
133
134         if (stasis_app_control_answer(control) != 0) {
135                 ast_ari_response_error(
136                         response, 500, "Internal Server Error",
137                         "Failed to answer channel");
138                 return;
139         }
140
141         ast_ari_response_no_content(response);
142 }
143
144 void ast_ari_mute_channel(struct ast_variable *headers, struct ast_mute_channel_args *args, struct ast_ari_response *response)
145 {
146         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
147         unsigned int direction = 0;
148         enum ast_frame_type frametype = AST_FRAME_VOICE;
149
150         control = find_control(response, args->channel_id);
151         if (control == NULL) {
152                 return;
153         }
154
155         if (ast_strlen_zero(args->direction)) {
156                 ast_ari_response_error(
157                         response, 400, "Bad Request",
158                         "Direction is required");
159                 return;
160         }
161
162         if (!strcmp(args->direction, "in")) {
163                 direction = AST_MUTE_DIRECTION_READ;
164         } else if (!strcmp(args->direction, "out")) {
165                 direction = AST_MUTE_DIRECTION_WRITE;
166         } else if (!strcmp(args->direction, "both")) {
167                 direction = AST_MUTE_DIRECTION_READ | AST_MUTE_DIRECTION_WRITE;
168         } else {
169                 ast_ari_response_error(
170                         response, 400, "Bad Request",
171                         "Invalid direction specified");
172                 return;
173         }
174
175         stasis_app_control_mute(control, direction, frametype);
176
177         ast_ari_response_no_content(response);
178 }
179
180 void ast_ari_unmute_channel(struct ast_variable *headers, struct ast_unmute_channel_args *args, struct ast_ari_response *response)
181 {
182         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
183         unsigned int direction = 0;
184         enum ast_frame_type frametype = AST_FRAME_VOICE;
185
186         control = find_control(response, args->channel_id);
187         if (control == NULL) {
188                 return;
189         }
190
191         if (ast_strlen_zero(args->direction)) {
192                 ast_ari_response_error(
193                         response, 400, "Bad Request",
194                         "Direction is required");
195                 return;
196         }
197
198         if (!strcmp(args->direction, "in")) {
199                 direction = AST_MUTE_DIRECTION_READ;
200         } else if (!strcmp(args->direction, "out")) {
201                 direction = AST_MUTE_DIRECTION_WRITE;
202         } else if (!strcmp(args->direction, "both")) {
203                 direction = AST_MUTE_DIRECTION_READ | AST_MUTE_DIRECTION_WRITE;
204         } else {
205                 ast_ari_response_error(
206                         response, 400, "Bad Request",
207                         "Invalid direction specified");
208                 return;
209         }
210
211         stasis_app_control_unmute(control, direction, frametype);
212
213         ast_ari_response_no_content(response);
214 }
215
216 void ast_ari_hold_channel(struct ast_variable *headers, struct ast_hold_channel_args *args, struct ast_ari_response *response)
217 {
218         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
219
220         control = find_control(response, args->channel_id);
221         if (control == NULL) {
222                 /* Response filled in by find_control */
223                 return;
224         }
225
226         stasis_app_control_hold(control);
227
228         ast_ari_response_no_content(response);
229 }
230
231 void ast_ari_unhold_channel(struct ast_variable *headers, struct ast_unhold_channel_args *args, struct ast_ari_response *response)
232 {
233         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
234
235         control = find_control(response, args->channel_id);
236         if (control == NULL) {
237                 /* Response filled in by find_control */
238                 return;
239         }
240
241         stasis_app_control_unhold(control);
242
243         ast_ari_response_no_content(response);
244 }
245
246 void ast_ari_moh_start_channel(struct ast_variable *headers, struct ast_moh_start_channel_args *args, struct ast_ari_response *response)
247 {
248         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
249
250         control = find_control(response, args->channel_id);
251         if (control == NULL) {
252                 /* Response filled in by find_control */
253                 return;
254         }
255
256         stasis_app_control_moh_start(control, args->moh_class);
257         ast_ari_response_no_content(response);
258 }
259
260 void ast_ari_moh_stop_channel(struct ast_variable *headers, struct ast_moh_stop_channel_args *args, struct ast_ari_response *response)
261 {
262         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
263
264         control = find_control(response, args->channel_id);
265         if (control == NULL) {
266                 /* Response filled in by find_control */
267                 return;
268         }
269
270         stasis_app_control_moh_stop(control);
271         ast_ari_response_no_content(response);
272 }
273
274 void ast_ari_play_on_channel(struct ast_variable *headers,
275         struct ast_play_on_channel_args *args,
276         struct ast_ari_response *response)
277 {
278         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
279         RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
280         RAII_VAR(struct stasis_app_playback *, playback, NULL, ao2_cleanup);
281         RAII_VAR(char *, playback_url, NULL, ast_free);
282         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
283         const char *language;
284
285         ast_assert(response != NULL);
286
287         control = find_control(response, args->channel_id);
288         if (control == NULL) {
289                 /* Response filled in by find_control */
290                 return;
291         }
292
293         snapshot = stasis_app_control_get_snapshot(control);
294         if (!snapshot) {
295                 ast_ari_response_error(
296                         response, 404, "Not Found",
297                         "Channel not found");
298                 return;
299         }
300
301         if (args->skipms < 0) {
302                 ast_ari_response_error(
303                         response, 400, "Bad Request",
304                         "skipms cannot be negative");
305                 return;
306         }
307
308         if (args->offsetms < 0) {
309                 ast_ari_response_error(
310                         response, 400, "Bad Request",
311                         "offsetms cannot be negative");
312                 return;
313         }
314
315         language = S_OR(args->lang, snapshot->language);
316
317         playback = stasis_app_control_play_uri(control, args->media, language,
318                 args->channel_id, STASIS_PLAYBACK_TARGET_CHANNEL, args->skipms, args->offsetms);
319         if (!playback) {
320                 ast_ari_response_error(
321                         response, 500, "Internal Server Error",
322                         "Failed to queue media for playback");
323                 return;
324         }
325
326         ast_asprintf(&playback_url, "/playback/%s",
327                 stasis_app_playback_get_id(playback));
328         if (!playback_url) {
329                 ast_ari_response_error(
330                         response, 500, "Internal Server Error",
331                         "Out of memory");
332                 return;
333         }
334
335         json = stasis_app_playback_to_json(playback);
336         if (!json) {
337                 ast_ari_response_error(
338                         response, 500, "Internal Server Error",
339                         "Out of memory");
340                 return;
341         }
342
343         ast_ari_response_created(response, playback_url, json);
344 }
345
346 void ast_ari_record_channel(struct ast_variable *headers,
347         struct ast_record_channel_args *args,
348         struct ast_ari_response *response)
349 {
350         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
351         RAII_VAR(struct ast_channel_snapshot *, snapshot, NULL, ao2_cleanup);
352         RAII_VAR(struct stasis_app_recording *, recording, NULL, ao2_cleanup);
353         RAII_VAR(char *, recording_url, NULL, ast_free);
354         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
355         RAII_VAR(struct stasis_app_recording_options *, options, NULL,
356                 ao2_cleanup);
357         RAII_VAR(char *, uri_encoded_name, NULL, ast_free);
358         size_t uri_name_maxlen;
359
360         ast_assert(response != NULL);
361
362         if (args->max_duration_seconds < 0) {
363                 ast_ari_response_error(
364                         response, 400, "Bad Request",
365                         "max_duration_seconds cannot be negative");
366                 return;
367         }
368
369         if (args->max_silence_seconds < 0) {
370                 ast_ari_response_error(
371                         response, 400, "Bad Request",
372                         "max_silence_seconds cannot be negative");
373                 return;
374         }
375
376         control = find_control(response, args->channel_id);
377         if (control == NULL) {
378                 /* Response filled in by find_control */
379                 return;
380         }
381
382         options = stasis_app_recording_options_create(args->name, args->format);
383         if (options == NULL) {
384                 ast_ari_response_error(
385                         response, 500, "Internal Server Error",
386                         "Out of memory");
387         }
388         options->max_silence_seconds = args->max_silence_seconds;
389         options->max_duration_seconds = args->max_duration_seconds;
390         options->terminate_on =
391                 stasis_app_recording_termination_parse(args->terminate_on);
392         options->if_exists =
393                 stasis_app_recording_if_exists_parse(args->if_exists);
394         options->beep = args->beep;
395
396         if (options->terminate_on == STASIS_APP_RECORDING_TERMINATE_INVALID) {
397                 ast_ari_response_error(
398                         response, 400, "Bad Request",
399                         "terminateOn invalid");
400                 return;
401         }
402
403         if (options->if_exists == -1) {
404                 ast_ari_response_error(
405                         response, 400, "Bad Request",
406                         "ifExists invalid");
407                 return;
408         }
409
410         recording = stasis_app_control_record(control, options);
411         if (recording == NULL) {
412                 switch(errno) {
413                 case EINVAL:
414                         /* While the arguments are invalid, we should have
415                          * caught them prior to calling record.
416                          */
417                         ast_ari_response_error(
418                                 response, 500, "Internal Server Error",
419                                 "Error parsing request");
420                         break;
421                 case EEXIST:
422                         ast_ari_response_error(response, 409, "Conflict",
423                                 "Recording '%s' already in progress",
424                                 args->name);
425                         break;
426                 case ENOMEM:
427                         ast_ari_response_error(
428                                 response, 500, "Internal Server Error",
429                                 "Out of memory");
430                         break;
431                 case EPERM:
432                         ast_ari_response_error(
433                                 response, 400, "Bad Request",
434                                 "Recording name invalid");
435                         break;
436                 default:
437                         ast_log(LOG_WARNING,
438                                 "Unrecognized recording error: %s\n",
439                                 strerror(errno));
440                         ast_ari_response_error(
441                                 response, 500, "Internal Server Error",
442                                 "Internal Server Error");
443                         break;
444                 }
445                 return;
446         }
447
448         uri_name_maxlen = strlen(args->name) * 3;
449         uri_encoded_name = ast_malloc(uri_name_maxlen);
450         if (!uri_encoded_name) {
451                 ast_ari_response_error(
452                         response, 500, "Internal Server Error",
453                         "Out of memory");
454                 return;
455         }
456         ast_uri_encode(args->name, uri_encoded_name, uri_name_maxlen,
457                 ast_uri_http);
458
459         ast_asprintf(&recording_url, "/recordings/live/%s", uri_encoded_name);
460         if (!recording_url) {
461                 ast_ari_response_error(
462                         response, 500, "Internal Server Error",
463                         "Out of memory");
464                 return;
465         }
466
467         json = stasis_app_recording_to_json(recording);
468         if (!json) {
469                 ast_ari_response_error(
470                         response, 500, "Internal Server Error",
471                         "Out of memory");
472                 return;
473         }
474
475         ast_ari_response_created(response, recording_url, json);
476 }
477
478 void ast_ari_get_channel(struct ast_variable *headers,
479                              struct ast_get_channel_args *args,
480                              struct ast_ari_response *response)
481 {
482         RAII_VAR(struct stasis_message *, msg, NULL, ao2_cleanup);
483         struct stasis_cache *cache;
484         struct ast_channel_snapshot *snapshot;
485
486         cache = ast_channel_cache();
487         if (!cache) {
488                 ast_ari_response_error(
489                         response, 500, "Internal Server Error",
490                         "Message bus not initialized");
491                 return;
492         }
493
494         msg = stasis_cache_get(cache, ast_channel_snapshot_type(),
495                                args->channel_id);
496         if (!msg) {
497                 ast_ari_response_error(
498                         response, 404, "Not Found",
499                         "Channel not found");
500                 return;
501         }
502
503         snapshot = stasis_message_data(msg);
504         ast_assert(snapshot != NULL);
505
506         ast_ari_response_ok(response,
507                                 ast_channel_snapshot_to_json(snapshot));
508 }
509
510 void ast_ari_delete_channel(struct ast_variable *headers,
511                                 struct ast_delete_channel_args *args,
512                                 struct ast_ari_response *response)
513 {
514         RAII_VAR(struct ast_channel *, chan, NULL, ao2_cleanup);
515
516         chan = ast_channel_get_by_name(args->channel_id);
517         if (chan == NULL) {
518                 ast_ari_response_error(
519                         response, 404, "Not Found",
520                         "Channel not found");
521                 return;
522         }
523
524         ast_softhangup(chan, AST_SOFTHANGUP_EXPLICIT);
525
526         ast_ari_response_no_content(response);
527 }
528
529 void ast_ari_get_channels(struct ast_variable *headers,
530                               struct ast_get_channels_args *args,
531                               struct ast_ari_response *response)
532 {
533         RAII_VAR(struct stasis_cache *, cache, NULL, ao2_cleanup);
534         RAII_VAR(struct ao2_container *, snapshots, NULL, ao2_cleanup);
535         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
536         struct ao2_iterator i;
537         void *obj;
538
539         cache = ast_channel_cache();
540         if (!cache) {
541                 ast_ari_response_error(
542                         response, 500, "Internal Server Error",
543                         "Message bus not initialized");
544                 return;
545         }
546         ao2_ref(cache, +1);
547
548         snapshots = stasis_cache_dump(cache, ast_channel_snapshot_type());
549         if (!snapshots) {
550                 ast_ari_response_alloc_failed(response);
551                 return;
552         }
553
554         json = ast_json_array_create();
555         if (!json) {
556                 ast_ari_response_alloc_failed(response);
557                 return;
558         }
559
560         i = ao2_iterator_init(snapshots, 0);
561         while ((obj = ao2_iterator_next(&i))) {
562                 RAII_VAR(struct stasis_message *, msg, obj, ao2_cleanup);
563                 struct ast_channel_snapshot *snapshot = stasis_message_data(msg);
564                 int r = ast_json_array_append(
565                         json, ast_channel_snapshot_to_json(snapshot));
566                 if (r != 0) {
567                         ast_ari_response_alloc_failed(response);
568                         return;
569                 }
570         }
571         ao2_iterator_destroy(&i);
572
573         ast_ari_response_ok(response, ast_json_ref(json));
574 }
575
576 void ast_ari_originate(struct ast_variable *headers,
577                            struct ast_originate_args *args,
578                            struct ast_ari_response *response)
579 {
580         char *dialtech;
581         char dialdevice[AST_CHANNEL_NAME];
582         char *caller_id = NULL;
583         char *cid_num = NULL;
584         char *cid_name = NULL;
585         int timeout = 30000;
586
587         char *stuff;
588
589         if (ast_strlen_zero(args->endpoint)) {
590                 ast_ari_response_error(response, 400, "Bad Request",
591                         "Endpoint must be specified");
592                 return;
593         }
594
595         dialtech = ast_strdupa(args->endpoint);
596         if ((stuff = strchr(dialtech, '/'))) {
597                 *stuff++ = '\0';
598                 ast_copy_string(dialdevice, stuff, sizeof(dialdevice));
599         }
600
601         if (ast_strlen_zero(dialtech) || ast_strlen_zero(dialdevice)) {
602                 ast_ari_response_error(response, 400, "Bad Request",
603                         "Invalid endpoint specified");
604                 return;
605         }
606
607         if (args->timeout > 0) {
608                 timeout = args->timeout * 1000;
609         } else if (args->timeout == -1) {
610                 timeout = -1;
611         }
612
613         if (!ast_strlen_zero(args->caller_id)) {
614                 caller_id = ast_strdupa(args->caller_id);
615                 ast_callerid_parse(caller_id, &cid_name, &cid_num);
616
617                 if (ast_is_shrinkable_phonenumber(cid_num)) {
618                         ast_shrink_phone_number(cid_num);
619                 }
620         }
621
622         if (!ast_strlen_zero(args->app)) {
623                 const char *app = "Stasis";
624
625                 RAII_VAR(struct ast_str *, appdata, ast_str_create(64), ast_free);
626
627                 if (!appdata) {
628                         ast_ari_response_alloc_failed(response);
629                         return;
630                 }
631
632                 ast_str_set(&appdata, 0, "%s", args->app);
633                 if (!ast_strlen_zero(args->app_args)) {
634                         ast_str_append(&appdata, 0, ",%s", args->app_args);
635                 }
636
637                 /* originate a channel, putting it into an application */
638                 if (ast_pbx_outgoing_app(dialtech, NULL, dialdevice, timeout, app, ast_str_buffer(appdata), NULL, 0, cid_num, cid_name, NULL, NULL, NULL)) {
639                         ast_ari_response_alloc_failed(response);
640                         return;
641                 }
642         } else if (!ast_strlen_zero(args->extension)) {
643                 /* originate a channel, sending it to an extension */
644                 if (ast_pbx_outgoing_exten(dialtech, NULL, dialdevice, timeout, S_OR(args->context, "default"), args->extension, args->priority ? args->priority : 1, NULL, 0, cid_num, cid_name, NULL, NULL, NULL, 0)) {
645                         ast_ari_response_alloc_failed(response);
646                         return;
647                 }
648         } else {
649                 ast_ari_response_error(response, 400, "Bad Request",
650                         "Application or extension must be specified");
651                 return;
652         }
653
654         ast_ari_response_no_content(response);
655 }
656
657 void ast_ari_get_channel_var(struct ast_variable *headers, struct ast_get_channel_var_args *args, struct ast_ari_response *response)
658 {
659         RAII_VAR(struct ast_json *, json, NULL, ast_json_unref);
660         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
661         RAII_VAR(char *, value, NULL, ast_free);
662
663         ast_assert(response != NULL);
664
665         if (ast_strlen_zero(args->variable)) {
666                 ast_ari_response_error(
667                         response, 400, "Bad Request",
668                         "Variable name is required");
669                 return;
670         }
671
672         control = find_control(response, args->channel_id);
673         if (control == NULL) {
674                 /* response filled in by find_control */
675                 return;
676         }
677
678         value = stasis_app_control_get_channel_var(control, args->variable);
679
680         if (!(json = ast_json_pack("{s: s}", "value", S_OR(value, "")))) {
681                 ast_ari_response_alloc_failed(response);
682                 return;
683         }
684
685         ast_ari_response_ok(response, ast_json_ref(json));
686 }
687
688 void ast_ari_set_channel_var(struct ast_variable *headers, struct ast_set_channel_var_args *args, struct ast_ari_response *response)
689 {
690         RAII_VAR(struct stasis_app_control *, control, NULL, ao2_cleanup);
691
692         ast_assert(response != NULL);
693
694         if (ast_strlen_zero(args->variable)) {
695                 ast_ari_response_error(
696                         response, 400, "Bad Request",
697                         "Variable name is required");
698                 return;
699         }
700
701         control = find_control(response, args->channel_id);
702         if (control == NULL) {
703                 /* response filled in by find_control */
704                 return;
705         }
706
707         if (stasis_app_control_set_channel_var(control, args->variable, args->value)) {
708                 ast_ari_response_error(
709                         response, 400, "Bad Request",
710                         "Failed to execute function");
711                 return;
712         }
713
714         ast_ari_response_no_content(response);
715 }
716