2 * UDP prototype streaming system
3 * Copyright (c) 2000, 2001, 2002 Fabrice Bellard
5 * This file is part of Libav.
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.
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.
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
27 #define _BSD_SOURCE /* Needed for using struct ip_mreq with recent glibc */
30 #include "avio_internal.h"
31 #include "libavutil/parseutils.h"
32 #include "libavutil/avstring.h"
33 #include "libavutil/opt.h"
36 #include "os_support.h"
39 #ifndef IPV6_ADD_MEMBERSHIP
40 #define IPV6_ADD_MEMBERSHIP IPV6_JOIN_GROUP
41 #define IPV6_DROP_MEMBERSHIP IPV6_LEAVE_GROUP
44 typedef struct UDPContext {
53 struct sockaddr_storage dest_addr;
61 #define UDP_TX_BUF_SIZE 32768
62 #define UDP_MAX_PKT_SIZE 65536
64 #define OFFSET(x) offsetof(UDPContext, x)
65 #define D AV_OPT_FLAG_DECODING_PARAM
66 #define E AV_OPT_FLAG_ENCODING_PARAM
67 static const AVOption options[] = {
68 { "ttl", "Time to live (in milliseconds, multicast only)", OFFSET(ttl), AV_OPT_TYPE_INT, { .i64 = 16 }, 0, INT_MAX, .flags = D|E },
69 { "buffer_size", "System data size (in bytes)", OFFSET(buffer_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, .flags = D|E },
70 { "local_port", "Local port", OFFSET(local_port), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, .flags = D|E },
71 { "reuse_socket", "Reuse socket", OFFSET(reuse_socket), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, .flags = D|E },
72 { "connect", "Connect socket", OFFSET(is_connected), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, .flags = D|E },
73 { "pkt_size", "Maximum packet size", OFFSET(pkt_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, .flags = D|E },
74 { "localaddr", "Local address", OFFSET(localaddr), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
75 { "sources", "Source list", OFFSET(sources), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
76 { "block", "Block list", OFFSET(block), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
80 static const AVClass udp_class = {
82 .item_name = av_default_item_name,
84 .version = LIBAVUTIL_VERSION_INT,
87 static void log_net_error(void *ctx, int level, const char* prefix)
90 av_strerror(ff_neterrno(), errbuf, sizeof(errbuf));
91 av_log(ctx, level, "%s: %s\n", prefix, errbuf);
94 static int udp_set_multicast_ttl(int sockfd, int mcastTTL,
95 struct sockaddr *addr)
97 #ifdef IP_MULTICAST_TTL
98 if (addr->sa_family == AF_INET) {
99 if (setsockopt(sockfd, IPPROTO_IP, IP_MULTICAST_TTL, &mcastTTL, sizeof(mcastTTL)) < 0) {
100 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_MULTICAST_TTL)");
105 #if defined(IPPROTO_IPV6) && defined(IPV6_MULTICAST_HOPS)
106 if (addr->sa_family == AF_INET6) {
107 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_MULTICAST_HOPS, &mcastTTL, sizeof(mcastTTL)) < 0) {
108 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_MULTICAST_HOPS)");
116 static int udp_join_multicast_group(int sockfd, struct sockaddr *addr)
118 #ifdef IP_ADD_MEMBERSHIP
119 if (addr->sa_family == AF_INET) {
122 mreq.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
123 mreq.imr_interface.s_addr= INADDR_ANY;
124 if (setsockopt(sockfd, IPPROTO_IP, IP_ADD_MEMBERSHIP, (const void *)&mreq, sizeof(mreq)) < 0) {
125 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_ADD_MEMBERSHIP)");
130 #if HAVE_STRUCT_IPV6_MREQ && defined(IPPROTO_IPV6)
131 if (addr->sa_family == AF_INET6) {
132 struct ipv6_mreq mreq6;
134 memcpy(&mreq6.ipv6mr_multiaddr, &(((struct sockaddr_in6 *)addr)->sin6_addr), sizeof(struct in6_addr));
135 mreq6.ipv6mr_interface= 0;
136 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_ADD_MEMBERSHIP, &mreq6, sizeof(mreq6)) < 0) {
137 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_ADD_MEMBERSHIP)");
145 static int udp_leave_multicast_group(int sockfd, struct sockaddr *addr)
147 #ifdef IP_DROP_MEMBERSHIP
148 if (addr->sa_family == AF_INET) {
151 mreq.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
152 mreq.imr_interface.s_addr= INADDR_ANY;
153 if (setsockopt(sockfd, IPPROTO_IP, IP_DROP_MEMBERSHIP, (const void *)&mreq, sizeof(mreq)) < 0) {
154 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_DROP_MEMBERSHIP)");
159 #if HAVE_STRUCT_IPV6_MREQ && defined(IPPROTO_IPV6)
160 if (addr->sa_family == AF_INET6) {
161 struct ipv6_mreq mreq6;
163 memcpy(&mreq6.ipv6mr_multiaddr, &(((struct sockaddr_in6 *)addr)->sin6_addr), sizeof(struct in6_addr));
164 mreq6.ipv6mr_interface= 0;
165 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_DROP_MEMBERSHIP, &mreq6, sizeof(mreq6)) < 0) {
166 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_DROP_MEMBERSHIP)");
174 static struct addrinfo *udp_resolve_host(URLContext *h,
175 const char *hostname, int port,
176 int type, int family, int flags)
178 struct addrinfo hints = { 0 }, *res = 0;
181 const char *node = 0, *service = "0";
184 snprintf(sport, sizeof(sport), "%d", port);
187 if ((hostname) && (hostname[0] != '\0') && (hostname[0] != '?')) {
190 hints.ai_socktype = type;
191 hints.ai_family = family;
192 hints.ai_flags = flags;
193 if ((error = getaddrinfo(node, service, &hints, &res))) {
195 av_log(h, AV_LOG_ERROR, "getaddrinfo(%s, %s): %s\n",
196 node ? node : "unknown",
197 service ? service : "unknown",
198 gai_strerror(error));
204 static int udp_set_multicast_sources(URLContext *h,
205 int sockfd, struct sockaddr *addr,
206 int addr_len, char **sources,
207 int nb_sources, int include)
209 #if HAVE_STRUCT_GROUP_SOURCE_REQ && defined(MCAST_BLOCK_SOURCE) && !defined(_WIN32)
210 /* These ones are available in the microsoft SDK, but don't seem to work
211 * as on linux, so just prefer the v4-only approach there for now. */
213 for (i = 0; i < nb_sources; i++) {
214 struct group_source_req mreqs;
215 int level = addr->sa_family == AF_INET ? IPPROTO_IP : IPPROTO_IPV6;
216 struct addrinfo *sourceaddr = udp_resolve_host(h, sources[i], 0,
217 SOCK_DGRAM, AF_UNSPEC,
220 return AVERROR(ENOENT);
222 mreqs.gsr_interface = 0;
223 memcpy(&mreqs.gsr_group, addr, addr_len);
224 memcpy(&mreqs.gsr_source, sourceaddr->ai_addr, sourceaddr->ai_addrlen);
225 freeaddrinfo(sourceaddr);
227 if (setsockopt(sockfd, level,
228 include ? MCAST_JOIN_SOURCE_GROUP : MCAST_BLOCK_SOURCE,
229 (const void *)&mreqs, sizeof(mreqs)) < 0) {
231 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(MCAST_JOIN_SOURCE_GROUP)");
233 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(MCAST_BLOCK_SOURCE)");
234 return ff_neterrno();
237 #elif HAVE_STRUCT_IP_MREQ_SOURCE && defined(IP_BLOCK_SOURCE)
239 if (addr->sa_family != AF_INET) {
240 av_log(NULL, AV_LOG_ERROR,
241 "Setting multicast sources only supported for IPv4\n");
242 return AVERROR(EINVAL);
244 for (i = 0; i < nb_sources; i++) {
245 struct ip_mreq_source mreqs;
246 struct addrinfo *sourceaddr = udp_resolve_host(h, sources[i], 0,
247 SOCK_DGRAM, AF_UNSPEC,
250 return AVERROR(ENOENT);
251 if (sourceaddr->ai_addr->sa_family != AF_INET) {
252 freeaddrinfo(sourceaddr);
253 av_log(NULL, AV_LOG_ERROR, "%s is of incorrect protocol family\n",
255 return AVERROR(EINVAL);
258 mreqs.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
259 mreqs.imr_interface.s_addr = INADDR_ANY;
260 mreqs.imr_sourceaddr.s_addr = ((struct sockaddr_in *)sourceaddr->ai_addr)->sin_addr.s_addr;
261 freeaddrinfo(sourceaddr);
263 if (setsockopt(sockfd, IPPROTO_IP,
264 include ? IP_ADD_SOURCE_MEMBERSHIP : IP_BLOCK_SOURCE,
265 (const void *)&mreqs, sizeof(mreqs)) < 0) {
267 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_ADD_SOURCE_MEMBERSHIP)");
269 log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_BLOCK_SOURCE)");
270 return ff_neterrno();
274 return AVERROR(ENOSYS);
278 static int udp_set_url(URLContext *h,
279 struct sockaddr_storage *addr,
280 const char *hostname, int port)
282 struct addrinfo *res0;
285 res0 = udp_resolve_host(h, hostname, port, SOCK_DGRAM, AF_UNSPEC, 0);
286 if (res0 == 0) return AVERROR(EIO);
287 memcpy(addr, res0->ai_addr, res0->ai_addrlen);
288 addr_len = res0->ai_addrlen;
294 static int udp_socket_create(URLContext *h, struct sockaddr_storage *addr,
295 socklen_t *addr_len, const char *localaddr)
297 UDPContext *s = h->priv_data;
299 struct addrinfo *res0 = NULL, *res = NULL;
300 int family = AF_UNSPEC;
302 if (((struct sockaddr *) &s->dest_addr)->sa_family)
303 family = ((struct sockaddr *) &s->dest_addr)->sa_family;
304 res0 = udp_resolve_host(h, (localaddr && localaddr[0]) ? localaddr : NULL,
306 SOCK_DGRAM, family, AI_PASSIVE);
309 for (res = res0; res; res=res->ai_next) {
310 udp_fd = ff_socket(res->ai_family, SOCK_DGRAM, 0);
311 if (udp_fd != -1) break;
312 log_net_error(NULL, AV_LOG_ERROR, "socket");
318 memcpy(addr, res->ai_addr, res->ai_addrlen);
319 *addr_len = res->ai_addrlen;
333 static int udp_port(struct sockaddr_storage *addr, int addr_len)
335 char sbuf[sizeof(int)*3+1];
338 if ((error = getnameinfo((struct sockaddr *)addr, addr_len, NULL, 0, sbuf, sizeof(sbuf), NI_NUMERICSERV)) != 0) {
339 av_log(NULL, AV_LOG_ERROR, "getnameinfo: %s\n", gai_strerror(error));
343 return strtol(sbuf, NULL, 10);
348 * If no filename is given to av_open_input_file because you want to
349 * get the local port first, then you must call this function to set
350 * the remote server address.
352 * url syntax: udp://host:port[?option=val...]
353 * option: 'ttl=n' : set the ttl value (for multicast only)
354 * 'localport=n' : set the local port
355 * 'pkt_size=n' : set max packet size
356 * 'reuse=1' : enable reusing the socket
358 * @param h media file context
359 * @param uri of the remote server
360 * @return zero if no error.
362 int ff_udp_set_remote_url(URLContext *h, const char *uri)
364 UDPContext *s = h->priv_data;
365 char hostname[256], buf[10];
369 av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &port, NULL, 0, uri);
371 /* set the destination address */
372 s->dest_addr_len = udp_set_url(h, &s->dest_addr, hostname, port);
373 if (s->dest_addr_len < 0) {
376 s->is_multicast = ff_is_multicast_address((struct sockaddr*) &s->dest_addr);
377 p = strchr(uri, '?');
379 if (av_find_info_tag(buf, sizeof(buf), "connect", p)) {
380 int was_connected = s->is_connected;
381 s->is_connected = strtol(buf, NULL, 10);
382 if (s->is_connected && !was_connected) {
383 if (connect(s->udp_fd, (struct sockaddr *) &s->dest_addr,
386 log_net_error(h, AV_LOG_ERROR, "connect");
397 * Return the local port used by the UDP connection
398 * @param h media file context
399 * @return the local port number
401 int ff_udp_get_local_port(URLContext *h)
403 UDPContext *s = h->priv_data;
404 return s->local_port;
408 * Return the udp file handle for select() usage to wait for several RTP
409 * streams at the same time.
410 * @param h media file context
412 static int udp_get_file_handle(URLContext *h)
414 UDPContext *s = h->priv_data;
418 static int parse_source_list(char *buf, char **sources, int *num_sources,
425 char *next = strchr(source_start, ',');
428 sources[*num_sources] = av_strdup(source_start);
429 if (!sources[*num_sources])
430 return AVERROR(ENOMEM);
431 source_start = next + 1;
433 if (*num_sources >= max_sources || !next)
439 /* put it in UDP context */
440 /* return non zero if error */
441 static int udp_open(URLContext *h, const char *uri, int flags)
443 char hostname[1024], localaddr[1024] = "";
444 int port, udp_fd = -1, tmp, bind_ret = -1;
445 UDPContext *s = h->priv_data;
449 struct sockaddr_storage my_addr;
451 int i, num_include_sources = 0, num_exclude_sources = 0;
452 char *include_sources[32], *exclude_sources[32];
455 h->max_packet_size = 1472;
457 is_output = !(flags & AVIO_FLAG_READ);
459 if (s->buffer_size < 0)
460 s->buffer_size = is_output ? UDP_TX_BUF_SIZE : UDP_MAX_PKT_SIZE;
463 if (parse_source_list(s->sources, include_sources,
464 &num_include_sources,
465 FF_ARRAY_ELEMS(include_sources)))
470 if (parse_source_list(s->block, exclude_sources, &num_exclude_sources,
471 FF_ARRAY_ELEMS(exclude_sources)))
476 h->max_packet_size = s->pkt_size;
478 p = strchr(uri, '?');
480 if (av_find_info_tag(buf, sizeof(buf), "reuse", p)) {
482 s->reuse_socket = strtol(buf, &endptr, 10);
483 /* assume if no digits were found it is a request to enable it */
487 if (av_find_info_tag(buf, sizeof(buf), "ttl", p)) {
488 s->ttl = strtol(buf, NULL, 10);
490 if (av_find_info_tag(buf, sizeof(buf), "localport", p)) {
491 s->local_port = strtol(buf, NULL, 10);
493 if (av_find_info_tag(buf, sizeof(buf), "pkt_size", p)) {
494 h->max_packet_size = strtol(buf, NULL, 10);
496 if (av_find_info_tag(buf, sizeof(buf), "buffer_size", p)) {
497 s->buffer_size = strtol(buf, NULL, 10);
499 if (av_find_info_tag(buf, sizeof(buf), "connect", p)) {
500 s->is_connected = strtol(buf, NULL, 10);
502 if (av_find_info_tag(buf, sizeof(buf), "localaddr", p)) {
503 av_strlcpy(localaddr, buf, sizeof(localaddr));
505 if (av_find_info_tag(buf, sizeof(buf), "sources", p)) {
506 if (parse_source_list(buf, include_sources, &num_include_sources,
507 FF_ARRAY_ELEMS(include_sources)))
510 if (av_find_info_tag(buf, sizeof(buf), "block", p)) {
511 if (parse_source_list(buf, exclude_sources, &num_exclude_sources,
512 FF_ARRAY_ELEMS(exclude_sources)))
517 /* fill the dest addr */
518 av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &port, NULL, 0, uri);
520 /* XXX: fix av_url_split */
521 if (hostname[0] == '\0' || hostname[0] == '?') {
522 /* only accepts null hostname if input */
523 if (!(flags & AVIO_FLAG_READ))
526 if (ff_udp_set_remote_url(h, uri) < 0)
530 if ((s->is_multicast || s->local_port < 0) && (h->flags & AVIO_FLAG_READ))
531 s->local_port = port;
534 udp_fd = udp_socket_create(h, &my_addr, &len, localaddr);
536 udp_fd = udp_socket_create(h, &my_addr, &len, s->localaddr);
540 /* Follow the requested reuse option, unless it's multicast in which
541 * case enable reuse unless explicitly disabled.
543 if (s->reuse_socket > 0 || (s->is_multicast && s->reuse_socket < 0)) {
545 if (setsockopt (udp_fd, SOL_SOCKET, SO_REUSEADDR, &(s->reuse_socket), sizeof(s->reuse_socket)) != 0)
549 /* If multicast, try binding the multicast address first, to avoid
550 * receiving UDP packets from other sources aimed at the same UDP
551 * port. This fails on windows. This makes sending to the same address
552 * using sendto() fail, so only do it if we're opened in read-only mode. */
553 if (s->is_multicast && !(h->flags & AVIO_FLAG_WRITE)) {
554 bind_ret = bind(udp_fd,(struct sockaddr *)&s->dest_addr, len);
556 /* bind to the local address if not multicast or if the multicast
558 /* the bind is needed to give a port to the socket now */
559 if (bind_ret < 0 && bind(udp_fd,(struct sockaddr *)&my_addr, len) < 0) {
560 log_net_error(h, AV_LOG_ERROR, "bind failed");
564 len = sizeof(my_addr);
565 getsockname(udp_fd, (struct sockaddr *)&my_addr, &len);
566 s->local_port = udp_port(&my_addr, len);
568 if (s->is_multicast) {
569 if (h->flags & AVIO_FLAG_WRITE) {
571 if (udp_set_multicast_ttl(udp_fd, s->ttl, (struct sockaddr *)&s->dest_addr) < 0)
574 if (h->flags & AVIO_FLAG_READ) {
576 if (num_include_sources && num_exclude_sources) {
577 av_log(h, AV_LOG_ERROR, "Simultaneously including and excluding multicast sources is not supported\n");
580 if (num_include_sources) {
581 if (udp_set_multicast_sources(h, udp_fd,
582 (struct sockaddr *)&s->dest_addr,
585 num_include_sources, 1) < 0)
588 if (udp_join_multicast_group(udp_fd, (struct sockaddr *)&s->dest_addr) < 0)
591 if (num_exclude_sources) {
592 if (udp_set_multicast_sources(h, udp_fd,
593 (struct sockaddr *)&s->dest_addr,
596 num_exclude_sources, 0) < 0)
603 /* limit the tx buf size to limit latency */
604 tmp = s->buffer_size;
605 if (setsockopt(udp_fd, SOL_SOCKET, SO_SNDBUF, &tmp, sizeof(tmp)) < 0) {
606 log_net_error(h, AV_LOG_ERROR, "setsockopt(SO_SNDBUF)");
610 /* set udp recv buffer size to the largest possible udp packet size to
611 * avoid losing data on OSes that set this too low by default. */
612 tmp = s->buffer_size;
613 if (setsockopt(udp_fd, SOL_SOCKET, SO_RCVBUF, &tmp, sizeof(tmp)) < 0) {
614 log_net_error(h, AV_LOG_WARNING, "setsockopt(SO_RECVBUF)");
616 /* make the socket non-blocking */
617 ff_socket_nonblock(udp_fd, 1);
619 if (s->is_connected) {
620 if (connect(udp_fd, (struct sockaddr *) &s->dest_addr, s->dest_addr_len)) {
621 log_net_error(h, AV_LOG_ERROR, "connect");
626 for (i = 0; i < num_include_sources; i++)
627 av_freep(&include_sources[i]);
628 for (i = 0; i < num_exclude_sources; i++)
629 av_freep(&exclude_sources[i]);
636 for (i = 0; i < num_include_sources; i++)
637 av_freep(&include_sources[i]);
638 for (i = 0; i < num_exclude_sources; i++)
639 av_freep(&exclude_sources[i]);
643 static int udp_read(URLContext *h, uint8_t *buf, int size)
645 UDPContext *s = h->priv_data;
648 if (!(h->flags & AVIO_FLAG_NONBLOCK)) {
649 ret = ff_network_wait_fd(s->udp_fd, 0);
653 ret = recv(s->udp_fd, buf, size, 0);
654 return ret < 0 ? ff_neterrno() : ret;
657 static int udp_write(URLContext *h, const uint8_t *buf, int size)
659 UDPContext *s = h->priv_data;
662 if (!(h->flags & AVIO_FLAG_NONBLOCK)) {
663 ret = ff_network_wait_fd(s->udp_fd, 1);
668 if (!s->is_connected) {
669 ret = sendto (s->udp_fd, buf, size, 0,
670 (struct sockaddr *) &s->dest_addr,
673 ret = send(s->udp_fd, buf, size, 0);
675 return ret < 0 ? ff_neterrno() : ret;
678 static int udp_close(URLContext *h)
680 UDPContext *s = h->priv_data;
682 if (s->is_multicast && (h->flags & AVIO_FLAG_READ))
683 udp_leave_multicast_group(s->udp_fd, (struct sockaddr *)&s->dest_addr);
684 closesocket(s->udp_fd);
688 URLProtocol ff_udp_protocol = {
690 .url_open = udp_open,
691 .url_read = udp_read,
692 .url_write = udp_write,
693 .url_close = udp_close,
694 .url_get_file_handle = udp_get_file_handle,
695 .priv_data_size = sizeof(UDPContext),
696 .flags = URL_PROTOCOL_FLAG_NETWORK,
697 .priv_data_class = &udp_class,