rtp_engine.c: Extract rtp_codecs_payload_replace_rx().
[asterisk/asterisk.git] / main / rtp_engine.c
1 /*
2  * Asterisk -- An open source telephony toolkit.
3  *
4  * Copyright (C) 1999 - 2008, Digium, Inc.
5  *
6  * Joshua Colp <jcolp@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 Pluggable RTP Architecture
22  *
23  * \author Joshua Colp <jcolp@digium.com>
24  */
25
26 /*** MODULEINFO
27         <support_level>core</support_level>
28 ***/
29
30 /*** DOCUMENTATION
31         <managerEvent language="en_US" name="RTCPSent">
32                 <managerEventInstance class="EVENT_FLAG_REPORTING">
33                         <synopsis>Raised when an RTCP packet is sent.</synopsis>
34                         <syntax>
35                                 <channel_snapshot/>
36                                 <parameter name="SSRC">
37                                         <para>The SSRC identifier for our stream</para>
38                                 </parameter>
39                                 <parameter name="PT">
40                                         <para>The type of packet for this RTCP report.</para>
41                                         <enumlist>
42                                                 <enum name="200(SR)"/>
43                                                 <enum name="201(RR)"/>
44                                         </enumlist>
45                                 </parameter>
46                                 <parameter name="To">
47                                         <para>The address the report is sent to.</para>
48                                 </parameter>
49                                 <parameter name="ReportCount">
50                                         <para>The number of reports that were sent.</para>
51                                         <para>The report count determines the number of ReportX headers in
52                                         the message. The X for each set of report headers will range from 0 to
53                                         <literal>ReportCount - 1</literal>.</para>
54                                 </parameter>
55                                 <parameter name="SentNTP" required="false">
56                                         <para>The time the sender generated the report. Only valid when
57                                         PT is <literal>200(SR)</literal>.</para>
58                                 </parameter>
59                                 <parameter name="SentRTP" required="false">
60                                         <para>The sender's last RTP timestamp. Only valid when PT is
61                                         <literal>200(SR)</literal>.</para>
62                                 </parameter>
63                                 <parameter name="SentPackets" required="false">
64                                         <para>The number of packets the sender has sent. Only valid when PT
65                                         is <literal>200(SR)</literal>.</para>
66                                 </parameter>
67                                 <parameter name="SentOctets" required="false">
68                                         <para>The number of bytes the sender has sent. Only valid when PT is
69                                         <literal>200(SR)</literal>.</para>
70                                 </parameter>
71                                 <parameter name="ReportXSourceSSRC">
72                                         <para>The SSRC for the source of this report block.</para>
73                                 </parameter>
74                                 <parameter name="ReportXFractionLost">
75                                         <para>The fraction of RTP data packets from <literal>ReportXSourceSSRC</literal>
76                                         lost since the previous SR or RR report was sent.</para>
77                                 </parameter>
78                                 <parameter name="ReportXCumulativeLost">
79                                         <para>The total number of RTP data packets from <literal>ReportXSourceSSRC</literal>
80                                         lost since the beginning of reception.</para>
81                                 </parameter>
82                                 <parameter name="ReportXHighestSequence">
83                                         <para>The highest sequence number received in an RTP data packet from
84                                         <literal>ReportXSourceSSRC</literal>.</para>
85                                 </parameter>
86                                 <parameter name="ReportXSequenceNumberCycles">
87                                         <para>The number of sequence number cycles seen for the RTP data
88                                         received from <literal>ReportXSourceSSRC</literal>.</para>
89                                 </parameter>
90                                 <parameter name="ReportXIAJitter">
91                                         <para>An estimate of the statistical variance of the RTP data packet
92                                         interarrival time, measured in timestamp units.</para>
93                                 </parameter>
94                                 <parameter name="ReportXLSR">
95                                         <para>The last SR timestamp received from <literal>ReportXSourceSSRC</literal>.
96                                         If no SR has been received from <literal>ReportXSourceSSRC</literal>,
97                                         then 0.</para>
98                                 </parameter>
99                                 <parameter name="ReportXDLSR">
100                                         <para>The delay, expressed in units of 1/65536 seconds, between
101                                         receiving the last SR packet from <literal>ReportXSourceSSRC</literal>
102                                         and sending this report.</para>
103                                 </parameter>
104                         </syntax>
105                 </managerEventInstance>
106         </managerEvent>
107         <managerEvent language="en_US" name="RTCPReceived">
108                 <managerEventInstance class="EVENT_FLAG_REPORTING">
109                         <synopsis>Raised when an RTCP packet is received.</synopsis>
110                         <syntax>
111                                 <channel_snapshot/>
112                                 <parameter name="SSRC">
113                                         <para>The SSRC identifier for the remote system</para>
114                                 </parameter>
115                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[@name='PT'])" />
116                                 <parameter name="From">
117                                         <para>The address the report was received from.</para>
118                                 </parameter>
119                                 <parameter name="RTT">
120                                         <para>Calculated Round-Trip Time in seconds</para>
121                                 </parameter>
122                                 <parameter name="ReportCount">
123                                         <para>The number of reports that were received.</para>
124                                         <para>The report count determines the number of ReportX headers in
125                                         the message. The X for each set of report headers will range from 0 to
126                                         <literal>ReportCount - 1</literal>.</para>
127                                 </parameter>
128                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[@name='SentNTP'])" />
129                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[@name='SentRTP'])" />
130                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[@name='SentPackets'])" />
131                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[@name='SentOctets'])" />
132                                 <xi:include xpointer="xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[contains(@name, 'ReportX')])" />
133                         </syntax>
134                 </managerEventInstance>
135         </managerEvent>
136  ***/
137
138 #include "asterisk.h"
139
140 ASTERISK_REGISTER_FILE()
141
142 #include <math.h>
143
144 #include "asterisk/channel.h"
145 #include "asterisk/frame.h"
146 #include "asterisk/module.h"
147 #include "asterisk/rtp_engine.h"
148 #include "asterisk/manager.h"
149 #include "asterisk/options.h"
150 #include "asterisk/astobj2.h"
151 #include "asterisk/pbx.h"
152 #include "asterisk/translate.h"
153 #include "asterisk/netsock2.h"
154 #include "asterisk/_private.h"
155 #include "asterisk/framehook.h"
156 #include "asterisk/stasis.h"
157 #include "asterisk/json.h"
158 #include "asterisk/stasis_channels.h"
159
160 struct ast_srtp_res *res_srtp = NULL;
161 struct ast_srtp_policy_res *res_srtp_policy = NULL;
162
163 /*! Structure that represents an RTP session (instance) */
164 struct ast_rtp_instance {
165         /*! Engine that is handling this RTP instance */
166         struct ast_rtp_engine *engine;
167         /*! Data unique to the RTP engine */
168         void *data;
169         /*! RTP properties that have been set and their value */
170         int properties[AST_RTP_PROPERTY_MAX];
171         /*! Address that we are expecting RTP to come in to */
172         struct ast_sockaddr local_address;
173         /*! The original source address */
174         struct ast_sockaddr requested_target_address;
175         /*! Address that we are sending RTP to */
176         struct ast_sockaddr incoming_source_address;
177         /*! Instance that we are bridged to if doing remote or local bridging */
178         struct ast_rtp_instance *bridged;
179         /*! Payload and packetization information */
180         struct ast_rtp_codecs codecs;
181         /*! RTP timeout time (negative or zero means disabled, negative value means temporarily disabled) */
182         int timeout;
183         /*! RTP timeout when on hold (negative or zero means disabled, negative value means temporarily disabled). */
184         int holdtimeout;
185         /*! RTP keepalive interval */
186         int keepalive;
187         /*! Glue currently in use */
188         struct ast_rtp_glue *glue;
189         /*! SRTP info associated with the instance */
190         struct ast_srtp *srtp;
191         /*! Channel unique ID */
192         char channel_uniqueid[AST_MAX_UNIQUEID];
193         /*! Time of last packet sent */
194         time_t last_tx;
195         /*! Time of last packet received */
196         time_t last_rx;
197 };
198
199 /*! List of RTP engines that are currently registered */
200 static AST_RWLIST_HEAD_STATIC(engines, ast_rtp_engine);
201
202 /*! List of RTP glues */
203 static AST_RWLIST_HEAD_STATIC(glues, ast_rtp_glue);
204
205 #define MAX_RTP_MIME_TYPES 128
206
207 /*! The following array defines the MIME Media type (and subtype) for each
208    of our codecs, or RTP-specific data type. */
209 static struct ast_rtp_mime_type {
210         /*! \brief A mapping object between the Asterisk codec and this RTP payload */
211         struct ast_rtp_payload_type payload_type;
212         /*! \brief The media type */
213         char type[16];
214         /*! \brief The format type */
215         char subtype[64];
216         /*! \brief Expected sample rate of the /c subtype */
217         unsigned int sample_rate;
218 } ast_rtp_mime_types[128]; /* This will Likely not need to grow any time soon. */
219 static ast_rwlock_t mime_types_lock;
220 static int mime_types_len = 0;
221
222 /*!
223  * \brief Mapping between Asterisk codecs and rtp payload types
224  *
225  * Static (i.e., well-known) RTP payload types for our "AST_FORMAT..."s:
226  * also, our own choices for dynamic payload types.  This is our master
227  * table for transmission
228  *
229  * See http://www.iana.org/assignments/rtp-parameters for a list of
230  * assigned values
231  */
232 static struct ast_rtp_payload_type *static_RTP_PT[AST_RTP_MAX_PT];
233 static ast_rwlock_t static_RTP_PT_lock;
234
235 /*! \brief \ref stasis topic for RTP related messages */
236 static struct stasis_topic *rtp_topic;
237
238
239 /*!
240  * \internal
241  * \brief Destructor for \c ast_rtp_payload_type
242  */
243 static void rtp_payload_type_dtor(void *obj)
244 {
245         struct ast_rtp_payload_type *payload = obj;
246
247         ao2_cleanup(payload->format);
248 }
249
250 struct ast_rtp_payload_type *ast_rtp_engine_alloc_payload_type(void)
251 {
252         struct ast_rtp_payload_type *payload;
253
254         payload = ao2_alloc_options(sizeof(*payload), rtp_payload_type_dtor,
255                 AO2_ALLOC_OPT_LOCK_NOLOCK);
256
257         return payload;
258 }
259
260 int ast_rtp_engine_register2(struct ast_rtp_engine *engine, struct ast_module *module)
261 {
262         struct ast_rtp_engine *current_engine;
263
264         /* Perform a sanity check on the engine structure to make sure it has the basics */
265         if (ast_strlen_zero(engine->name) || !engine->new || !engine->destroy || !engine->write || !engine->read) {
266                 ast_log(LOG_WARNING, "RTP Engine '%s' failed sanity check so it was not registered.\n", !ast_strlen_zero(engine->name) ? engine->name : "Unknown");
267                 return -1;
268         }
269
270         /* Link owner module to the RTP engine for reference counting purposes */
271         engine->mod = module;
272
273         AST_RWLIST_WRLOCK(&engines);
274
275         /* Ensure that no two modules with the same name are registered at the same time */
276         AST_RWLIST_TRAVERSE(&engines, current_engine, entry) {
277                 if (!strcmp(current_engine->name, engine->name)) {
278                         ast_log(LOG_WARNING, "An RTP engine with the name '%s' has already been registered.\n", engine->name);
279                         AST_RWLIST_UNLOCK(&engines);
280                         return -1;
281                 }
282         }
283
284         /* The engine survived our critique. Off to the list it goes to be used */
285         AST_RWLIST_INSERT_TAIL(&engines, engine, entry);
286
287         AST_RWLIST_UNLOCK(&engines);
288
289         ast_verb(2, "Registered RTP engine '%s'\n", engine->name);
290
291         return 0;
292 }
293
294 int ast_rtp_engine_unregister(struct ast_rtp_engine *engine)
295 {
296         struct ast_rtp_engine *current_engine = NULL;
297
298         AST_RWLIST_WRLOCK(&engines);
299
300         if ((current_engine = AST_RWLIST_REMOVE(&engines, engine, entry))) {
301                 ast_verb(2, "Unregistered RTP engine '%s'\n", engine->name);
302         }
303
304         AST_RWLIST_UNLOCK(&engines);
305
306         return current_engine ? 0 : -1;
307 }
308
309 int ast_rtp_glue_register2(struct ast_rtp_glue *glue, struct ast_module *module)
310 {
311         struct ast_rtp_glue *current_glue = NULL;
312
313         if (ast_strlen_zero(glue->type)) {
314                 return -1;
315         }
316
317         glue->mod = module;
318
319         AST_RWLIST_WRLOCK(&glues);
320
321         AST_RWLIST_TRAVERSE(&glues, current_glue, entry) {
322                 if (!strcasecmp(current_glue->type, glue->type)) {
323                         ast_log(LOG_WARNING, "RTP glue with the name '%s' has already been registered.\n", glue->type);
324                         AST_RWLIST_UNLOCK(&glues);
325                         return -1;
326                 }
327         }
328
329         AST_RWLIST_INSERT_TAIL(&glues, glue, entry);
330
331         AST_RWLIST_UNLOCK(&glues);
332
333         ast_verb(2, "Registered RTP glue '%s'\n", glue->type);
334
335         return 0;
336 }
337
338 int ast_rtp_glue_unregister(struct ast_rtp_glue *glue)
339 {
340         struct ast_rtp_glue *current_glue = NULL;
341
342         AST_RWLIST_WRLOCK(&glues);
343
344         if ((current_glue = AST_RWLIST_REMOVE(&glues, glue, entry))) {
345                 ast_verb(2, "Unregistered RTP glue '%s'\n", glue->type);
346         }
347
348         AST_RWLIST_UNLOCK(&glues);
349
350         return current_glue ? 0 : -1;
351 }
352
353 static void instance_destructor(void *obj)
354 {
355         struct ast_rtp_instance *instance = obj;
356
357         /* Pass us off to the engine to destroy */
358         if (instance->data && instance->engine->destroy(instance)) {
359                 ast_debug(1, "Engine '%s' failed to destroy RTP instance '%p'\n", instance->engine->name, instance);
360                 return;
361         }
362
363         if (instance->srtp) {
364                 res_srtp->destroy(instance->srtp);
365         }
366
367         ast_rtp_codecs_payloads_destroy(&instance->codecs);
368
369         /* Drop our engine reference */
370         ast_module_unref(instance->engine->mod);
371
372         ast_debug(1, "Destroyed RTP instance '%p'\n", instance);
373 }
374
375 int ast_rtp_instance_destroy(struct ast_rtp_instance *instance)
376 {
377         ao2_ref(instance, -1);
378
379         return 0;
380 }
381
382 struct ast_rtp_instance *ast_rtp_instance_new(const char *engine_name,
383                 struct ast_sched_context *sched, const struct ast_sockaddr *sa,
384                 void *data)
385 {
386         struct ast_sockaddr address = {{0,}};
387         struct ast_rtp_instance *instance = NULL;
388         struct ast_rtp_engine *engine = NULL;
389
390         AST_RWLIST_RDLOCK(&engines);
391
392         /* If an engine name was specified try to use it or otherwise use the first one registered */
393         if (!ast_strlen_zero(engine_name)) {
394                 AST_RWLIST_TRAVERSE(&engines, engine, entry) {
395                         if (!strcmp(engine->name, engine_name)) {
396                                 break;
397                         }
398                 }
399         } else {
400                 engine = AST_RWLIST_FIRST(&engines);
401         }
402
403         /* If no engine was actually found bail out now */
404         if (!engine) {
405                 ast_log(LOG_ERROR, "No RTP engine was found. Do you have one loaded?\n");
406                 AST_RWLIST_UNLOCK(&engines);
407                 return NULL;
408         }
409
410         /* Bump up the reference count before we return so the module can not be unloaded */
411         ast_module_ref(engine->mod);
412
413         AST_RWLIST_UNLOCK(&engines);
414
415         /* Allocate a new RTP instance */
416         if (!(instance = ao2_alloc(sizeof(*instance), instance_destructor))) {
417                 ast_module_unref(engine->mod);
418                 return NULL;
419         }
420         instance->engine = engine;
421         ast_sockaddr_copy(&instance->local_address, sa);
422         ast_sockaddr_copy(&address, sa);
423
424         if (ast_rtp_codecs_payloads_initialize(&instance->codecs)) {
425                 ao2_ref(instance, -1);
426                 return NULL;
427         }
428
429         ast_debug(1, "Using engine '%s' for RTP instance '%p'\n", engine->name, instance);
430
431         /* And pass it off to the engine to setup */
432         if (instance->engine->new(instance, sched, &address, data)) {
433                 ast_debug(1, "Engine '%s' failed to setup RTP instance '%p'\n", engine->name, instance);
434                 ao2_ref(instance, -1);
435                 return NULL;
436         }
437
438         ast_debug(1, "RTP instance '%p' is setup and ready to go\n", instance);
439
440         return instance;
441 }
442
443 const char *ast_rtp_instance_get_channel_id(struct ast_rtp_instance *instance)
444 {
445         return instance->channel_uniqueid;
446 }
447
448 void ast_rtp_instance_set_channel_id(struct ast_rtp_instance *instance, const char *uniqueid)
449 {
450         ast_copy_string(instance->channel_uniqueid, uniqueid, sizeof(instance->channel_uniqueid));
451 }
452
453 void ast_rtp_instance_set_data(struct ast_rtp_instance *instance, void *data)
454 {
455         instance->data = data;
456 }
457
458 void *ast_rtp_instance_get_data(struct ast_rtp_instance *instance)
459 {
460         return instance->data;
461 }
462
463 int ast_rtp_instance_write(struct ast_rtp_instance *instance, struct ast_frame *frame)
464 {
465         return instance->engine->write(instance, frame);
466 }
467
468 struct ast_frame *ast_rtp_instance_read(struct ast_rtp_instance *instance, int rtcp)
469 {
470         return instance->engine->read(instance, rtcp);
471 }
472
473 int ast_rtp_instance_set_local_address(struct ast_rtp_instance *instance,
474                 const struct ast_sockaddr *address)
475 {
476         ast_sockaddr_copy(&instance->local_address, address);
477         return 0;
478 }
479
480 int ast_rtp_instance_set_incoming_source_address(struct ast_rtp_instance *instance,
481                                                  const struct ast_sockaddr *address)
482 {
483         ast_sockaddr_copy(&instance->incoming_source_address, address);
484
485         /* moo */
486
487         if (instance->engine->remote_address_set) {
488                 instance->engine->remote_address_set(instance, &instance->incoming_source_address);
489         }
490
491         return 0;
492 }
493
494 int ast_rtp_instance_set_requested_target_address(struct ast_rtp_instance *instance,
495                                                   const struct ast_sockaddr *address)
496 {
497         ast_sockaddr_copy(&instance->requested_target_address, address);
498
499         return ast_rtp_instance_set_incoming_source_address(instance, address);
500 }
501
502 int ast_rtp_instance_get_and_cmp_local_address(struct ast_rtp_instance *instance,
503                 struct ast_sockaddr *address)
504 {
505         if (ast_sockaddr_cmp(address, &instance->local_address) != 0) {
506                 ast_sockaddr_copy(address, &instance->local_address);
507                 return 1;
508         }
509
510         return 0;
511 }
512
513 void ast_rtp_instance_get_local_address(struct ast_rtp_instance *instance,
514                 struct ast_sockaddr *address)
515 {
516         ast_sockaddr_copy(address, &instance->local_address);
517 }
518
519 int ast_rtp_instance_get_and_cmp_requested_target_address(struct ast_rtp_instance *instance,
520                 struct ast_sockaddr *address)
521 {
522         if (ast_sockaddr_cmp(address, &instance->requested_target_address) != 0) {
523                 ast_sockaddr_copy(address, &instance->requested_target_address);
524                 return 1;
525         }
526
527         return 0;
528 }
529
530 void ast_rtp_instance_get_incoming_source_address(struct ast_rtp_instance *instance,
531                                                   struct ast_sockaddr *address)
532 {
533         ast_sockaddr_copy(address, &instance->incoming_source_address);
534 }
535
536 void ast_rtp_instance_get_requested_target_address(struct ast_rtp_instance *instance,
537                                                    struct ast_sockaddr *address)
538 {
539         ast_sockaddr_copy(address, &instance->requested_target_address);
540 }
541
542 void ast_rtp_instance_set_extended_prop(struct ast_rtp_instance *instance, int property, void *value)
543 {
544         if (instance->engine->extended_prop_set) {
545                 instance->engine->extended_prop_set(instance, property, value);
546         }
547 }
548
549 void *ast_rtp_instance_get_extended_prop(struct ast_rtp_instance *instance, int property)
550 {
551         if (instance->engine->extended_prop_get) {
552                 return instance->engine->extended_prop_get(instance, property);
553         }
554
555         return NULL;
556 }
557
558 void ast_rtp_instance_set_prop(struct ast_rtp_instance *instance, enum ast_rtp_property property, int value)
559 {
560         instance->properties[property] = value;
561
562         if (instance->engine->prop_set) {
563                 instance->engine->prop_set(instance, property, value);
564         }
565 }
566
567 int ast_rtp_instance_get_prop(struct ast_rtp_instance *instance, enum ast_rtp_property property)
568 {
569         return instance->properties[property];
570 }
571
572 struct ast_rtp_codecs *ast_rtp_instance_get_codecs(struct ast_rtp_instance *instance)
573 {
574         return &instance->codecs;
575 }
576
577 int ast_rtp_codecs_payloads_initialize(struct ast_rtp_codecs *codecs)
578 {
579         int res;
580
581         codecs->framing = 0;
582         ast_rwlock_init(&codecs->codecs_lock);
583         res = AST_VECTOR_INIT(&codecs->payload_mapping_rx, AST_RTP_MAX_PT);
584         res |= AST_VECTOR_INIT(&codecs->payload_mapping_tx, AST_RTP_MAX_PT);
585         if (res) {
586                 AST_VECTOR_FREE(&codecs->payload_mapping_rx);
587                 AST_VECTOR_FREE(&codecs->payload_mapping_tx);
588         }
589
590         return res;
591 }
592
593 void ast_rtp_codecs_payloads_destroy(struct ast_rtp_codecs *codecs)
594 {
595         int idx;
596         struct ast_rtp_payload_type *type;
597
598         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
599                 type = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
600                 ao2_t_cleanup(type, "destroying ast_rtp_codec rx mapping");
601         }
602         AST_VECTOR_FREE(&codecs->payload_mapping_rx);
603
604         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
605                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
606                 ao2_t_cleanup(type, "destroying ast_rtp_codec tx mapping");
607         }
608         AST_VECTOR_FREE(&codecs->payload_mapping_tx);
609
610         ast_rwlock_destroy(&codecs->codecs_lock);
611 }
612
613 void ast_rtp_codecs_payloads_clear(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance)
614 {
615         ast_rtp_codecs_payloads_destroy(codecs);
616         ast_rtp_codecs_payloads_initialize(codecs);
617
618         if (instance && instance->engine && instance->engine->payload_set) {
619                 int i;
620                 for (i = 0; i < AST_RTP_MAX_PT; i++) {
621                         instance->engine->payload_set(instance, i, 0, NULL, 0);
622                 }
623         }
624 }
625
626 /*!
627  * \internal
628  * \brief Clear the rx primary mapping flag on all other matching mappings.
629  * \since 14.0.0
630  *
631  * \param codecs Codecs that need rx clearing.
632  * \param to_match Payload type object to compare against.
633  *
634  * \note It is assumed that codecs is write locked before calling.
635  *
636  * \return Nothing
637  */
638 static void payload_mapping_rx_clear_primary(struct ast_rtp_codecs *codecs, struct ast_rtp_payload_type *to_match)
639 {
640         int idx;
641         struct ast_rtp_payload_type *current;
642         struct ast_rtp_payload_type *new_type;
643
644         if (!to_match->primary_mapping) {
645                 return;
646         }
647
648         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
649                 current = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
650
651                 if (!current || current == to_match || !current->primary_mapping) {
652                         continue;
653                 }
654                 if (current->asterisk_format && to_match->asterisk_format) {
655                         if (ast_format_cmp(current->format, to_match->format) == AST_FORMAT_CMP_NOT_EQUAL) {
656                                 continue;
657                         }
658                 } else if (!current->asterisk_format && !to_match->asterisk_format) {
659                         if (current->rtp_code != to_match->rtp_code) {
660                                 continue;
661                         }
662                 } else {
663                         continue;
664                 }
665
666                 /* Replace current with non-primary marked version */
667                 new_type = ast_rtp_engine_alloc_payload_type();
668                 if (!new_type) {
669                         continue;
670                 }
671                 *new_type = *current;
672                 new_type->primary_mapping = 0;
673                 ao2_bump(new_type->format);
674                 AST_VECTOR_REPLACE(&codecs->payload_mapping_rx, idx, new_type);
675                 ao2_ref(current, -1);
676         }
677 }
678
679 /*!
680  * \internal
681  * \brief Put the new_type into the rx payload type mapping.
682  * \since 14.0.0
683  *
684  * \param codecs Codecs structure to put new_type into
685  * \param payload type position to replace.
686  * \param new_type RTP payload mapping object to store.
687  *
688  * \note It is assumed that codecs is write locked before calling.
689  *
690  * \return Nothing
691  */
692 static void rtp_codecs_payload_replace_rx(struct ast_rtp_codecs *codecs, int payload, struct ast_rtp_payload_type *new_type)
693 {
694         ao2_ref(new_type, +1);
695         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_rx)) {
696                 ao2_t_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_rx, payload),
697                         "cleaning up rx mapping vector element about to be replaced");
698         }
699         AST_VECTOR_REPLACE(&codecs->payload_mapping_rx, payload, new_type);
700
701         payload_mapping_rx_clear_primary(codecs, new_type);
702 }
703
704 /*!
705  * \internal
706  * \brief Copy the rx payload type mapping to the destination.
707  * \since 14.0.0
708  *
709  * \param src The source codecs structure
710  * \param dest The destination codecs structure that the values from src will be copied to
711  * \param instance Optionally the instance that the dst codecs structure belongs to
712  *
713  * \note It is assumed that src is at least read locked before calling.
714  * \note It is assumed that dest is write locked before calling.
715  *
716  * \return Nothing
717  */
718 static void rtp_codecs_payloads_copy_rx(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
719 {
720         int idx;
721         struct ast_rtp_payload_type *type;
722
723         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_rx); ++idx) {
724                 type = AST_VECTOR_GET(&src->payload_mapping_rx, idx);
725                 if (!type) {
726                         continue;
727                 }
728
729                 ast_debug(2, "Copying rx payload mapping %d (%p) from %p to %p\n",
730                         idx, type, src, dest);
731                 rtp_codecs_payload_replace_rx(dest, idx, type);
732
733                 if (instance && instance->engine && instance->engine->payload_set) {
734                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
735                 }
736         }
737 }
738
739 /*!
740  * \internal
741  * \brief Remove other matching payload mappings.
742  * \since 14.0.0
743  *
744  * \param codecs Codecs that need tx mappings removed.
745  * \param instance RTP instance to notify of any payloads removed.
746  * \param to_match Payload type object to compare against.
747  *
748  * \note It is assumed that codecs is write locked before calling.
749  *
750  * \return Nothing
751  */
752 static void payload_mapping_tx_remove_other_mappings(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, struct ast_rtp_payload_type *to_match)
753 {
754         int idx;
755         struct ast_rtp_payload_type *current;
756
757         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
758                 current = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
759
760                 if (!current || current == to_match) {
761                         continue;
762                 }
763                 if (current->asterisk_format && to_match->asterisk_format) {
764                         if (ast_format_cmp(current->format, to_match->format) == AST_FORMAT_CMP_NOT_EQUAL) {
765                                 continue;
766                         }
767                 } else if (!current->asterisk_format && !to_match->asterisk_format) {
768                         if (current->rtp_code != to_match->rtp_code) {
769                                 continue;
770                         }
771                 } else {
772                         continue;
773                 }
774
775                 /* Remove other mapping */
776                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, idx, NULL);
777                 ao2_ref(current, -1);
778                 if (instance && instance->engine && instance->engine->payload_set) {
779                         instance->engine->payload_set(instance, idx, 0, NULL, 0);
780                 }
781         }
782 }
783
784 /*!
785  * \internal
786  * \brief Copy the tx payload type mapping to the destination.
787  * \since 14.0.0
788  *
789  * \param src The source codecs structure
790  * \param dest The destination codecs structure that the values from src will be copied to
791  * \param instance Optionally the instance that the dst codecs structure belongs to
792  *
793  * \note It is assumed that src is at least read locked before calling.
794  * \note It is assumed that dest is write locked before calling.
795  *
796  * \return Nothing
797  */
798 static void rtp_codecs_payloads_copy_tx(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
799 {
800         int idx;
801         struct ast_rtp_payload_type *type;
802
803         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_tx); ++idx) {
804                 type = AST_VECTOR_GET(&src->payload_mapping_tx, idx);
805                 if (!type) {
806                         continue;
807                 }
808
809                 ast_debug(2, "Copying tx payload mapping %d (%p) from %p to %p\n",
810                         idx, type, src, dest);
811                 ao2_ref(type, +1);
812                 if (idx < AST_VECTOR_SIZE(&dest->payload_mapping_tx)) {
813                         ao2_t_cleanup(AST_VECTOR_GET(&dest->payload_mapping_tx, idx),
814                                 "cleaning up tx mapping vector element about to be replaced");
815                 }
816                 AST_VECTOR_REPLACE(&dest->payload_mapping_tx, idx, type);
817
818                 if (instance && instance->engine && instance->engine->payload_set) {
819                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
820                 }
821
822                 payload_mapping_tx_remove_other_mappings(dest, instance, type);
823         }
824 }
825
826 void ast_rtp_codecs_payloads_copy(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
827 {
828         ast_rwlock_wrlock(&dest->codecs_lock);
829
830         /* Deadlock avoidance because of held write lock. */
831         while (ast_rwlock_tryrdlock(&src->codecs_lock)) {
832                 ast_rwlock_unlock(&dest->codecs_lock);
833                 sched_yield();
834                 ast_rwlock_wrlock(&dest->codecs_lock);
835         }
836
837         rtp_codecs_payloads_copy_rx(src, dest, instance);
838         rtp_codecs_payloads_copy_tx(src, dest, instance);
839         dest->framing = src->framing;
840
841         ast_rwlock_unlock(&src->codecs_lock);
842         ast_rwlock_unlock(&dest->codecs_lock);
843 }
844
845 void ast_rtp_codecs_payloads_xover(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
846 {
847         int idx;
848         struct ast_rtp_payload_type *type;
849
850         ast_rwlock_wrlock(&dest->codecs_lock);
851         if (src != dest) {
852                 /* Deadlock avoidance because of held write lock. */
853                 while (ast_rwlock_tryrdlock(&src->codecs_lock)) {
854                         ast_rwlock_unlock(&dest->codecs_lock);
855                         sched_yield();
856                         ast_rwlock_wrlock(&dest->codecs_lock);
857                 }
858         }
859
860         /* Crossover copy payload type tx mapping to rx mapping. */
861         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_tx); ++idx) {
862                 type = AST_VECTOR_GET(&src->payload_mapping_tx, idx);
863                 if (!type) {
864                         continue;
865                 }
866
867                 /* All tx mapping elements should have the primary flag set. */
868                 ast_assert(type->primary_mapping);
869
870                 ast_debug(2, "Crossover copying tx to rx payload mapping %d (%p) from %p to %p\n",
871                         idx, type, src, dest);
872                 rtp_codecs_payload_replace_rx(dest, idx, type);
873
874                 if (instance && instance->engine && instance->engine->payload_set) {
875                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
876                 }
877         }
878
879         dest->framing = src->framing;
880
881         if (src != dest) {
882                 ast_rwlock_unlock(&src->codecs_lock);
883         }
884         ast_rwlock_unlock(&dest->codecs_lock);
885 }
886
887 void ast_rtp_codecs_payloads_set_m_type(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload)
888 {
889         struct ast_rtp_payload_type *new_type;
890
891         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
892                 return;
893         }
894
895         ast_rwlock_rdlock(&static_RTP_PT_lock);
896         new_type = ao2_bump(static_RTP_PT[payload]);
897         ast_rwlock_unlock(&static_RTP_PT_lock);
898         if (!new_type) {
899                 ast_debug(1, "Don't have a default tx payload type %d format for m type on %p\n",
900                         payload, codecs);
901                 return;
902         }
903
904         ast_debug(1, "Setting tx payload type %d based on m type on %p\n",
905                 payload, codecs);
906
907         ast_rwlock_wrlock(&codecs->codecs_lock);
908
909         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
910                 ao2_t_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, payload),
911                         "cleaning up replaced tx payload type");
912         }
913         AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, new_type);
914
915         if (instance && instance->engine && instance->engine->payload_set) {
916                 instance->engine->payload_set(instance, payload, new_type->asterisk_format, new_type->format, new_type->rtp_code);
917         }
918
919         payload_mapping_tx_remove_other_mappings(codecs, instance, new_type);
920
921         ast_rwlock_unlock(&codecs->codecs_lock);
922 }
923
924 int ast_rtp_codecs_payloads_set_rtpmap_type_rate(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int pt,
925                                  char *mimetype, char *mimesubtype,
926                                  enum ast_rtp_options options,
927                                  unsigned int sample_rate)
928 {
929         unsigned int idx;
930         int found = 0;
931
932         if (pt < 0 || pt >= AST_RTP_MAX_PT) {
933                 return -1; /* bogus payload type */
934         }
935
936         ast_rwlock_rdlock(&mime_types_lock);
937         ast_rwlock_wrlock(&codecs->codecs_lock);
938
939         for (idx = 0; idx < mime_types_len; ++idx) {
940                 const struct ast_rtp_mime_type *t = &ast_rtp_mime_types[idx];
941                 struct ast_rtp_payload_type *new_type;
942
943                 if (strcasecmp(mimesubtype, t->subtype)) {
944                         continue;
945                 }
946
947                 if (strcasecmp(mimetype, t->type)) {
948                         continue;
949                 }
950
951                 /* if both sample rates have been supplied, and they don't match,
952                  * then this not a match; if one has not been supplied, then the
953                  * rates are not compared */
954                 if (sample_rate && t->sample_rate &&
955                     (sample_rate != t->sample_rate)) {
956                         continue;
957                 }
958
959                 found = 1;
960
961                 new_type = ast_rtp_engine_alloc_payload_type();
962                 if (!new_type) {
963                         continue;
964                 }
965
966                 new_type->asterisk_format = t->payload_type.asterisk_format;
967                 new_type->rtp_code = t->payload_type.rtp_code;
968                 new_type->payload = pt;
969                 new_type->primary_mapping = 1;
970                 if (t->payload_type.asterisk_format
971                         && ast_format_cmp(t->payload_type.format, ast_format_g726) == AST_FORMAT_CMP_EQUAL
972                         && (options & AST_RTP_OPT_G726_NONSTANDARD)) {
973                         new_type->format = ao2_bump(ast_format_g726_aal2);
974                 } else {
975                         new_type->format = ao2_bump(t->payload_type.format);
976                 }
977
978                 if (pt < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
979                         ao2_t_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, pt),
980                                 "cleaning up replaced tx payload type");
981                 }
982                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, pt, new_type);
983
984                 if (instance && instance->engine && instance->engine->payload_set) {
985                         instance->engine->payload_set(instance, pt, new_type->asterisk_format, new_type->format, new_type->rtp_code);
986                 }
987
988                 payload_mapping_tx_remove_other_mappings(codecs, instance, new_type);
989                 break;
990         }
991
992         ast_rwlock_unlock(&codecs->codecs_lock);
993         ast_rwlock_unlock(&mime_types_lock);
994
995         return (found ? 0 : -2);
996 }
997
998 int ast_rtp_codecs_payloads_set_rtpmap_type(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload, char *mimetype, char *mimesubtype, enum ast_rtp_options options)
999 {
1000         return ast_rtp_codecs_payloads_set_rtpmap_type_rate(codecs, instance, payload, mimetype, mimesubtype, options, 0);
1001 }
1002
1003 void ast_rtp_codecs_payloads_unset(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload)
1004 {
1005         struct ast_rtp_payload_type *type;
1006
1007         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
1008                 return;
1009         }
1010
1011         ast_debug(2, "Unsetting payload %d on %p\n", payload, codecs);
1012
1013         ast_rwlock_wrlock(&codecs->codecs_lock);
1014
1015         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1016                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1017                 ao2_cleanup(type);
1018                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, NULL);
1019         }
1020
1021         if (instance && instance->engine && instance->engine->payload_set) {
1022                 instance->engine->payload_set(instance, payload, 0, NULL, 0);
1023         }
1024
1025         ast_rwlock_unlock(&codecs->codecs_lock);
1026 }
1027
1028 struct ast_rtp_payload_type *ast_rtp_codecs_get_payload(struct ast_rtp_codecs *codecs, int payload)
1029 {
1030         struct ast_rtp_payload_type *type = NULL;
1031
1032         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
1033                 return NULL;
1034         }
1035
1036         ast_rwlock_rdlock(&codecs->codecs_lock);
1037         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_rx)) {
1038                 type = AST_VECTOR_GET(&codecs->payload_mapping_rx, payload);
1039                 ao2_bump(type);
1040         }
1041         ast_rwlock_unlock(&codecs->codecs_lock);
1042
1043         if (!type) {
1044                 ast_rwlock_rdlock(&static_RTP_PT_lock);
1045                 type = ao2_bump(static_RTP_PT[payload]);
1046                 ast_rwlock_unlock(&static_RTP_PT_lock);
1047         }
1048
1049         return type;
1050 }
1051
1052 int ast_rtp_codecs_payload_replace_format(struct ast_rtp_codecs *codecs, int payload, struct ast_format *format)
1053 {
1054         struct ast_rtp_payload_type *type;
1055
1056         if (payload < 0 || payload >= AST_RTP_MAX_PT || !format) {
1057                 return -1;
1058         }
1059
1060         type = ast_rtp_engine_alloc_payload_type();
1061         if (!type) {
1062                 return -1;
1063         }
1064         ao2_ref(format, +1);
1065         type->format = format;
1066         type->asterisk_format = 1;
1067         type->payload = payload;
1068         type->primary_mapping = 1;
1069
1070         ast_rwlock_wrlock(&codecs->codecs_lock);
1071         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1072                 ao2_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, payload));
1073         }
1074         AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, type);
1075         payload_mapping_tx_remove_other_mappings(codecs, NULL, type);
1076         ast_rwlock_unlock(&codecs->codecs_lock);
1077
1078         return 0;
1079 }
1080
1081 struct ast_format *ast_rtp_codecs_get_payload_format(struct ast_rtp_codecs *codecs, int payload)
1082 {
1083         struct ast_rtp_payload_type *type;
1084         struct ast_format *format = NULL;
1085
1086         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
1087                 return NULL;
1088         }
1089
1090         ast_rwlock_rdlock(&codecs->codecs_lock);
1091         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1092                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1093                 if (type && type->asterisk_format) {
1094                         format = ao2_bump(type->format);
1095                 }
1096         }
1097         ast_rwlock_unlock(&codecs->codecs_lock);
1098
1099         return format;
1100 }
1101
1102 void ast_rtp_codecs_set_framing(struct ast_rtp_codecs *codecs, unsigned int framing)
1103 {
1104         if (!framing) {
1105                 return;
1106         }
1107
1108         ast_rwlock_wrlock(&codecs->codecs_lock);
1109         codecs->framing = framing;
1110         ast_rwlock_unlock(&codecs->codecs_lock);
1111 }
1112
1113 unsigned int ast_rtp_codecs_get_framing(struct ast_rtp_codecs *codecs)
1114 {
1115         unsigned int framing;
1116
1117         ast_rwlock_rdlock(&codecs->codecs_lock);
1118         framing = codecs->framing;
1119         ast_rwlock_unlock(&codecs->codecs_lock);
1120
1121         return framing;
1122 }
1123
1124 void ast_rtp_codecs_payload_formats(struct ast_rtp_codecs *codecs, struct ast_format_cap *astformats, int *nonastformats)
1125 {
1126         int idx;
1127
1128         ast_format_cap_remove_by_type(astformats, AST_MEDIA_TYPE_UNKNOWN);
1129         *nonastformats = 0;
1130
1131         ast_rwlock_rdlock(&codecs->codecs_lock);
1132
1133         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1134                 struct ast_rtp_payload_type *type;
1135
1136                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1137                 if (!type) {
1138                         continue;
1139                 }
1140
1141                 if (type->asterisk_format) {
1142                         ast_format_cap_append(astformats, type->format, 0);
1143                 } else {
1144                         *nonastformats |= type->rtp_code;
1145                 }
1146         }
1147         if (codecs->framing) {
1148                 ast_format_cap_set_framing(astformats, codecs->framing);
1149         }
1150
1151         ast_rwlock_unlock(&codecs->codecs_lock);
1152 }
1153
1154 /*!
1155  * \internal
1156  * \brief Find the static payload type mapping for the format.
1157  * \since 14.0.0
1158  *
1159  * \param asterisk_format Non-zero if the given Asterisk format is present
1160  * \param format Asterisk format to look for
1161  * \param code The non-Asterisk format code to look for
1162  *
1163  * \retval Numerical payload type
1164  * \retval -1 if not found.
1165  */
1166 static int find_static_payload_type(int asterisk_format, const struct ast_format *format, int code)
1167 {
1168         int idx;
1169         int payload = -1;
1170
1171         if (!asterisk_format) {
1172                 ast_rwlock_rdlock(&static_RTP_PT_lock);
1173                 for (idx = 0; idx < AST_RTP_MAX_PT; ++idx) {
1174                         if (static_RTP_PT[idx]
1175                                 && !static_RTP_PT[idx]->asterisk_format
1176                                 && static_RTP_PT[idx]->rtp_code == code) {
1177                                 payload = idx;
1178                                 break;
1179                         }
1180                 }
1181                 ast_rwlock_unlock(&static_RTP_PT_lock);
1182         } else if (format) {
1183                 ast_rwlock_rdlock(&static_RTP_PT_lock);
1184                 for (idx = 0; idx < AST_RTP_MAX_PT; ++idx) {
1185                         if (static_RTP_PT[idx]
1186                                 && static_RTP_PT[idx]->asterisk_format
1187                                 && ast_format_cmp(format, static_RTP_PT[idx]->format)
1188                                         != AST_FORMAT_CMP_NOT_EQUAL) {
1189                                 payload = idx;
1190                                 break;
1191                         }
1192                 }
1193                 ast_rwlock_unlock(&static_RTP_PT_lock);
1194         }
1195
1196         return payload;
1197 }
1198
1199 int ast_rtp_codecs_payload_code(struct ast_rtp_codecs *codecs, int asterisk_format, const struct ast_format *format, int code)
1200 {
1201         struct ast_rtp_payload_type *type;
1202         int idx;
1203         int payload = -1;
1204
1205         if (!asterisk_format) {
1206                 ast_rwlock_rdlock(&codecs->codecs_lock);
1207                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
1208                         type = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
1209                         if (!type) {
1210                                 continue;
1211                         }
1212
1213                         if (!type->asterisk_format
1214                                 && type->rtp_code == code) {
1215                                 if (type->primary_mapping) {
1216                                         payload = idx;
1217                                         break;
1218                                 }
1219                                 if (payload == -1) {
1220                                         payload = idx;
1221                                 }
1222                         }
1223                 }
1224                 ast_rwlock_unlock(&codecs->codecs_lock);
1225         } else if (format) {
1226                 ast_rwlock_rdlock(&codecs->codecs_lock);
1227                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
1228                         type = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
1229                         if (!type) {
1230                                 continue;
1231                         }
1232
1233                         if (type->asterisk_format
1234                                 && ast_format_cmp(format, type->format) == AST_FORMAT_CMP_EQUAL) {
1235                                 if (type->primary_mapping) {
1236                                         payload = idx;
1237                                         break;
1238                                 }
1239                                 if (payload == -1) {
1240                                         payload = idx;
1241                                 }
1242                         }
1243                 }
1244                 ast_rwlock_unlock(&codecs->codecs_lock);
1245         }
1246
1247         if (payload < 0) {
1248                 payload = find_static_payload_type(asterisk_format, format, code);
1249         }
1250
1251         return payload;
1252 }
1253
1254 int ast_rtp_codecs_payload_code_tx(struct ast_rtp_codecs *codecs, int asterisk_format, const struct ast_format *format, int code)
1255 {
1256         struct ast_rtp_payload_type *type;
1257         int idx;
1258         int payload = -1;
1259
1260         if (!asterisk_format) {
1261                 ast_rwlock_rdlock(&codecs->codecs_lock);
1262                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1263                         type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1264                         if (!type) {
1265                                 continue;
1266                         }
1267
1268                         if (!type->asterisk_format
1269                                 && type->rtp_code == code) {
1270                                 payload = idx;
1271                                 break;
1272                         }
1273                 }
1274                 ast_rwlock_unlock(&codecs->codecs_lock);
1275         } else if (format) {
1276                 ast_rwlock_rdlock(&codecs->codecs_lock);
1277                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1278                         type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1279                         if (!type) {
1280                                 continue;
1281                         }
1282
1283                         if (type->asterisk_format
1284                                 && ast_format_cmp(format, type->format) == AST_FORMAT_CMP_EQUAL) {
1285                                 payload = idx;
1286                                 break;
1287                         }
1288                 }
1289                 ast_rwlock_unlock(&codecs->codecs_lock);
1290         }
1291
1292         if (payload < 0) {
1293                 payload = find_static_payload_type(asterisk_format, format, code);
1294         }
1295
1296         return payload;
1297 }
1298
1299 int ast_rtp_codecs_find_payload_code(struct ast_rtp_codecs *codecs, int payload)
1300 {
1301         struct ast_rtp_payload_type *type;
1302         int res = -1;
1303
1304         ast_rwlock_rdlock(&codecs->codecs_lock);
1305         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1306                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1307                 if (type) {
1308                         res = payload;
1309                 }
1310         }
1311         ast_rwlock_unlock(&codecs->codecs_lock);
1312
1313         return res;
1314 }
1315
1316 const char *ast_rtp_lookup_mime_subtype2(const int asterisk_format, struct ast_format *format, int code, enum ast_rtp_options options)
1317 {
1318         int i;
1319         const char *res = "";
1320
1321         ast_rwlock_rdlock(&mime_types_lock);
1322         for (i = 0; i < mime_types_len; i++) {
1323                 if (ast_rtp_mime_types[i].payload_type.asterisk_format && asterisk_format && format &&
1324                         (ast_format_cmp(format, ast_rtp_mime_types[i].payload_type.format) != AST_FORMAT_CMP_NOT_EQUAL)) {
1325                         if ((ast_format_cmp(format, ast_format_g726_aal2) == AST_FORMAT_CMP_EQUAL) &&
1326                                         (options & AST_RTP_OPT_G726_NONSTANDARD)) {
1327                                 res = "G726-32";
1328                                 break;
1329                         } else {
1330                                 res = ast_rtp_mime_types[i].subtype;
1331                                 break;
1332                         }
1333                 } else if (!ast_rtp_mime_types[i].payload_type.asterisk_format && !asterisk_format &&
1334                         ast_rtp_mime_types[i].payload_type.rtp_code == code) {
1335
1336                         res = ast_rtp_mime_types[i].subtype;
1337                         break;
1338                 }
1339         }
1340         ast_rwlock_unlock(&mime_types_lock);
1341
1342         return res;
1343 }
1344
1345 unsigned int ast_rtp_lookup_sample_rate2(int asterisk_format, struct ast_format *format, int code)
1346 {
1347         unsigned int i;
1348         unsigned int res = 0;
1349
1350         ast_rwlock_rdlock(&mime_types_lock);
1351         for (i = 0; i < mime_types_len; ++i) {
1352                 if (ast_rtp_mime_types[i].payload_type.asterisk_format && asterisk_format && format &&
1353                         (ast_format_cmp(format, ast_rtp_mime_types[i].payload_type.format) != AST_FORMAT_CMP_NOT_EQUAL)) {
1354                         res = ast_rtp_mime_types[i].sample_rate;
1355                         break;
1356                 } else if (!ast_rtp_mime_types[i].payload_type.asterisk_format && !asterisk_format &&
1357                         ast_rtp_mime_types[i].payload_type.rtp_code == code) {
1358                         res = ast_rtp_mime_types[i].sample_rate;
1359                         break;
1360                 }
1361         }
1362         ast_rwlock_unlock(&mime_types_lock);
1363
1364         return res;
1365 }
1366
1367 char *ast_rtp_lookup_mime_multiple2(struct ast_str *buf, struct ast_format_cap *ast_format_capability, int rtp_capability, const int asterisk_format, enum ast_rtp_options options)
1368 {
1369         int found = 0;
1370         const char *name;
1371         if (!buf) {
1372                 return NULL;
1373         }
1374
1375
1376         if (asterisk_format) {
1377                 int x;
1378                 struct ast_format *tmp_fmt;
1379                 for (x = 0; x < ast_format_cap_count(ast_format_capability); x++) {
1380                         tmp_fmt = ast_format_cap_get_format(ast_format_capability, x);
1381                         name = ast_rtp_lookup_mime_subtype2(asterisk_format, tmp_fmt, 0, options);
1382                         ao2_ref(tmp_fmt, -1);
1383                         ast_str_append(&buf, 0, "%s|", name);
1384                         found = 1;
1385                 }
1386         } else {
1387                 int x;
1388                 ast_str_append(&buf, 0, "0x%x (", (unsigned int) rtp_capability);
1389                 for (x = 1; x <= AST_RTP_MAX; x <<= 1) {
1390                         if (rtp_capability & x) {
1391                                 name = ast_rtp_lookup_mime_subtype2(asterisk_format, NULL, x, options);
1392                                 ast_str_append(&buf, 0, "%s|", name);
1393                                 found = 1;
1394                         }
1395                 }
1396         }
1397
1398         ast_str_append(&buf, 0, "%s", found ? ")" : "nothing)");
1399
1400         return ast_str_buffer(buf);
1401 }
1402
1403 int ast_rtp_instance_dtmf_begin(struct ast_rtp_instance *instance, char digit)
1404 {
1405         return instance->engine->dtmf_begin ? instance->engine->dtmf_begin(instance, digit) : -1;
1406 }
1407
1408 int ast_rtp_instance_dtmf_end(struct ast_rtp_instance *instance, char digit)
1409 {
1410         return instance->engine->dtmf_end ? instance->engine->dtmf_end(instance, digit) : -1;
1411 }
1412 int ast_rtp_instance_dtmf_end_with_duration(struct ast_rtp_instance *instance, char digit, unsigned int duration)
1413 {
1414         return instance->engine->dtmf_end_with_duration ? instance->engine->dtmf_end_with_duration(instance, digit, duration) : -1;
1415 }
1416
1417 int ast_rtp_instance_dtmf_mode_set(struct ast_rtp_instance *instance, enum ast_rtp_dtmf_mode dtmf_mode)
1418 {
1419         return (!instance->engine->dtmf_mode_set || instance->engine->dtmf_mode_set(instance, dtmf_mode)) ? -1 : 0;
1420 }
1421
1422 enum ast_rtp_dtmf_mode ast_rtp_instance_dtmf_mode_get(struct ast_rtp_instance *instance)
1423 {
1424         return instance->engine->dtmf_mode_get ? instance->engine->dtmf_mode_get(instance) : 0;
1425 }
1426
1427 void ast_rtp_instance_update_source(struct ast_rtp_instance *instance)
1428 {
1429         if (instance->engine->update_source) {
1430                 instance->engine->update_source(instance);
1431         }
1432 }
1433
1434 void ast_rtp_instance_change_source(struct ast_rtp_instance *instance)
1435 {
1436         if (instance->engine->change_source) {
1437                 instance->engine->change_source(instance);
1438         }
1439 }
1440
1441 int ast_rtp_instance_set_qos(struct ast_rtp_instance *instance, int tos, int cos, const char *desc)
1442 {
1443         return instance->engine->qos ? instance->engine->qos(instance, tos, cos, desc) : -1;
1444 }
1445
1446 void ast_rtp_instance_stop(struct ast_rtp_instance *instance)
1447 {
1448         if (instance->engine->stop) {
1449                 instance->engine->stop(instance);
1450         }
1451 }
1452
1453 int ast_rtp_instance_fd(struct ast_rtp_instance *instance, int rtcp)
1454 {
1455         return instance->engine->fd ? instance->engine->fd(instance, rtcp) : -1;
1456 }
1457
1458 struct ast_rtp_glue *ast_rtp_instance_get_glue(const char *type)
1459 {
1460         struct ast_rtp_glue *glue = NULL;
1461
1462         AST_RWLIST_RDLOCK(&glues);
1463
1464         AST_RWLIST_TRAVERSE(&glues, glue, entry) {
1465                 if (!strcasecmp(glue->type, type)) {
1466                         break;
1467                 }
1468         }
1469
1470         AST_RWLIST_UNLOCK(&glues);
1471
1472         return glue;
1473 }
1474
1475 /*!
1476  * \brief Conditionally unref an rtp instance
1477  */
1478 static void unref_instance_cond(struct ast_rtp_instance **instance)
1479 {
1480         if (*instance) {
1481                 ao2_ref(*instance, -1);
1482                 *instance = NULL;
1483         }
1484 }
1485
1486 struct ast_rtp_instance *ast_rtp_instance_get_bridged(struct ast_rtp_instance *instance)
1487 {
1488         return instance->bridged;
1489 }
1490
1491 void ast_rtp_instance_set_bridged(struct ast_rtp_instance *instance, struct ast_rtp_instance *bridged)
1492 {
1493         instance->bridged = bridged;
1494 }
1495
1496 void ast_rtp_instance_early_bridge_make_compatible(struct ast_channel *c_dst, struct ast_channel *c_src)
1497 {
1498         struct ast_rtp_instance *instance_dst = NULL, *instance_src = NULL,
1499                 *vinstance_dst = NULL, *vinstance_src = NULL,
1500                 *tinstance_dst = NULL, *tinstance_src = NULL;
1501         struct ast_rtp_glue *glue_dst, *glue_src;
1502         enum ast_rtp_glue_result audio_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID, video_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID;
1503         enum ast_rtp_glue_result audio_glue_src_res = AST_RTP_GLUE_RESULT_FORBID, video_glue_src_res = AST_RTP_GLUE_RESULT_FORBID;
1504         struct ast_format_cap *cap_dst = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1505         struct ast_format_cap *cap_src = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1506
1507         /* Lock both channels so we can look for the glue that binds them together */
1508         ast_channel_lock_both(c_dst, c_src);
1509
1510         if (!cap_src || !cap_dst) {
1511                 goto done;
1512         }
1513
1514         /* Grab glue that binds each channel to something using the RTP engine */
1515         if (!(glue_dst = ast_rtp_instance_get_glue(ast_channel_tech(c_dst)->type)) || !(glue_src = ast_rtp_instance_get_glue(ast_channel_tech(c_src)->type))) {
1516                 ast_debug(1, "Can't find native functions for channel '%s'\n", glue_dst ? ast_channel_name(c_src) : ast_channel_name(c_dst));
1517                 goto done;
1518         }
1519
1520         audio_glue_dst_res = glue_dst->get_rtp_info(c_dst, &instance_dst);
1521         video_glue_dst_res = glue_dst->get_vrtp_info ? glue_dst->get_vrtp_info(c_dst, &vinstance_dst) : AST_RTP_GLUE_RESULT_FORBID;
1522
1523         audio_glue_src_res = glue_src->get_rtp_info(c_src, &instance_src);
1524         video_glue_src_res = glue_src->get_vrtp_info ? glue_src->get_vrtp_info(c_src, &vinstance_src) : AST_RTP_GLUE_RESULT_FORBID;
1525
1526         /* If we are carrying video, and both sides are not going to remotely bridge... fail the native bridge */
1527         if (video_glue_dst_res != AST_RTP_GLUE_RESULT_FORBID && (audio_glue_dst_res != AST_RTP_GLUE_RESULT_REMOTE || video_glue_dst_res != AST_RTP_GLUE_RESULT_REMOTE)) {
1528                 audio_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID;
1529         }
1530         if (video_glue_src_res != AST_RTP_GLUE_RESULT_FORBID && (audio_glue_src_res != AST_RTP_GLUE_RESULT_REMOTE || video_glue_src_res != AST_RTP_GLUE_RESULT_REMOTE)) {
1531                 audio_glue_src_res = AST_RTP_GLUE_RESULT_FORBID;
1532         }
1533         if (audio_glue_dst_res == AST_RTP_GLUE_RESULT_REMOTE && (video_glue_dst_res == AST_RTP_GLUE_RESULT_FORBID || video_glue_dst_res == AST_RTP_GLUE_RESULT_REMOTE) && glue_dst->get_codec) {
1534                 glue_dst->get_codec(c_dst, cap_dst);
1535         }
1536         if (audio_glue_src_res == AST_RTP_GLUE_RESULT_REMOTE && (video_glue_src_res == AST_RTP_GLUE_RESULT_FORBID || video_glue_src_res == AST_RTP_GLUE_RESULT_REMOTE) && glue_src->get_codec) {
1537                 glue_src->get_codec(c_src, cap_src);
1538         }
1539
1540         /* If any sort of bridge is forbidden just completely bail out and go back to generic bridging */
1541         if (audio_glue_dst_res != AST_RTP_GLUE_RESULT_REMOTE || audio_glue_src_res != AST_RTP_GLUE_RESULT_REMOTE) {
1542                 goto done;
1543         }
1544
1545         /* Make sure we have matching codecs */
1546         if (!ast_format_cap_iscompatible(cap_dst, cap_src)) {
1547                 goto done;
1548         }
1549
1550         ast_rtp_codecs_payloads_xover(&instance_src->codecs, &instance_dst->codecs, instance_dst);
1551
1552         if (vinstance_dst && vinstance_src) {
1553                 ast_rtp_codecs_payloads_xover(&vinstance_src->codecs, &vinstance_dst->codecs, vinstance_dst);
1554         }
1555         if (tinstance_dst && tinstance_src) {
1556                 ast_rtp_codecs_payloads_xover(&tinstance_src->codecs, &tinstance_dst->codecs, tinstance_dst);
1557         }
1558
1559         if (glue_dst->update_peer(c_dst, instance_src, vinstance_src, tinstance_src, cap_src, 0)) {
1560                 ast_log(LOG_WARNING, "Channel '%s' failed to setup early bridge to '%s'\n",
1561                         ast_channel_name(c_dst), ast_channel_name(c_src));
1562         } else {
1563                 ast_debug(1, "Seeded SDP of '%s' with that of '%s'\n",
1564                         ast_channel_name(c_dst), ast_channel_name(c_src));
1565         }
1566
1567 done:
1568         ast_channel_unlock(c_dst);
1569         ast_channel_unlock(c_src);
1570
1571         ao2_cleanup(cap_dst);
1572         ao2_cleanup(cap_src);
1573
1574         unref_instance_cond(&instance_dst);
1575         unref_instance_cond(&instance_src);
1576         unref_instance_cond(&vinstance_dst);
1577         unref_instance_cond(&vinstance_src);
1578         unref_instance_cond(&tinstance_dst);
1579         unref_instance_cond(&tinstance_src);
1580 }
1581
1582 int ast_rtp_instance_early_bridge(struct ast_channel *c0, struct ast_channel *c1)
1583 {
1584         struct ast_rtp_instance *instance0 = NULL, *instance1 = NULL,
1585                         *vinstance0 = NULL, *vinstance1 = NULL,
1586                         *tinstance0 = NULL, *tinstance1 = NULL;
1587         struct ast_rtp_glue *glue0, *glue1;
1588         enum ast_rtp_glue_result audio_glue0_res = AST_RTP_GLUE_RESULT_FORBID, video_glue0_res = AST_RTP_GLUE_RESULT_FORBID;
1589         enum ast_rtp_glue_result audio_glue1_res = AST_RTP_GLUE_RESULT_FORBID, video_glue1_res = AST_RTP_GLUE_RESULT_FORBID;
1590         struct ast_format_cap *cap0 = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1591         struct ast_format_cap *cap1 = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1592
1593         /* If there is no second channel just immediately bail out, we are of no use in that scenario */
1594         if (!c1 || !cap1 || !cap0) {
1595                 ao2_cleanup(cap0);
1596                 ao2_cleanup(cap1);
1597                 return -1;
1598         }
1599
1600         /* Lock both channels so we can look for the glue that binds them together */
1601         ast_channel_lock_both(c0, c1);
1602
1603         /* Grab glue that binds each channel to something using the RTP engine */
1604         if (!(glue0 = ast_rtp_instance_get_glue(ast_channel_tech(c0)->type)) || !(glue1 = ast_rtp_instance_get_glue(ast_channel_tech(c1)->type))) {
1605                 ast_log(LOG_WARNING, "Can't find native functions for channel '%s'\n", glue0 ? ast_channel_name(c1) : ast_channel_name(c0));
1606                 goto done;
1607         }
1608
1609         audio_glue0_res = glue0->get_rtp_info(c0, &instance0);
1610         video_glue0_res = glue0->get_vrtp_info ? glue0->get_vrtp_info(c0, &vinstance0) : AST_RTP_GLUE_RESULT_FORBID;
1611
1612         audio_glue1_res = glue1->get_rtp_info(c1, &instance1);
1613         video_glue1_res = glue1->get_vrtp_info ? glue1->get_vrtp_info(c1, &vinstance1) : AST_RTP_GLUE_RESULT_FORBID;
1614
1615         /* If we are carrying video, and both sides are not going to remotely bridge... fail the native bridge */
1616         if (video_glue0_res != AST_RTP_GLUE_RESULT_FORBID && (audio_glue0_res != AST_RTP_GLUE_RESULT_REMOTE || video_glue0_res != AST_RTP_GLUE_RESULT_REMOTE)) {
1617                 audio_glue0_res = AST_RTP_GLUE_RESULT_FORBID;
1618         }
1619         if (video_glue1_res != AST_RTP_GLUE_RESULT_FORBID && (audio_glue1_res != AST_RTP_GLUE_RESULT_REMOTE || video_glue1_res != AST_RTP_GLUE_RESULT_REMOTE)) {
1620                 audio_glue1_res = AST_RTP_GLUE_RESULT_FORBID;
1621         }
1622         if (audio_glue0_res == AST_RTP_GLUE_RESULT_REMOTE && (video_glue0_res == AST_RTP_GLUE_RESULT_FORBID || video_glue0_res == AST_RTP_GLUE_RESULT_REMOTE) && glue0->get_codec) {
1623                 glue0->get_codec(c0, cap0);
1624         }
1625         if (audio_glue1_res == AST_RTP_GLUE_RESULT_REMOTE && (video_glue1_res == AST_RTP_GLUE_RESULT_FORBID || video_glue1_res == AST_RTP_GLUE_RESULT_REMOTE) && glue1->get_codec) {
1626                 glue1->get_codec(c1, cap1);
1627         }
1628
1629         /* If any sort of bridge is forbidden just completely bail out and go back to generic bridging */
1630         if (audio_glue0_res != AST_RTP_GLUE_RESULT_REMOTE || audio_glue1_res != AST_RTP_GLUE_RESULT_REMOTE) {
1631                 goto done;
1632         }
1633
1634         /* Make sure we have matching codecs */
1635         if (!ast_format_cap_iscompatible(cap0, cap1)) {
1636                 goto done;
1637         }
1638
1639         /* Bridge media early */
1640         if (glue0->update_peer(c0, instance1, vinstance1, tinstance1, cap1, 0)) {
1641                 ast_log(LOG_WARNING, "Channel '%s' failed to setup early bridge to '%s'\n", ast_channel_name(c0), c1 ? ast_channel_name(c1) : "<unspecified>");
1642         }
1643
1644 done:
1645         ast_channel_unlock(c0);
1646         ast_channel_unlock(c1);
1647
1648         ao2_cleanup(cap0);
1649         ao2_cleanup(cap1);
1650
1651         unref_instance_cond(&instance0);
1652         unref_instance_cond(&instance1);
1653         unref_instance_cond(&vinstance0);
1654         unref_instance_cond(&vinstance1);
1655         unref_instance_cond(&tinstance0);
1656         unref_instance_cond(&tinstance1);
1657
1658         ast_debug(1, "Setting early bridge SDP of '%s' with that of '%s'\n", ast_channel_name(c0), c1 ? ast_channel_name(c1) : "<unspecified>");
1659
1660         return 0;
1661 }
1662
1663 int ast_rtp_red_init(struct ast_rtp_instance *instance, int buffer_time, int *payloads, int generations)
1664 {
1665         return instance->engine->red_init ? instance->engine->red_init(instance, buffer_time, payloads, generations) : -1;
1666 }
1667
1668 int ast_rtp_red_buffer(struct ast_rtp_instance *instance, struct ast_frame *frame)
1669 {
1670         return instance->engine->red_buffer ? instance->engine->red_buffer(instance, frame) : -1;
1671 }
1672
1673 int ast_rtp_instance_get_stats(struct ast_rtp_instance *instance, struct ast_rtp_instance_stats *stats, enum ast_rtp_instance_stat stat)
1674 {
1675         return instance->engine->get_stat ? instance->engine->get_stat(instance, stats, stat) : -1;
1676 }
1677
1678 char *ast_rtp_instance_get_quality(struct ast_rtp_instance *instance, enum ast_rtp_instance_stat_field field, char *buf, size_t size)
1679 {
1680         struct ast_rtp_instance_stats stats = { 0, };
1681         enum ast_rtp_instance_stat stat;
1682
1683         /* Determine what statistics we will need to retrieve based on field passed in */
1684         if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY) {
1685                 stat = AST_RTP_INSTANCE_STAT_ALL;
1686         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER) {
1687                 stat = AST_RTP_INSTANCE_STAT_COMBINED_JITTER;
1688         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS) {
1689                 stat = AST_RTP_INSTANCE_STAT_COMBINED_LOSS;
1690         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT) {
1691                 stat = AST_RTP_INSTANCE_STAT_COMBINED_RTT;
1692         } else {
1693                 return NULL;
1694         }
1695
1696         /* Attempt to actually retrieve the statistics we need to generate the quality string */
1697         if (ast_rtp_instance_get_stats(instance, &stats, stat)) {
1698                 return NULL;
1699         }
1700
1701         /* Now actually fill the buffer with the good information */
1702         if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY) {
1703                 snprintf(buf, size, "ssrc=%u;themssrc=%u;lp=%u;rxjitter=%f;rxcount=%u;txjitter=%f;txcount=%u;rlp=%u;rtt=%f",
1704                          stats.local_ssrc, stats.remote_ssrc, stats.rxploss, stats.rxjitter, stats.rxcount, stats.txjitter, stats.txcount, stats.txploss, stats.rtt);
1705         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER) {
1706                 snprintf(buf, size, "minrxjitter=%f;maxrxjitter=%f;avgrxjitter=%f;stdevrxjitter=%f;reported_minjitter=%f;reported_maxjitter=%f;reported_avgjitter=%f;reported_stdevjitter=%f;",
1707                          stats.local_minjitter, stats.local_maxjitter, stats.local_normdevjitter, sqrt(stats.local_stdevjitter), stats.remote_minjitter, stats.remote_maxjitter, stats.remote_normdevjitter, sqrt(stats.remote_stdevjitter));
1708         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS) {
1709                 snprintf(buf, size, "minrxlost=%f;maxrxlost=%f;avgrxlost=%f;stdevrxlost=%f;reported_minlost=%f;reported_maxlost=%f;reported_avglost=%f;reported_stdevlost=%f;",
1710                          stats.local_minrxploss, stats.local_maxrxploss, stats.local_normdevrxploss, sqrt(stats.local_stdevrxploss), stats.remote_minrxploss, stats.remote_maxrxploss, stats.remote_normdevrxploss, sqrt(stats.remote_stdevrxploss));
1711         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT) {
1712                 snprintf(buf, size, "minrtt=%f;maxrtt=%f;avgrtt=%f;stdevrtt=%f;", stats.minrtt, stats.maxrtt, stats.normdevrtt, stats.stdevrtt);
1713         }
1714
1715         return buf;
1716 }
1717
1718 void ast_rtp_instance_set_stats_vars(struct ast_channel *chan, struct ast_rtp_instance *instance)
1719 {
1720         char quality_buf[AST_MAX_USER_FIELD];
1721         char *quality;
1722         struct ast_channel *bridge = ast_channel_bridge_peer(chan);
1723
1724         ast_channel_lock(chan);
1725         ast_channel_stage_snapshot(chan);
1726         ast_channel_unlock(chan);
1727         if (bridge) {
1728                 ast_channel_lock(bridge);
1729                 ast_channel_stage_snapshot(bridge);
1730                 ast_channel_unlock(bridge);
1731         }
1732
1733         quality = ast_rtp_instance_get_quality(instance, AST_RTP_INSTANCE_STAT_FIELD_QUALITY,
1734                 quality_buf, sizeof(quality_buf));
1735         if (quality) {
1736                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOS", quality);
1737                 if (bridge) {
1738                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSBRIDGED", quality);
1739                 }
1740         }
1741
1742         quality = ast_rtp_instance_get_quality(instance,
1743                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER, quality_buf, sizeof(quality_buf));
1744         if (quality) {
1745                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSJITTER", quality);
1746                 if (bridge) {
1747                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSJITTERBRIDGED", quality);
1748                 }
1749         }
1750
1751         quality = ast_rtp_instance_get_quality(instance,
1752                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS, quality_buf, sizeof(quality_buf));
1753         if (quality) {
1754                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSLOSS", quality);
1755                 if (bridge) {
1756                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSLOSSBRIDGED", quality);
1757                 }
1758         }
1759
1760         quality = ast_rtp_instance_get_quality(instance,
1761                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT, quality_buf, sizeof(quality_buf));
1762         if (quality) {
1763                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSRTT", quality);
1764                 if (bridge) {
1765                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSRTTBRIDGED", quality);
1766                 }
1767         }
1768
1769         ast_channel_lock(chan);
1770         ast_channel_stage_snapshot_done(chan);
1771         ast_channel_unlock(chan);
1772         if (bridge) {
1773                 ast_channel_lock(bridge);
1774                 ast_channel_stage_snapshot_done(bridge);
1775                 ast_channel_unlock(bridge);
1776                 ast_channel_unref(bridge);
1777         }
1778 }
1779
1780 int ast_rtp_instance_set_read_format(struct ast_rtp_instance *instance, struct ast_format *format)
1781 {
1782         return instance->engine->set_read_format ? instance->engine->set_read_format(instance, format) : -1;
1783 }
1784
1785 int ast_rtp_instance_set_write_format(struct ast_rtp_instance *instance, struct ast_format *format)
1786 {
1787         return instance->engine->set_write_format ? instance->engine->set_write_format(instance, format) : -1;
1788 }
1789
1790 int ast_rtp_instance_make_compatible(struct ast_channel *chan, struct ast_rtp_instance *instance, struct ast_channel *peer)
1791 {
1792         struct ast_rtp_glue *glue;
1793         struct ast_rtp_instance *peer_instance = NULL;
1794         int res = -1;
1795
1796         if (!instance->engine->make_compatible) {
1797                 return -1;
1798         }
1799
1800         ast_channel_lock(peer);
1801
1802         if (!(glue = ast_rtp_instance_get_glue(ast_channel_tech(peer)->type))) {
1803                 ast_channel_unlock(peer);
1804                 return -1;
1805         }
1806
1807         glue->get_rtp_info(peer, &peer_instance);
1808         if (!peer_instance) {
1809                 ast_log(LOG_ERROR, "Unable to get_rtp_info for peer type %s\n", glue->type);
1810                 ast_channel_unlock(peer);
1811                 return -1;
1812         }
1813         if (peer_instance->engine != instance->engine) {
1814                 ast_log(LOG_ERROR, "Peer engine mismatch for type %s\n", glue->type);
1815                 ast_channel_unlock(peer);
1816                 ao2_ref(peer_instance, -1);
1817                 return -1;
1818         }
1819
1820         res = instance->engine->make_compatible(chan, instance, peer, peer_instance);
1821
1822         ast_channel_unlock(peer);
1823
1824         ao2_ref(peer_instance, -1);
1825         peer_instance = NULL;
1826
1827         return res;
1828 }
1829
1830 void ast_rtp_instance_available_formats(struct ast_rtp_instance *instance, struct ast_format_cap *to_endpoint, struct ast_format_cap *to_asterisk, struct ast_format_cap *result)
1831 {
1832         if (instance->engine->available_formats) {
1833                 instance->engine->available_formats(instance, to_endpoint, to_asterisk, result);
1834                 if (ast_format_cap_count(result)) {
1835                         return;
1836                 }
1837         }
1838
1839         ast_translate_available_formats(to_endpoint, to_asterisk, result);
1840 }
1841
1842 int ast_rtp_instance_activate(struct ast_rtp_instance *instance)
1843 {
1844         return instance->engine->activate ? instance->engine->activate(instance) : 0;
1845 }
1846
1847 void ast_rtp_instance_stun_request(struct ast_rtp_instance *instance,
1848                                    struct ast_sockaddr *suggestion,
1849                                    const char *username)
1850 {
1851         if (instance->engine->stun_request) {
1852                 instance->engine->stun_request(instance, suggestion, username);
1853         }
1854 }
1855
1856 void ast_rtp_instance_set_timeout(struct ast_rtp_instance *instance, int timeout)
1857 {
1858         instance->timeout = timeout;
1859 }
1860
1861 void ast_rtp_instance_set_hold_timeout(struct ast_rtp_instance *instance, int timeout)
1862 {
1863         instance->holdtimeout = timeout;
1864 }
1865
1866 void ast_rtp_instance_set_keepalive(struct ast_rtp_instance *instance, int interval)
1867 {
1868         instance->keepalive = interval;
1869 }
1870
1871 int ast_rtp_instance_get_timeout(struct ast_rtp_instance *instance)
1872 {
1873         return instance->timeout;
1874 }
1875
1876 int ast_rtp_instance_get_hold_timeout(struct ast_rtp_instance *instance)
1877 {
1878         return instance->holdtimeout;
1879 }
1880
1881 int ast_rtp_instance_get_keepalive(struct ast_rtp_instance *instance)
1882 {
1883         return instance->keepalive;
1884 }
1885
1886 struct ast_rtp_engine *ast_rtp_instance_get_engine(struct ast_rtp_instance *instance)
1887 {
1888         return instance->engine;
1889 }
1890
1891 struct ast_rtp_glue *ast_rtp_instance_get_active_glue(struct ast_rtp_instance *instance)
1892 {
1893         return instance->glue;
1894 }
1895
1896 int ast_rtp_engine_register_srtp(struct ast_srtp_res *srtp_res, struct ast_srtp_policy_res *policy_res)
1897 {
1898         if (res_srtp || res_srtp_policy) {
1899                 return -1;
1900         }
1901         if (!srtp_res || !policy_res) {
1902                 return -1;
1903         }
1904
1905         res_srtp = srtp_res;
1906         res_srtp_policy = policy_res;
1907
1908         return 0;
1909 }
1910
1911 void ast_rtp_engine_unregister_srtp(void)
1912 {
1913         res_srtp = NULL;
1914         res_srtp_policy = NULL;
1915 }
1916
1917 int ast_rtp_engine_srtp_is_registered(void)
1918 {
1919         return res_srtp && res_srtp_policy;
1920 }
1921
1922 int ast_rtp_instance_add_srtp_policy(struct ast_rtp_instance *instance, struct ast_srtp_policy *remote_policy, struct ast_srtp_policy *local_policy)
1923 {
1924         int res = 0;
1925
1926         if (!res_srtp) {
1927                 return -1;
1928         }
1929
1930         if (!instance->srtp) {
1931                 res = res_srtp->create(&instance->srtp, instance, remote_policy);
1932         } else {
1933                 res = res_srtp->replace(&instance->srtp, instance, remote_policy);
1934         }
1935         if (!res) {
1936                 res = res_srtp->add_stream(instance->srtp, local_policy);
1937         }
1938
1939         return res;
1940 }
1941
1942 struct ast_srtp *ast_rtp_instance_get_srtp(struct ast_rtp_instance *instance)
1943 {
1944         return instance->srtp;
1945 }
1946
1947 int ast_rtp_instance_sendcng(struct ast_rtp_instance *instance, int level)
1948 {
1949         if (instance->engine->sendcng) {
1950                 return instance->engine->sendcng(instance, level);
1951         }
1952
1953         return -1;
1954 }
1955
1956 struct ast_rtp_engine_ice *ast_rtp_instance_get_ice(struct ast_rtp_instance *instance)
1957 {
1958         return instance->engine->ice;
1959 }
1960
1961 struct ast_rtp_engine_dtls *ast_rtp_instance_get_dtls(struct ast_rtp_instance *instance)
1962 {
1963         return instance->engine->dtls;
1964 }
1965
1966 int ast_rtp_dtls_cfg_parse(struct ast_rtp_dtls_cfg *dtls_cfg, const char *name, const char *value)
1967 {
1968         if (!strcasecmp(name, "dtlsenable")) {
1969                 dtls_cfg->enabled = ast_true(value) ? 1 : 0;
1970         } else if (!strcasecmp(name, "dtlsverify")) {
1971                 if (!strcasecmp(value, "yes")) {
1972                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_FINGERPRINT | AST_RTP_DTLS_VERIFY_CERTIFICATE;
1973                 } else if (!strcasecmp(value, "fingerprint")) {
1974                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_FINGERPRINT;
1975                 } else if (!strcasecmp(value, "certificate")) {
1976                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_CERTIFICATE;
1977                 } else if (!strcasecmp(value, "no")) {
1978                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_NONE;
1979                 } else {
1980                         return -1;
1981                 }
1982         } else if (!strcasecmp(name, "dtlsrekey")) {
1983                 if (sscanf(value, "%30u", &dtls_cfg->rekey) != 1) {
1984                         return -1;
1985                 }
1986         } else if (!strcasecmp(name, "dtlscertfile")) {
1987                 ast_free(dtls_cfg->certfile);
1988                 dtls_cfg->certfile = ast_strdup(value);
1989         } else if (!strcasecmp(name, "dtlsprivatekey")) {
1990                 ast_free(dtls_cfg->pvtfile);
1991                 dtls_cfg->pvtfile = ast_strdup(value);
1992         } else if (!strcasecmp(name, "dtlscipher")) {
1993                 ast_free(dtls_cfg->cipher);
1994                 dtls_cfg->cipher = ast_strdup(value);
1995         } else if (!strcasecmp(name, "dtlscafile")) {
1996                 ast_free(dtls_cfg->cafile);
1997                 dtls_cfg->cafile = ast_strdup(value);
1998         } else if (!strcasecmp(name, "dtlscapath") || !strcasecmp(name, "dtlscadir")) {
1999                 ast_free(dtls_cfg->capath);
2000                 dtls_cfg->capath = ast_strdup(value);
2001         } else if (!strcasecmp(name, "dtlssetup")) {
2002                 if (!strcasecmp(value, "active")) {
2003                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_ACTIVE;
2004                 } else if (!strcasecmp(value, "passive")) {
2005                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_PASSIVE;
2006                 } else if (!strcasecmp(value, "actpass")) {
2007                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_ACTPASS;
2008                 }
2009         } else if (!strcasecmp(name, "dtlsfingerprint")) {
2010                 if (!strcasecmp(value, "sha-256")) {
2011                         dtls_cfg->hash = AST_RTP_DTLS_HASH_SHA256;
2012                 } else if (!strcasecmp(value, "sha-1")) {
2013                         dtls_cfg->hash = AST_RTP_DTLS_HASH_SHA1;
2014                 }
2015         } else {
2016                 return -1;
2017         }
2018
2019         return 0;
2020 }
2021
2022 void ast_rtp_dtls_cfg_copy(const struct ast_rtp_dtls_cfg *src_cfg, struct ast_rtp_dtls_cfg *dst_cfg)
2023 {
2024         ast_rtp_dtls_cfg_free(dst_cfg);         /* Prevent a double-call leaking memory via ast_strdup */
2025
2026         dst_cfg->enabled = src_cfg->enabled;
2027         dst_cfg->verify = src_cfg->verify;
2028         dst_cfg->rekey = src_cfg->rekey;
2029         dst_cfg->suite = src_cfg->suite;
2030         dst_cfg->hash = src_cfg->hash;
2031         dst_cfg->certfile = ast_strdup(src_cfg->certfile);
2032         dst_cfg->pvtfile = ast_strdup(src_cfg->pvtfile);
2033         dst_cfg->cipher = ast_strdup(src_cfg->cipher);
2034         dst_cfg->cafile = ast_strdup(src_cfg->cafile);
2035         dst_cfg->capath = ast_strdup(src_cfg->capath);
2036         dst_cfg->default_setup = src_cfg->default_setup;
2037 }
2038
2039 void ast_rtp_dtls_cfg_free(struct ast_rtp_dtls_cfg *dtls_cfg)
2040 {
2041         ast_free(dtls_cfg->certfile);
2042         dtls_cfg->certfile = NULL;
2043         ast_free(dtls_cfg->pvtfile);
2044         dtls_cfg->pvtfile = NULL;
2045         ast_free(dtls_cfg->cipher);
2046         dtls_cfg->cipher = NULL;
2047         ast_free(dtls_cfg->cafile);
2048         dtls_cfg->cafile = NULL;
2049         ast_free(dtls_cfg->capath);
2050         dtls_cfg->capath = NULL;
2051 }
2052
2053 /*! \internal
2054  * \brief Small helper routine that cleans up entry i in
2055  * \c ast_rtp_mime_types.
2056  */
2057 static void rtp_engine_mime_type_cleanup(int i)
2058 {
2059         ao2_cleanup(ast_rtp_mime_types[i].payload_type.format);
2060         memset(&ast_rtp_mime_types[i], 0, sizeof(struct ast_rtp_mime_type));
2061 }
2062
2063 static void set_next_mime_type(struct ast_format *format, int rtp_code, const char *type, const char *subtype, unsigned int sample_rate)
2064 {
2065         int x;
2066
2067         ast_rwlock_wrlock(&mime_types_lock);
2068
2069         x = mime_types_len;
2070         if (ARRAY_LEN(ast_rtp_mime_types) <= x) {
2071                 ast_rwlock_unlock(&mime_types_lock);
2072                 return;
2073         }
2074
2075         /* Make sure any previous value in ast_rtp_mime_types is cleaned up */
2076         memset(&ast_rtp_mime_types[x], 0, sizeof(struct ast_rtp_mime_type));    
2077         if (format) {
2078                 ast_rtp_mime_types[x].payload_type.asterisk_format = 1;
2079                 ast_rtp_mime_types[x].payload_type.format = ao2_bump(format);
2080         } else {
2081                 ast_rtp_mime_types[x].payload_type.rtp_code = rtp_code;
2082         }
2083         ast_copy_string(ast_rtp_mime_types[x].type, type, sizeof(ast_rtp_mime_types[x].type));
2084         ast_copy_string(ast_rtp_mime_types[x].subtype, subtype, sizeof(ast_rtp_mime_types[x].subtype));
2085         ast_rtp_mime_types[x].sample_rate = sample_rate;
2086         mime_types_len++;
2087
2088         ast_rwlock_unlock(&mime_types_lock);
2089 }
2090
2091 static void add_static_payload(int map, struct ast_format *format, int rtp_code)
2092 {
2093         int x;
2094         struct ast_rtp_payload_type *type;
2095
2096         ast_assert(map < ARRAY_LEN(static_RTP_PT));
2097
2098         ast_rwlock_wrlock(&static_RTP_PT_lock);
2099         if (map < 0) {
2100                 /* find next available dynamic payload slot */
2101                 for (x = AST_RTP_PT_FIRST_DYNAMIC; x < AST_RTP_MAX_PT; ++x) {
2102                         if (!static_RTP_PT[x]) {
2103                                 map = x;
2104                                 break;
2105                         }
2106                 }
2107                 if (map < 0) {
2108                         if (format) {
2109                                 ast_log(LOG_WARNING, "No Dynamic RTP mapping available for format %s\n",
2110                                         ast_format_get_name(format));
2111                         } else {
2112                                 ast_log(LOG_WARNING, "No Dynamic RTP mapping available for RTP code %d\n",
2113                                         rtp_code);
2114                         }
2115                         ast_rwlock_unlock(&static_RTP_PT_lock);
2116                         return;
2117                 }
2118         }
2119
2120         type = ast_rtp_engine_alloc_payload_type();
2121         if (type) {
2122                 if (format) {
2123                         ao2_ref(format, +1);
2124                         type->format = format;
2125                         type->asterisk_format = 1;
2126                 } else {
2127                         type->rtp_code = rtp_code;
2128                 }
2129                 type->payload = map;
2130                 type->primary_mapping = 1;
2131                 ao2_cleanup(static_RTP_PT[map]);
2132                 static_RTP_PT[map] = type;
2133         }
2134         ast_rwlock_unlock(&static_RTP_PT_lock);
2135 }
2136
2137 int ast_rtp_engine_load_format(struct ast_format *format)
2138 {
2139         char *codec_name = ast_strdupa(ast_format_get_name(format));
2140
2141         codec_name = ast_str_to_upper(codec_name);
2142
2143         set_next_mime_type(format,
2144                 0,
2145                 ast_codec_media_type2str(ast_format_get_type(format)),
2146                 codec_name,
2147                 ast_format_get_sample_rate(format));
2148         add_static_payload(-1, format, 0);
2149
2150         return 0;
2151 }
2152
2153 int ast_rtp_engine_unload_format(struct ast_format *format)
2154 {
2155         int x;
2156         int y = 0;
2157
2158         ast_rwlock_wrlock(&static_RTP_PT_lock);
2159         /* remove everything pertaining to this format id from the lists */
2160         for (x = 0; x < AST_RTP_MAX_PT; x++) {
2161                 if (static_RTP_PT[x]
2162                         && ast_format_cmp(static_RTP_PT[x]->format, format) == AST_FORMAT_CMP_EQUAL) {
2163                         ao2_ref(static_RTP_PT[x], -1);
2164                         static_RTP_PT[x] = NULL;
2165                 }
2166         }
2167         ast_rwlock_unlock(&static_RTP_PT_lock);
2168
2169         ast_rwlock_wrlock(&mime_types_lock);
2170         /* rebuild the list skipping the items matching this id */
2171         for (x = 0; x < mime_types_len; x++) {
2172                 if (ast_format_cmp(ast_rtp_mime_types[x].payload_type.format, format) == AST_FORMAT_CMP_EQUAL) {
2173                         rtp_engine_mime_type_cleanup(x);
2174                         continue;
2175                 }
2176                 if (x != y) {
2177                         ast_rtp_mime_types[y] = ast_rtp_mime_types[x];
2178                 }
2179                 y++;
2180         }
2181         mime_types_len = y;
2182         ast_rwlock_unlock(&mime_types_lock);
2183         return 0;
2184 }
2185
2186 /*!
2187  * \internal
2188  * \brief \ref stasis message payload for RTCP messages
2189  */
2190 struct rtcp_message_payload {
2191         struct ast_channel_snapshot *snapshot;  /*< The channel snapshot, if available */
2192         struct ast_rtp_rtcp_report *report;     /*< The RTCP report */
2193         struct ast_json *blob;                  /*< Extra JSON data to publish */
2194 };
2195
2196 static void rtcp_message_payload_dtor(void *obj)
2197 {
2198         struct rtcp_message_payload *payload = obj;
2199
2200         ao2_cleanup(payload->report);
2201         ao2_cleanup(payload->snapshot);
2202         ast_json_unref(payload->blob);
2203 }
2204
2205 static struct ast_manager_event_blob *rtcp_report_to_ami(struct stasis_message *msg)
2206 {
2207         struct rtcp_message_payload *payload = stasis_message_data(msg);
2208         RAII_VAR(struct ast_str *, channel_string, NULL, ast_free);
2209         RAII_VAR(struct ast_str *, packet_string, ast_str_create(512), ast_free);
2210         unsigned int ssrc = payload->report->ssrc;
2211         unsigned int type = payload->report->type;
2212         unsigned int report_count = payload->report->reception_report_count;
2213         int i;
2214
2215         if (!packet_string) {
2216                 return NULL;
2217         }
2218
2219         if (payload->snapshot) {
2220                 channel_string = ast_manager_build_channel_state_string(payload->snapshot);
2221                 if (!channel_string) {
2222                         return NULL;
2223                 }
2224         }
2225
2226         if (payload->blob) {
2227                 /* Optional data */
2228                 struct ast_json *to = ast_json_object_get(payload->blob, "to");
2229                 struct ast_json *from = ast_json_object_get(payload->blob, "from");
2230                 struct ast_json *rtt = ast_json_object_get(payload->blob, "rtt");
2231                 if (to) {
2232                         ast_str_append(&packet_string, 0, "To: %s\r\n", ast_json_string_get(to));
2233                 }
2234                 if (from) {
2235                         ast_str_append(&packet_string, 0, "From: %s\r\n", ast_json_string_get(from));
2236                 }
2237                 if (rtt) {
2238                         ast_str_append(&packet_string, 0, "RTT: %4.4f\r\n", ast_json_real_get(rtt));
2239                 }
2240         }
2241
2242         ast_str_append(&packet_string, 0, "SSRC: 0x%.8x\r\n", ssrc);
2243         ast_str_append(&packet_string, 0, "PT: %u(%s)\r\n", type, type== AST_RTP_RTCP_SR ? "SR" : "RR");
2244         ast_str_append(&packet_string, 0, "ReportCount: %u\r\n", report_count);
2245         if (type == AST_RTP_RTCP_SR) {
2246                 ast_str_append(&packet_string, 0, "SentNTP: %lu.%06lu\r\n",
2247                         (unsigned long)payload->report->sender_information.ntp_timestamp.tv_sec,
2248                         (unsigned long)payload->report->sender_information.ntp_timestamp.tv_usec * 4096);
2249                 ast_str_append(&packet_string, 0, "SentRTP: %u\r\n",
2250                                 payload->report->sender_information.rtp_timestamp);
2251                 ast_str_append(&packet_string, 0, "SentPackets: %u\r\n",
2252                                 payload->report->sender_information.packet_count);
2253                 ast_str_append(&packet_string, 0, "SentOctets: %u\r\n",
2254                                 payload->report->sender_information.octet_count);
2255         }
2256
2257         for (i = 0; i < report_count; i++) {
2258                 RAII_VAR(struct ast_str *, report_string, NULL, ast_free);
2259
2260                 if (!payload->report->report_block[i]) {
2261                         break;
2262                 }
2263
2264                 report_string = ast_str_create(256);
2265                 if (!report_string) {
2266                         return NULL;
2267                 }
2268
2269                 ast_str_append(&report_string, 0, "Report%dSourceSSRC: 0x%.8x\r\n",
2270                                 i, payload->report->report_block[i]->source_ssrc);
2271                 ast_str_append(&report_string, 0, "Report%dFractionLost: %d\r\n",
2272                                 i, payload->report->report_block[i]->lost_count.fraction);
2273                 ast_str_append(&report_string, 0, "Report%dCumulativeLost: %u\r\n",
2274                                 i, payload->report->report_block[i]->lost_count.packets);
2275                 ast_str_append(&report_string, 0, "Report%dHighestSequence: %u\r\n",
2276                                 i, payload->report->report_block[i]->highest_seq_no & 0xffff);
2277                 ast_str_append(&report_string, 0, "Report%dSequenceNumberCycles: %u\r\n",
2278                                 i, payload->report->report_block[i]->highest_seq_no >> 16);
2279                 ast_str_append(&report_string, 0, "Report%dIAJitter: %u\r\n",
2280                                 i, payload->report->report_block[i]->ia_jitter);
2281                 ast_str_append(&report_string, 0, "Report%dLSR: %u\r\n",
2282                                 i, payload->report->report_block[i]->lsr);
2283                 ast_str_append(&report_string, 0, "Report%dDLSR: %4.4f\r\n",
2284                                 i, ((double)payload->report->report_block[i]->dlsr) / 65536);
2285                 ast_str_append(&packet_string, 0, "%s", ast_str_buffer(report_string));
2286         }
2287
2288         return ast_manager_event_blob_create(EVENT_FLAG_REPORTING,
2289                 stasis_message_type(msg) == ast_rtp_rtcp_received_type() ? "RTCPReceived" : "RTCPSent",
2290                 "%s%s",
2291                 AS_OR(channel_string, ""),
2292                 ast_str_buffer(packet_string));
2293 }
2294
2295 static struct ast_json *rtcp_report_to_json(struct stasis_message *msg,
2296         const struct stasis_message_sanitizer *sanitize)
2297 {
2298         struct rtcp_message_payload *payload = stasis_message_data(msg);
2299         RAII_VAR(struct ast_json *, json_rtcp_report, NULL, ast_json_unref);
2300         RAII_VAR(struct ast_json *, json_rtcp_report_blocks, NULL, ast_json_unref);
2301         RAII_VAR(struct ast_json *, json_rtcp_sender_info, NULL, ast_json_unref);
2302         RAII_VAR(struct ast_json *, json_channel, NULL, ast_json_unref);
2303         int i;
2304
2305         json_rtcp_report_blocks = ast_json_array_create();
2306         if (!json_rtcp_report_blocks) {
2307                 return NULL;
2308         }
2309
2310         for (i = 0; i < payload->report->reception_report_count && payload->report->report_block[i]; i++) {
2311                 struct ast_json *json_report_block;
2312                 char str_lsr[32];
2313                 snprintf(str_lsr, sizeof(str_lsr), "%u", payload->report->report_block[i]->lsr);
2314                 json_report_block = ast_json_pack("{s: i, s: i, s: i, s: i, s: i, s: s, s: i}",
2315                                 "source_ssrc", payload->report->report_block[i]->source_ssrc,
2316                                 "fraction_lost", payload->report->report_block[i]->lost_count.fraction,
2317                                 "packets_lost", payload->report->report_block[i]->lost_count.packets,
2318                                 "highest_seq_no", payload->report->report_block[i]->highest_seq_no,
2319                                 "ia_jitter", payload->report->report_block[i]->ia_jitter,
2320                                 "lsr", str_lsr,
2321                                 "dlsr", payload->report->report_block[i]->dlsr);
2322                 if (!json_report_block) {
2323                         return NULL;
2324                 }
2325
2326                 if (ast_json_array_append(json_rtcp_report_blocks, json_report_block)) {
2327                         return NULL;
2328                 }
2329         }
2330
2331         if (payload->report->type == AST_RTP_RTCP_SR) {
2332                 char sec[32];
2333                 char usec[32];
2334                 snprintf(sec, sizeof(sec), "%lu", (unsigned long)payload->report->sender_information.ntp_timestamp.tv_sec);
2335                 snprintf(usec, sizeof(usec), "%lu", (unsigned long)payload->report->sender_information.ntp_timestamp.tv_usec);
2336                 json_rtcp_sender_info = ast_json_pack("{s: s, s: s, s: i, s: i, s: i}",
2337                                 "ntp_timestamp_sec", sec,
2338                                 "ntp_timestamp_usec", usec,
2339                                 "rtp_timestamp", payload->report->sender_information.rtp_timestamp,
2340                                 "packets", payload->report->sender_information.packet_count,
2341                                 "octets", payload->report->sender_information.octet_count);
2342                 if (!json_rtcp_sender_info) {
2343                         return NULL;
2344                 }
2345         }
2346
2347         json_rtcp_report = ast_json_pack("{s: i, s: i, s: i, s: O, s: O}",
2348                         "ssrc", payload->report->ssrc,
2349                         "type", payload->report->type,
2350                         "report_count", payload->report->reception_report_count,
2351                         "sender_information", json_rtcp_sender_info ? json_rtcp_sender_info : ast_json_null(),
2352                         "report_blocks", json_rtcp_report_blocks);
2353         if (!json_rtcp_report) {
2354                 return NULL;
2355         }
2356
2357         if (payload->snapshot) {
2358                 json_channel = ast_channel_snapshot_to_json(payload->snapshot, sanitize);
2359                 if (!json_channel) {
2360                         return NULL;
2361                 }
2362         }
2363
2364         return ast_json_pack("{s: O, s: O, s: O}",
2365                 "channel", payload->snapshot ? json_channel : ast_json_null(),
2366                 "rtcp_report", json_rtcp_report,
2367                 "blob", payload->blob);
2368 }
2369
2370 static void rtp_rtcp_report_dtor(void *obj)
2371 {
2372         int i;
2373         struct ast_rtp_rtcp_report *rtcp_report = obj;
2374
2375         for (i = 0; i < rtcp_report->reception_report_count; i++) {
2376                 ast_free(rtcp_report->report_block[i]);
2377         }
2378 }
2379
2380 struct ast_rtp_rtcp_report *ast_rtp_rtcp_report_alloc(unsigned int report_blocks)
2381 {
2382         struct ast_rtp_rtcp_report *rtcp_report;
2383
2384         /* Size of object is sizeof the report + the number of report_blocks * sizeof pointer */
2385         rtcp_report = ao2_alloc((sizeof(*rtcp_report) + report_blocks * sizeof(struct ast_rtp_rtcp_report_block *)),
2386                 rtp_rtcp_report_dtor);
2387
2388         return rtcp_report;
2389 }
2390
2391 void ast_rtp_publish_rtcp_message(struct ast_rtp_instance *rtp,
2392                 struct stasis_message_type *message_type,
2393                 struct ast_rtp_rtcp_report *report,
2394                 struct ast_json *blob)
2395 {
2396         RAII_VAR(struct rtcp_message_payload *, payload, NULL, ao2_cleanup);
2397         RAII_VAR(struct stasis_message *, message, NULL, ao2_cleanup);
2398
2399         if (!message_type) {
2400                 return;
2401         }
2402
2403         payload = ao2_alloc(sizeof(*payload), rtcp_message_payload_dtor);
2404         if (!payload || !report) {
2405                 return;
2406         }
2407
2408         if (!ast_strlen_zero(rtp->channel_uniqueid)) {
2409                 payload->snapshot = ast_channel_snapshot_get_latest(rtp->channel_uniqueid);
2410         }
2411         if (blob) {
2412                 payload->blob = blob;
2413                 ast_json_ref(blob);
2414         }
2415         ao2_ref(report, +1);
2416         payload->report = report;
2417
2418         message = stasis_message_create(message_type, payload);
2419         if (!message) {
2420                 return;
2421         }
2422
2423         stasis_publish(ast_rtp_topic(), message);
2424 }
2425
2426 /*!
2427  * @{ \brief Define RTCP/RTP message types.
2428  */
2429 STASIS_MESSAGE_TYPE_DEFN(ast_rtp_rtcp_sent_type,
2430                 .to_ami = rtcp_report_to_ami,
2431                 .to_json = rtcp_report_to_json,);
2432 STASIS_MESSAGE_TYPE_DEFN(ast_rtp_rtcp_received_type,
2433                 .to_ami = rtcp_report_to_ami,
2434                 .to_json = rtcp_report_to_json,);
2435 /*! @} */
2436
2437 struct stasis_topic *ast_rtp_topic(void)
2438 {
2439         return rtp_topic;
2440 }
2441
2442 static void rtp_engine_shutdown(void)
2443 {
2444         int x;
2445
2446         ao2_cleanup(rtp_topic);
2447         rtp_topic = NULL;
2448         STASIS_MESSAGE_TYPE_CLEANUP(ast_rtp_rtcp_received_type);
2449         STASIS_MESSAGE_TYPE_CLEANUP(ast_rtp_rtcp_sent_type);
2450
2451         ast_rwlock_wrlock(&static_RTP_PT_lock);
2452         for (x = 0; x < AST_RTP_MAX_PT; x++) {
2453                 ao2_cleanup(static_RTP_PT[x]);
2454                 static_RTP_PT[x] = NULL;
2455         }
2456         ast_rwlock_unlock(&static_RTP_PT_lock);
2457
2458         ast_rwlock_wrlock(&mime_types_lock);
2459         for (x = 0; x < mime_types_len; x++) {
2460                 if (ast_rtp_mime_types[x].payload_type.format) {
2461                         rtp_engine_mime_type_cleanup(x);
2462                 }
2463         }
2464         mime_types_len = 0;
2465         ast_rwlock_unlock(&mime_types_lock);
2466 }
2467
2468 int ast_rtp_engine_init(void)
2469 {
2470         ast_rwlock_init(&mime_types_lock);
2471         ast_rwlock_init(&static_RTP_PT_lock);
2472
2473         rtp_topic = stasis_topic_create("rtp_topic");
2474         if (!rtp_topic) {
2475                 return -1;
2476         }
2477         STASIS_MESSAGE_TYPE_INIT(ast_rtp_rtcp_sent_type);
2478         STASIS_MESSAGE_TYPE_INIT(ast_rtp_rtcp_received_type);
2479         ast_register_cleanup(rtp_engine_shutdown);
2480
2481         /* Define all the RTP mime types available */
2482         set_next_mime_type(ast_format_g723, 0, "audio", "G723", 8000);
2483         set_next_mime_type(ast_format_gsm, 0, "audio", "GSM", 8000);
2484         set_next_mime_type(ast_format_ulaw, 0, "audio", "PCMU", 8000);
2485         set_next_mime_type(ast_format_ulaw, 0, "audio", "G711U", 8000);
2486         set_next_mime_type(ast_format_alaw, 0, "audio", "PCMA", 8000);
2487         set_next_mime_type(ast_format_alaw, 0, "audio", "G711A", 8000);
2488         set_next_mime_type(ast_format_g726, 0, "audio", "G726-32", 8000);
2489         set_next_mime_type(ast_format_adpcm, 0, "audio", "DVI4", 8000);
2490         set_next_mime_type(ast_format_slin, 0, "audio", "L16", 8000);
2491         set_next_mime_type(ast_format_slin16, 0, "audio", "L16", 16000);
2492         set_next_mime_type(ast_format_slin16, 0, "audio", "L16-256", 16000);
2493         set_next_mime_type(ast_format_slin12, 0, "audio", "L16", 12000);
2494         set_next_mime_type(ast_format_slin24, 0, "audio", "L16", 24000);
2495         set_next_mime_type(ast_format_slin32, 0, "audio", "L16", 32000);
2496         set_next_mime_type(ast_format_slin44, 0, "audio", "L16", 44000);
2497         set_next_mime_type(ast_format_slin48, 0, "audio", "L16", 48000);
2498         set_next_mime_type(ast_format_slin96, 0, "audio", "L16", 96000);
2499         set_next_mime_type(ast_format_slin192, 0, "audio", "L16", 192000);
2500         set_next_mime_type(ast_format_lpc10, 0, "audio", "LPC", 8000);
2501         set_next_mime_type(ast_format_g729, 0, "audio", "G729", 8000);
2502         set_next_mime_type(ast_format_g729, 0, "audio", "G729A", 8000);
2503         set_next_mime_type(ast_format_g729, 0, "audio", "G.729", 8000);
2504         set_next_mime_type(ast_format_speex, 0, "audio", "speex", 8000);
2505         set_next_mime_type(ast_format_speex16, 0,  "audio", "speex", 16000);
2506         set_next_mime_type(ast_format_speex32, 0,  "audio", "speex", 32000);
2507         set_next_mime_type(ast_format_ilbc, 0, "audio", "iLBC", 8000);
2508         /* this is the sample rate listed in the RTP profile for the G.722 codec, *NOT* the actual sample rate of the media stream */
2509         set_next_mime_type(ast_format_g722, 0, "audio", "G722", 8000);
2510         set_next_mime_type(ast_format_g726_aal2, 0, "audio", "AAL2-G726-32", 8000);
2511         set_next_mime_type(NULL, AST_RTP_DTMF, "audio", "telephone-event", 8000);
2512         set_next_mime_type(NULL, AST_RTP_CISCO_DTMF, "audio", "cisco-telephone-event", 8000);
2513         set_next_mime_type(NULL, AST_RTP_CN, "audio", "CN", 8000);
2514         set_next_mime_type(ast_format_jpeg, 0, "video", "JPEG", 90000);
2515         set_next_mime_type(ast_format_png, 0, "video", "PNG", 90000);
2516         set_next_mime_type(ast_format_h261, 0, "video", "H261", 90000);
2517         set_next_mime_type(ast_format_h263, 0, "video", "H263", 90000);
2518         set_next_mime_type(ast_format_h263p, 0, "video", "h263-1998", 90000);
2519         set_next_mime_type(ast_format_h264, 0, "video", "H264", 90000);
2520         set_next_mime_type(ast_format_mp4, 0, "video", "MP4V-ES", 90000);
2521         set_next_mime_type(ast_format_t140_red, 0, "text", "RED", 1000);
2522         set_next_mime_type(ast_format_t140, 0, "text", "T140", 1000);
2523         set_next_mime_type(ast_format_siren7, 0, "audio", "G7221", 16000);
2524         set_next_mime_type(ast_format_siren14, 0, "audio", "G7221", 32000);
2525         set_next_mime_type(ast_format_g719, 0, "audio", "G719", 48000);
2526         /* Opus and VP8 */
2527         set_next_mime_type(ast_format_opus, 0,  "audio", "opus", 48000);
2528         set_next_mime_type(ast_format_vp8, 0,  "video", "VP8", 90000);
2529
2530         /* Define the static rtp payload mappings */
2531         add_static_payload(0, ast_format_ulaw, 0);
2532         #ifdef USE_DEPRECATED_G726
2533         add_static_payload(2, ast_format_g726, 0);/* Technically this is G.721, but if Cisco can do it, so can we... */
2534         #endif
2535         add_static_payload(3, ast_format_gsm, 0);
2536         add_static_payload(4, ast_format_g723, 0);
2537         add_static_payload(5, ast_format_adpcm, 0);/* 8 kHz */
2538         add_static_payload(6, ast_format_adpcm, 0); /* 16 kHz */
2539         add_static_payload(7, ast_format_lpc10, 0);
2540         add_static_payload(8, ast_format_alaw, 0);
2541         add_static_payload(9, ast_format_g722, 0);
2542         add_static_payload(10, ast_format_slin, 0); /* 2 channels */
2543         add_static_payload(11, ast_format_slin, 0); /* 1 channel */
2544         add_static_payload(13, NULL, AST_RTP_CN);
2545         add_static_payload(16, ast_format_adpcm, 0); /* 11.025 kHz */
2546         add_static_payload(17, ast_format_adpcm, 0); /* 22.050 kHz */
2547         add_static_payload(18, ast_format_g729, 0);
2548         add_static_payload(19, NULL, AST_RTP_CN);         /* Also used for CN */
2549         add_static_payload(26, ast_format_jpeg, 0);
2550         add_static_payload(31, ast_format_h261, 0);
2551         add_static_payload(34, ast_format_h263, 0);
2552         add_static_payload(97, ast_format_ilbc, 0);
2553         add_static_payload(98, ast_format_h263p, 0);
2554         add_static_payload(99, ast_format_h264, 0);
2555         add_static_payload(101, NULL, AST_RTP_DTMF);
2556         add_static_payload(102, ast_format_siren7, 0);
2557         add_static_payload(103, ast_format_h263p, 0);
2558         add_static_payload(104, ast_format_mp4, 0);
2559         add_static_payload(105, ast_format_t140_red, 0);   /* Real time text chat (with redundancy encoding) */
2560         add_static_payload(106, ast_format_t140, 0);     /* Real time text chat */
2561         add_static_payload(110, ast_format_speex, 0);
2562         add_static_payload(111, ast_format_g726, 0);
2563         add_static_payload(112, ast_format_g726_aal2, 0);
2564         add_static_payload(115, ast_format_siren14, 0);
2565         add_static_payload(116, ast_format_g719, 0);
2566         add_static_payload(117, ast_format_speex16, 0);
2567         add_static_payload(118, ast_format_slin16, 0); /* 16 Khz signed linear */
2568         add_static_payload(119, ast_format_speex32, 0);
2569         add_static_payload(121, NULL, AST_RTP_CISCO_DTMF);   /* Must be type 121 */
2570         add_static_payload(122, ast_format_slin12, 0);
2571         add_static_payload(123, ast_format_slin24, 0);
2572         add_static_payload(124, ast_format_slin32, 0);
2573         add_static_payload(125, ast_format_slin44, 0);
2574         add_static_payload(126, ast_format_slin48, 0);
2575         add_static_payload(127, ast_format_slin96, 0);
2576         /* payload types above 127 are not valid */
2577         add_static_payload(96, ast_format_slin192, 0);
2578         /* Opus and VP8 */
2579         add_static_payload(100, ast_format_vp8, 0);
2580         add_static_payload(107, ast_format_opus, 0);
2581
2582         return 0;
2583 }
2584
2585 time_t ast_rtp_instance_get_last_tx(const struct ast_rtp_instance *rtp)
2586 {
2587         return rtp->last_tx;
2588 }
2589
2590 void ast_rtp_instance_set_last_tx(struct ast_rtp_instance *rtp, time_t time)
2591 {
2592         rtp->last_tx = time;
2593 }
2594
2595 time_t ast_rtp_instance_get_last_rx(const struct ast_rtp_instance *rtp)
2596 {
2597         return rtp->last_rx;
2598 }
2599
2600 void ast_rtp_instance_set_last_rx(struct ast_rtp_instance *rtp, time_t time)
2601 {
2602         rtp->last_rx = time;
2603 }