]> git.sesse.net Git - ffmpeg/blob - libavformat/rtpdec.c
cosmetics: Fix spelling mistakes
[ffmpeg] / libavformat / rtpdec.c
1 /*
2  * RTP input format
3  * Copyright (c) 2002 Fabrice Bellard
4  *
5  * This file is part of Libav.
6  *
7  * Libav is free software; you can redistribute it and/or
8  * modify it under the terms of the GNU Lesser General Public
9  * License as published by the Free Software Foundation; either
10  * version 2.1 of the License, or (at your option) any later version.
11  *
12  * Libav is distributed in the hope that it will be useful,
13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15  * Lesser General Public License for more details.
16  *
17  * You should have received a copy of the GNU Lesser General Public
18  * License along with Libav; if not, write to the Free Software
19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
20  */
21
22 #include "libavutil/mathematics.h"
23 #include "libavutil/avstring.h"
24 #include "libavutil/time.h"
25 #include "libavcodec/get_bits.h"
26 #include "avformat.h"
27 #include "network.h"
28 #include "srtp.h"
29 #include "url.h"
30 #include "rtpdec.h"
31 #include "rtpdec_formats.h"
32
33 #define MIN_FEEDBACK_INTERVAL 200000 /* 200 ms in us */
34
35 static RTPDynamicProtocolHandler realmedia_mp3_dynamic_handler = {
36     .enc_name   = "X-MP3-draft-00",
37     .codec_type = AVMEDIA_TYPE_AUDIO,
38     .codec_id   = AV_CODEC_ID_MP3ADU,
39 };
40
41 static RTPDynamicProtocolHandler speex_dynamic_handler = {
42     .enc_name   = "speex",
43     .codec_type = AVMEDIA_TYPE_AUDIO,
44     .codec_id   = AV_CODEC_ID_SPEEX,
45 };
46
47 static RTPDynamicProtocolHandler opus_dynamic_handler = {
48     .enc_name   = "opus",
49     .codec_type = AVMEDIA_TYPE_AUDIO,
50     .codec_id   = AV_CODEC_ID_OPUS,
51 };
52
53 static RTPDynamicProtocolHandler t140_dynamic_handler = { /* RFC 4103 */
54     .enc_name   = "t140",
55     .codec_type = AVMEDIA_TYPE_DATA,
56     .codec_id   = AV_CODEC_ID_TEXT,
57 };
58
59 static RTPDynamicProtocolHandler *rtp_first_dynamic_payload_handler = NULL;
60
61 void ff_register_dynamic_payload_handler(RTPDynamicProtocolHandler *handler)
62 {
63     handler->next = rtp_first_dynamic_payload_handler;
64     rtp_first_dynamic_payload_handler = handler;
65 }
66
67 void ff_register_rtp_dynamic_payload_handlers(void)
68 {
69     ff_register_dynamic_payload_handler(&ff_ac3_dynamic_handler);
70     ff_register_dynamic_payload_handler(&ff_amr_nb_dynamic_handler);
71     ff_register_dynamic_payload_handler(&ff_amr_wb_dynamic_handler);
72     ff_register_dynamic_payload_handler(&ff_dv_dynamic_handler);
73     ff_register_dynamic_payload_handler(&ff_g726_16_dynamic_handler);
74     ff_register_dynamic_payload_handler(&ff_g726_24_dynamic_handler);
75     ff_register_dynamic_payload_handler(&ff_g726_32_dynamic_handler);
76     ff_register_dynamic_payload_handler(&ff_g726_40_dynamic_handler);
77     ff_register_dynamic_payload_handler(&ff_h261_dynamic_handler);
78     ff_register_dynamic_payload_handler(&ff_h263_1998_dynamic_handler);
79     ff_register_dynamic_payload_handler(&ff_h263_2000_dynamic_handler);
80     ff_register_dynamic_payload_handler(&ff_h263_rfc2190_dynamic_handler);
81     ff_register_dynamic_payload_handler(&ff_h264_dynamic_handler);
82     ff_register_dynamic_payload_handler(&ff_hevc_dynamic_handler);
83     ff_register_dynamic_payload_handler(&ff_ilbc_dynamic_handler);
84     ff_register_dynamic_payload_handler(&ff_jpeg_dynamic_handler);
85     ff_register_dynamic_payload_handler(&ff_mp4a_latm_dynamic_handler);
86     ff_register_dynamic_payload_handler(&ff_mp4v_es_dynamic_handler);
87     ff_register_dynamic_payload_handler(&ff_mpeg_audio_dynamic_handler);
88     ff_register_dynamic_payload_handler(&ff_mpeg_audio_robust_dynamic_handler);
89     ff_register_dynamic_payload_handler(&ff_mpeg_video_dynamic_handler);
90     ff_register_dynamic_payload_handler(&ff_mpeg4_generic_dynamic_handler);
91     ff_register_dynamic_payload_handler(&ff_mpegts_dynamic_handler);
92     ff_register_dynamic_payload_handler(&ff_ms_rtp_asf_pfa_handler);
93     ff_register_dynamic_payload_handler(&ff_ms_rtp_asf_pfv_handler);
94     ff_register_dynamic_payload_handler(&ff_qcelp_dynamic_handler);
95     ff_register_dynamic_payload_handler(&ff_qdm2_dynamic_handler);
96     ff_register_dynamic_payload_handler(&ff_qt_rtp_aud_handler);
97     ff_register_dynamic_payload_handler(&ff_qt_rtp_vid_handler);
98     ff_register_dynamic_payload_handler(&ff_quicktime_rtp_aud_handler);
99     ff_register_dynamic_payload_handler(&ff_quicktime_rtp_vid_handler);
100     ff_register_dynamic_payload_handler(&ff_svq3_dynamic_handler);
101     ff_register_dynamic_payload_handler(&ff_theora_dynamic_handler);
102     ff_register_dynamic_payload_handler(&ff_vorbis_dynamic_handler);
103     ff_register_dynamic_payload_handler(&ff_vp8_dynamic_handler);
104     ff_register_dynamic_payload_handler(&ff_vp9_dynamic_handler);
105     ff_register_dynamic_payload_handler(&opus_dynamic_handler);
106     ff_register_dynamic_payload_handler(&realmedia_mp3_dynamic_handler);
107     ff_register_dynamic_payload_handler(&speex_dynamic_handler);
108     ff_register_dynamic_payload_handler(&t140_dynamic_handler);
109 }
110
111 RTPDynamicProtocolHandler *ff_rtp_handler_find_by_name(const char *name,
112                                                        enum AVMediaType codec_type)
113 {
114     RTPDynamicProtocolHandler *handler;
115     for (handler = rtp_first_dynamic_payload_handler;
116          handler; handler = handler->next)
117         if (handler->enc_name &&
118             !av_strcasecmp(name, handler->enc_name) &&
119             codec_type == handler->codec_type)
120             return handler;
121     return NULL;
122 }
123
124 RTPDynamicProtocolHandler *ff_rtp_handler_find_by_id(int id,
125                                                      enum AVMediaType codec_type)
126 {
127     RTPDynamicProtocolHandler *handler;
128     for (handler = rtp_first_dynamic_payload_handler;
129          handler; handler = handler->next)
130         if (handler->static_payload_id && handler->static_payload_id == id &&
131             codec_type == handler->codec_type)
132             return handler;
133     return NULL;
134 }
135
136 static int rtcp_parse_packet(RTPDemuxContext *s, const unsigned char *buf,
137                              int len)
138 {
139     int payload_len;
140     while (len >= 4) {
141         payload_len = FFMIN(len, (AV_RB16(buf + 2) + 1) * 4);
142
143         switch (buf[1]) {
144         case RTCP_SR:
145             if (payload_len < 20) {
146                 av_log(s->ic, AV_LOG_ERROR, "Invalid RTCP SR packet length\n");
147                 return AVERROR_INVALIDDATA;
148             }
149
150             s->last_rtcp_reception_time = av_gettime_relative();
151             s->last_rtcp_ntp_time  = AV_RB64(buf + 8);
152             s->last_rtcp_timestamp = AV_RB32(buf + 16);
153             if (s->first_rtcp_ntp_time == AV_NOPTS_VALUE) {
154                 s->first_rtcp_ntp_time = s->last_rtcp_ntp_time;
155                 if (!s->base_timestamp)
156                     s->base_timestamp = s->last_rtcp_timestamp;
157                 s->rtcp_ts_offset = (int32_t)(s->last_rtcp_timestamp - s->base_timestamp);
158             }
159
160             break;
161         case RTCP_BYE:
162             return -RTCP_BYE;
163         }
164
165         buf += payload_len;
166         len -= payload_len;
167     }
168     return -1;
169 }
170
171 #define RTP_SEQ_MOD (1 << 16)
172
173 static void rtp_init_statistics(RTPStatistics *s, uint16_t base_sequence)
174 {
175     memset(s, 0, sizeof(RTPStatistics));
176     s->max_seq   = base_sequence;
177     s->probation = 1;
178 }
179
180 /*
181  * Called whenever there is a large jump in sequence numbers,
182  * or when they get out of probation...
183  */
184 static void rtp_init_sequence(RTPStatistics *s, uint16_t seq)
185 {
186     s->max_seq        = seq;
187     s->cycles         = 0;
188     s->base_seq       = seq - 1;
189     s->bad_seq        = RTP_SEQ_MOD + 1;
190     s->received       = 0;
191     s->expected_prior = 0;
192     s->received_prior = 0;
193     s->jitter         = 0;
194     s->transit        = 0;
195 }
196
197 /* Returns 1 if we should handle this packet. */
198 static int rtp_valid_packet_in_sequence(RTPStatistics *s, uint16_t seq)
199 {
200     uint16_t udelta = seq - s->max_seq;
201     const int MAX_DROPOUT    = 3000;
202     const int MAX_MISORDER   = 100;
203     const int MIN_SEQUENTIAL = 2;
204
205     /* source not valid until MIN_SEQUENTIAL packets with sequence
206      * seq. numbers have been received */
207     if (s->probation) {
208         if (seq == s->max_seq + 1) {
209             s->probation--;
210             s->max_seq = seq;
211             if (s->probation == 0) {
212                 rtp_init_sequence(s, seq);
213                 s->received++;
214                 return 1;
215             }
216         } else {
217             s->probation = MIN_SEQUENTIAL - 1;
218             s->max_seq   = seq;
219         }
220     } else if (udelta < MAX_DROPOUT) {
221         // in order, with permissible gap
222         if (seq < s->max_seq) {
223             // sequence number wrapped; count another 64k cycles
224             s->cycles += RTP_SEQ_MOD;
225         }
226         s->max_seq = seq;
227     } else if (udelta <= RTP_SEQ_MOD - MAX_MISORDER) {
228         // sequence made a large jump...
229         if (seq == s->bad_seq) {
230             /* two sequential packets -- assume that the other side
231              * restarted without telling us; just resync. */
232             rtp_init_sequence(s, seq);
233         } else {
234             s->bad_seq = (seq + 1) & (RTP_SEQ_MOD - 1);
235             return 0;
236         }
237     } else {
238         // duplicate or reordered packet...
239     }
240     s->received++;
241     return 1;
242 }
243
244 static void rtcp_update_jitter(RTPStatistics *s, uint32_t sent_timestamp,
245                                uint32_t arrival_timestamp)
246 {
247     // Most of this is pretty straight from RFC 3550 appendix A.8
248     uint32_t transit = arrival_timestamp - sent_timestamp;
249     uint32_t prev_transit = s->transit;
250     int32_t d = transit - prev_transit;
251     // Doing the FFABS() call directly on the "transit - prev_transit"
252     // expression doesn't work, since it's an unsigned expression. Doing the
253     // transit calculation in unsigned is desired though, since it most
254     // probably will need to wrap around.
255     d = FFABS(d);
256     s->transit = transit;
257     if (!prev_transit)
258         return;
259     s->jitter += d - (int32_t) ((s->jitter + 8) >> 4);
260 }
261
262 int ff_rtp_check_and_send_back_rr(RTPDemuxContext *s, URLContext *fd,
263                                   AVIOContext *avio, int count)
264 {
265     AVIOContext *pb;
266     uint8_t *buf;
267     int len;
268     int rtcp_bytes;
269     RTPStatistics *stats = &s->statistics;
270     uint32_t lost;
271     uint32_t extended_max;
272     uint32_t expected_interval;
273     uint32_t received_interval;
274     int32_t  lost_interval;
275     uint32_t expected;
276     uint32_t fraction;
277
278     if ((!fd && !avio) || (count < 1))
279         return -1;
280
281     /* TODO: I think this is way too often; RFC 1889 has algorithm for this */
282     /* XXX: MPEG pts hardcoded. RTCP send every 0.5 seconds */
283     s->octet_count += count;
284     rtcp_bytes = ((s->octet_count - s->last_octet_count) * RTCP_TX_RATIO_NUM) /
285         RTCP_TX_RATIO_DEN;
286     rtcp_bytes /= 50; // mmu_man: that's enough for me... VLC sends much less btw !?
287     if (rtcp_bytes < 28)
288         return -1;
289     s->last_octet_count = s->octet_count;
290
291     if (!fd)
292         pb = avio;
293     else if (avio_open_dyn_buf(&pb) < 0)
294         return -1;
295
296     // Receiver Report
297     avio_w8(pb, (RTP_VERSION << 6) + 1); /* 1 report block */
298     avio_w8(pb, RTCP_RR);
299     avio_wb16(pb, 7); /* length in words - 1 */
300     // our own SSRC: we use the server's SSRC + 1 to avoid conflicts
301     avio_wb32(pb, s->ssrc + 1);
302     avio_wb32(pb, s->ssrc); // server SSRC
303     // some placeholders we should really fill...
304     // RFC 1889/p64
305     extended_max          = stats->cycles + stats->max_seq;
306     expected              = extended_max - stats->base_seq;
307     lost                  = expected - stats->received;
308     lost                  = FFMIN(lost, 0xffffff); // clamp it since it's only 24 bits...
309     expected_interval     = expected - stats->expected_prior;
310     stats->expected_prior = expected;
311     received_interval     = stats->received - stats->received_prior;
312     stats->received_prior = stats->received;
313     lost_interval         = expected_interval - received_interval;
314     if (expected_interval == 0 || lost_interval <= 0)
315         fraction = 0;
316     else
317         fraction = (lost_interval << 8) / expected_interval;
318
319     fraction = (fraction << 24) | lost;
320
321     avio_wb32(pb, fraction); /* 8 bits of fraction, 24 bits of total packets lost */
322     avio_wb32(pb, extended_max); /* max sequence received */
323     avio_wb32(pb, stats->jitter >> 4); /* jitter */
324
325     if (s->last_rtcp_ntp_time == AV_NOPTS_VALUE) {
326         avio_wb32(pb, 0); /* last SR timestamp */
327         avio_wb32(pb, 0); /* delay since last SR */
328     } else {
329         uint32_t middle_32_bits   = s->last_rtcp_ntp_time >> 16; // this is valid, right? do we need to handle 64 bit values special?
330         uint32_t delay_since_last = av_rescale(av_gettime_relative() - s->last_rtcp_reception_time,
331                                                65536, AV_TIME_BASE);
332
333         avio_wb32(pb, middle_32_bits); /* last SR timestamp */
334         avio_wb32(pb, delay_since_last); /* delay since last SR */
335     }
336
337     // CNAME
338     avio_w8(pb, (RTP_VERSION << 6) + 1); /* 1 report block */
339     avio_w8(pb, RTCP_SDES);
340     len = strlen(s->hostname);
341     avio_wb16(pb, (7 + len + 3) / 4); /* length in words - 1 */
342     avio_wb32(pb, s->ssrc + 1);
343     avio_w8(pb, 0x01);
344     avio_w8(pb, len);
345     avio_write(pb, s->hostname, len);
346     avio_w8(pb, 0); /* END */
347     // padding
348     for (len = (7 + len) % 4; len % 4; len++)
349         avio_w8(pb, 0);
350
351     avio_flush(pb);
352     if (!fd)
353         return 0;
354     len = avio_close_dyn_buf(pb, &buf);
355     if ((len > 0) && buf) {
356         int av_unused result;
357         av_log(s->ic, AV_LOG_TRACE, "sending %d bytes of RR\n", len);
358         result = ffurl_write(fd, buf, len);
359         av_log(s->ic, AV_LOG_TRACE, "result from ffurl_write: %d\n", result);
360         av_free(buf);
361     }
362     return 0;
363 }
364
365 void ff_rtp_send_punch_packets(URLContext *rtp_handle)
366 {
367     AVIOContext *pb;
368     uint8_t *buf;
369     int len;
370
371     /* Send a small RTP packet */
372     if (avio_open_dyn_buf(&pb) < 0)
373         return;
374
375     avio_w8(pb, (RTP_VERSION << 6));
376     avio_w8(pb, 0); /* Payload type */
377     avio_wb16(pb, 0); /* Seq */
378     avio_wb32(pb, 0); /* Timestamp */
379     avio_wb32(pb, 0); /* SSRC */
380
381     avio_flush(pb);
382     len = avio_close_dyn_buf(pb, &buf);
383     if ((len > 0) && buf)
384         ffurl_write(rtp_handle, buf, len);
385     av_free(buf);
386
387     /* Send a minimal RTCP RR */
388     if (avio_open_dyn_buf(&pb) < 0)
389         return;
390
391     avio_w8(pb, (RTP_VERSION << 6));
392     avio_w8(pb, RTCP_RR); /* receiver report */
393     avio_wb16(pb, 1); /* length in words - 1 */
394     avio_wb32(pb, 0); /* our own SSRC */
395
396     avio_flush(pb);
397     len = avio_close_dyn_buf(pb, &buf);
398     if ((len > 0) && buf)
399         ffurl_write(rtp_handle, buf, len);
400     av_free(buf);
401 }
402
403 static int find_missing_packets(RTPDemuxContext *s, uint16_t *first_missing,
404                                 uint16_t *missing_mask)
405 {
406     int i;
407     uint16_t next_seq = s->seq + 1;
408     RTPPacket *pkt = s->queue;
409
410     if (!pkt || pkt->seq == next_seq)
411         return 0;
412
413     *missing_mask = 0;
414     for (i = 1; i <= 16; i++) {
415         uint16_t missing_seq = next_seq + i;
416         while (pkt) {
417             int16_t diff = pkt->seq - missing_seq;
418             if (diff >= 0)
419                 break;
420             pkt = pkt->next;
421         }
422         if (!pkt)
423             break;
424         if (pkt->seq == missing_seq)
425             continue;
426         *missing_mask |= 1 << (i - 1);
427     }
428
429     *first_missing = next_seq;
430     return 1;
431 }
432
433 int ff_rtp_send_rtcp_feedback(RTPDemuxContext *s, URLContext *fd,
434                               AVIOContext *avio)
435 {
436     int len, need_keyframe, missing_packets;
437     AVIOContext *pb;
438     uint8_t *buf;
439     int64_t now;
440     uint16_t first_missing = 0, missing_mask = 0;
441
442     if (!fd && !avio)
443         return -1;
444
445     need_keyframe = s->handler && s->handler->need_keyframe &&
446                     s->handler->need_keyframe(s->dynamic_protocol_context);
447     missing_packets = find_missing_packets(s, &first_missing, &missing_mask);
448
449     if (!need_keyframe && !missing_packets)
450         return 0;
451
452     /* Send new feedback if enough time has elapsed since the last
453      * feedback packet. */
454
455     now = av_gettime_relative();
456     if (s->last_feedback_time &&
457         (now - s->last_feedback_time) < MIN_FEEDBACK_INTERVAL)
458         return 0;
459     s->last_feedback_time = now;
460
461     if (!fd)
462         pb = avio;
463     else if (avio_open_dyn_buf(&pb) < 0)
464         return -1;
465
466     if (need_keyframe) {
467         avio_w8(pb, (RTP_VERSION << 6) | 1); /* PLI */
468         avio_w8(pb, RTCP_PSFB);
469         avio_wb16(pb, 2); /* length in words - 1 */
470         // our own SSRC: we use the server's SSRC + 1 to avoid conflicts
471         avio_wb32(pb, s->ssrc + 1);
472         avio_wb32(pb, s->ssrc); // server SSRC
473     }
474
475     if (missing_packets) {
476         avio_w8(pb, (RTP_VERSION << 6) | 1); /* NACK */
477         avio_w8(pb, RTCP_RTPFB);
478         avio_wb16(pb, 3); /* length in words - 1 */
479         avio_wb32(pb, s->ssrc + 1);
480         avio_wb32(pb, s->ssrc); // server SSRC
481
482         avio_wb16(pb, first_missing);
483         avio_wb16(pb, missing_mask);
484     }
485
486     avio_flush(pb);
487     if (!fd)
488         return 0;
489     len = avio_close_dyn_buf(pb, &buf);
490     if (len > 0 && buf) {
491         ffurl_write(fd, buf, len);
492         av_free(buf);
493     }
494     return 0;
495 }
496
497 /**
498  * open a new RTP parse context for stream 'st'. 'st' can be NULL for
499  * MPEG-2 TS streams.
500  */
501 RTPDemuxContext *ff_rtp_parse_open(AVFormatContext *s1, AVStream *st,
502                                    int payload_type, int queue_size)
503 {
504     RTPDemuxContext *s;
505
506     s = av_mallocz(sizeof(RTPDemuxContext));
507     if (!s)
508         return NULL;
509     s->payload_type        = payload_type;
510     s->last_rtcp_ntp_time  = AV_NOPTS_VALUE;
511     s->first_rtcp_ntp_time = AV_NOPTS_VALUE;
512     s->ic                  = s1;
513     s->st                  = st;
514     s->queue_size          = queue_size;
515
516     av_log(s->ic, AV_LOG_VERBOSE, "setting jitter buffer size to %d\n",
517            s->queue_size);
518
519     rtp_init_statistics(&s->statistics, 0);
520     if (st) {
521         switch (st->codecpar->codec_id) {
522         case AV_CODEC_ID_ADPCM_G722:
523             /* According to RFC 3551, the stream clock rate is 8000
524              * even if the sample rate is 16000. */
525             if (st->codecpar->sample_rate == 8000)
526                 st->codecpar->sample_rate = 16000;
527             break;
528         default:
529             break;
530         }
531     }
532     // needed to send back RTCP RR in RTSP sessions
533     gethostname(s->hostname, sizeof(s->hostname));
534     return s;
535 }
536
537 void ff_rtp_parse_set_dynamic_protocol(RTPDemuxContext *s, PayloadContext *ctx,
538                                        RTPDynamicProtocolHandler *handler)
539 {
540     s->dynamic_protocol_context = ctx;
541     s->handler                  = handler;
542 }
543
544 void ff_rtp_parse_set_crypto(RTPDemuxContext *s, const char *suite,
545                              const char *params)
546 {
547     if (!ff_srtp_set_crypto(&s->srtp, suite, params))
548         s->srtp_enabled = 1;
549 }
550
551 /**
552  * This was the second switch in rtp_parse packet.
553  * Normalizes time, if required, sets stream_index, etc.
554  */
555 static void finalize_packet(RTPDemuxContext *s, AVPacket *pkt, uint32_t timestamp)
556 {
557     if (pkt->pts != AV_NOPTS_VALUE || pkt->dts != AV_NOPTS_VALUE)
558         return; /* Timestamp already set by depacketizer */
559     if (timestamp == RTP_NOTS_VALUE)
560         return;
561
562     if (s->last_rtcp_ntp_time != AV_NOPTS_VALUE && s->ic->nb_streams > 1) {
563         int64_t addend;
564         int delta_timestamp;
565
566         /* compute pts from timestamp with received ntp_time */
567         delta_timestamp = timestamp - s->last_rtcp_timestamp;
568         /* convert to the PTS timebase */
569         addend = av_rescale(s->last_rtcp_ntp_time - s->first_rtcp_ntp_time,
570                             s->st->time_base.den,
571                             (uint64_t) s->st->time_base.num << 32);
572         pkt->pts = s->range_start_offset + s->rtcp_ts_offset + addend +
573                    delta_timestamp;
574         return;
575     }
576
577     if (!s->base_timestamp)
578         s->base_timestamp = timestamp;
579     /* assume that the difference is INT32_MIN < x < INT32_MAX,
580      * but allow the first timestamp to exceed INT32_MAX */
581     if (!s->timestamp)
582         s->unwrapped_timestamp += timestamp;
583     else
584         s->unwrapped_timestamp += (int32_t)(timestamp - s->timestamp);
585     s->timestamp = timestamp;
586     pkt->pts     = s->unwrapped_timestamp + s->range_start_offset -
587                    s->base_timestamp;
588 }
589
590 static int rtp_parse_packet_internal(RTPDemuxContext *s, AVPacket *pkt,
591                                      const uint8_t *buf, int len)
592 {
593     unsigned int ssrc;
594     int payload_type, seq, flags = 0;
595     int ext, csrc;
596     AVStream *st;
597     uint32_t timestamp;
598     int rv = 0;
599
600     csrc         = buf[0] & 0x0f;
601     ext          = buf[0] & 0x10;
602     payload_type = buf[1] & 0x7f;
603     if (buf[1] & 0x80)
604         flags |= RTP_FLAG_MARKER;
605     seq       = AV_RB16(buf + 2);
606     timestamp = AV_RB32(buf + 4);
607     ssrc      = AV_RB32(buf + 8);
608     /* store the ssrc in the RTPDemuxContext */
609     s->ssrc = ssrc;
610
611     /* NOTE: we can handle only one payload type */
612     if (s->payload_type != payload_type)
613         return -1;
614
615     st = s->st;
616     // only do something with this if all the rtp checks pass...
617     if (!rtp_valid_packet_in_sequence(&s->statistics, seq)) {
618         av_log(s->ic, AV_LOG_ERROR,
619                "RTP: PT=%02x: bad cseq %04x expected=%04x\n",
620                payload_type, seq, ((s->seq + 1) & 0xffff));
621         return -1;
622     }
623
624     if (buf[0] & 0x20) {
625         int padding = buf[len - 1];
626         if (len >= 12 + padding)
627             len -= padding;
628     }
629
630     s->seq = seq;
631     len   -= 12;
632     buf   += 12;
633
634     len   -= 4 * csrc;
635     buf   += 4 * csrc;
636     if (len < 0)
637         return AVERROR_INVALIDDATA;
638
639     /* RFC 3550 Section 5.3.1 RTP Header Extension handling */
640     if (ext) {
641         if (len < 4)
642             return -1;
643         /* calculate the header extension length (stored as number
644          * of 32-bit words) */
645         ext = (AV_RB16(buf + 2) + 1) << 2;
646
647         if (len < ext)
648             return -1;
649         // skip past RTP header extension
650         len -= ext;
651         buf += ext;
652     }
653
654     if (s->handler && s->handler->parse_packet) {
655         rv = s->handler->parse_packet(s->ic, s->dynamic_protocol_context,
656                                       s->st, pkt, &timestamp, buf, len, seq,
657                                       flags);
658     } else if (st) {
659         if ((rv = av_new_packet(pkt, len)) < 0)
660             return rv;
661         memcpy(pkt->data, buf, len);
662         pkt->stream_index = st->index;
663     } else {
664         return AVERROR(EINVAL);
665     }
666
667     // now perform timestamp things....
668     finalize_packet(s, pkt, timestamp);
669
670     return rv;
671 }
672
673 void ff_rtp_reset_packet_queue(RTPDemuxContext *s)
674 {
675     while (s->queue) {
676         RTPPacket *next = s->queue->next;
677         av_free(s->queue->buf);
678         av_free(s->queue);
679         s->queue = next;
680     }
681     s->seq       = 0;
682     s->queue_len = 0;
683     s->prev_ret  = 0;
684 }
685
686 static int enqueue_packet(RTPDemuxContext *s, uint8_t *buf, int len)
687 {
688     uint16_t seq   = AV_RB16(buf + 2);
689     RTPPacket **cur = &s->queue, *packet;
690
691     /* Find the correct place in the queue to insert the packet */
692     while (*cur) {
693         int16_t diff = seq - (*cur)->seq;
694         if (diff < 0)
695             break;
696         cur = &(*cur)->next;
697     }
698
699     packet = av_mallocz(sizeof(*packet));
700     if (!packet)
701         return AVERROR(ENOMEM);
702     packet->recvtime = av_gettime_relative();
703     packet->seq      = seq;
704     packet->len      = len;
705     packet->buf      = buf;
706     packet->next     = *cur;
707     *cur = packet;
708     s->queue_len++;
709
710     return 0;
711 }
712
713 static int has_next_packet(RTPDemuxContext *s)
714 {
715     return s->queue && s->queue->seq == (uint16_t) (s->seq + 1);
716 }
717
718 int64_t ff_rtp_queued_packet_time(RTPDemuxContext *s)
719 {
720     return s->queue ? s->queue->recvtime : 0;
721 }
722
723 static int rtp_parse_queued_packet(RTPDemuxContext *s, AVPacket *pkt)
724 {
725     int rv;
726     RTPPacket *next;
727
728     if (s->queue_len <= 0)
729         return -1;
730
731     if (!has_next_packet(s))
732         av_log(s->ic, AV_LOG_WARNING,
733                "RTP: missed %d packets\n", s->queue->seq - s->seq - 1);
734
735     /* Parse the first packet in the queue, and dequeue it */
736     rv   = rtp_parse_packet_internal(s, pkt, s->queue->buf, s->queue->len);
737     next = s->queue->next;
738     av_free(s->queue->buf);
739     av_free(s->queue);
740     s->queue = next;
741     s->queue_len--;
742     return rv;
743 }
744
745 static int rtp_parse_one_packet(RTPDemuxContext *s, AVPacket *pkt,
746                                 uint8_t **bufptr, int len)
747 {
748     uint8_t *buf = bufptr ? *bufptr : NULL;
749     int flags = 0;
750     uint32_t timestamp;
751     int rv = 0;
752
753     if (!buf) {
754         /* If parsing of the previous packet actually returned 0 or an error,
755          * there's nothing more to be parsed from that packet, but we may have
756          * indicated that we can return the next enqueued packet. */
757         if (s->prev_ret <= 0)
758             return rtp_parse_queued_packet(s, pkt);
759         /* return the next packets, if any */
760         if (s->handler && s->handler->parse_packet) {
761             /* timestamp should be overwritten by parse_packet, if not,
762              * the packet is left with pts == AV_NOPTS_VALUE */
763             timestamp = RTP_NOTS_VALUE;
764             rv        = s->handler->parse_packet(s->ic, s->dynamic_protocol_context,
765                                                  s->st, pkt, &timestamp, NULL, 0, 0,
766                                                  flags);
767             finalize_packet(s, pkt, timestamp);
768             return rv;
769         }
770     }
771
772     if (len < 12)
773         return -1;
774
775     if ((buf[0] & 0xc0) != (RTP_VERSION << 6))
776         return -1;
777     if (RTP_PT_IS_RTCP(buf[1])) {
778         return rtcp_parse_packet(s, buf, len);
779     }
780
781     if (s->st) {
782         int64_t received = av_gettime_relative();
783         uint32_t arrival_ts = av_rescale_q(received, AV_TIME_BASE_Q,
784                                            s->st->time_base);
785         timestamp = AV_RB32(buf + 4);
786         // Calculate the jitter immediately, before queueing the packet
787         // into the reordering queue.
788         rtcp_update_jitter(&s->statistics, timestamp, arrival_ts);
789     }
790
791     if ((s->seq == 0 && !s->queue) || s->queue_size <= 1) {
792         /* First packet, or no reordering */
793         return rtp_parse_packet_internal(s, pkt, buf, len);
794     } else {
795         uint16_t seq = AV_RB16(buf + 2);
796         int16_t diff = seq - s->seq;
797         if (diff < 0) {
798             /* Packet older than the previously emitted one, drop */
799             av_log(s->ic, AV_LOG_WARNING,
800                    "RTP: dropping old packet received too late\n");
801             return -1;
802         } else if (diff <= 1) {
803             /* Correct packet */
804             rv = rtp_parse_packet_internal(s, pkt, buf, len);
805             return rv;
806         } else {
807             /* Still missing some packet, enqueue this one. */
808             rv = enqueue_packet(s, buf, len);
809             if (rv < 0)
810                 return rv;
811             *bufptr = NULL;
812             /* Return the first enqueued packet if the queue is full,
813              * even if we're missing something */
814             if (s->queue_len >= s->queue_size) {
815                 av_log(s->ic, AV_LOG_WARNING, "jitter buffer full\n");
816                 return rtp_parse_queued_packet(s, pkt);
817             }
818             return -1;
819         }
820     }
821 }
822
823 /**
824  * Parse an RTP or RTCP packet directly sent as a buffer.
825  * @param s RTP parse context.
826  * @param pkt returned packet
827  * @param bufptr pointer to the input buffer or NULL to read the next packets
828  * @param len buffer len
829  * @return 0 if a packet is returned, 1 if a packet is returned and more can follow
830  * (use buf as NULL to read the next). -1 if no packet (error or no more packet).
831  */
832 int ff_rtp_parse_packet(RTPDemuxContext *s, AVPacket *pkt,
833                         uint8_t **bufptr, int len)
834 {
835     int rv;
836     if (s->srtp_enabled && bufptr && ff_srtp_decrypt(&s->srtp, *bufptr, &len) < 0)
837         return -1;
838     rv = rtp_parse_one_packet(s, pkt, bufptr, len);
839     s->prev_ret = rv;
840     while (rv == AVERROR(EAGAIN) && has_next_packet(s))
841         rv = rtp_parse_queued_packet(s, pkt);
842     return rv ? rv : has_next_packet(s);
843 }
844
845 void ff_rtp_parse_close(RTPDemuxContext *s)
846 {
847     ff_rtp_reset_packet_queue(s);
848     ff_srtp_free(&s->srtp);
849     av_free(s);
850 }
851
852 int ff_parse_fmtp(AVFormatContext *s,
853                   AVStream *stream, PayloadContext *data, const char *p,
854                   int (*parse_fmtp)(AVFormatContext *s,
855                                     AVStream *stream,
856                                     PayloadContext *data,
857                                     const char *attr, const char *value))
858 {
859     char attr[256];
860     char *value;
861     int res;
862     int value_size = strlen(p) + 1;
863
864     if (!(value = av_malloc(value_size))) {
865         av_log(s, AV_LOG_ERROR, "Failed to allocate data for FMTP.");
866         return AVERROR(ENOMEM);
867     }
868
869     // remove protocol identifier
870     while (*p && *p == ' ')
871         p++;                     // strip spaces
872     while (*p && *p != ' ')
873         p++;                     // eat protocol identifier
874     while (*p && *p == ' ')
875         p++;                     // strip trailing spaces
876
877     while (ff_rtsp_next_attr_and_value(&p,
878                                        attr, sizeof(attr),
879                                        value, value_size)) {
880         res = parse_fmtp(s, stream, data, attr, value);
881         if (res < 0 && res != AVERROR_PATCHWELCOME) {
882             av_free(value);
883             return res;
884         }
885     }
886     av_free(value);
887     return 0;
888 }
889
890 int ff_rtp_finalize_packet(AVPacket *pkt, AVIOContext **dyn_buf, int stream_idx)
891 {
892     int ret;
893     av_init_packet(pkt);
894
895     pkt->size         = avio_close_dyn_buf(*dyn_buf, &pkt->data);
896     pkt->stream_index = stream_idx;
897     *dyn_buf = NULL;
898     if ((ret = av_packet_from_data(pkt, pkt->data, pkt->size)) < 0) {
899         av_freep(&pkt->data);
900         return ret;
901     }
902     return pkt->size;
903 }