libavformat/rtpproto.c

   1 /*
   2  * RTP network protocol
   3  * Copyright (c) 2002 Fabrice Bellard
   4  *
   5  * This file is part of FFmpeg.
   6  *
   7  * FFmpeg 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  * FFmpeg 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 FFmpeg; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 /**
  23  * @file
  24  * RTP protocol
  25  */
  26
  27 #include "libavutil/parseutils.h"
  28 #include "libavutil/avstring.h"
  29 #include "libavutil/opt.h"
  30 #include "avformat.h"
  31 #include "rtp.h"
  32 #include "rtpproto.h"
  33 #include "url.h"
  34 #include "ip.h"
  35
  36 #include <stdarg.h>
  37 #include "internal.h"
  38 #include "network.h"
  39 #include "os_support.h"
  40 #include <fcntl.h>
  41 #if HAVE_POLL_H
  42 #include <poll.h>
  43 #endif
  44
  45 typedef struct RTPContext {
  46     const AVClass *class;
  47     URLContext *rtp_hd, *rtcp_hd, *fec_hd;
  48     int rtp_fd, rtcp_fd;
  49     IPSourceFilters filters;
  50     int write_to_source;
  51     struct sockaddr_storage last_rtp_source, last_rtcp_source;
  52     socklen_t last_rtp_source_len, last_rtcp_source_len;
  53     int ttl;
  54     int buffer_size;
  55     int rtcp_port, local_rtpport, local_rtcpport;
  56     int connect;
  57     int pkt_size;
  58     int dscp;
  59     char *sources;
  60     char *block;
  61     char *fec_options_str;
  62     int64_t rw_timeout;
  63     char *localaddr;
  64 } RTPContext;
  65
  66 #define OFFSET(x) offsetof(RTPContext, x)
  67 #define D AV_OPT_FLAG_DECODING_PARAM
  68 #define E AV_OPT_FLAG_ENCODING_PARAM
  69 static const AVOption options[] = {
  70     { "ttl",                "Time to live (multicast only)",                                    OFFSET(ttl),             AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, 255,     .flags = D|E },
  71     { "buffer_size",        "Send/Receive buffer size (in bytes)",                              OFFSET(buffer_size),     AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  72     { "rtcp_port",          "Custom rtcp port",                                                 OFFSET(rtcp_port),       AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  73     { "local_rtpport",      "Local rtp port",                                                   OFFSET(local_rtpport),   AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  74     { "local_rtcpport",     "Local rtcp port",                                                  OFFSET(local_rtcpport),  AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  75     { "connect",            "Connect socket",                                                   OFFSET(connect),         AV_OPT_TYPE_BOOL,   { .i64 =  0 },     0, 1,       .flags = D|E },
  76     { "write_to_source",    "Send packets to the source address of the latest received packet", OFFSET(write_to_source), AV_OPT_TYPE_BOOL,   { .i64 =  0 },     0, 1,       .flags = D|E },
  77     { "pkt_size",           "Maximum packet size",                                              OFFSET(pkt_size),        AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  78     { "dscp",               "DSCP class",                                                       OFFSET(dscp),            AV_OPT_TYPE_INT,    { .i64 = -1 },    -1, INT_MAX, .flags = D|E },
  79     { "timeout",            "set timeout (in microseconds) of socket I/O operations",           OFFSET(rw_timeout),      AV_OPT_TYPE_INT64,  { .i64 = -1 },    -1, INT64_MAX, .flags = D|E },
  80     { "sources",            "Source list",                                                      OFFSET(sources),         AV_OPT_TYPE_STRING, { .str = NULL },               .flags = D|E },
  81     { "block",              "Block list",                                                       OFFSET(block),           AV_OPT_TYPE_STRING, { .str = NULL },               .flags = D|E },
  82     { "fec",                "FEC",                                                              OFFSET(fec_options_str), AV_OPT_TYPE_STRING, { .str = NULL },               .flags = E },
  83     { "localaddr",          "Local address",                                                    OFFSET(localaddr),       AV_OPT_TYPE_STRING, { .str = NULL },               .flags = D|E },
  84     { NULL }
  85 };
  86
  87 static const AVClass rtp_class = {
  88     .class_name = "rtp",
  89     .item_name  = av_default_item_name,
  90     .option     = options,
  91     .version    = LIBAVUTIL_VERSION_INT,
  92 };
  93
  94 /**
  95  * If no filename is given to av_open_input_file because you want to
  96  * get the local port first, then you must call this function to set
  97  * the remote server address.
  98  *
  99  * @param h media file context
 100  * @param uri of the remote server
 101  * @return zero if no error.
 102  */
 103
 104 int ff_rtp_set_remote_url(URLContext *h, const char *uri)
 105 {
 106     RTPContext *s = h->priv_data;
 107     char hostname[256];
 108     int port, rtcp_port;
 109     const char *p;
 110
 111     char buf[1024];
 112     char path[1024];
 113
 114     av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &port,
 115                  path, sizeof(path), uri);
 116     rtcp_port = port + 1;
 117
 118     p = strchr(uri, '?');
 119     if (p) {
 120         if (av_find_info_tag(buf, sizeof(buf), "rtcpport", p)) {
 121             rtcp_port = strtol(buf, NULL, 10);
 122         }
 123     }
 124
 125     ff_url_join(buf, sizeof(buf), "udp", NULL, hostname, port, "%s", path);
 126     ff_udp_set_remote_url(s->rtp_hd, buf);
 127
 128     ff_url_join(buf, sizeof(buf), "udp", NULL, hostname, rtcp_port, "%s", path);
 129     ff_udp_set_remote_url(s->rtcp_hd, buf);
 130     return 0;
 131 }
 132
 133 static int get_port(const struct sockaddr_storage *ss)
 134 {
 135     if (ss->ss_family == AF_INET)
 136         return ntohs(((const struct sockaddr_in *)ss)->sin_port);
 137 #if HAVE_STRUCT_SOCKADDR_IN6
 138     if (ss->ss_family == AF_INET6)
 139         return ntohs(((const struct sockaddr_in6 *)ss)->sin6_port);
 140 #endif
 141     return 0;
 142 }
 143
 144 static void set_port(struct sockaddr_storage *ss, int port)
 145 {
 146     if (ss->ss_family == AF_INET)
 147         ((struct sockaddr_in *)ss)->sin_port = htons(port);
 148 #if HAVE_STRUCT_SOCKADDR_IN6
 149     else if (ss->ss_family == AF_INET6)
 150         ((struct sockaddr_in6 *)ss)->sin6_port = htons(port);
 151 #endif
 152 }
 153
 154 /**
 155  * add option to url of the form:
 156  * "http://host:port/path?option1=val1&option2=val2...
 157  */
 158
 159 static av_printf_format(3, 4) void url_add_option(char *buf, int buf_size, const char *fmt, ...)
 160 {
 161     char buf1[1024];
 162     va_list ap;
 163
 164     va_start(ap, fmt);
 165     if (strchr(buf, '?'))
 166         av_strlcat(buf, "&", buf_size);
 167     else
 168         av_strlcat(buf, "?", buf_size);
 169     vsnprintf(buf1, sizeof(buf1), fmt, ap);
 170     av_strlcat(buf, buf1, buf_size);
 171     va_end(ap);
 172 }
 173
 174 static void build_udp_url(RTPContext *s,
 175                           char *buf, int buf_size,
 176                           const char *hostname,
 177                           const char *localaddr,
 178                           int port, int local_port,
 179                           const char *include_sources,
 180                           const char *exclude_sources)
 181 {
 182     ff_url_join(buf, buf_size, "udp", NULL, hostname, port, NULL);
 183     if (local_port >= 0)
 184         url_add_option(buf, buf_size, "localport=%d", local_port);
 185     if (s->ttl >= 0)
 186         url_add_option(buf, buf_size, "ttl=%d", s->ttl);
 187     if (s->buffer_size >= 0)
 188         url_add_option(buf, buf_size, "buffer_size=%d", s->buffer_size);
 189     if (s->pkt_size >= 0)
 190         url_add_option(buf, buf_size, "pkt_size=%d", s->pkt_size);
 191     if (s->connect)
 192         url_add_option(buf, buf_size, "connect=1");
 193     if (s->dscp >= 0)
 194         url_add_option(buf, buf_size, "dscp=%d", s->dscp);
 195     url_add_option(buf, buf_size, "fifo_size=0");
 196     if (include_sources && include_sources[0])
 197         url_add_option(buf, buf_size, "sources=%s", include_sources);
 198     if (exclude_sources && exclude_sources[0])
 199         url_add_option(buf, buf_size, "block=%s", exclude_sources);
 200     if (localaddr && localaddr[0])
 201         url_add_option(buf, buf_size, "localaddr=%s", localaddr);
 202 }
 203
 204 /**
 205  * url syntax: rtp://host:port[?option=val...]
 206  * option: 'ttl=n'            : set the ttl value (for multicast only)
 207  *         'rtcpport=n'       : set the remote rtcp port to n
 208  *         'localrtpport=n'   : set the local rtp port to n
 209  *         'localrtcpport=n'  : set the local rtcp port to n
 210  *         'pkt_size=n'       : set max packet size
 211  *         'connect=0/1'      : do a connect() on the UDP socket
 212  *         'sources=ip[,ip]'  : list allowed source IP addresses
 213  *         'block=ip[,ip]'    : list disallowed source IP addresses
 214  *         'write_to_source=0/1' : send packets to the source address of the latest received packet
 215  *         'dscp=n'           : set DSCP value to n (QoS)
 216  * deprecated option:
 217  *         'localport=n'      : set the local port to n
 218  *
 219  * if rtcpport isn't set the rtcp port will be the rtp port + 1
 220  * if local rtp port isn't set any available port will be used for the local
 221  * rtp and rtcp ports
 222  * if the local rtcp port is not set it will be the local rtp port + 1
 223  */
 224
 225 static int rtp_open(URLContext *h, const char *uri, int flags)
 226 {
 227     RTPContext *s = h->priv_data;
 228     AVDictionary *fec_opts = NULL;
 229     int rtp_port;
 230     char hostname[256], include_sources[1024] = "", exclude_sources[1024] = "";
 231     char *sources = include_sources, *block = exclude_sources;
 232     char *fec_protocol = NULL;
 233     char buf[1024];
 234     char path[1024];
 235     const char *p;
 236     int i, max_retry_count = 3;
 237     int rtcpflags;
 238
 239     av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &rtp_port,
 240                  path, sizeof(path), uri);
 241     /* extract parameters */
 242     if (s->rtcp_port < 0)
 243         s->rtcp_port = rtp_port + 1;
 244
 245     p = strchr(uri, '?');
 246     if (p) {
 247         if (av_find_info_tag(buf, sizeof(buf), "ttl", p)) {
 248             s->ttl = strtol(buf, NULL, 10);
 249         }
 250         if (av_find_info_tag(buf, sizeof(buf), "rtcpport", p)) {
 251             s->rtcp_port = strtol(buf, NULL, 10);
 252         }
 253         if (av_find_info_tag(buf, sizeof(buf), "localport", p)) {
 254             s->local_rtpport = strtol(buf, NULL, 10);
 255         }
 256         if (av_find_info_tag(buf, sizeof(buf), "localrtpport", p)) {
 257             s->local_rtpport = strtol(buf, NULL, 10);
 258         }
 259         if (av_find_info_tag(buf, sizeof(buf), "localrtcpport", p)) {
 260             s->local_rtcpport = strtol(buf, NULL, 10);
 261         }
 262         if (av_find_info_tag(buf, sizeof(buf), "pkt_size", p)) {
 263             s->pkt_size = strtol(buf, NULL, 10);
 264         }
 265         if (av_find_info_tag(buf, sizeof(buf), "connect", p)) {
 266             s->connect = strtol(buf, NULL, 10);
 267         }
 268         if (av_find_info_tag(buf, sizeof(buf), "write_to_source", p)) {
 269             s->write_to_source = strtol(buf, NULL, 10);
 270         }
 271         if (av_find_info_tag(buf, sizeof(buf), "dscp", p)) {
 272             s->dscp = strtol(buf, NULL, 10);
 273         }
 274         if (av_find_info_tag(buf, sizeof(buf), "timeout", p)) {
 275             s->rw_timeout = strtol(buf, NULL, 10);
 276         }
 277         if (av_find_info_tag(buf, sizeof(buf), "sources", p)) {
 278             av_strlcpy(include_sources, buf, sizeof(include_sources));
 279             ff_ip_parse_sources(h, buf, &s->filters);
 280         } else {
 281             ff_ip_parse_sources(h, s->sources, &s->filters);
 282             sources = s->sources;
 283         }
 284         if (av_find_info_tag(buf, sizeof(buf), "block", p)) {
 285             av_strlcpy(exclude_sources, buf, sizeof(exclude_sources));
 286             ff_ip_parse_blocks(h, buf, &s->filters);
 287         } else {
 288             ff_ip_parse_blocks(h, s->block, &s->filters);
 289             block = s->block;
 290         }
 291         if (av_find_info_tag(buf, sizeof(buf), "localaddr", p)) {
 292             av_freep(&s->localaddr);
 293             s->localaddr = av_strdup(buf);
 294             if (!s->localaddr)
 295                 goto fail;
 296         }
 297     }
 298     if (s->rw_timeout >= 0)
 299         h->rw_timeout = s->rw_timeout;
 300
 301     if (s->fec_options_str) {
 302         p = s->fec_options_str;
 303
 304         if (!(fec_protocol = av_get_token(&p, "="))) {
 305             av_log(h, AV_LOG_ERROR, "Failed to parse the FEC protocol value\n");
 306             goto fail;
 307         }
 308         if (strcmp(fec_protocol, "prompeg")) {
 309             av_log(h, AV_LOG_ERROR, "Unsupported FEC protocol %s\n", fec_protocol);
 310             goto fail;
 311         }
 312
 313         p = s->fec_options_str + strlen(fec_protocol);
 314         while (*p && *p == '=') p++;
 315
 316         if (av_dict_parse_string(&fec_opts, p, "=", ":", 0) < 0) {
 317             av_log(h, AV_LOG_ERROR, "Failed to parse the FEC options\n");
 318             goto fail;
 319         }
 320         if (s->ttl > 0) {
 321             av_dict_set_int(&fec_opts, "ttl", s->ttl, 0);
 322         }
 323     }
 324
 325     for (i = 0; i < max_retry_count; i++) {
 326         build_udp_url(s, buf, sizeof(buf),
 327                       hostname, s->localaddr, rtp_port, s->local_rtpport,
 328                       sources, block);
 329         if (ffurl_open_whitelist(&s->rtp_hd, buf, flags, &h->interrupt_callback,
 330                                  NULL, h->protocol_whitelist, h->protocol_blacklist, h) < 0)
 331             goto fail;
 332         s->local_rtpport = ff_udp_get_local_port(s->rtp_hd);
 333         if(s->local_rtpport == 65535) {
 334             s->local_rtpport = -1;
 335             continue;
 336         }
 337         rtcpflags = flags | AVIO_FLAG_WRITE;
 338         if (s->local_rtcpport < 0) {
 339             s->local_rtcpport = s->local_rtpport + 1;
 340             build_udp_url(s, buf, sizeof(buf),
 341                           hostname, s->localaddr, s->rtcp_port, s->local_rtcpport,
 342                           sources, block);
 343             if (ffurl_open_whitelist(&s->rtcp_hd, buf, rtcpflags,
 344                                      &h->interrupt_callback, NULL,
 345                                      h->protocol_whitelist, h->protocol_blacklist, h) < 0) {
 346                 s->local_rtpport = s->local_rtcpport = -1;
 347                 continue;
 348             }
 349             break;
 350         }
 351         build_udp_url(s, buf, sizeof(buf),
 352                       hostname, s->localaddr, s->rtcp_port, s->local_rtcpport,
 353                       sources, block);
 354         if (ffurl_open_whitelist(&s->rtcp_hd, buf, rtcpflags, &h->interrupt_callback,
 355                                  NULL, h->protocol_whitelist, h->protocol_blacklist, h) < 0)
 356             goto fail;
 357         break;
 358     }
 359
 360     s->fec_hd = NULL;
 361     if (fec_protocol) {
 362         ff_url_join(buf, sizeof(buf), fec_protocol, NULL, hostname, rtp_port, NULL);
 363         if (ffurl_open_whitelist(&s->fec_hd, buf, flags, &h->interrupt_callback,
 364                              &fec_opts, h->protocol_whitelist, h->protocol_blacklist, h) < 0)
 365             goto fail;
 366     }
 367
 368     /* just to ease handle access. XXX: need to suppress direct handle
 369        access */
 370     s->rtp_fd = ffurl_get_file_handle(s->rtp_hd);
 371     s->rtcp_fd = ffurl_get_file_handle(s->rtcp_hd);
 372
 373     h->max_packet_size = s->rtp_hd->max_packet_size;
 374     h->is_streamed = 1;
 375
 376     av_free(fec_protocol);
 377     av_dict_free(&fec_opts);
 378
 379     return 0;
 380
 381  fail:
 382     ffurl_closep(&s->rtp_hd);
 383     ffurl_closep(&s->rtcp_hd);
 384     ffurl_closep(&s->fec_hd);
 385     av_free(fec_protocol);
 386     av_dict_free(&fec_opts);
 387     return AVERROR(EIO);
 388 }
 389
 390 static int rtp_read(URLContext *h, uint8_t *buf, int size)
 391 {
 392     RTPContext *s = h->priv_data;
 393     int len, n, i;
 394     struct pollfd p[2] = {{s->rtp_fd, POLLIN, 0}, {s->rtcp_fd, POLLIN, 0}};
 395     int poll_delay = h->flags & AVIO_FLAG_NONBLOCK ? 0 : POLLING_TIME;
 396     struct sockaddr_storage *addrs[2] = { &s->last_rtp_source, &s->last_rtcp_source };
 397     socklen_t *addr_lens[2] = { &s->last_rtp_source_len, &s->last_rtcp_source_len };
 398     int runs = h->rw_timeout / 1000 / POLLING_TIME;
 399
 400     for(;;) {
 401         if (ff_check_interrupt(&h->interrupt_callback))
 402             return AVERROR_EXIT;
 403         n = poll(p, 2, poll_delay);
 404         if (n > 0) {
 405             /* first try RTCP, then RTP */
 406             for (i = 1; i >= 0; i--) {
 407                 if (!(p[i].revents & POLLIN))
 408                     continue;
 409                 *addr_lens[i] = sizeof(*addrs[i]);
 410                 len = recvfrom(p[i].fd, buf, size, 0,
 411                                 (struct sockaddr *)addrs[i], addr_lens[i]);
 412                 if (len < 0) {
 413                     if (ff_neterrno() == AVERROR(EAGAIN) ||
 414                         ff_neterrno() == AVERROR(EINTR))
 415                         continue;
 416                     return AVERROR(EIO);
 417                 }
 418                 if (ff_ip_check_source_lists(addrs[i], &s->filters))
 419                     continue;
 420                 return len;
 421             }
 422         } else if (n == 0 && h->rw_timeout > 0 && --runs <= 0) {
 423             return AVERROR(ETIMEDOUT);
 424         } else if (n < 0) {
 425             if (ff_neterrno() == AVERROR(EINTR))
 426                 continue;
 427             return AVERROR(EIO);
 428         }
 429         if (h->flags & AVIO_FLAG_NONBLOCK)
 430             return AVERROR(EAGAIN);
 431     }
 432 }
 433
 434 static int rtp_write(URLContext *h, const uint8_t *buf, int size)
 435 {
 436     RTPContext *s = h->priv_data;
 437     int ret, ret_fec;
 438     URLContext *hd;
 439
 440     if (size < 2)
 441         return AVERROR(EINVAL);
 442
 443     if ((buf[0] & 0xc0) != (RTP_VERSION << 6))
 444         av_log(h, AV_LOG_WARNING, "Data doesn't look like RTP packets, "
 445                                   "make sure the RTP muxer is used\n");
 446
 447     if (s->write_to_source) {
 448         int fd;
 449         struct sockaddr_storage *source, temp_source;
 450         socklen_t *source_len, temp_len;
 451         if (!s->last_rtp_source.ss_family && !s->last_rtcp_source.ss_family) {
 452             av_log(h, AV_LOG_ERROR,
 453                    "Unable to send packet to source, no packets received yet\n");
 454             // Intentionally not returning an error here
 455             return size;
 456         }
 457
 458         if (RTP_PT_IS_RTCP(buf[1])) {
 459             fd = s->rtcp_fd;
 460             source     = &s->last_rtcp_source;
 461             source_len = &s->last_rtcp_source_len;
 462         } else {
 463             fd = s->rtp_fd;
 464             source     = &s->last_rtp_source;
 465             source_len = &s->last_rtp_source_len;
 466         }
 467         if (!source->ss_family) {
 468             source      = &temp_source;
 469             source_len  = &temp_len;
 470             if (RTP_PT_IS_RTCP(buf[1])) {
 471                 temp_source = s->last_rtp_source;
 472                 temp_len    = s->last_rtp_source_len;
 473                 set_port(source, get_port(source) + 1);
 474                 av_log(h, AV_LOG_INFO,
 475                        "Not received any RTCP packets yet, inferring peer port "
 476                        "from the RTP port\n");
 477             } else {
 478                 temp_source = s->last_rtcp_source;
 479                 temp_len    = s->last_rtcp_source_len;
 480                 set_port(source, get_port(source) - 1);
 481                 av_log(h, AV_LOG_INFO,
 482                        "Not received any RTP packets yet, inferring peer port "
 483                        "from the RTCP port\n");
 484             }
 485         }
 486
 487         if (!(h->flags & AVIO_FLAG_NONBLOCK)) {
 488             ret = ff_network_wait_fd(fd, 1);
 489             if (ret < 0)
 490                 return ret;
 491         }
 492         ret = sendto(fd, buf, size, 0, (struct sockaddr *) source,
 493                      *source_len);
 494
 495         return ret < 0 ? ff_neterrno() : ret;
 496     }
 497
 498     if (RTP_PT_IS_RTCP(buf[1])) {
 499         /* RTCP payload type */
 500         hd = s->rtcp_hd;
 501     } else {
 502         /* RTP payload type */
 503         hd = s->rtp_hd;
 504     }
 505
 506     if ((ret = ffurl_write(hd, buf, size)) < 0) {
 507         return ret;
 508     }
 509
 510     if (s->fec_hd && !RTP_PT_IS_RTCP(buf[1])) {
 511         if ((ret_fec = ffurl_write(s->fec_hd, buf, size)) < 0) {
 512             av_log(h, AV_LOG_ERROR, "Failed to send FEC\n");
 513             return ret_fec;
 514         }
 515     }
 516
 517     return ret;
 518 }
 519
 520 static int rtp_close(URLContext *h)
 521 {
 522     RTPContext *s = h->priv_data;
 523
 524     ff_ip_reset_filters(&s->filters);
 525
 526     ffurl_closep(&s->rtp_hd);
 527     ffurl_closep(&s->rtcp_hd);
 528     ffurl_closep(&s->fec_hd);
 529     return 0;
 530 }
 531
 532 /**
 533  * Return the local rtp port used by the RTP connection
 534  * @param h media file context
 535  * @return the local port number
 536  */
 537
 538 int ff_rtp_get_local_rtp_port(URLContext *h)
 539 {
 540     RTPContext *s = h->priv_data;
 541     return ff_udp_get_local_port(s->rtp_hd);
 542 }
 543
 544 /**
 545  * Return the local rtcp port used by the RTP connection
 546  * @param h media file context
 547  * @return the local port number
 548  */
 549
 550 static int rtp_get_file_handle(URLContext *h)
 551 {
 552     RTPContext *s = h->priv_data;
 553     return s->rtp_fd;
 554 }
 555
 556 static int rtp_get_multi_file_handle(URLContext *h, int **handles,
 557                                      int *numhandles)
 558 {
 559     RTPContext *s = h->priv_data;
 560     int *hs       = *handles = av_malloc(sizeof(**handles) * 2);
 561     if (!hs)
 562         return AVERROR(ENOMEM);
 563     hs[0] = s->rtp_fd;
 564     hs[1] = s->rtcp_fd;
 565     *numhandles = 2;
 566     return 0;
 567 }
 568
 569 const URLProtocol ff_rtp_protocol = {
 570     .name                      = "rtp",
 571     .url_open                  = rtp_open,
 572     .url_read                  = rtp_read,
 573     .url_write                 = rtp_write,
 574     .url_close                 = rtp_close,
 575     .url_get_file_handle       = rtp_get_file_handle,
 576     .url_get_multi_file_handle = rtp_get_multi_file_handle,
 577     .priv_data_size            = sizeof(RTPContext),
 578     .flags                     = URL_PROTOCOL_FLAG_NETWORK,
 579     .priv_data_class           = &rtp_class,
 580 };