rtp_engine.c: Initial split of payload types into rx and tx mappings.
[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 Copy the rx payload type mapping to the destination.
682  * \since 14.0.0
683  *
684  * \param src The source codecs structure
685  * \param dest The destination codecs structure that the values from src will be copied to
686  * \param instance Optionally the instance that the dst codecs structure belongs to
687  *
688  * \note It is assumed that src is at least read locked before calling.
689  * \note It is assumed that dest is write locked before calling.
690  *
691  * \return Nothing
692  */
693 static void rtp_codecs_payloads_copy_rx(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
694 {
695         int idx;
696         struct ast_rtp_payload_type *type;
697
698         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_rx); ++idx) {
699                 type = AST_VECTOR_GET(&src->payload_mapping_rx, idx);
700                 if (!type) {
701                         continue;
702                 }
703
704                 ast_debug(2, "Copying rx payload mapping %d (%p) from %p to %p\n",
705                         idx, type, src, dest);
706                 ao2_ref(type, +1);
707                 if (idx < AST_VECTOR_SIZE(&dest->payload_mapping_rx)) {
708                         ao2_t_cleanup(AST_VECTOR_GET(&dest->payload_mapping_rx, idx),
709                                 "cleaning up rx mapping vector element about to be replaced");
710                 }
711                 AST_VECTOR_REPLACE(&dest->payload_mapping_rx, idx, type);
712
713                 payload_mapping_rx_clear_primary(dest, type);
714
715                 if (instance && instance->engine && instance->engine->payload_set) {
716                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
717                 }
718         }
719 }
720
721 /*!
722  * \internal
723  * \brief Remove other matching payload mappings.
724  * \since 14.0.0
725  *
726  * \param codecs Codecs that need tx mappings removed.
727  * \param instance RTP instance to notify of any payloads removed.
728  * \param to_match Payload type object to compare against.
729  *
730  * \note It is assumed that codecs is write locked before calling.
731  *
732  * \return Nothing
733  */
734 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)
735 {
736         int idx;
737         struct ast_rtp_payload_type *current;
738
739         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
740                 current = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
741
742                 if (!current || current == to_match) {
743                         continue;
744                 }
745                 if (current->asterisk_format && to_match->asterisk_format) {
746                         if (ast_format_cmp(current->format, to_match->format) == AST_FORMAT_CMP_NOT_EQUAL) {
747                                 continue;
748                         }
749                 } else if (!current->asterisk_format && !to_match->asterisk_format) {
750                         if (current->rtp_code != to_match->rtp_code) {
751                                 continue;
752                         }
753                 } else {
754                         continue;
755                 }
756
757                 /* Remove other mapping */
758                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, idx, NULL);
759                 ao2_ref(current, -1);
760                 if (instance && instance->engine && instance->engine->payload_set) {
761                         instance->engine->payload_set(instance, idx, 0, NULL, 0);
762                 }
763         }
764 }
765
766 /*!
767  * \internal
768  * \brief Copy the tx payload type mapping to the destination.
769  * \since 14.0.0
770  *
771  * \param src The source codecs structure
772  * \param dest The destination codecs structure that the values from src will be copied to
773  * \param instance Optionally the instance that the dst codecs structure belongs to
774  *
775  * \note It is assumed that src is at least read locked before calling.
776  * \note It is assumed that dest is write locked before calling.
777  *
778  * \return Nothing
779  */
780 static void rtp_codecs_payloads_copy_tx(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
781 {
782         int idx;
783         struct ast_rtp_payload_type *type;
784
785         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_tx); ++idx) {
786                 type = AST_VECTOR_GET(&src->payload_mapping_tx, idx);
787                 if (!type) {
788                         continue;
789                 }
790
791                 ast_debug(2, "Copying tx payload mapping %d (%p) from %p to %p\n",
792                         idx, type, src, dest);
793                 ao2_ref(type, +1);
794                 if (idx < AST_VECTOR_SIZE(&dest->payload_mapping_tx)) {
795                         ao2_t_cleanup(AST_VECTOR_GET(&dest->payload_mapping_tx, idx),
796                                 "cleaning up tx mapping vector element about to be replaced");
797                 }
798                 AST_VECTOR_REPLACE(&dest->payload_mapping_tx, idx, type);
799
800                 if (instance && instance->engine && instance->engine->payload_set) {
801                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
802                 }
803
804                 payload_mapping_tx_remove_other_mappings(dest, instance, type);
805         }
806 }
807
808 void ast_rtp_codecs_payloads_copy(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
809 {
810         ast_rwlock_wrlock(&dest->codecs_lock);
811
812         /* Deadlock avoidance because of held write lock. */
813         while (ast_rwlock_tryrdlock(&src->codecs_lock)) {
814                 ast_rwlock_unlock(&dest->codecs_lock);
815                 sched_yield();
816                 ast_rwlock_wrlock(&dest->codecs_lock);
817         }
818
819         rtp_codecs_payloads_copy_rx(src, dest, instance);
820         rtp_codecs_payloads_copy_tx(src, dest, instance);
821         dest->framing = src->framing;
822
823         ast_rwlock_unlock(&src->codecs_lock);
824         ast_rwlock_unlock(&dest->codecs_lock);
825 }
826
827 void ast_rtp_codecs_payloads_xover(struct ast_rtp_codecs *src, struct ast_rtp_codecs *dest, struct ast_rtp_instance *instance)
828 {
829         int idx;
830         struct ast_rtp_payload_type *type;
831
832         ast_rwlock_wrlock(&dest->codecs_lock);
833         if (src != dest) {
834                 /* Deadlock avoidance because of held write lock. */
835                 while (ast_rwlock_tryrdlock(&src->codecs_lock)) {
836                         ast_rwlock_unlock(&dest->codecs_lock);
837                         sched_yield();
838                         ast_rwlock_wrlock(&dest->codecs_lock);
839                 }
840         }
841
842         /* Crossover copy payload type tx mapping to rx mapping. */
843         for (idx = 0; idx < AST_VECTOR_SIZE(&src->payload_mapping_tx); ++idx) {
844                 type = AST_VECTOR_GET(&src->payload_mapping_tx, idx);
845                 if (!type) {
846                         continue;
847                 }
848
849                 /* All tx mapping elements should have the primary flag set. */
850                 ast_assert(type->primary_mapping);
851
852                 ast_debug(2, "Crossover copying tx to rx payload mapping %d (%p) from %p to %p\n",
853                         idx, type, src, dest);
854                 ao2_ref(type, +1);
855                 if (idx < AST_VECTOR_SIZE(&dest->payload_mapping_rx)) {
856                         ao2_t_cleanup(AST_VECTOR_GET(&dest->payload_mapping_rx, idx),
857                                 "cleaning up rx mapping vector element about to be replaced");
858                 }
859                 AST_VECTOR_REPLACE(&dest->payload_mapping_rx, idx, type);
860
861                 payload_mapping_rx_clear_primary(dest, type);
862
863                 if (instance && instance->engine && instance->engine->payload_set) {
864                         instance->engine->payload_set(instance, idx, type->asterisk_format, type->format, type->rtp_code);
865                 }
866         }
867
868         dest->framing = src->framing;
869
870         if (src != dest) {
871                 ast_rwlock_unlock(&src->codecs_lock);
872         }
873         ast_rwlock_unlock(&dest->codecs_lock);
874 }
875
876 void ast_rtp_codecs_payloads_set_m_type(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload)
877 {
878         struct ast_rtp_payload_type *new_type;
879
880         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
881                 return;
882         }
883
884         ast_rwlock_rdlock(&static_RTP_PT_lock);
885         new_type = ao2_bump(static_RTP_PT[payload]);
886         ast_rwlock_unlock(&static_RTP_PT_lock);
887         if (!new_type) {
888                 ast_debug(1, "Don't have a default tx payload type %d format for m type on %p\n",
889                         payload, codecs);
890                 return;
891         }
892
893         ast_debug(1, "Setting tx payload type %d based on m type on %p\n",
894                 payload, codecs);
895
896         ast_rwlock_wrlock(&codecs->codecs_lock);
897
898         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
899                 ao2_t_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, payload),
900                         "cleaning up replaced tx payload type");
901         }
902         AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, new_type);
903
904         if (instance && instance->engine && instance->engine->payload_set) {
905                 instance->engine->payload_set(instance, payload, new_type->asterisk_format, new_type->format, new_type->rtp_code);
906         }
907
908         payload_mapping_tx_remove_other_mappings(codecs, instance, new_type);
909
910         ast_rwlock_unlock(&codecs->codecs_lock);
911 }
912
913 int ast_rtp_codecs_payloads_set_rtpmap_type_rate(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int pt,
914                                  char *mimetype, char *mimesubtype,
915                                  enum ast_rtp_options options,
916                                  unsigned int sample_rate)
917 {
918         unsigned int idx;
919         int found = 0;
920
921         if (pt < 0 || pt >= AST_RTP_MAX_PT) {
922                 return -1; /* bogus payload type */
923         }
924
925         ast_rwlock_rdlock(&mime_types_lock);
926         ast_rwlock_wrlock(&codecs->codecs_lock);
927
928         for (idx = 0; idx < mime_types_len; ++idx) {
929                 const struct ast_rtp_mime_type *t = &ast_rtp_mime_types[idx];
930                 struct ast_rtp_payload_type *new_type;
931
932                 if (strcasecmp(mimesubtype, t->subtype)) {
933                         continue;
934                 }
935
936                 if (strcasecmp(mimetype, t->type)) {
937                         continue;
938                 }
939
940                 /* if both sample rates have been supplied, and they don't match,
941                  * then this not a match; if one has not been supplied, then the
942                  * rates are not compared */
943                 if (sample_rate && t->sample_rate &&
944                     (sample_rate != t->sample_rate)) {
945                         continue;
946                 }
947
948                 found = 1;
949
950                 new_type = ast_rtp_engine_alloc_payload_type();
951                 if (!new_type) {
952                         continue;
953                 }
954
955                 new_type->asterisk_format = t->payload_type.asterisk_format;
956                 new_type->rtp_code = t->payload_type.rtp_code;
957                 new_type->payload = pt;
958                 new_type->primary_mapping = 1;
959                 if (t->payload_type.asterisk_format
960                         && ast_format_cmp(t->payload_type.format, ast_format_g726) == AST_FORMAT_CMP_EQUAL
961                         && (options & AST_RTP_OPT_G726_NONSTANDARD)) {
962                         new_type->format = ao2_bump(ast_format_g726_aal2);
963                 } else {
964                         new_type->format = ao2_bump(t->payload_type.format);
965                 }
966
967                 if (pt < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
968                         ao2_t_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, pt),
969                                 "cleaning up replaced tx payload type");
970                 }
971                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, pt, new_type);
972
973                 if (instance && instance->engine && instance->engine->payload_set) {
974                         instance->engine->payload_set(instance, pt, new_type->asterisk_format, new_type->format, new_type->rtp_code);
975                 }
976
977                 payload_mapping_tx_remove_other_mappings(codecs, instance, new_type);
978                 break;
979         }
980
981         ast_rwlock_unlock(&codecs->codecs_lock);
982         ast_rwlock_unlock(&mime_types_lock);
983
984         return (found ? 0 : -2);
985 }
986
987 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)
988 {
989         return ast_rtp_codecs_payloads_set_rtpmap_type_rate(codecs, instance, payload, mimetype, mimesubtype, options, 0);
990 }
991
992 void ast_rtp_codecs_payloads_unset(struct ast_rtp_codecs *codecs, struct ast_rtp_instance *instance, int payload)
993 {
994         struct ast_rtp_payload_type *type;
995
996         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
997                 return;
998         }
999
1000         ast_debug(2, "Unsetting payload %d on %p\n", payload, codecs);
1001
1002         ast_rwlock_wrlock(&codecs->codecs_lock);
1003
1004         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1005                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1006                 ao2_cleanup(type);
1007                 AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, NULL);
1008         }
1009
1010         if (instance && instance->engine && instance->engine->payload_set) {
1011                 instance->engine->payload_set(instance, payload, 0, NULL, 0);
1012         }
1013
1014         ast_rwlock_unlock(&codecs->codecs_lock);
1015 }
1016
1017 struct ast_rtp_payload_type *ast_rtp_codecs_get_payload(struct ast_rtp_codecs *codecs, int payload)
1018 {
1019         struct ast_rtp_payload_type *type = NULL;
1020
1021         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
1022                 return NULL;
1023         }
1024
1025         ast_rwlock_rdlock(&codecs->codecs_lock);
1026         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_rx)) {
1027                 type = AST_VECTOR_GET(&codecs->payload_mapping_rx, payload);
1028                 ao2_bump(type);
1029         }
1030         ast_rwlock_unlock(&codecs->codecs_lock);
1031
1032         if (!type) {
1033                 ast_rwlock_rdlock(&static_RTP_PT_lock);
1034                 type = ao2_bump(static_RTP_PT[payload]);
1035                 ast_rwlock_unlock(&static_RTP_PT_lock);
1036         }
1037
1038         return type;
1039 }
1040
1041 int ast_rtp_codecs_payload_replace_format(struct ast_rtp_codecs *codecs, int payload, struct ast_format *format)
1042 {
1043         struct ast_rtp_payload_type *type;
1044
1045         if (payload < 0 || payload >= AST_RTP_MAX_PT || !format) {
1046                 return -1;
1047         }
1048
1049         type = ast_rtp_engine_alloc_payload_type();
1050         if (!type) {
1051                 return -1;
1052         }
1053         ao2_ref(format, +1);
1054         type->format = format;
1055         type->asterisk_format = 1;
1056         type->payload = payload;
1057         type->primary_mapping = 1;
1058
1059         ast_rwlock_wrlock(&codecs->codecs_lock);
1060         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1061                 ao2_cleanup(AST_VECTOR_GET(&codecs->payload_mapping_tx, payload));
1062         }
1063         AST_VECTOR_REPLACE(&codecs->payload_mapping_tx, payload, type);
1064         payload_mapping_tx_remove_other_mappings(codecs, NULL, type);
1065         ast_rwlock_unlock(&codecs->codecs_lock);
1066
1067         return 0;
1068 }
1069
1070 struct ast_format *ast_rtp_codecs_get_payload_format(struct ast_rtp_codecs *codecs, int payload)
1071 {
1072         struct ast_rtp_payload_type *type;
1073         struct ast_format *format = NULL;
1074
1075         if (payload < 0 || payload >= AST_RTP_MAX_PT) {
1076                 return NULL;
1077         }
1078
1079         ast_rwlock_rdlock(&codecs->codecs_lock);
1080         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1081                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1082                 if (type && type->asterisk_format) {
1083                         format = ao2_bump(type->format);
1084                 }
1085         }
1086         ast_rwlock_unlock(&codecs->codecs_lock);
1087
1088         return format;
1089 }
1090
1091 void ast_rtp_codecs_set_framing(struct ast_rtp_codecs *codecs, unsigned int framing)
1092 {
1093         if (!framing) {
1094                 return;
1095         }
1096
1097         ast_rwlock_wrlock(&codecs->codecs_lock);
1098         codecs->framing = framing;
1099         ast_rwlock_unlock(&codecs->codecs_lock);
1100 }
1101
1102 unsigned int ast_rtp_codecs_get_framing(struct ast_rtp_codecs *codecs)
1103 {
1104         unsigned int framing;
1105
1106         ast_rwlock_rdlock(&codecs->codecs_lock);
1107         framing = codecs->framing;
1108         ast_rwlock_unlock(&codecs->codecs_lock);
1109
1110         return framing;
1111 }
1112
1113 void ast_rtp_codecs_payload_formats(struct ast_rtp_codecs *codecs, struct ast_format_cap *astformats, int *nonastformats)
1114 {
1115         int idx;
1116
1117         ast_format_cap_remove_by_type(astformats, AST_MEDIA_TYPE_UNKNOWN);
1118         *nonastformats = 0;
1119
1120         ast_rwlock_rdlock(&codecs->codecs_lock);
1121
1122         for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1123                 struct ast_rtp_payload_type *type;
1124
1125                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1126                 if (!type) {
1127                         continue;
1128                 }
1129
1130                 if (type->asterisk_format) {
1131                         ast_format_cap_append(astformats, type->format, 0);
1132                 } else {
1133                         *nonastformats |= type->rtp_code;
1134                 }
1135         }
1136         if (codecs->framing) {
1137                 ast_format_cap_set_framing(astformats, codecs->framing);
1138         }
1139
1140         ast_rwlock_unlock(&codecs->codecs_lock);
1141 }
1142
1143 /*!
1144  * \internal
1145  * \brief Find the static payload type mapping for the format.
1146  * \since 14.0.0
1147  *
1148  * \param asterisk_format Non-zero if the given Asterisk format is present
1149  * \param format Asterisk format to look for
1150  * \param code The non-Asterisk format code to look for
1151  *
1152  * \retval Numerical payload type
1153  * \retval -1 if not found.
1154  */
1155 static int find_static_payload_type(int asterisk_format, const struct ast_format *format, int code)
1156 {
1157         int idx;
1158         int payload = -1;
1159
1160         if (!asterisk_format) {
1161                 ast_rwlock_rdlock(&static_RTP_PT_lock);
1162                 for (idx = 0; idx < AST_RTP_MAX_PT; ++idx) {
1163                         if (static_RTP_PT[idx]
1164                                 && !static_RTP_PT[idx]->asterisk_format
1165                                 && static_RTP_PT[idx]->rtp_code == code) {
1166                                 payload = idx;
1167                                 break;
1168                         }
1169                 }
1170                 ast_rwlock_unlock(&static_RTP_PT_lock);
1171         } else if (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                                 && ast_format_cmp(format, static_RTP_PT[idx]->format)
1177                                         != AST_FORMAT_CMP_NOT_EQUAL) {
1178                                 payload = idx;
1179                                 break;
1180                         }
1181                 }
1182                 ast_rwlock_unlock(&static_RTP_PT_lock);
1183         }
1184
1185         return payload;
1186 }
1187
1188 int ast_rtp_codecs_payload_code(struct ast_rtp_codecs *codecs, int asterisk_format, const struct ast_format *format, int code)
1189 {
1190         struct ast_rtp_payload_type *type;
1191         int idx;
1192         int payload = -1;
1193
1194         if (!asterisk_format) {
1195                 ast_rwlock_rdlock(&codecs->codecs_lock);
1196                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
1197                         type = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
1198                         if (!type) {
1199                                 continue;
1200                         }
1201
1202                         if (!type->asterisk_format
1203                                 && type->rtp_code == code) {
1204                                 if (type->primary_mapping) {
1205                                         payload = idx;
1206                                         break;
1207                                 }
1208                                 if (payload == -1) {
1209                                         payload = idx;
1210                                 }
1211                         }
1212                 }
1213                 ast_rwlock_unlock(&codecs->codecs_lock);
1214         } else if (format) {
1215                 ast_rwlock_rdlock(&codecs->codecs_lock);
1216                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_rx); ++idx) {
1217                         type = AST_VECTOR_GET(&codecs->payload_mapping_rx, idx);
1218                         if (!type) {
1219                                 continue;
1220                         }
1221
1222                         if (type->asterisk_format
1223                                 && ast_format_cmp(format, type->format) == AST_FORMAT_CMP_EQUAL) {
1224                                 if (type->primary_mapping) {
1225                                         payload = idx;
1226                                         break;
1227                                 }
1228                                 if (payload == -1) {
1229                                         payload = idx;
1230                                 }
1231                         }
1232                 }
1233                 ast_rwlock_unlock(&codecs->codecs_lock);
1234         }
1235
1236         if (payload < 0) {
1237                 payload = find_static_payload_type(asterisk_format, format, code);
1238         }
1239
1240         return payload;
1241 }
1242
1243 int ast_rtp_codecs_payload_code_tx(struct ast_rtp_codecs *codecs, int asterisk_format, const struct ast_format *format, int code)
1244 {
1245         struct ast_rtp_payload_type *type;
1246         int idx;
1247         int payload = -1;
1248
1249         if (!asterisk_format) {
1250                 ast_rwlock_rdlock(&codecs->codecs_lock);
1251                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1252                         type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1253                         if (!type) {
1254                                 continue;
1255                         }
1256
1257                         if (!type->asterisk_format
1258                                 && type->rtp_code == code) {
1259                                 payload = idx;
1260                                 break;
1261                         }
1262                 }
1263                 ast_rwlock_unlock(&codecs->codecs_lock);
1264         } else if (format) {
1265                 ast_rwlock_rdlock(&codecs->codecs_lock);
1266                 for (idx = 0; idx < AST_VECTOR_SIZE(&codecs->payload_mapping_tx); ++idx) {
1267                         type = AST_VECTOR_GET(&codecs->payload_mapping_tx, idx);
1268                         if (!type) {
1269                                 continue;
1270                         }
1271
1272                         if (type->asterisk_format
1273                                 && ast_format_cmp(format, type->format) == AST_FORMAT_CMP_EQUAL) {
1274                                 payload = idx;
1275                                 break;
1276                         }
1277                 }
1278                 ast_rwlock_unlock(&codecs->codecs_lock);
1279         }
1280
1281         if (payload < 0) {
1282                 payload = find_static_payload_type(asterisk_format, format, code);
1283         }
1284
1285         return payload;
1286 }
1287
1288 int ast_rtp_codecs_find_payload_code(struct ast_rtp_codecs *codecs, int payload)
1289 {
1290         struct ast_rtp_payload_type *type;
1291         int res = -1;
1292
1293         ast_rwlock_rdlock(&codecs->codecs_lock);
1294         if (payload < AST_VECTOR_SIZE(&codecs->payload_mapping_tx)) {
1295                 type = AST_VECTOR_GET(&codecs->payload_mapping_tx, payload);
1296                 if (type) {
1297                         res = payload;
1298                 }
1299         }
1300         ast_rwlock_unlock(&codecs->codecs_lock);
1301
1302         return res;
1303 }
1304
1305 const char *ast_rtp_lookup_mime_subtype2(const int asterisk_format, struct ast_format *format, int code, enum ast_rtp_options options)
1306 {
1307         int i;
1308         const char *res = "";
1309
1310         ast_rwlock_rdlock(&mime_types_lock);
1311         for (i = 0; i < mime_types_len; i++) {
1312                 if (ast_rtp_mime_types[i].payload_type.asterisk_format && asterisk_format && format &&
1313                         (ast_format_cmp(format, ast_rtp_mime_types[i].payload_type.format) != AST_FORMAT_CMP_NOT_EQUAL)) {
1314                         if ((ast_format_cmp(format, ast_format_g726_aal2) == AST_FORMAT_CMP_EQUAL) &&
1315                                         (options & AST_RTP_OPT_G726_NONSTANDARD)) {
1316                                 res = "G726-32";
1317                                 break;
1318                         } else {
1319                                 res = ast_rtp_mime_types[i].subtype;
1320                                 break;
1321                         }
1322                 } else if (!ast_rtp_mime_types[i].payload_type.asterisk_format && !asterisk_format &&
1323                         ast_rtp_mime_types[i].payload_type.rtp_code == code) {
1324
1325                         res = ast_rtp_mime_types[i].subtype;
1326                         break;
1327                 }
1328         }
1329         ast_rwlock_unlock(&mime_types_lock);
1330
1331         return res;
1332 }
1333
1334 unsigned int ast_rtp_lookup_sample_rate2(int asterisk_format, struct ast_format *format, int code)
1335 {
1336         unsigned int i;
1337         unsigned int res = 0;
1338
1339         ast_rwlock_rdlock(&mime_types_lock);
1340         for (i = 0; i < mime_types_len; ++i) {
1341                 if (ast_rtp_mime_types[i].payload_type.asterisk_format && asterisk_format && format &&
1342                         (ast_format_cmp(format, ast_rtp_mime_types[i].payload_type.format) != AST_FORMAT_CMP_NOT_EQUAL)) {
1343                         res = ast_rtp_mime_types[i].sample_rate;
1344                         break;
1345                 } else if (!ast_rtp_mime_types[i].payload_type.asterisk_format && !asterisk_format &&
1346                         ast_rtp_mime_types[i].payload_type.rtp_code == code) {
1347                         res = ast_rtp_mime_types[i].sample_rate;
1348                         break;
1349                 }
1350         }
1351         ast_rwlock_unlock(&mime_types_lock);
1352
1353         return res;
1354 }
1355
1356 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)
1357 {
1358         int found = 0;
1359         const char *name;
1360         if (!buf) {
1361                 return NULL;
1362         }
1363
1364
1365         if (asterisk_format) {
1366                 int x;
1367                 struct ast_format *tmp_fmt;
1368                 for (x = 0; x < ast_format_cap_count(ast_format_capability); x++) {
1369                         tmp_fmt = ast_format_cap_get_format(ast_format_capability, x);
1370                         name = ast_rtp_lookup_mime_subtype2(asterisk_format, tmp_fmt, 0, options);
1371                         ao2_ref(tmp_fmt, -1);
1372                         ast_str_append(&buf, 0, "%s|", name);
1373                         found = 1;
1374                 }
1375         } else {
1376                 int x;
1377                 ast_str_append(&buf, 0, "0x%x (", (unsigned int) rtp_capability);
1378                 for (x = 1; x <= AST_RTP_MAX; x <<= 1) {
1379                         if (rtp_capability & x) {
1380                                 name = ast_rtp_lookup_mime_subtype2(asterisk_format, NULL, x, options);
1381                                 ast_str_append(&buf, 0, "%s|", name);
1382                                 found = 1;
1383                         }
1384                 }
1385         }
1386
1387         ast_str_append(&buf, 0, "%s", found ? ")" : "nothing)");
1388
1389         return ast_str_buffer(buf);
1390 }
1391
1392 int ast_rtp_instance_dtmf_begin(struct ast_rtp_instance *instance, char digit)
1393 {
1394         return instance->engine->dtmf_begin ? instance->engine->dtmf_begin(instance, digit) : -1;
1395 }
1396
1397 int ast_rtp_instance_dtmf_end(struct ast_rtp_instance *instance, char digit)
1398 {
1399         return instance->engine->dtmf_end ? instance->engine->dtmf_end(instance, digit) : -1;
1400 }
1401 int ast_rtp_instance_dtmf_end_with_duration(struct ast_rtp_instance *instance, char digit, unsigned int duration)
1402 {
1403         return instance->engine->dtmf_end_with_duration ? instance->engine->dtmf_end_with_duration(instance, digit, duration) : -1;
1404 }
1405
1406 int ast_rtp_instance_dtmf_mode_set(struct ast_rtp_instance *instance, enum ast_rtp_dtmf_mode dtmf_mode)
1407 {
1408         return (!instance->engine->dtmf_mode_set || instance->engine->dtmf_mode_set(instance, dtmf_mode)) ? -1 : 0;
1409 }
1410
1411 enum ast_rtp_dtmf_mode ast_rtp_instance_dtmf_mode_get(struct ast_rtp_instance *instance)
1412 {
1413         return instance->engine->dtmf_mode_get ? instance->engine->dtmf_mode_get(instance) : 0;
1414 }
1415
1416 void ast_rtp_instance_update_source(struct ast_rtp_instance *instance)
1417 {
1418         if (instance->engine->update_source) {
1419                 instance->engine->update_source(instance);
1420         }
1421 }
1422
1423 void ast_rtp_instance_change_source(struct ast_rtp_instance *instance)
1424 {
1425         if (instance->engine->change_source) {
1426                 instance->engine->change_source(instance);
1427         }
1428 }
1429
1430 int ast_rtp_instance_set_qos(struct ast_rtp_instance *instance, int tos, int cos, const char *desc)
1431 {
1432         return instance->engine->qos ? instance->engine->qos(instance, tos, cos, desc) : -1;
1433 }
1434
1435 void ast_rtp_instance_stop(struct ast_rtp_instance *instance)
1436 {
1437         if (instance->engine->stop) {
1438                 instance->engine->stop(instance);
1439         }
1440 }
1441
1442 int ast_rtp_instance_fd(struct ast_rtp_instance *instance, int rtcp)
1443 {
1444         return instance->engine->fd ? instance->engine->fd(instance, rtcp) : -1;
1445 }
1446
1447 struct ast_rtp_glue *ast_rtp_instance_get_glue(const char *type)
1448 {
1449         struct ast_rtp_glue *glue = NULL;
1450
1451         AST_RWLIST_RDLOCK(&glues);
1452
1453         AST_RWLIST_TRAVERSE(&glues, glue, entry) {
1454                 if (!strcasecmp(glue->type, type)) {
1455                         break;
1456                 }
1457         }
1458
1459         AST_RWLIST_UNLOCK(&glues);
1460
1461         return glue;
1462 }
1463
1464 /*!
1465  * \brief Conditionally unref an rtp instance
1466  */
1467 static void unref_instance_cond(struct ast_rtp_instance **instance)
1468 {
1469         if (*instance) {
1470                 ao2_ref(*instance, -1);
1471                 *instance = NULL;
1472         }
1473 }
1474
1475 struct ast_rtp_instance *ast_rtp_instance_get_bridged(struct ast_rtp_instance *instance)
1476 {
1477         return instance->bridged;
1478 }
1479
1480 void ast_rtp_instance_set_bridged(struct ast_rtp_instance *instance, struct ast_rtp_instance *bridged)
1481 {
1482         instance->bridged = bridged;
1483 }
1484
1485 void ast_rtp_instance_early_bridge_make_compatible(struct ast_channel *c_dst, struct ast_channel *c_src)
1486 {
1487         struct ast_rtp_instance *instance_dst = NULL, *instance_src = NULL,
1488                 *vinstance_dst = NULL, *vinstance_src = NULL,
1489                 *tinstance_dst = NULL, *tinstance_src = NULL;
1490         struct ast_rtp_glue *glue_dst, *glue_src;
1491         enum ast_rtp_glue_result audio_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID, video_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID;
1492         enum ast_rtp_glue_result audio_glue_src_res = AST_RTP_GLUE_RESULT_FORBID, video_glue_src_res = AST_RTP_GLUE_RESULT_FORBID;
1493         struct ast_format_cap *cap_dst = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1494         struct ast_format_cap *cap_src = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1495
1496         /* Lock both channels so we can look for the glue that binds them together */
1497         ast_channel_lock_both(c_dst, c_src);
1498
1499         if (!cap_src || !cap_dst) {
1500                 goto done;
1501         }
1502
1503         /* Grab glue that binds each channel to something using the RTP engine */
1504         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))) {
1505                 ast_debug(1, "Can't find native functions for channel '%s'\n", glue_dst ? ast_channel_name(c_src) : ast_channel_name(c_dst));
1506                 goto done;
1507         }
1508
1509         audio_glue_dst_res = glue_dst->get_rtp_info(c_dst, &instance_dst);
1510         video_glue_dst_res = glue_dst->get_vrtp_info ? glue_dst->get_vrtp_info(c_dst, &vinstance_dst) : AST_RTP_GLUE_RESULT_FORBID;
1511
1512         audio_glue_src_res = glue_src->get_rtp_info(c_src, &instance_src);
1513         video_glue_src_res = glue_src->get_vrtp_info ? glue_src->get_vrtp_info(c_src, &vinstance_src) : AST_RTP_GLUE_RESULT_FORBID;
1514
1515         /* If we are carrying video, and both sides are not going to remotely bridge... fail the native bridge */
1516         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)) {
1517                 audio_glue_dst_res = AST_RTP_GLUE_RESULT_FORBID;
1518         }
1519         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)) {
1520                 audio_glue_src_res = AST_RTP_GLUE_RESULT_FORBID;
1521         }
1522         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) {
1523                 glue_dst->get_codec(c_dst, cap_dst);
1524         }
1525         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) {
1526                 glue_src->get_codec(c_src, cap_src);
1527         }
1528
1529         /* If any sort of bridge is forbidden just completely bail out and go back to generic bridging */
1530         if (audio_glue_dst_res != AST_RTP_GLUE_RESULT_REMOTE || audio_glue_src_res != AST_RTP_GLUE_RESULT_REMOTE) {
1531                 goto done;
1532         }
1533
1534         /* Make sure we have matching codecs */
1535         if (!ast_format_cap_iscompatible(cap_dst, cap_src)) {
1536                 goto done;
1537         }
1538
1539         ast_rtp_codecs_payloads_xover(&instance_src->codecs, &instance_dst->codecs, instance_dst);
1540
1541         if (vinstance_dst && vinstance_src) {
1542                 ast_rtp_codecs_payloads_xover(&vinstance_src->codecs, &vinstance_dst->codecs, vinstance_dst);
1543         }
1544         if (tinstance_dst && tinstance_src) {
1545                 ast_rtp_codecs_payloads_xover(&tinstance_src->codecs, &tinstance_dst->codecs, tinstance_dst);
1546         }
1547
1548         if (glue_dst->update_peer(c_dst, instance_src, vinstance_src, tinstance_src, cap_src, 0)) {
1549                 ast_log(LOG_WARNING, "Channel '%s' failed to setup early bridge to '%s'\n",
1550                         ast_channel_name(c_dst), ast_channel_name(c_src));
1551         } else {
1552                 ast_debug(1, "Seeded SDP of '%s' with that of '%s'\n",
1553                         ast_channel_name(c_dst), ast_channel_name(c_src));
1554         }
1555
1556 done:
1557         ast_channel_unlock(c_dst);
1558         ast_channel_unlock(c_src);
1559
1560         ao2_cleanup(cap_dst);
1561         ao2_cleanup(cap_src);
1562
1563         unref_instance_cond(&instance_dst);
1564         unref_instance_cond(&instance_src);
1565         unref_instance_cond(&vinstance_dst);
1566         unref_instance_cond(&vinstance_src);
1567         unref_instance_cond(&tinstance_dst);
1568         unref_instance_cond(&tinstance_src);
1569 }
1570
1571 int ast_rtp_instance_early_bridge(struct ast_channel *c0, struct ast_channel *c1)
1572 {
1573         struct ast_rtp_instance *instance0 = NULL, *instance1 = NULL,
1574                         *vinstance0 = NULL, *vinstance1 = NULL,
1575                         *tinstance0 = NULL, *tinstance1 = NULL;
1576         struct ast_rtp_glue *glue0, *glue1;
1577         enum ast_rtp_glue_result audio_glue0_res = AST_RTP_GLUE_RESULT_FORBID, video_glue0_res = AST_RTP_GLUE_RESULT_FORBID;
1578         enum ast_rtp_glue_result audio_glue1_res = AST_RTP_GLUE_RESULT_FORBID, video_glue1_res = AST_RTP_GLUE_RESULT_FORBID;
1579         struct ast_format_cap *cap0 = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1580         struct ast_format_cap *cap1 = ast_format_cap_alloc(AST_FORMAT_CAP_FLAG_DEFAULT);
1581
1582         /* If there is no second channel just immediately bail out, we are of no use in that scenario */
1583         if (!c1 || !cap1 || !cap0) {
1584                 ao2_cleanup(cap0);
1585                 ao2_cleanup(cap1);
1586                 return -1;
1587         }
1588
1589         /* Lock both channels so we can look for the glue that binds them together */
1590         ast_channel_lock_both(c0, c1);
1591
1592         /* Grab glue that binds each channel to something using the RTP engine */
1593         if (!(glue0 = ast_rtp_instance_get_glue(ast_channel_tech(c0)->type)) || !(glue1 = ast_rtp_instance_get_glue(ast_channel_tech(c1)->type))) {
1594                 ast_log(LOG_WARNING, "Can't find native functions for channel '%s'\n", glue0 ? ast_channel_name(c1) : ast_channel_name(c0));
1595                 goto done;
1596         }
1597
1598         audio_glue0_res = glue0->get_rtp_info(c0, &instance0);
1599         video_glue0_res = glue0->get_vrtp_info ? glue0->get_vrtp_info(c0, &vinstance0) : AST_RTP_GLUE_RESULT_FORBID;
1600
1601         audio_glue1_res = glue1->get_rtp_info(c1, &instance1);
1602         video_glue1_res = glue1->get_vrtp_info ? glue1->get_vrtp_info(c1, &vinstance1) : AST_RTP_GLUE_RESULT_FORBID;
1603
1604         /* If we are carrying video, and both sides are not going to remotely bridge... fail the native bridge */
1605         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)) {
1606                 audio_glue0_res = AST_RTP_GLUE_RESULT_FORBID;
1607         }
1608         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)) {
1609                 audio_glue1_res = AST_RTP_GLUE_RESULT_FORBID;
1610         }
1611         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) {
1612                 glue0->get_codec(c0, cap0);
1613         }
1614         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) {
1615                 glue1->get_codec(c1, cap1);
1616         }
1617
1618         /* If any sort of bridge is forbidden just completely bail out and go back to generic bridging */
1619         if (audio_glue0_res != AST_RTP_GLUE_RESULT_REMOTE || audio_glue1_res != AST_RTP_GLUE_RESULT_REMOTE) {
1620                 goto done;
1621         }
1622
1623         /* Make sure we have matching codecs */
1624         if (!ast_format_cap_iscompatible(cap0, cap1)) {
1625                 goto done;
1626         }
1627
1628         /* Bridge media early */
1629         if (glue0->update_peer(c0, instance1, vinstance1, tinstance1, cap1, 0)) {
1630                 ast_log(LOG_WARNING, "Channel '%s' failed to setup early bridge to '%s'\n", ast_channel_name(c0), c1 ? ast_channel_name(c1) : "<unspecified>");
1631         }
1632
1633 done:
1634         ast_channel_unlock(c0);
1635         ast_channel_unlock(c1);
1636
1637         ao2_cleanup(cap0);
1638         ao2_cleanup(cap1);
1639
1640         unref_instance_cond(&instance0);
1641         unref_instance_cond(&instance1);
1642         unref_instance_cond(&vinstance0);
1643         unref_instance_cond(&vinstance1);
1644         unref_instance_cond(&tinstance0);
1645         unref_instance_cond(&tinstance1);
1646
1647         ast_debug(1, "Setting early bridge SDP of '%s' with that of '%s'\n", ast_channel_name(c0), c1 ? ast_channel_name(c1) : "<unspecified>");
1648
1649         return 0;
1650 }
1651
1652 int ast_rtp_red_init(struct ast_rtp_instance *instance, int buffer_time, int *payloads, int generations)
1653 {
1654         return instance->engine->red_init ? instance->engine->red_init(instance, buffer_time, payloads, generations) : -1;
1655 }
1656
1657 int ast_rtp_red_buffer(struct ast_rtp_instance *instance, struct ast_frame *frame)
1658 {
1659         return instance->engine->red_buffer ? instance->engine->red_buffer(instance, frame) : -1;
1660 }
1661
1662 int ast_rtp_instance_get_stats(struct ast_rtp_instance *instance, struct ast_rtp_instance_stats *stats, enum ast_rtp_instance_stat stat)
1663 {
1664         return instance->engine->get_stat ? instance->engine->get_stat(instance, stats, stat) : -1;
1665 }
1666
1667 char *ast_rtp_instance_get_quality(struct ast_rtp_instance *instance, enum ast_rtp_instance_stat_field field, char *buf, size_t size)
1668 {
1669         struct ast_rtp_instance_stats stats = { 0, };
1670         enum ast_rtp_instance_stat stat;
1671
1672         /* Determine what statistics we will need to retrieve based on field passed in */
1673         if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY) {
1674                 stat = AST_RTP_INSTANCE_STAT_ALL;
1675         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER) {
1676                 stat = AST_RTP_INSTANCE_STAT_COMBINED_JITTER;
1677         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS) {
1678                 stat = AST_RTP_INSTANCE_STAT_COMBINED_LOSS;
1679         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT) {
1680                 stat = AST_RTP_INSTANCE_STAT_COMBINED_RTT;
1681         } else {
1682                 return NULL;
1683         }
1684
1685         /* Attempt to actually retrieve the statistics we need to generate the quality string */
1686         if (ast_rtp_instance_get_stats(instance, &stats, stat)) {
1687                 return NULL;
1688         }
1689
1690         /* Now actually fill the buffer with the good information */
1691         if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY) {
1692                 snprintf(buf, size, "ssrc=%u;themssrc=%u;lp=%u;rxjitter=%f;rxcount=%u;txjitter=%f;txcount=%u;rlp=%u;rtt=%f",
1693                          stats.local_ssrc, stats.remote_ssrc, stats.rxploss, stats.rxjitter, stats.rxcount, stats.txjitter, stats.txcount, stats.txploss, stats.rtt);
1694         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER) {
1695                 snprintf(buf, size, "minrxjitter=%f;maxrxjitter=%f;avgrxjitter=%f;stdevrxjitter=%f;reported_minjitter=%f;reported_maxjitter=%f;reported_avgjitter=%f;reported_stdevjitter=%f;",
1696                          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));
1697         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS) {
1698                 snprintf(buf, size, "minrxlost=%f;maxrxlost=%f;avgrxlost=%f;stdevrxlost=%f;reported_minlost=%f;reported_maxlost=%f;reported_avglost=%f;reported_stdevlost=%f;",
1699                          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));
1700         } else if (field == AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT) {
1701                 snprintf(buf, size, "minrtt=%f;maxrtt=%f;avgrtt=%f;stdevrtt=%f;", stats.minrtt, stats.maxrtt, stats.normdevrtt, stats.stdevrtt);
1702         }
1703
1704         return buf;
1705 }
1706
1707 void ast_rtp_instance_set_stats_vars(struct ast_channel *chan, struct ast_rtp_instance *instance)
1708 {
1709         char quality_buf[AST_MAX_USER_FIELD];
1710         char *quality;
1711         struct ast_channel *bridge = ast_channel_bridge_peer(chan);
1712
1713         ast_channel_lock(chan);
1714         ast_channel_stage_snapshot(chan);
1715         ast_channel_unlock(chan);
1716         if (bridge) {
1717                 ast_channel_lock(bridge);
1718                 ast_channel_stage_snapshot(bridge);
1719                 ast_channel_unlock(bridge);
1720         }
1721
1722         quality = ast_rtp_instance_get_quality(instance, AST_RTP_INSTANCE_STAT_FIELD_QUALITY,
1723                 quality_buf, sizeof(quality_buf));
1724         if (quality) {
1725                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOS", quality);
1726                 if (bridge) {
1727                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSBRIDGED", quality);
1728                 }
1729         }
1730
1731         quality = ast_rtp_instance_get_quality(instance,
1732                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_JITTER, quality_buf, sizeof(quality_buf));
1733         if (quality) {
1734                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSJITTER", quality);
1735                 if (bridge) {
1736                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSJITTERBRIDGED", quality);
1737                 }
1738         }
1739
1740         quality = ast_rtp_instance_get_quality(instance,
1741                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_LOSS, quality_buf, sizeof(quality_buf));
1742         if (quality) {
1743                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSLOSS", quality);
1744                 if (bridge) {
1745                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSLOSSBRIDGED", quality);
1746                 }
1747         }
1748
1749         quality = ast_rtp_instance_get_quality(instance,
1750                 AST_RTP_INSTANCE_STAT_FIELD_QUALITY_RTT, quality_buf, sizeof(quality_buf));
1751         if (quality) {
1752                 pbx_builtin_setvar_helper(chan, "RTPAUDIOQOSRTT", quality);
1753                 if (bridge) {
1754                         pbx_builtin_setvar_helper(bridge, "RTPAUDIOQOSRTTBRIDGED", quality);
1755                 }
1756         }
1757
1758         ast_channel_lock(chan);
1759         ast_channel_stage_snapshot_done(chan);
1760         ast_channel_unlock(chan);
1761         if (bridge) {
1762                 ast_channel_lock(bridge);
1763                 ast_channel_stage_snapshot_done(bridge);
1764                 ast_channel_unlock(bridge);
1765                 ast_channel_unref(bridge);
1766         }
1767 }
1768
1769 int ast_rtp_instance_set_read_format(struct ast_rtp_instance *instance, struct ast_format *format)
1770 {
1771         return instance->engine->set_read_format ? instance->engine->set_read_format(instance, format) : -1;
1772 }
1773
1774 int ast_rtp_instance_set_write_format(struct ast_rtp_instance *instance, struct ast_format *format)
1775 {
1776         return instance->engine->set_write_format ? instance->engine->set_write_format(instance, format) : -1;
1777 }
1778
1779 int ast_rtp_instance_make_compatible(struct ast_channel *chan, struct ast_rtp_instance *instance, struct ast_channel *peer)
1780 {
1781         struct ast_rtp_glue *glue;
1782         struct ast_rtp_instance *peer_instance = NULL;
1783         int res = -1;
1784
1785         if (!instance->engine->make_compatible) {
1786                 return -1;
1787         }
1788
1789         ast_channel_lock(peer);
1790
1791         if (!(glue = ast_rtp_instance_get_glue(ast_channel_tech(peer)->type))) {
1792                 ast_channel_unlock(peer);
1793                 return -1;
1794         }
1795
1796         glue->get_rtp_info(peer, &peer_instance);
1797         if (!peer_instance) {
1798                 ast_log(LOG_ERROR, "Unable to get_rtp_info for peer type %s\n", glue->type);
1799                 ast_channel_unlock(peer);
1800                 return -1;
1801         }
1802         if (peer_instance->engine != instance->engine) {
1803                 ast_log(LOG_ERROR, "Peer engine mismatch for type %s\n", glue->type);
1804                 ast_channel_unlock(peer);
1805                 ao2_ref(peer_instance, -1);
1806                 return -1;
1807         }
1808
1809         res = instance->engine->make_compatible(chan, instance, peer, peer_instance);
1810
1811         ast_channel_unlock(peer);
1812
1813         ao2_ref(peer_instance, -1);
1814         peer_instance = NULL;
1815
1816         return res;
1817 }
1818
1819 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)
1820 {
1821         if (instance->engine->available_formats) {
1822                 instance->engine->available_formats(instance, to_endpoint, to_asterisk, result);
1823                 if (ast_format_cap_count(result)) {
1824                         return;
1825                 }
1826         }
1827
1828         ast_translate_available_formats(to_endpoint, to_asterisk, result);
1829 }
1830
1831 int ast_rtp_instance_activate(struct ast_rtp_instance *instance)
1832 {
1833         return instance->engine->activate ? instance->engine->activate(instance) : 0;
1834 }
1835
1836 void ast_rtp_instance_stun_request(struct ast_rtp_instance *instance,
1837                                    struct ast_sockaddr *suggestion,
1838                                    const char *username)
1839 {
1840         if (instance->engine->stun_request) {
1841                 instance->engine->stun_request(instance, suggestion, username);
1842         }
1843 }
1844
1845 void ast_rtp_instance_set_timeout(struct ast_rtp_instance *instance, int timeout)
1846 {
1847         instance->timeout = timeout;
1848 }
1849
1850 void ast_rtp_instance_set_hold_timeout(struct ast_rtp_instance *instance, int timeout)
1851 {
1852         instance->holdtimeout = timeout;
1853 }
1854
1855 void ast_rtp_instance_set_keepalive(struct ast_rtp_instance *instance, int interval)
1856 {
1857         instance->keepalive = interval;
1858 }
1859
1860 int ast_rtp_instance_get_timeout(struct ast_rtp_instance *instance)
1861 {
1862         return instance->timeout;
1863 }
1864
1865 int ast_rtp_instance_get_hold_timeout(struct ast_rtp_instance *instance)
1866 {
1867         return instance->holdtimeout;
1868 }
1869
1870 int ast_rtp_instance_get_keepalive(struct ast_rtp_instance *instance)
1871 {
1872         return instance->keepalive;
1873 }
1874
1875 struct ast_rtp_engine *ast_rtp_instance_get_engine(struct ast_rtp_instance *instance)
1876 {
1877         return instance->engine;
1878 }
1879
1880 struct ast_rtp_glue *ast_rtp_instance_get_active_glue(struct ast_rtp_instance *instance)
1881 {
1882         return instance->glue;
1883 }
1884
1885 int ast_rtp_engine_register_srtp(struct ast_srtp_res *srtp_res, struct ast_srtp_policy_res *policy_res)
1886 {
1887         if (res_srtp || res_srtp_policy) {
1888                 return -1;
1889         }
1890         if (!srtp_res || !policy_res) {
1891                 return -1;
1892         }
1893
1894         res_srtp = srtp_res;
1895         res_srtp_policy = policy_res;
1896
1897         return 0;
1898 }
1899
1900 void ast_rtp_engine_unregister_srtp(void)
1901 {
1902         res_srtp = NULL;
1903         res_srtp_policy = NULL;
1904 }
1905
1906 int ast_rtp_engine_srtp_is_registered(void)
1907 {
1908         return res_srtp && res_srtp_policy;
1909 }
1910
1911 int ast_rtp_instance_add_srtp_policy(struct ast_rtp_instance *instance, struct ast_srtp_policy *remote_policy, struct ast_srtp_policy *local_policy)
1912 {
1913         int res = 0;
1914
1915         if (!res_srtp) {
1916                 return -1;
1917         }
1918
1919         if (!instance->srtp) {
1920                 res = res_srtp->create(&instance->srtp, instance, remote_policy);
1921         } else {
1922                 res = res_srtp->replace(&instance->srtp, instance, remote_policy);
1923         }
1924         if (!res) {
1925                 res = res_srtp->add_stream(instance->srtp, local_policy);
1926         }
1927
1928         return res;
1929 }
1930
1931 struct ast_srtp *ast_rtp_instance_get_srtp(struct ast_rtp_instance *instance)
1932 {
1933         return instance->srtp;
1934 }
1935
1936 int ast_rtp_instance_sendcng(struct ast_rtp_instance *instance, int level)
1937 {
1938         if (instance->engine->sendcng) {
1939                 return instance->engine->sendcng(instance, level);
1940         }
1941
1942         return -1;
1943 }
1944
1945 struct ast_rtp_engine_ice *ast_rtp_instance_get_ice(struct ast_rtp_instance *instance)
1946 {
1947         return instance->engine->ice;
1948 }
1949
1950 struct ast_rtp_engine_dtls *ast_rtp_instance_get_dtls(struct ast_rtp_instance *instance)
1951 {
1952         return instance->engine->dtls;
1953 }
1954
1955 int ast_rtp_dtls_cfg_parse(struct ast_rtp_dtls_cfg *dtls_cfg, const char *name, const char *value)
1956 {
1957         if (!strcasecmp(name, "dtlsenable")) {
1958                 dtls_cfg->enabled = ast_true(value) ? 1 : 0;
1959         } else if (!strcasecmp(name, "dtlsverify")) {
1960                 if (!strcasecmp(value, "yes")) {
1961                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_FINGERPRINT | AST_RTP_DTLS_VERIFY_CERTIFICATE;
1962                 } else if (!strcasecmp(value, "fingerprint")) {
1963                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_FINGERPRINT;
1964                 } else if (!strcasecmp(value, "certificate")) {
1965                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_CERTIFICATE;
1966                 } else if (!strcasecmp(value, "no")) {
1967                         dtls_cfg->verify = AST_RTP_DTLS_VERIFY_NONE;
1968                 } else {
1969                         return -1;
1970                 }
1971         } else if (!strcasecmp(name, "dtlsrekey")) {
1972                 if (sscanf(value, "%30u", &dtls_cfg->rekey) != 1) {
1973                         return -1;
1974                 }
1975         } else if (!strcasecmp(name, "dtlscertfile")) {
1976                 ast_free(dtls_cfg->certfile);
1977                 dtls_cfg->certfile = ast_strdup(value);
1978         } else if (!strcasecmp(name, "dtlsprivatekey")) {
1979                 ast_free(dtls_cfg->pvtfile);
1980                 dtls_cfg->pvtfile = ast_strdup(value);
1981         } else if (!strcasecmp(name, "dtlscipher")) {
1982                 ast_free(dtls_cfg->cipher);
1983                 dtls_cfg->cipher = ast_strdup(value);
1984         } else if (!strcasecmp(name, "dtlscafile")) {
1985                 ast_free(dtls_cfg->cafile);
1986                 dtls_cfg->cafile = ast_strdup(value);
1987         } else if (!strcasecmp(name, "dtlscapath") || !strcasecmp(name, "dtlscadir")) {
1988                 ast_free(dtls_cfg->capath);
1989                 dtls_cfg->capath = ast_strdup(value);
1990         } else if (!strcasecmp(name, "dtlssetup")) {
1991                 if (!strcasecmp(value, "active")) {
1992                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_ACTIVE;
1993                 } else if (!strcasecmp(value, "passive")) {
1994                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_PASSIVE;
1995                 } else if (!strcasecmp(value, "actpass")) {
1996                         dtls_cfg->default_setup = AST_RTP_DTLS_SETUP_ACTPASS;
1997                 }
1998         } else if (!strcasecmp(name, "dtlsfingerprint")) {
1999                 if (!strcasecmp(value, "sha-256")) {
2000                         dtls_cfg->hash = AST_RTP_DTLS_HASH_SHA256;
2001                 } else if (!strcasecmp(value, "sha-1")) {
2002                         dtls_cfg->hash = AST_RTP_DTLS_HASH_SHA1;
2003                 }
2004         } else {
2005                 return -1;
2006         }
2007
2008         return 0;
2009 }
2010
2011 void ast_rtp_dtls_cfg_copy(const struct ast_rtp_dtls_cfg *src_cfg, struct ast_rtp_dtls_cfg *dst_cfg)
2012 {
2013         ast_rtp_dtls_cfg_free(dst_cfg);         /* Prevent a double-call leaking memory via ast_strdup */
2014
2015         dst_cfg->enabled = src_cfg->enabled;
2016         dst_cfg->verify = src_cfg->verify;
2017         dst_cfg->rekey = src_cfg->rekey;
2018         dst_cfg->suite = src_cfg->suite;
2019         dst_cfg->hash = src_cfg->hash;
2020         dst_cfg->certfile = ast_strdup(src_cfg->certfile);
2021         dst_cfg->pvtfile = ast_strdup(src_cfg->pvtfile);
2022         dst_cfg->cipher = ast_strdup(src_cfg->cipher);
2023         dst_cfg->cafile = ast_strdup(src_cfg->cafile);
2024         dst_cfg->capath = ast_strdup(src_cfg->capath);
2025         dst_cfg->default_setup = src_cfg->default_setup;
2026 }
2027
2028 void ast_rtp_dtls_cfg_free(struct ast_rtp_dtls_cfg *dtls_cfg)
2029 {
2030         ast_free(dtls_cfg->certfile);
2031         dtls_cfg->certfile = NULL;
2032         ast_free(dtls_cfg->pvtfile);
2033         dtls_cfg->pvtfile = NULL;
2034         ast_free(dtls_cfg->cipher);
2035         dtls_cfg->cipher = NULL;
2036         ast_free(dtls_cfg->cafile);
2037         dtls_cfg->cafile = NULL;
2038         ast_free(dtls_cfg->capath);
2039         dtls_cfg->capath = NULL;
2040 }
2041
2042 /*! \internal
2043  * \brief Small helper routine that cleans up entry i in
2044  * \c ast_rtp_mime_types.
2045  */
2046 static void rtp_engine_mime_type_cleanup(int i)
2047 {
2048         ao2_cleanup(ast_rtp_mime_types[i].payload_type.format);
2049         memset(&ast_rtp_mime_types[i], 0, sizeof(struct ast_rtp_mime_type));
2050 }
2051
2052 static void set_next_mime_type(struct ast_format *format, int rtp_code, const char *type, const char *subtype, unsigned int sample_rate)
2053 {
2054         int x;
2055
2056         ast_rwlock_wrlock(&mime_types_lock);
2057
2058         x = mime_types_len;
2059         if (ARRAY_LEN(ast_rtp_mime_types) <= x) {
2060                 ast_rwlock_unlock(&mime_types_lock);
2061                 return;
2062         }
2063
2064         /* Make sure any previous value in ast_rtp_mime_types is cleaned up */
2065         memset(&ast_rtp_mime_types[x], 0, sizeof(struct ast_rtp_mime_type));    
2066         if (format) {
2067                 ast_rtp_mime_types[x].payload_type.asterisk_format = 1;
2068                 ast_rtp_mime_types[x].payload_type.format = ao2_bump(format);
2069         } else {
2070                 ast_rtp_mime_types[x].payload_type.rtp_code = rtp_code;
2071         }
2072         ast_copy_string(ast_rtp_mime_types[x].type, type, sizeof(ast_rtp_mime_types[x].type));
2073         ast_copy_string(ast_rtp_mime_types[x].subtype, subtype, sizeof(ast_rtp_mime_types[x].subtype));
2074         ast_rtp_mime_types[x].sample_rate = sample_rate;
2075         mime_types_len++;
2076
2077         ast_rwlock_unlock(&mime_types_lock);
2078 }
2079
2080 static void add_static_payload(int map, struct ast_format *format, int rtp_code)
2081 {
2082         int x;
2083         struct ast_rtp_payload_type *type;
2084
2085         ast_assert(map < ARRAY_LEN(static_RTP_PT));
2086
2087         ast_rwlock_wrlock(&static_RTP_PT_lock);
2088         if (map < 0) {
2089                 /* find next available dynamic payload slot */
2090                 for (x = AST_RTP_PT_FIRST_DYNAMIC; x < AST_RTP_MAX_PT; ++x) {
2091                         if (!static_RTP_PT[x]) {
2092                                 map = x;
2093                                 break;
2094                         }
2095                 }
2096                 if (map < 0) {
2097                         if (format) {
2098                                 ast_log(LOG_WARNING, "No Dynamic RTP mapping available for format %s\n",
2099                                         ast_format_get_name(format));
2100                         } else {
2101                                 ast_log(LOG_WARNING, "No Dynamic RTP mapping available for RTP code %d\n",
2102                                         rtp_code);
2103                         }
2104                         ast_rwlock_unlock(&static_RTP_PT_lock);
2105                         return;
2106                 }
2107         }
2108
2109         type = ast_rtp_engine_alloc_payload_type();
2110         if (type) {
2111                 if (format) {
2112                         ao2_ref(format, +1);
2113                         type->format = format;
2114                         type->asterisk_format = 1;
2115                 } else {
2116                         type->rtp_code = rtp_code;
2117                 }
2118                 type->payload = map;
2119                 type->primary_mapping = 1;
2120                 ao2_cleanup(static_RTP_PT[map]);
2121                 static_RTP_PT[map] = type;
2122         }
2123         ast_rwlock_unlock(&static_RTP_PT_lock);
2124 }
2125
2126 int ast_rtp_engine_load_format(struct ast_format *format)
2127 {
2128         char *codec_name = ast_strdupa(ast_format_get_name(format));
2129
2130         codec_name = ast_str_to_upper(codec_name);
2131
2132         set_next_mime_type(format,
2133                 0,
2134                 ast_codec_media_type2str(ast_format_get_type(format)),
2135                 codec_name,
2136                 ast_format_get_sample_rate(format));
2137         add_static_payload(-1, format, 0);
2138
2139         return 0;
2140 }
2141
2142 int ast_rtp_engine_unload_format(struct ast_format *format)
2143 {
2144         int x;
2145         int y = 0;
2146
2147         ast_rwlock_wrlock(&static_RTP_PT_lock);
2148         /* remove everything pertaining to this format id from the lists */
2149         for (x = 0; x < AST_RTP_MAX_PT; x++) {
2150                 if (static_RTP_PT[x]
2151                         && ast_format_cmp(static_RTP_PT[x]->format, format) == AST_FORMAT_CMP_EQUAL) {
2152                         ao2_ref(static_RTP_PT[x], -1);
2153                         static_RTP_PT[x] = NULL;
2154                 }
2155         }
2156         ast_rwlock_unlock(&static_RTP_PT_lock);
2157
2158         ast_rwlock_wrlock(&mime_types_lock);
2159         /* rebuild the list skipping the items matching this id */
2160         for (x = 0; x < mime_types_len; x++) {
2161                 if (ast_format_cmp(ast_rtp_mime_types[x].payload_type.format, format) == AST_FORMAT_CMP_EQUAL) {
2162                         rtp_engine_mime_type_cleanup(x);
2163                         continue;
2164                 }
2165                 if (x != y) {
2166                         ast_rtp_mime_types[y] = ast_rtp_mime_types[x];
2167                 }
2168                 y++;
2169         }
2170         mime_types_len = y;
2171         ast_rwlock_unlock(&mime_types_lock);
2172         return 0;
2173 }
2174
2175 /*!
2176  * \internal
2177  * \brief \ref stasis message payload for RTCP messages
2178  */
2179 struct rtcp_message_payload {
2180         struct ast_channel_snapshot *snapshot;  /*< The channel snapshot, if available */
2181         struct ast_rtp_rtcp_report *report;     /*< The RTCP report */
2182         struct ast_json *blob;                  /*< Extra JSON data to publish */
2183 };
2184
2185 static void rtcp_message_payload_dtor(void *obj)
2186 {
2187         struct rtcp_message_payload *payload = obj;
2188
2189         ao2_cleanup(payload->report);
2190         ao2_cleanup(payload->snapshot);
2191         ast_json_unref(payload->blob);
2192 }
2193
2194 static struct ast_manager_event_blob *rtcp_report_to_ami(struct stasis_message *msg)
2195 {
2196         struct rtcp_message_payload *payload = stasis_message_data(msg);
2197         RAII_VAR(struct ast_str *, channel_string, NULL, ast_free);
2198         RAII_VAR(struct ast_str *, packet_string, ast_str_create(512), ast_free);
2199         unsigned int ssrc = payload->report->ssrc;
2200         unsigned int type = payload->report->type;
2201         unsigned int report_count = payload->report->reception_report_count;
2202         int i;
2203
2204         if (!packet_string) {
2205                 return NULL;
2206         }
2207
2208         if (payload->snapshot) {
2209                 channel_string = ast_manager_build_channel_state_string(payload->snapshot);
2210                 if (!channel_string) {
2211                         return NULL;
2212                 }
2213         }
2214
2215         if (payload->blob) {
2216                 /* Optional data */
2217                 struct ast_json *to = ast_json_object_get(payload->blob, "to");
2218                 struct ast_json *from = ast_json_object_get(payload->blob, "from");
2219                 struct ast_json *rtt = ast_json_object_get(payload->blob, "rtt");
2220                 if (to) {
2221                         ast_str_append(&packet_string, 0, "To: %s\r\n", ast_json_string_get(to));
2222                 }
2223                 if (from) {
2224                         ast_str_append(&packet_string, 0, "From: %s\r\n", ast_json_string_get(from));
2225                 }
2226                 if (rtt) {
2227                         ast_str_append(&packet_string, 0, "RTT: %4.4f\r\n", ast_json_real_get(rtt));
2228                 }
2229         }
2230
2231         ast_str_append(&packet_string, 0, "SSRC: 0x%.8x\r\n", ssrc);
2232         ast_str_append(&packet_string, 0, "PT: %u(%s)\r\n", type, type== AST_RTP_RTCP_SR ? "SR" : "RR");
2233         ast_str_append(&packet_string, 0, "ReportCount: %u\r\n", report_count);
2234         if (type == AST_RTP_RTCP_SR) {
2235                 ast_str_append(&packet_string, 0, "SentNTP: %lu.%06lu\r\n",
2236                         (unsigned long)payload->report->sender_information.ntp_timestamp.tv_sec,
2237                         (unsigned long)payload->report->sender_information.ntp_timestamp.tv_usec * 4096);
2238                 ast_str_append(&packet_string, 0, "SentRTP: %u\r\n",
2239                                 payload->report->sender_information.rtp_timestamp);
2240                 ast_str_append(&packet_string, 0, "SentPackets: %u\r\n",
2241                                 payload->report->sender_information.packet_count);
2242                 ast_str_append(&packet_string, 0, "SentOctets: %u\r\n",
2243                                 payload->report->sender_information.octet_count);
2244         }
2245
2246         for (i = 0; i < report_count; i++) {
2247                 RAII_VAR(struct ast_str *, report_string, NULL, ast_free);
2248
2249                 if (!payload->report->report_block[i]) {
2250                         break;
2251                 }
2252
2253                 report_string = ast_str_create(256);
2254                 if (!report_string) {
2255                         return NULL;
2256                 }
2257
2258                 ast_str_append(&report_string, 0, "Report%dSourceSSRC: 0x%.8x\r\n",
2259                                 i, payload->report->report_block[i]->source_ssrc);
2260                 ast_str_append(&report_string, 0, "Report%dFractionLost: %d\r\n",
2261                                 i, payload->report->report_block[i]->lost_count.fraction);
2262                 ast_str_append(&report_string, 0, "Report%dCumulativeLost: %u\r\n",
2263                                 i, payload->report->report_block[i]->lost_count.packets);
2264                 ast_str_append(&report_string, 0, "Report%dHighestSequence: %u\r\n",
2265                                 i, payload->report->report_block[i]->highest_seq_no & 0xffff);
2266                 ast_str_append(&report_string, 0, "Report%dSequenceNumberCycles: %u\r\n",
2267                                 i, payload->report->report_block[i]->highest_seq_no >> 16);
2268                 ast_str_append(&report_string, 0, "Report%dIAJitter: %u\r\n",
2269                                 i, payload->report->report_block[i]->ia_jitter);
2270                 ast_str_append(&report_string, 0, "Report%dLSR: %u\r\n",
2271                                 i, payload->report->report_block[i]->lsr);
2272                 ast_str_append(&report_string, 0, "Report%dDLSR: %4.4f\r\n",
2273                                 i, ((double)payload->report->report_block[i]->dlsr) / 65536);
2274                 ast_str_append(&packet_string, 0, "%s", ast_str_buffer(report_string));
2275         }
2276
2277         return ast_manager_event_blob_create(EVENT_FLAG_REPORTING,
2278                 stasis_message_type(msg) == ast_rtp_rtcp_received_type() ? "RTCPReceived" : "RTCPSent",
2279                 "%s%s",
2280                 AS_OR(channel_string, ""),
2281                 ast_str_buffer(packet_string));
2282 }
2283
2284 static struct ast_json *rtcp_report_to_json(struct stasis_message *msg,
2285         const struct stasis_message_sanitizer *sanitize)
2286 {
2287         struct rtcp_message_payload *payload = stasis_message_data(msg);
2288         RAII_VAR(struct ast_json *, json_rtcp_report, NULL, ast_json_unref);
2289         RAII_VAR(struct ast_json *, json_rtcp_report_blocks, NULL, ast_json_unref);
2290         RAII_VAR(struct ast_json *, json_rtcp_sender_info, NULL, ast_json_unref);
2291         RAII_VAR(struct ast_json *, json_channel, NULL, ast_json_unref);
2292         int i;
2293
2294         json_rtcp_report_blocks = ast_json_array_create();
2295         if (!json_rtcp_report_blocks) {
2296                 return NULL;
2297         }
2298
2299         for (i = 0; i < payload->report->reception_report_count && payload->report->report_block[i]; i++) {
2300                 struct ast_json *json_report_block;
2301                 char str_lsr[32];
2302                 snprintf(str_lsr, sizeof(str_lsr), "%u", payload->report->report_block[i]->lsr);
2303                 json_report_block = ast_json_pack("{s: i, s: i, s: i, s: i, s: i, s: s, s: i}",
2304                                 "source_ssrc", payload->report->report_block[i]->source_ssrc,
2305                                 "fraction_lost", payload->report->report_block[i]->lost_count.fraction,
2306                                 "packets_lost", payload->report->report_block[i]->lost_count.packets,
2307                                 "highest_seq_no", payload->report->report_block[i]->highest_seq_no,
2308                                 "ia_jitter", payload->report->report_block[i]->ia_jitter,
2309                                 "lsr", str_lsr,
2310                                 "dlsr", payload->report->report_block[i]->dlsr);
2311                 if (!json_report_block) {
2312                         return NULL;
2313                 }
2314
2315                 if (ast_json_array_append(json_rtcp_report_blocks, json_report_block)) {
2316                         return NULL;
2317                 }
2318         }
2319
2320         if (payload->report->type == AST_RTP_RTCP_SR) {
2321                 char sec[32];
2322                 char usec[32];
2323                 snprintf(sec, sizeof(sec), "%lu", (unsigned long)payload->report->sender_information.ntp_timestamp.tv_sec);
2324                 snprintf(usec, sizeof(usec), "%lu", (unsigned long)payload->report->sender_information.ntp_timestamp.tv_usec);
2325                 json_rtcp_sender_info = ast_json_pack("{s: s, s: s, s: i, s: i, s: i}",
2326                                 "ntp_timestamp_sec", sec,
2327                                 "ntp_timestamp_usec", usec,
2328                                 "rtp_timestamp", payload->report->sender_information.rtp_timestamp,
2329                                 "packets", payload->report->sender_information.packet_count,
2330                                 "octets", payload->report->sender_information.octet_count);
2331                 if (!json_rtcp_sender_info) {
2332                         return NULL;
2333                 }
2334         }
2335
2336         json_rtcp_report = ast_json_pack("{s: i, s: i, s: i, s: O, s: O}",
2337                         "ssrc", payload->report->ssrc,
2338                         "type", payload->report->type,
2339                         "report_count", payload->report->reception_report_count,
2340                         "sender_information", json_rtcp_sender_info ? json_rtcp_sender_info : ast_json_null(),
2341                         "report_blocks", json_rtcp_report_blocks);
2342         if (!json_rtcp_report) {
2343                 return NULL;
2344         }
2345
2346         if (payload->snapshot) {
2347                 json_channel = ast_channel_snapshot_to_json(payload->snapshot, sanitize);
2348                 if (!json_channel) {
2349                         return NULL;
2350                 }
2351         }
2352
2353         return ast_json_pack("{s: O, s: O, s: O}",
2354                 "channel", payload->snapshot ? json_channel : ast_json_null(),
2355                 "rtcp_report", json_rtcp_report,
2356                 "blob", payload->blob);
2357 }
2358
2359 static void rtp_rtcp_report_dtor(void *obj)
2360 {
2361         int i;
2362         struct ast_rtp_rtcp_report *rtcp_report = obj;
2363
2364         for (i = 0; i < rtcp_report->reception_report_count; i++) {
2365                 ast_free(rtcp_report->report_block[i]);
2366         }
2367 }
2368
2369 struct ast_rtp_rtcp_report *ast_rtp_rtcp_report_alloc(unsigned int report_blocks)
2370 {
2371         struct ast_rtp_rtcp_report *rtcp_report;
2372
2373         /* Size of object is sizeof the report + the number of report_blocks * sizeof pointer */
2374         rtcp_report = ao2_alloc((sizeof(*rtcp_report) + report_blocks * sizeof(struct ast_rtp_rtcp_report_block *)),
2375                 rtp_rtcp_report_dtor);
2376
2377         return rtcp_report;
2378 }
2379
2380 void ast_rtp_publish_rtcp_message(struct ast_rtp_instance *rtp,
2381                 struct stasis_message_type *message_type,
2382                 struct ast_rtp_rtcp_report *report,
2383                 struct ast_json *blob)
2384 {
2385         RAII_VAR(struct rtcp_message_payload *, payload, NULL, ao2_cleanup);
2386         RAII_VAR(struct stasis_message *, message, NULL, ao2_cleanup);
2387
2388         if (!message_type) {
2389                 return;
2390         }
2391
2392         payload = ao2_alloc(sizeof(*payload), rtcp_message_payload_dtor);
2393         if (!payload || !report) {
2394                 return;
2395         }
2396
2397         if (!ast_strlen_zero(rtp->channel_uniqueid)) {
2398                 payload->snapshot = ast_channel_snapshot_get_latest(rtp->channel_uniqueid);
2399         }
2400         if (blob) {
2401                 payload->blob = blob;
2402                 ast_json_ref(blob);
2403         }
2404         ao2_ref(report, +1);
2405         payload->report = report;
2406
2407         message = stasis_message_create(message_type, payload);
2408         if (!message) {
2409                 return;
2410         }
2411
2412         stasis_publish(ast_rtp_topic(), message);
2413 }
2414
2415 /*!
2416  * @{ \brief Define RTCP/RTP message types.
2417  */
2418 STASIS_MESSAGE_TYPE_DEFN(ast_rtp_rtcp_sent_type,
2419                 .to_ami = rtcp_report_to_ami,
2420                 .to_json = rtcp_report_to_json,);
2421 STASIS_MESSAGE_TYPE_DEFN(ast_rtp_rtcp_received_type,
2422                 .to_ami = rtcp_report_to_ami,
2423                 .to_json = rtcp_report_to_json,);
2424 /*! @} */
2425
2426 struct stasis_topic *ast_rtp_topic(void)
2427 {
2428         return rtp_topic;
2429 }
2430
2431 static void rtp_engine_shutdown(void)
2432 {
2433         int x;
2434
2435         ao2_cleanup(rtp_topic);
2436         rtp_topic = NULL;
2437         STASIS_MESSAGE_TYPE_CLEANUP(ast_rtp_rtcp_received_type);
2438         STASIS_MESSAGE_TYPE_CLEANUP(ast_rtp_rtcp_sent_type);
2439
2440         ast_rwlock_wrlock(&static_RTP_PT_lock);
2441         for (x = 0; x < AST_RTP_MAX_PT; x++) {
2442                 ao2_cleanup(static_RTP_PT[x]);
2443                 static_RTP_PT[x] = NULL;
2444         }
2445         ast_rwlock_unlock(&static_RTP_PT_lock);
2446
2447         ast_rwlock_wrlock(&mime_types_lock);
2448         for (x = 0; x < mime_types_len; x++) {
2449                 if (ast_rtp_mime_types[x].payload_type.format) {
2450                         rtp_engine_mime_type_cleanup(x);
2451                 }
2452         }
2453         mime_types_len = 0;
2454         ast_rwlock_unlock(&mime_types_lock);
2455 }
2456
2457 int ast_rtp_engine_init(void)
2458 {
2459         ast_rwlock_init(&mime_types_lock);
2460         ast_rwlock_init(&static_RTP_PT_lock);
2461
2462         rtp_topic = stasis_topic_create("rtp_topic");
2463         if (!rtp_topic) {
2464                 return -1;
2465         }
2466         STASIS_MESSAGE_TYPE_INIT(ast_rtp_rtcp_sent_type);
2467         STASIS_MESSAGE_TYPE_INIT(ast_rtp_rtcp_received_type);
2468         ast_register_cleanup(rtp_engine_shutdown);
2469
2470         /* Define all the RTP mime types available */
2471         set_next_mime_type(ast_format_g723, 0, "audio", "G723", 8000);
2472         set_next_mime_type(ast_format_gsm, 0, "audio", "GSM", 8000);
2473         set_next_mime_type(ast_format_ulaw, 0, "audio", "PCMU", 8000);
2474         set_next_mime_type(ast_format_ulaw, 0, "audio", "G711U", 8000);
2475         set_next_mime_type(ast_format_alaw, 0, "audio", "PCMA", 8000);
2476         set_next_mime_type(ast_format_alaw, 0, "audio", "G711A", 8000);
2477         set_next_mime_type(ast_format_g726, 0, "audio", "G726-32", 8000);
2478         set_next_mime_type(ast_format_adpcm, 0, "audio", "DVI4", 8000);
2479         set_next_mime_type(ast_format_slin, 0, "audio", "L16", 8000);
2480         set_next_mime_type(ast_format_slin16, 0, "audio", "L16", 16000);
2481         set_next_mime_type(ast_format_slin16, 0, "audio", "L16-256", 16000);
2482         set_next_mime_type(ast_format_slin12, 0, "audio", "L16", 12000);
2483         set_next_mime_type(ast_format_slin24, 0, "audio", "L16", 24000);
2484         set_next_mime_type(ast_format_slin32, 0, "audio", "L16", 32000);
2485         set_next_mime_type(ast_format_slin44, 0, "audio", "L16", 44000);
2486         set_next_mime_type(ast_format_slin48, 0, "audio", "L16", 48000);
2487         set_next_mime_type(ast_format_slin96, 0, "audio", "L16", 96000);
2488         set_next_mime_type(ast_format_slin192, 0, "audio", "L16", 192000);
2489         set_next_mime_type(ast_format_lpc10, 0, "audio", "LPC", 8000);
2490         set_next_mime_type(ast_format_g729, 0, "audio", "G729", 8000);
2491         set_next_mime_type(ast_format_g729, 0, "audio", "G729A", 8000);
2492         set_next_mime_type(ast_format_g729, 0, "audio", "G.729", 8000);
2493         set_next_mime_type(ast_format_speex, 0, "audio", "speex", 8000);
2494         set_next_mime_type(ast_format_speex16, 0,  "audio", "speex", 16000);
2495         set_next_mime_type(ast_format_speex32, 0,  "audio", "speex", 32000);
2496         set_next_mime_type(ast_format_ilbc, 0, "audio", "iLBC", 8000);
2497         /* this is the sample rate listed in the RTP profile for the G.722 codec, *NOT* the actual sample rate of the media stream */
2498         set_next_mime_type(ast_format_g722, 0, "audio", "G722", 8000);
2499         set_next_mime_type(ast_format_g726_aal2, 0, "audio", "AAL2-G726-32", 8000);
2500         set_next_mime_type(NULL, AST_RTP_DTMF, "audio", "telephone-event", 8000);
2501         set_next_mime_type(NULL, AST_RTP_CISCO_DTMF, "audio", "cisco-telephone-event", 8000);
2502         set_next_mime_type(NULL, AST_RTP_CN, "audio", "CN", 8000);
2503         set_next_mime_type(ast_format_jpeg, 0, "video", "JPEG", 90000);
2504         set_next_mime_type(ast_format_png, 0, "video", "PNG", 90000);
2505         set_next_mime_type(ast_format_h261, 0, "video", "H261", 90000);
2506         set_next_mime_type(ast_format_h263, 0, "video", "H263", 90000);
2507         set_next_mime_type(ast_format_h263p, 0, "video", "h263-1998", 90000);
2508         set_next_mime_type(ast_format_h264, 0, "video", "H264", 90000);
2509         set_next_mime_type(ast_format_mp4, 0, "video", "MP4V-ES", 90000);
2510         set_next_mime_type(ast_format_t140_red, 0, "text", "RED", 1000);
2511         set_next_mime_type(ast_format_t140, 0, "text", "T140", 1000);
2512         set_next_mime_type(ast_format_siren7, 0, "audio", "G7221", 16000);
2513         set_next_mime_type(ast_format_siren14, 0, "audio", "G7221", 32000);
2514         set_next_mime_type(ast_format_g719, 0, "audio", "G719", 48000);
2515         /* Opus and VP8 */
2516         set_next_mime_type(ast_format_opus, 0,  "audio", "opus", 48000);
2517         set_next_mime_type(ast_format_vp8, 0,  "video", "VP8", 90000);
2518
2519         /* Define the static rtp payload mappings */
2520         add_static_payload(0, ast_format_ulaw, 0);
2521         #ifdef USE_DEPRECATED_G726
2522         add_static_payload(2, ast_format_g726, 0);/* Technically this is G.721, but if Cisco can do it, so can we... */
2523         #endif
2524         add_static_payload(3, ast_format_gsm, 0);
2525         add_static_payload(4, ast_format_g723, 0);
2526         add_static_payload(5, ast_format_adpcm, 0);/* 8 kHz */
2527         add_static_payload(6, ast_format_adpcm, 0); /* 16 kHz */
2528         add_static_payload(7, ast_format_lpc10, 0);
2529         add_static_payload(8, ast_format_alaw, 0);
2530         add_static_payload(9, ast_format_g722, 0);
2531         add_static_payload(10, ast_format_slin, 0); /* 2 channels */
2532         add_static_payload(11, ast_format_slin, 0); /* 1 channel */
2533         add_static_payload(13, NULL, AST_RTP_CN);
2534         add_static_payload(16, ast_format_adpcm, 0); /* 11.025 kHz */
2535         add_static_payload(17, ast_format_adpcm, 0); /* 22.050 kHz */
2536         add_static_payload(18, ast_format_g729, 0);
2537         add_static_payload(19, NULL, AST_RTP_CN);         /* Also used for CN */
2538         add_static_payload(26, ast_format_jpeg, 0);
2539         add_static_payload(31, ast_format_h261, 0);
2540         add_static_payload(34, ast_format_h263, 0);
2541         add_static_payload(97, ast_format_ilbc, 0);
2542         add_static_payload(98, ast_format_h263p, 0);
2543         add_static_payload(99, ast_format_h264, 0);
2544         add_static_payload(101, NULL, AST_RTP_DTMF);
2545         add_static_payload(102, ast_format_siren7, 0);
2546         add_static_payload(103, ast_format_h263p, 0);
2547         add_static_payload(104, ast_format_mp4, 0);
2548         add_static_payload(105, ast_format_t140_red, 0);   /* Real time text chat (with redundancy encoding) */
2549         add_static_payload(106, ast_format_t140, 0);     /* Real time text chat */
2550         add_static_payload(110, ast_format_speex, 0);
2551         add_static_payload(111, ast_format_g726, 0);
2552         add_static_payload(112, ast_format_g726_aal2, 0);
2553         add_static_payload(115, ast_format_siren14, 0);
2554         add_static_payload(116, ast_format_g719, 0);
2555         add_static_payload(117, ast_format_speex16, 0);
2556         add_static_payload(118, ast_format_slin16, 0); /* 16 Khz signed linear */
2557         add_static_payload(119, ast_format_speex32, 0);
2558         add_static_payload(121, NULL, AST_RTP_CISCO_DTMF);   /* Must be type 121 */
2559         add_static_payload(122, ast_format_slin12, 0);
2560         add_static_payload(123, ast_format_slin24, 0);
2561         add_static_payload(124, ast_format_slin32, 0);
2562         add_static_payload(125, ast_format_slin44, 0);
2563         add_static_payload(126, ast_format_slin48, 0);
2564         add_static_payload(127, ast_format_slin96, 0);
2565         /* payload types above 127 are not valid */
2566         add_static_payload(96, ast_format_slin192, 0);
2567         /* Opus and VP8 */
2568         add_static_payload(100, ast_format_vp8, 0);
2569         add_static_payload(107, ast_format_opus, 0);
2570
2571         return 0;
2572 }
2573
2574 time_t ast_rtp_instance_get_last_tx(const struct ast_rtp_instance *rtp)
2575 {
2576         return rtp->last_tx;
2577 }
2578
2579 void ast_rtp_instance_set_last_tx(struct ast_rtp_instance *rtp, time_t time)
2580 {
2581         rtp->last_tx = time;
2582 }
2583
2584 time_t ast_rtp_instance_get_last_rx(const struct ast_rtp_instance *rtp)
2585 {
2586         return rtp->last_rx;
2587 }
2588
2589 void ast_rtp_instance_set_last_rx(struct ast_rtp_instance *rtp, time_t time)
2590 {
2591         rtp->last_rx = time;
2592 }