1 /*
2 * UDP prototype streaming system
3 * Copyright (c) 2000, 2001, 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 * UDP protocol
25 */
26
27 #define _DEFAULT_SOURCE
28 #define _BSD_SOURCE /* Needed for using struct ip_mreq with recent glibc */
29
30 #include "avformat.h"
31 #include "avio_internal.h"
32 #include "libavutil/avassert.h"
33 #include "libavutil/parseutils.h"
34 #include "libavutil/fifo.h"
35 #include "libavutil/intreadwrite.h"
36 #include "libavutil/avstring.h"
37 #include "libavutil/opt.h"
38 #include "libavutil/log.h"
39 #include "libavutil/time.h"
40 #include "internal.h"
41 #include "network.h"
42 #include "os_support.h"
43 #include "url.h"
44 #include "ip.h"
45
46 #ifdef __APPLE__
47 #include "TargetConditionals.h"
48 #endif
49
50 #if HAVE_UDPLITE_H
51 #include "udplite.h"
52 #else
53 /* On many Linux systems, udplite.h is missing but the kernel supports UDP-Lite.
54 * So, we provide a fallback here.
55 */
56 #define UDPLITE_SEND_CSCOV 10
57 #define UDPLITE_RECV_CSCOV 11
58 #endif
59
60 #ifndef IPPROTO_UDPLITE
61 #define IPPROTO_UDPLITE 136
62 #endif
63
64 #if HAVE_W32THREADS
65 #undef HAVE_PTHREAD_CANCEL
66 #define HAVE_PTHREAD_CANCEL 1
67 #endif
68
69 #if HAVE_PTHREAD_CANCEL
70 #include "libavutil/thread.h"
71 #endif
72
73 #ifndef IPV6_ADD_MEMBERSHIP
74 #define IPV6_ADD_MEMBERSHIP IPV6_JOIN_GROUP
75 #define IPV6_DROP_MEMBERSHIP IPV6_LEAVE_GROUP
76 #endif
77
78 #define UDP_TX_BUF_SIZE 32768
79 #define UDP_RX_BUF_SIZE 393216
80 #define UDP_MAX_PKT_SIZE 65536
81 #define UDP_HEADER_SIZE 8
82
83 typedef struct UDPContext {
84 const AVClass *class;
85 int udp_fd;
86 int ttl;
87 int udplite_coverage;
88 int buffer_size;
89 int pkt_size;
90 int is_multicast;
91 int is_broadcast;
92 int local_port;
93 int reuse_socket;
94 int overrun_nonfatal;
95 struct sockaddr_storage dest_addr;
96 int dest_addr_len;
97 int is_connected;
98
99 /* Circular Buffer variables for use in UDP receive code */
100 int circular_buffer_size;
101 AVFifoBuffer *fifo;
102 int circular_buffer_error;
103 int64_t bitrate; /* number of bits to send per second */
104 int64_t burst_bits;
105 int close_req;
106 #if HAVE_PTHREAD_CANCEL
107 pthread_t circular_buffer_thread;
108 pthread_mutex_t mutex;
109 pthread_cond_t cond;
110 int thread_started;
111 #endif
112 uint8_t tmp[UDP_MAX_PKT_SIZE+4];
113 int remaining_in_dg;
114 char *localaddr;
115 int timeout;
116 struct sockaddr_storage local_addr_storage;
117 char *sources;
118 char *block;
119 IPSourceFilters filters;
120 } UDPContext;
121
122 #define OFFSET(x) offsetof(UDPContext, x)
123 #define D AV_OPT_FLAG_DECODING_PARAM
124 #define E AV_OPT_FLAG_ENCODING_PARAM
125 static const AVOption options[] = {
126 { "buffer_size", "System data size (in bytes)", OFFSET(buffer_size), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, .flags = D|E },
127 { "bitrate", "Bits to send per second", OFFSET(bitrate), AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, INT64_MAX, .flags = E },
128 { "burst_bits", "Max length of bursts in bits (when using bitrate)", OFFSET(burst_bits), AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, INT64_MAX, .flags = E },
129 { "localport", "Local port", OFFSET(local_port), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, D|E },
130 { "local_port", "Local port", OFFSET(local_port), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, INT_MAX, .flags = D|E },
131 { "localaddr", "Local address", OFFSET(localaddr), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
132 { "udplite_coverage", "choose UDPLite head size which should be validated by checksum", OFFSET(udplite_coverage), AV_OPT_TYPE_INT, {.i64 = 0}, 0, INT_MAX, D|E },
133 { "pkt_size", "Maximum UDP packet size", OFFSET(pkt_size), AV_OPT_TYPE_INT, { .i64 = 1472 }, -1, INT_MAX, .flags = D|E },
134 { "reuse", "explicitly allow reusing UDP sockets", OFFSET(reuse_socket), AV_OPT_TYPE_BOOL, { .i64 = -1 }, -1, 1, D|E },
135 { "reuse_socket", "explicitly allow reusing UDP sockets", OFFSET(reuse_socket), AV_OPT_TYPE_BOOL, { .i64 = -1 }, -1, 1, .flags = D|E },
136 { "broadcast", "explicitly allow or disallow broadcast destination", OFFSET(is_broadcast), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, E },
137 { "ttl", "Time to live (multicast only)", OFFSET(ttl), AV_OPT_TYPE_INT, { .i64 = 16 }, 0, INT_MAX, E },
138 { "connect", "set if connect() should be called on socket", OFFSET(is_connected), AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1, .flags = D|E },
139 { "fifo_size", "set the UDP receiving circular buffer size, expressed as a number of packets with size of 188 bytes", OFFSET(circular_buffer_size), AV_OPT_TYPE_INT, {.i64 = 7*4096}, 0, INT_MAX, D },
140 { "overrun_nonfatal", "survive in case of UDP receiving circular buffer overrun", OFFSET(overrun_nonfatal), AV_OPT_TYPE_BOOL, {.i64 = 0}, 0, 1, D },
141 { "timeout", "set raise error timeout (only in read mode)", OFFSET(timeout), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX, D },
142 { "sources", "Source list", OFFSET(sources), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
143 { "block", "Block list", OFFSET(block), AV_OPT_TYPE_STRING, { .str = NULL }, .flags = D|E },
144 { NULL }
145 };
146
147 static const AVClass udp_class = {
148 .class_name = "udp",
149 .item_name = av_default_item_name,
150 .option = options,
151 .version = LIBAVUTIL_VERSION_INT,
152 };
153
154 static const AVClass udplite_context_class = {
155 .class_name = "udplite",
156 .item_name = av_default_item_name,
157 .option = options,
158 .version = LIBAVUTIL_VERSION_INT,
159 };
160
udp_set_multicast_ttl(int sockfd,int mcastTTL,struct sockaddr * addr)161 static int udp_set_multicast_ttl(int sockfd, int mcastTTL,
162 struct sockaddr *addr)
163 {
164 #ifdef IP_MULTICAST_TTL
165 if (addr->sa_family == AF_INET) {
166 if (setsockopt(sockfd, IPPROTO_IP, IP_MULTICAST_TTL, &mcastTTL, sizeof(mcastTTL)) < 0) {
167 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_MULTICAST_TTL)");
168 return -1;
169 }
170 }
171 #endif
172 #if defined(IPPROTO_IPV6) && defined(IPV6_MULTICAST_HOPS)
173 if (addr->sa_family == AF_INET6) {
174 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_MULTICAST_HOPS, &mcastTTL, sizeof(mcastTTL)) < 0) {
175 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_MULTICAST_HOPS)");
176 return -1;
177 }
178 }
179 #endif
180 return 0;
181 }
182
udp_join_multicast_group(int sockfd,struct sockaddr * addr,struct sockaddr * local_addr)183 static int udp_join_multicast_group(int sockfd, struct sockaddr *addr,struct sockaddr *local_addr)
184 {
185 #ifdef IP_ADD_MEMBERSHIP
186 if (addr->sa_family == AF_INET) {
187 struct ip_mreq mreq;
188
189 mreq.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
190 if (local_addr)
191 mreq.imr_interface= ((struct sockaddr_in *)local_addr)->sin_addr;
192 else
193 mreq.imr_interface.s_addr= INADDR_ANY;
194 if (setsockopt(sockfd, IPPROTO_IP, IP_ADD_MEMBERSHIP, (const void *)&mreq, sizeof(mreq)) < 0) {
195 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_ADD_MEMBERSHIP)");
196 return -1;
197 }
198 }
199 #endif
200 #if HAVE_STRUCT_IPV6_MREQ && defined(IPPROTO_IPV6)
201 if (addr->sa_family == AF_INET6) {
202 struct ipv6_mreq mreq6;
203
204 memcpy(&mreq6.ipv6mr_multiaddr, &(((struct sockaddr_in6 *)addr)->sin6_addr), sizeof(struct in6_addr));
205 //TODO: Interface index should be looked up from local_addr
206 mreq6.ipv6mr_interface= 0;
207 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_ADD_MEMBERSHIP, &mreq6, sizeof(mreq6)) < 0) {
208 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_ADD_MEMBERSHIP)");
209 return -1;
210 }
211 }
212 #endif
213 return 0;
214 }
215
udp_leave_multicast_group(int sockfd,struct sockaddr * addr,struct sockaddr * local_addr)216 static int udp_leave_multicast_group(int sockfd, struct sockaddr *addr,struct sockaddr *local_addr)
217 {
218 #ifdef IP_DROP_MEMBERSHIP
219 if (addr->sa_family == AF_INET) {
220 struct ip_mreq mreq;
221
222 mreq.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
223 if (local_addr)
224 mreq.imr_interface= ((struct sockaddr_in *)local_addr)->sin_addr;
225 else
226 mreq.imr_interface.s_addr= INADDR_ANY;
227 if (setsockopt(sockfd, IPPROTO_IP, IP_DROP_MEMBERSHIP, (const void *)&mreq, sizeof(mreq)) < 0) {
228 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IP_DROP_MEMBERSHIP)");
229 return -1;
230 }
231 }
232 #endif
233 #if HAVE_STRUCT_IPV6_MREQ && defined(IPPROTO_IPV6)
234 if (addr->sa_family == AF_INET6) {
235 struct ipv6_mreq mreq6;
236
237 memcpy(&mreq6.ipv6mr_multiaddr, &(((struct sockaddr_in6 *)addr)->sin6_addr), sizeof(struct in6_addr));
238 //TODO: Interface index should be looked up from local_addr
239 mreq6.ipv6mr_interface= 0;
240 if (setsockopt(sockfd, IPPROTO_IPV6, IPV6_DROP_MEMBERSHIP, &mreq6, sizeof(mreq6)) < 0) {
241 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(IPV6_DROP_MEMBERSHIP)");
242 return -1;
243 }
244 }
245 #endif
246 return 0;
247 }
248
udp_set_multicast_sources(URLContext * h,int sockfd,struct sockaddr * addr,int addr_len,struct sockaddr_storage * local_addr,struct sockaddr_storage * sources,int nb_sources,int include)249 static int udp_set_multicast_sources(URLContext *h,
250 int sockfd, struct sockaddr *addr,
251 int addr_len, struct sockaddr_storage *local_addr,
252 struct sockaddr_storage *sources,
253 int nb_sources, int include)
254 {
255 int i;
256 if (addr->sa_family != AF_INET) {
257 #if HAVE_STRUCT_GROUP_SOURCE_REQ && defined(MCAST_BLOCK_SOURCE)
258 /* For IPv4 prefer the old approach, as that alone works reliably on
259 * Windows and it also supports supplying the interface based on its
260 * address. */
261 int i;
262 for (i = 0; i < nb_sources; i++) {
263 struct group_source_req mreqs;
264 int level = addr->sa_family == AF_INET ? IPPROTO_IP : IPPROTO_IPV6;
265
266 //TODO: Interface index should be looked up from local_addr
267 mreqs.gsr_interface = 0;
268 memcpy(&mreqs.gsr_group, addr, addr_len);
269 memcpy(&mreqs.gsr_source, &sources[i], sizeof(*sources));
270
271 if (setsockopt(sockfd, level,
272 include ? MCAST_JOIN_SOURCE_GROUP : MCAST_BLOCK_SOURCE,
273 (const void *)&mreqs, sizeof(mreqs)) < 0) {
274 if (include)
275 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(MCAST_JOIN_SOURCE_GROUP)");
276 else
277 ff_log_net_error(NULL, AV_LOG_ERROR, "setsockopt(MCAST_BLOCK_SOURCE)");
278 return ff_neterrno();
279 }
280 }
281 return 0;
282 #else
283 av_log(h, AV_LOG_ERROR,
284 "Setting multicast sources only supported for IPv4\n");
285 return AVERROR(EINVAL);
286 #endif
287 }
288 #if HAVE_STRUCT_IP_MREQ_SOURCE && defined(IP_BLOCK_SOURCE)
289 for (i = 0; i < nb_sources; i++) {
290 struct ip_mreq_source mreqs;
291 if (sources[i].ss_family != AF_INET) {
292 av_log(h, AV_LOG_ERROR, "Source/block address %d is of incorrect protocol family\n", i + 1);
293 return AVERROR(EINVAL);
294 }
295
296 mreqs.imr_multiaddr.s_addr = ((struct sockaddr_in *)addr)->sin_addr.s_addr;
297 if (local_addr)
298 mreqs.imr_interface= ((struct sockaddr_in *)local_addr)->sin_addr;
299 else
300 mreqs.imr_interface.s_addr= INADDR_ANY;
301 mreqs.imr_sourceaddr.s_addr = ((struct sockaddr_in *)&sources[i])->sin_addr.s_addr;
302
303 if (setsockopt(sockfd, IPPROTO_IP,
304 include ? IP_ADD_SOURCE_MEMBERSHIP : IP_BLOCK_SOURCE,
305 (const void *)&mreqs, sizeof(mreqs)) < 0) {
306 if (include)
307 ff_log_net_error(h, AV_LOG_ERROR, "setsockopt(IP_ADD_SOURCE_MEMBERSHIP)");
308 else
309 ff_log_net_error(h, AV_LOG_ERROR, "setsockopt(IP_BLOCK_SOURCE)");
310 return ff_neterrno();
311 }
312 }
313 #else
314 return AVERROR(ENOSYS);
315 #endif
316 return 0;
317 }
udp_set_url(URLContext * h,struct sockaddr_storage * addr,const char * hostname,int port)318 static int udp_set_url(URLContext *h,
319 struct sockaddr_storage *addr,
320 const char *hostname, int port)
321 {
322 struct addrinfo *res0;
323 int addr_len;
324
325 res0 = ff_ip_resolve_host(h, hostname, port, SOCK_DGRAM, AF_UNSPEC, 0);
326 if (!res0) return AVERROR(EIO);
327 memcpy(addr, res0->ai_addr, res0->ai_addrlen);
328 addr_len = res0->ai_addrlen;
329 freeaddrinfo(res0);
330
331 return addr_len;
332 }
333
udp_socket_create(URLContext * h,struct sockaddr_storage * addr,socklen_t * addr_len,const char * localaddr)334 static int udp_socket_create(URLContext *h, struct sockaddr_storage *addr,
335 socklen_t *addr_len, const char *localaddr)
336 {
337 UDPContext *s = h->priv_data;
338 int udp_fd = -1;
339 struct addrinfo *res0, *res;
340 int family = AF_UNSPEC;
341
342 if (((struct sockaddr *) &s->dest_addr)->sa_family)
343 family = ((struct sockaddr *) &s->dest_addr)->sa_family;
344 res0 = ff_ip_resolve_host(h, (localaddr && localaddr[0]) ? localaddr : NULL,
345 s->local_port,
346 SOCK_DGRAM, family, AI_PASSIVE);
347 if (!res0)
348 goto fail;
349 for (res = res0; res; res=res->ai_next) {
350 if (s->udplite_coverage)
351 udp_fd = ff_socket(res->ai_family, SOCK_DGRAM, IPPROTO_UDPLITE);
352 else
353 udp_fd = ff_socket(res->ai_family, SOCK_DGRAM, 0);
354 if (udp_fd != -1) break;
355 ff_log_net_error(NULL, AV_LOG_ERROR, "socket");
356 }
357
358 if (udp_fd < 0)
359 goto fail;
360
361 memcpy(addr, res->ai_addr, res->ai_addrlen);
362 *addr_len = res->ai_addrlen;
363
364 freeaddrinfo(res0);
365
366 return udp_fd;
367
368 fail:
369 if (udp_fd >= 0)
370 closesocket(udp_fd);
371 if(res0)
372 freeaddrinfo(res0);
373 return -1;
374 }
375
udp_port(struct sockaddr_storage * addr,int addr_len)376 static int udp_port(struct sockaddr_storage *addr, int addr_len)
377 {
378 char sbuf[sizeof(int)*3+1];
379 int error;
380
381 if ((error = getnameinfo((struct sockaddr *)addr, addr_len, NULL, 0, sbuf, sizeof(sbuf), NI_NUMERICSERV)) != 0) {
382 av_log(NULL, AV_LOG_ERROR, "getnameinfo: %s\n", gai_strerror(error));
383 return -1;
384 }
385
386 return strtol(sbuf, NULL, 10);
387 }
388
389
390 /**
391 * If no filename is given to av_open_input_file because you want to
392 * get the local port first, then you must call this function to set
393 * the remote server address.
394 *
395 * url syntax: udp://host:port[?option=val...]
396 * option: 'ttl=n' : set the ttl value (for multicast only)
397 * 'localport=n' : set the local port
398 * 'pkt_size=n' : set max packet size
399 * 'reuse=1' : enable reusing the socket
400 * 'overrun_nonfatal=1': survive in case of circular buffer overrun
401 *
402 * @param h media file context
403 * @param uri of the remote server
404 * @return zero if no error.
405 */
ff_udp_set_remote_url(URLContext * h,const char * uri)406 int ff_udp_set_remote_url(URLContext *h, const char *uri)
407 {
408 UDPContext *s = h->priv_data;
409 char hostname[256], buf[10];
410 int port;
411 const char *p;
412
413 av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &port, NULL, 0, uri);
414
415 /* set the destination address */
416 s->dest_addr_len = udp_set_url(h, &s->dest_addr, hostname, port);
417 if (s->dest_addr_len < 0) {
418 return AVERROR(EIO);
419 }
420 s->is_multicast = ff_is_multicast_address((struct sockaddr*) &s->dest_addr);
421 p = strchr(uri, '?');
422 if (p) {
423 if (av_find_info_tag(buf, sizeof(buf), "connect", p)) {
424 int was_connected = s->is_connected;
425 s->is_connected = strtol(buf, NULL, 10);
426 if (s->is_connected && !was_connected) {
427 if (connect(s->udp_fd, (struct sockaddr *) &s->dest_addr,
428 s->dest_addr_len)) {
429 s->is_connected = 0;
430 ff_log_net_error(h, AV_LOG_ERROR, "connect");
431 return AVERROR(EIO);
432 }
433 }
434 }
435 }
436
437 return 0;
438 }
439
440 /**
441 * Return the local port used by the UDP connection
442 * @param h media file context
443 * @return the local port number
444 */
ff_udp_get_local_port(URLContext * h)445 int ff_udp_get_local_port(URLContext *h)
446 {
447 UDPContext *s = h->priv_data;
448 return s->local_port;
449 }
450
451 /**
452 * Return the udp file handle for select() usage to wait for several RTP
453 * streams at the same time.
454 * @param h media file context
455 */
udp_get_file_handle(URLContext * h)456 static int udp_get_file_handle(URLContext *h)
457 {
458 UDPContext *s = h->priv_data;
459 return s->udp_fd;
460 }
461
462 #if HAVE_PTHREAD_CANCEL
circular_buffer_task_rx(void * _URLContext)463 static void *circular_buffer_task_rx( void *_URLContext)
464 {
465 URLContext *h = _URLContext;
466 UDPContext *s = h->priv_data;
467 int old_cancelstate;
468
469 pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, &old_cancelstate);
470 pthread_mutex_lock(&s->mutex);
471 if (ff_socket_nonblock(s->udp_fd, 0) < 0) {
472 av_log(h, AV_LOG_ERROR, "Failed to set blocking mode");
473 s->circular_buffer_error = AVERROR(EIO);
474 goto end;
475 }
476 while(1) {
477 int len;
478 struct sockaddr_storage addr;
479 socklen_t addr_len = sizeof(addr);
480
481 pthread_mutex_unlock(&s->mutex);
482 /* Blocking operations are always cancellation points;
483 see "General Information" / "Thread Cancelation Overview"
484 in Single Unix. */
485 pthread_setcancelstate(PTHREAD_CANCEL_ENABLE, &old_cancelstate);
486 len = recvfrom(s->udp_fd, s->tmp+4, sizeof(s->tmp)-4, 0, (struct sockaddr *)&addr, &addr_len);
487 pthread_setcancelstate(PTHREAD_CANCEL_DISABLE, &old_cancelstate);
488 pthread_mutex_lock(&s->mutex);
489 if (len < 0) {
490 if (ff_neterrno() != AVERROR(EAGAIN) && ff_neterrno() != AVERROR(EINTR)) {
491 s->circular_buffer_error = ff_neterrno();
492 goto end;
493 }
494 continue;
495 }
496 if (ff_ip_check_source_lists(&addr, &s->filters))
497 continue;
498 AV_WL32(s->tmp, len);
499
500 if(av_fifo_space(s->fifo) < len + 4) {
501 /* No Space left */
502 if (s->overrun_nonfatal) {
503 av_log(h, AV_LOG_WARNING, "Circular buffer overrun. "
504 "Surviving due to overrun_nonfatal option\n");
505 continue;
506 } else {
507 av_log(h, AV_LOG_ERROR, "Circular buffer overrun. "
508 "To avoid, increase fifo_size URL option. "
509 "To survive in such case, use overrun_nonfatal option\n");
510 s->circular_buffer_error = AVERROR(EIO);
511 goto end;
512 }
513 }
514 av_fifo_generic_write(s->fifo, s->tmp, len+4, NULL);
515 pthread_cond_signal(&s->cond);
516 }
517
518 end:
519 pthread_cond_signal(&s->cond);
520 pthread_mutex_unlock(&s->mutex);
521 return NULL;
522 }
523
circular_buffer_task_tx(void * _URLContext)524 static void *circular_buffer_task_tx( void *_URLContext)
525 {
526 URLContext *h = _URLContext;
527 UDPContext *s = h->priv_data;
528 int64_t target_timestamp = av_gettime_relative();
529 int64_t start_timestamp = av_gettime_relative();
530 int64_t sent_bits = 0;
531 int64_t burst_interval = s->bitrate ? (s->burst_bits * 1000000 / s->bitrate) : 0;
532 int64_t max_delay = s->bitrate ? ((int64_t)h->max_packet_size * 8 * 1000000 / s->bitrate + 1) : 0;
533
534 pthread_mutex_lock(&s->mutex);
535
536 if (ff_socket_nonblock(s->udp_fd, 0) < 0) {
537 av_log(h, AV_LOG_ERROR, "Failed to set blocking mode");
538 s->circular_buffer_error = AVERROR(EIO);
539 goto end;
540 }
541
542 for(;;) {
543 int len;
544 const uint8_t *p;
545 uint8_t tmp[4];
546 int64_t timestamp;
547
548 len=av_fifo_size(s->fifo);
549
550 while (len<4) {
551 if (s->close_req)
552 goto end;
553 if (pthread_cond_wait(&s->cond, &s->mutex) < 0) {
554 goto end;
555 }
556 len=av_fifo_size(s->fifo);
557 }
558
559 av_fifo_generic_read(s->fifo, tmp, 4, NULL);
560 len=AV_RL32(tmp);
561
562 av_assert0(len >= 0);
563 av_assert0(len <= sizeof(s->tmp));
564
565 av_fifo_generic_read(s->fifo, s->tmp, len, NULL);
566
567 pthread_mutex_unlock(&s->mutex);
568
569 if (s->bitrate) {
570 timestamp = av_gettime_relative();
571 if (timestamp < target_timestamp) {
572 int64_t delay = target_timestamp - timestamp;
573 if (delay > max_delay) {
574 delay = max_delay;
575 start_timestamp = timestamp + delay;
576 sent_bits = 0;
577 }
578 av_usleep(delay);
579 } else {
580 if (timestamp - burst_interval > target_timestamp) {
581 start_timestamp = timestamp - burst_interval;
582 sent_bits = 0;
583 }
584 }
585 sent_bits += len * 8;
586 target_timestamp = start_timestamp + sent_bits * 1000000 / s->bitrate;
587 }
588
589 p = s->tmp;
590 while (len) {
591 int ret;
592 av_assert0(len > 0);
593 if (!s->is_connected) {
594 ret = sendto (s->udp_fd, p, len, 0,
595 (struct sockaddr *) &s->dest_addr,
596 s->dest_addr_len);
597 } else
598 ret = send(s->udp_fd, p, len, 0);
599 if (ret >= 0) {
600 len -= ret;
601 p += ret;
602 } else {
603 ret = ff_neterrno();
604 if (ret != AVERROR(EAGAIN) && ret != AVERROR(EINTR)) {
605 pthread_mutex_lock(&s->mutex);
606 s->circular_buffer_error = ret;
607 pthread_mutex_unlock(&s->mutex);
608 return NULL;
609 }
610 }
611 }
612
613 pthread_mutex_lock(&s->mutex);
614 }
615
616 end:
617 pthread_mutex_unlock(&s->mutex);
618 return NULL;
619 }
620
621
622 #endif
623
624 /* put it in UDP context */
625 /* return non zero if error */
udp_open(URLContext * h,const char * uri,int flags)626 static int udp_open(URLContext *h, const char *uri, int flags)
627 {
628 char hostname[1024], localaddr[1024] = "";
629 int port, udp_fd = -1, tmp, bind_ret = -1, dscp = -1;
630 UDPContext *s = h->priv_data;
631 int is_output;
632 const char *p;
633 char buf[256];
634 struct sockaddr_storage my_addr;
635 socklen_t len;
636
637 h->is_streamed = 1;
638
639 is_output = !(flags & AVIO_FLAG_READ);
640 if (s->buffer_size < 0)
641 s->buffer_size = is_output ? UDP_TX_BUF_SIZE : UDP_RX_BUF_SIZE;
642
643 if (s->sources) {
644 if (ff_ip_parse_sources(h, s->sources, &s->filters) < 0)
645 goto fail;
646 }
647
648 if (s->block) {
649 if (ff_ip_parse_blocks(h, s->block, &s->filters) < 0)
650 goto fail;
651 }
652
653 if (s->pkt_size > 0)
654 h->max_packet_size = s->pkt_size;
655
656 p = strchr(uri, '?');
657 if (p) {
658 if (av_find_info_tag(buf, sizeof(buf), "reuse", p)) {
659 char *endptr = NULL;
660 s->reuse_socket = strtol(buf, &endptr, 10);
661 /* assume if no digits were found it is a request to enable it */
662 if (buf == endptr)
663 s->reuse_socket = 1;
664 }
665 if (av_find_info_tag(buf, sizeof(buf), "overrun_nonfatal", p)) {
666 char *endptr = NULL;
667 s->overrun_nonfatal = strtol(buf, &endptr, 10);
668 /* assume if no digits were found it is a request to enable it */
669 if (buf == endptr)
670 s->overrun_nonfatal = 1;
671 if (!HAVE_PTHREAD_CANCEL)
672 av_log(h, AV_LOG_WARNING,
673 "'overrun_nonfatal' option was set but it is not supported "
674 "on this build (pthread support is required)\n");
675 }
676 if (av_find_info_tag(buf, sizeof(buf), "ttl", p)) {
677 s->ttl = strtol(buf, NULL, 10);
678 }
679 if (av_find_info_tag(buf, sizeof(buf), "udplite_coverage", p)) {
680 s->udplite_coverage = strtol(buf, NULL, 10);
681 }
682 if (av_find_info_tag(buf, sizeof(buf), "localport", p)) {
683 s->local_port = strtol(buf, NULL, 10);
684 }
685 if (av_find_info_tag(buf, sizeof(buf), "pkt_size", p)) {
686 s->pkt_size = strtol(buf, NULL, 10);
687 }
688 if (av_find_info_tag(buf, sizeof(buf), "buffer_size", p)) {
689 s->buffer_size = strtol(buf, NULL, 10);
690 }
691 if (av_find_info_tag(buf, sizeof(buf), "connect", p)) {
692 s->is_connected = strtol(buf, NULL, 10);
693 }
694 if (av_find_info_tag(buf, sizeof(buf), "dscp", p)) {
695 dscp = strtol(buf, NULL, 10);
696 }
697 if (av_find_info_tag(buf, sizeof(buf), "fifo_size", p)) {
698 s->circular_buffer_size = strtol(buf, NULL, 10);
699 if (!HAVE_PTHREAD_CANCEL)
700 av_log(h, AV_LOG_WARNING,
701 "'circular_buffer_size' option was set but it is not supported "
702 "on this build (pthread support is required)\n");
703 }
704 if (av_find_info_tag(buf, sizeof(buf), "bitrate", p)) {
705 s->bitrate = strtoll(buf, NULL, 10);
706 if (!HAVE_PTHREAD_CANCEL)
707 av_log(h, AV_LOG_WARNING,
708 "'bitrate' option was set but it is not supported "
709 "on this build (pthread support is required)\n");
710 }
711 if (av_find_info_tag(buf, sizeof(buf), "burst_bits", p)) {
712 s->burst_bits = strtoll(buf, NULL, 10);
713 }
714 if (av_find_info_tag(buf, sizeof(buf), "localaddr", p)) {
715 av_strlcpy(localaddr, buf, sizeof(localaddr));
716 }
717 if (av_find_info_tag(buf, sizeof(buf), "sources", p)) {
718 if (ff_ip_parse_sources(h, buf, &s->filters) < 0)
719 goto fail;
720 }
721 if (av_find_info_tag(buf, sizeof(buf), "block", p)) {
722 if (ff_ip_parse_blocks(h, buf, &s->filters) < 0)
723 goto fail;
724 }
725 if (!is_output && av_find_info_tag(buf, sizeof(buf), "timeout", p))
726 s->timeout = strtol(buf, NULL, 10);
727 if (is_output && av_find_info_tag(buf, sizeof(buf), "broadcast", p))
728 s->is_broadcast = strtol(buf, NULL, 10);
729 }
730 /* handling needed to support options picking from both AVOption and URL */
731 s->circular_buffer_size *= 188;
732 if (flags & AVIO_FLAG_WRITE) {
733 h->max_packet_size = s->pkt_size;
734 } else {
735 h->max_packet_size = UDP_MAX_PKT_SIZE;
736 }
737 h->rw_timeout = s->timeout;
738
739 /* fill the dest addr */
740 av_url_split(NULL, 0, NULL, 0, hostname, sizeof(hostname), &port, NULL, 0, uri);
741
742 /* XXX: fix av_url_split */
743 if (hostname[0] == '\0' || hostname[0] == '?') {
744 /* only accepts null hostname if input */
745 if (!(flags & AVIO_FLAG_READ))
746 goto fail;
747 } else {
748 if (ff_udp_set_remote_url(h, uri) < 0)
749 goto fail;
750 }
751
752 if ((s->is_multicast || s->local_port <= 0) && (h->flags & AVIO_FLAG_READ))
753 s->local_port = port;
754
755 if (localaddr[0])
756 udp_fd = udp_socket_create(h, &my_addr, &len, localaddr);
757 else
758 udp_fd = udp_socket_create(h, &my_addr, &len, s->localaddr);
759 if (udp_fd < 0)
760 goto fail;
761
762 s->local_addr_storage=my_addr; //store for future multicast join
763
764 /* Follow the requested reuse option, unless it's multicast in which
765 * case enable reuse unless explicitly disabled.
766 */
767 if (s->reuse_socket > 0 || (s->is_multicast && s->reuse_socket < 0)) {
768 s->reuse_socket = 1;
769 if (setsockopt (udp_fd, SOL_SOCKET, SO_REUSEADDR, &(s->reuse_socket), sizeof(s->reuse_socket)) != 0)
770 goto fail;
771 }
772
773 if (s->is_broadcast) {
774 #ifdef SO_BROADCAST
775 if (setsockopt (udp_fd, SOL_SOCKET, SO_BROADCAST, &(s->is_broadcast), sizeof(s->is_broadcast)) != 0)
776 #endif
777 goto fail;
778 }
779
780 /* Set the checksum coverage for UDP-Lite (RFC 3828) for sending and receiving.
781 * The receiver coverage has to be less than or equal to the sender coverage.
782 * Otherwise, the receiver will drop all packets.
783 */
784 if (s->udplite_coverage) {
785 if (setsockopt (udp_fd, IPPROTO_UDPLITE, UDPLITE_SEND_CSCOV, &(s->udplite_coverage), sizeof(s->udplite_coverage)) != 0)
786 av_log(h, AV_LOG_WARNING, "socket option UDPLITE_SEND_CSCOV not available");
787
788 if (setsockopt (udp_fd, IPPROTO_UDPLITE, UDPLITE_RECV_CSCOV, &(s->udplite_coverage), sizeof(s->udplite_coverage)) != 0)
789 av_log(h, AV_LOG_WARNING, "socket option UDPLITE_RECV_CSCOV not available");
790 }
791
792 if (dscp >= 0) {
793 dscp <<= 2;
794 if (setsockopt (udp_fd, IPPROTO_IP, IP_TOS, &dscp, sizeof(dscp)) != 0)
795 goto fail;
796 }
797
798 /* If multicast, try binding the multicast address first, to avoid
799 * receiving UDP packets from other sources aimed at the same UDP
800 * port. This fails on windows. This makes sending to the same address
801 * using sendto() fail, so only do it if we're opened in read-only mode. */
802 if (s->is_multicast && (h->flags & AVIO_FLAG_READ)) {
803 bind_ret = bind(udp_fd,(struct sockaddr *)&s->dest_addr, len);
804 }
805 /* bind to the local address if not multicast or if the multicast
806 * bind failed */
807 /* the bind is needed to give a port to the socket now */
808 if (bind_ret < 0 && bind(udp_fd,(struct sockaddr *)&my_addr, len) < 0) {
809 ff_log_net_error(h, AV_LOG_ERROR, "bind failed");
810 goto fail;
811 }
812
813 len = sizeof(my_addr);
814 getsockname(udp_fd, (struct sockaddr *)&my_addr, &len);
815 s->local_port = udp_port(&my_addr, len);
816
817 if (s->is_multicast) {
818 if (h->flags & AVIO_FLAG_WRITE) {
819 /* output */
820 if (udp_set_multicast_ttl(udp_fd, s->ttl, (struct sockaddr *)&s->dest_addr) < 0)
821 goto fail;
822 }
823 if (h->flags & AVIO_FLAG_READ) {
824 /* input */
825 if (s->filters.nb_include_addrs) {
826 if (udp_set_multicast_sources(h, udp_fd,
827 (struct sockaddr *)&s->dest_addr,
828 s->dest_addr_len, &s->local_addr_storage,
829 s->filters.include_addrs,
830 s->filters.nb_include_addrs, 1) < 0)
831 goto fail;
832 } else {
833 if (udp_join_multicast_group(udp_fd, (struct sockaddr *)&s->dest_addr,(struct sockaddr *)&s->local_addr_storage) < 0)
834 goto fail;
835 }
836 if (s->filters.nb_exclude_addrs) {
837 if (udp_set_multicast_sources(h, udp_fd,
838 (struct sockaddr *)&s->dest_addr,
839 s->dest_addr_len, &s->local_addr_storage,
840 s->filters.exclude_addrs,
841 s->filters.nb_exclude_addrs, 0) < 0)
842 goto fail;
843 }
844 }
845 }
846
847 if (is_output) {
848 /* limit the tx buf size to limit latency */
849 tmp = s->buffer_size;
850 if (setsockopt(udp_fd, SOL_SOCKET, SO_SNDBUF, &tmp, sizeof(tmp)) < 0) {
851 ff_log_net_error(h, AV_LOG_ERROR, "setsockopt(SO_SNDBUF)");
852 goto fail;
853 }
854 } else {
855 /* set udp recv buffer size to the requested value (default 64K) */
856 tmp = s->buffer_size;
857 if (setsockopt(udp_fd, SOL_SOCKET, SO_RCVBUF, &tmp, sizeof(tmp)) < 0) {
858 ff_log_net_error(h, AV_LOG_WARNING, "setsockopt(SO_RECVBUF)");
859 }
860 len = sizeof(tmp);
861 if (getsockopt(udp_fd, SOL_SOCKET, SO_RCVBUF, &tmp, &len) < 0) {
862 ff_log_net_error(h, AV_LOG_WARNING, "getsockopt(SO_RCVBUF)");
863 } else {
864 av_log(h, AV_LOG_DEBUG, "end receive buffer size reported is %d\n", tmp);
865 if(tmp < s->buffer_size)
866 av_log(h, AV_LOG_WARNING, "attempted to set receive buffer to size %d but it only ended up set as %d\n", s->buffer_size, tmp);
867 }
868
869 /* make the socket non-blocking */
870 ff_socket_nonblock(udp_fd, 1);
871 }
872 if (s->is_connected) {
873 if (connect(udp_fd, (struct sockaddr *) &s->dest_addr, s->dest_addr_len)) {
874 ff_log_net_error(h, AV_LOG_ERROR, "connect");
875 goto fail;
876 }
877 }
878
879 s->udp_fd = udp_fd;
880
881 #if HAVE_PTHREAD_CANCEL
882 /*
883 Create thread in case of:
884 1. Input and circular_buffer_size is set
885 2. Output and bitrate and circular_buffer_size is set
886 */
887
888 if (is_output && s->bitrate && !s->circular_buffer_size) {
889 /* Warn user in case of 'circular_buffer_size' is not set */
890 av_log(h, AV_LOG_WARNING,"'bitrate' option was set but 'circular_buffer_size' is not, but required\n");
891 }
892
893 if ((!is_output && s->circular_buffer_size) || (is_output && s->bitrate && s->circular_buffer_size)) {
894 int ret;
895
896 /* start the task going */
897 s->fifo = av_fifo_alloc(s->circular_buffer_size);
898 ret = pthread_mutex_init(&s->mutex, NULL);
899 if (ret != 0) {
900 av_log(h, AV_LOG_ERROR, "pthread_mutex_init failed : %s\n", strerror(ret));
901 goto fail;
902 }
903 ret = pthread_cond_init(&s->cond, NULL);
904 if (ret != 0) {
905 av_log(h, AV_LOG_ERROR, "pthread_cond_init failed : %s\n", strerror(ret));
906 goto cond_fail;
907 }
908 ret = pthread_create(&s->circular_buffer_thread, NULL, is_output?circular_buffer_task_tx:circular_buffer_task_rx, h);
909 if (ret != 0) {
910 av_log(h, AV_LOG_ERROR, "pthread_create failed : %s\n", strerror(ret));
911 goto thread_fail;
912 }
913 s->thread_started = 1;
914 }
915 #endif
916
917 return 0;
918 #if HAVE_PTHREAD_CANCEL
919 thread_fail:
920 pthread_cond_destroy(&s->cond);
921 cond_fail:
922 pthread_mutex_destroy(&s->mutex);
923 #endif
924 fail:
925 if (udp_fd >= 0)
926 closesocket(udp_fd);
927 av_fifo_freep(&s->fifo);
928 ff_ip_reset_filters(&s->filters);
929 return AVERROR(EIO);
930 }
931
udplite_open(URLContext * h,const char * uri,int flags)932 static int udplite_open(URLContext *h, const char *uri, int flags)
933 {
934 UDPContext *s = h->priv_data;
935
936 // set default checksum coverage
937 s->udplite_coverage = UDP_HEADER_SIZE;
938
939 return udp_open(h, uri, flags);
940 }
941
udp_read(URLContext * h,uint8_t * buf,int size)942 static int udp_read(URLContext *h, uint8_t *buf, int size)
943 {
944 UDPContext *s = h->priv_data;
945 int ret;
946 struct sockaddr_storage addr;
947 socklen_t addr_len = sizeof(addr);
948 #if HAVE_PTHREAD_CANCEL
949 int avail, nonblock = h->flags & AVIO_FLAG_NONBLOCK;
950
951 if (s->fifo) {
952 pthread_mutex_lock(&s->mutex);
953 do {
954 avail = av_fifo_size(s->fifo);
955 if (avail) { // >=size) {
956 uint8_t tmp[4];
957
958 av_fifo_generic_read(s->fifo, tmp, 4, NULL);
959 avail= AV_RL32(tmp);
960 if(avail > size){
961 av_log(h, AV_LOG_WARNING, "Part of datagram lost due to insufficient buffer size\n");
962 avail= size;
963 }
964
965 av_fifo_generic_read(s->fifo, buf, avail, NULL);
966 av_fifo_drain(s->fifo, AV_RL32(tmp) - avail);
967 pthread_mutex_unlock(&s->mutex);
968 return avail;
969 } else if(s->circular_buffer_error){
970 int err = s->circular_buffer_error;
971 pthread_mutex_unlock(&s->mutex);
972 return err;
973 } else if(nonblock) {
974 pthread_mutex_unlock(&s->mutex);
975 return AVERROR(EAGAIN);
976 }
977 else {
978 /* FIXME: using the monotonic clock would be better,
979 but it does not exist on all supported platforms. */
980 int64_t t = av_gettime() + 100000;
981 struct timespec tv = { .tv_sec = t / 1000000,
982 .tv_nsec = (t % 1000000) * 1000 };
983 int err = pthread_cond_timedwait(&s->cond, &s->mutex, &tv);
984 if (err) {
985 pthread_mutex_unlock(&s->mutex);
986 return AVERROR(err == ETIMEDOUT ? EAGAIN : err);
987 }
988 nonblock = 1;
989 }
990 } while( 1);
991 }
992 #endif
993
994 if (!(h->flags & AVIO_FLAG_NONBLOCK)) {
995 ret = ff_network_wait_fd(s->udp_fd, 0);
996 if (ret < 0)
997 return ret;
998 }
999 ret = recvfrom(s->udp_fd, buf, size, 0, (struct sockaddr *)&addr, &addr_len);
1000 if (ret < 0)
1001 return ff_neterrno();
1002 if (ff_ip_check_source_lists(&addr, &s->filters))
1003 return AVERROR(EINTR);
1004 return ret;
1005 }
1006
udp_write(URLContext * h,const uint8_t * buf,int size)1007 static int udp_write(URLContext *h, const uint8_t *buf, int size)
1008 {
1009 UDPContext *s = h->priv_data;
1010 int ret;
1011
1012 #if HAVE_PTHREAD_CANCEL
1013 if (s->fifo) {
1014 uint8_t tmp[4];
1015
1016 pthread_mutex_lock(&s->mutex);
1017
1018 /*
1019 Return error if last tx failed.
1020 Here we can't know on which packet error was, but it needs to know that error exists.
1021 */
1022 if (s->circular_buffer_error<0) {
1023 int err=s->circular_buffer_error;
1024 pthread_mutex_unlock(&s->mutex);
1025 return err;
1026 }
1027
1028 if(av_fifo_space(s->fifo) < size + 4) {
1029 /* What about a partial packet tx ? */
1030 pthread_mutex_unlock(&s->mutex);
1031 return AVERROR(ENOMEM);
1032 }
1033 AV_WL32(tmp, size);
1034 av_fifo_generic_write(s->fifo, tmp, 4, NULL); /* size of packet */
1035 av_fifo_generic_write(s->fifo, (uint8_t *)buf, size, NULL); /* the data */
1036 pthread_cond_signal(&s->cond);
1037 pthread_mutex_unlock(&s->mutex);
1038 return size;
1039 }
1040 #endif
1041 if (!(h->flags & AVIO_FLAG_NONBLOCK)) {
1042 ret = ff_network_wait_fd(s->udp_fd, 1);
1043 if (ret < 0)
1044 return ret;
1045 }
1046
1047 if (!s->is_connected) {
1048 ret = sendto (s->udp_fd, buf, size, 0,
1049 (struct sockaddr *) &s->dest_addr,
1050 s->dest_addr_len);
1051 } else
1052 ret = send(s->udp_fd, buf, size, 0);
1053
1054 return ret < 0 ? ff_neterrno() : ret;
1055 }
1056
udp_close(URLContext * h)1057 static int udp_close(URLContext *h)
1058 {
1059 UDPContext *s = h->priv_data;
1060
1061 #if HAVE_PTHREAD_CANCEL
1062 // Request close once writing is finished
1063 if (s->thread_started && !(h->flags & AVIO_FLAG_READ)) {
1064 pthread_mutex_lock(&s->mutex);
1065 s->close_req = 1;
1066 pthread_cond_signal(&s->cond);
1067 pthread_mutex_unlock(&s->mutex);
1068 }
1069 #endif
1070
1071 if (s->is_multicast && (h->flags & AVIO_FLAG_READ))
1072 udp_leave_multicast_group(s->udp_fd, (struct sockaddr *)&s->dest_addr,(struct sockaddr *)&s->local_addr_storage);
1073 #if HAVE_PTHREAD_CANCEL
1074 if (s->thread_started) {
1075 int ret;
1076 // Cancel only read, as write has been signaled as success to the user
1077 if (h->flags & AVIO_FLAG_READ) {
1078 #ifdef _WIN32
1079 /* recvfrom() is not a cancellation point for win32, so we shutdown
1080 * the socket and abort pending IO, subsequent recvfrom() calls
1081 * will fail with WSAESHUTDOWN causing the thread to exit. */
1082 shutdown(s->udp_fd, SD_RECEIVE);
1083 CancelIoEx((HANDLE)(SOCKET)s->udp_fd, NULL);
1084 #else
1085 pthread_cancel(s->circular_buffer_thread);
1086 #endif
1087 }
1088 ret = pthread_join(s->circular_buffer_thread, NULL);
1089 if (ret != 0)
1090 av_log(h, AV_LOG_ERROR, "pthread_join(): %s\n", strerror(ret));
1091 pthread_mutex_destroy(&s->mutex);
1092 pthread_cond_destroy(&s->cond);
1093 }
1094 #endif
1095 closesocket(s->udp_fd);
1096 av_fifo_freep(&s->fifo);
1097 ff_ip_reset_filters(&s->filters);
1098 return 0;
1099 }
1100
1101 const URLProtocol ff_udp_protocol = {
1102 .name = "udp",
1103 .url_open = udp_open,
1104 .url_read = udp_read,
1105 .url_write = udp_write,
1106 .url_close = udp_close,
1107 .url_get_file_handle = udp_get_file_handle,
1108 .priv_data_size = sizeof(UDPContext),
1109 .priv_data_class = &udp_class,
1110 .flags = URL_PROTOCOL_FLAG_NETWORK,
1111 };
1112
1113 const URLProtocol ff_udplite_protocol = {
1114 .name = "udplite",
1115 .url_open = udplite_open,
1116 .url_read = udp_read,
1117 .url_write = udp_write,
1118 .url_close = udp_close,
1119 .url_get_file_handle = udp_get_file_handle,
1120 .priv_data_size = sizeof(UDPContext),
1121 .priv_data_class = &udplite_context_class,
1122 .flags = URL_PROTOCOL_FLAG_NETWORK,
1123 };
1124