Go to the documentation of this file.
23 #include "config_components.h"
52 #define BUFFER_SIZE (MAX_URL_SIZE + HTTP_HEADERS_SIZE)
53 #define MAX_REDIRECTS 8
54 #define MAX_CACHED_REDIRECTS 32
58 #define WHITESPACES " \n\t\r"
115 z_stream inflate_stream;
116 uint8_t *inflate_buffer;
141 #define OFFSET(x) offsetof(HTTPContext, x)
142 #define D AV_OPT_FLAG_DECODING_PARAM
143 #define E AV_OPT_FLAG_ENCODING_PARAM
144 #define DEFAULT_USER_AGENT "Lavf/" AV_STRINGIFY(LIBAVFORMAT_VERSION)
147 {
"seekable",
"control seekability of connection",
OFFSET(seekable),
AV_OPT_TYPE_BOOL, { .i64 = -1 }, -1, 1,
D },
148 {
"chunked_post",
"use chunked transfer-encoding for posts",
OFFSET(chunked_post),
AV_OPT_TYPE_BOOL, { .i64 = 1 }, 0, 1,
E },
154 {
"multiple_requests",
"use persistent connections",
OFFSET(multiple_requests),
AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1,
D |
E },
158 {
"cookies",
"set cookies to be sent in applicable future requests, use newline delimited Set-Cookie HTTP field value syntax",
OFFSET(cookies),
AV_OPT_TYPE_STRING, { .str =
NULL }, 0, 0,
D },
164 {
"none",
"No auth method set, autodetect", 0,
AV_OPT_TYPE_CONST, { .i64 =
HTTP_AUTH_NONE }, 0, 0,
D |
E,
"auth_type"},
166 {
"send_expect_100",
"Force sending an Expect: 100-continue header for POST",
OFFSET(send_expect_100),
AV_OPT_TYPE_BOOL, { .i64 = -1 }, -1, 1,
E },
169 {
"end_offset",
"try to limit the request to bytes preceding this offset",
OFFSET(end_off),
AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, INT64_MAX,
D },
170 {
"method",
"Override the HTTP method or set the expected HTTP method from a client",
OFFSET(method),
AV_OPT_TYPE_STRING, { .str =
NULL }, 0, 0,
D |
E },
171 {
"reconnect",
"auto reconnect after disconnect before EOF",
OFFSET(reconnect),
AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1,
D },
172 {
"reconnect_at_eof",
"auto reconnect at EOF",
OFFSET(reconnect_at_eof),
AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1,
D },
173 {
"reconnect_on_network_error",
"auto reconnect in case of tcp/tls error during connect",
OFFSET(reconnect_on_network_error),
AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1,
D },
174 {
"reconnect_on_http_error",
"list of http status codes to reconnect on",
OFFSET(reconnect_on_http_error),
AV_OPT_TYPE_STRING, { .str =
NULL }, 0, 0,
D },
175 {
"reconnect_streamed",
"auto reconnect streamed / non seekable streams",
OFFSET(reconnect_streamed),
AV_OPT_TYPE_BOOL, { .i64 = 0 }, 0, 1,
D },
176 {
"reconnect_delay_max",
"max reconnect delay in seconds after which to give up",
OFFSET(reconnect_delay_max),
AV_OPT_TYPE_INT, { .i64 = 120 }, 0, UINT_MAX/1000/1000,
D },
179 {
"reply_code",
"The http status code to return to a client",
OFFSET(reply_code),
AV_OPT_TYPE_INT, { .i64 = 200}, INT_MIN, 599,
E},
180 {
"short_seek_size",
"Threshold to favor readahead over seek.",
OFFSET(short_seek_size),
AV_OPT_TYPE_INT, { .i64 = 0 }, 0, INT_MAX,
D },
185 const char *hoststr,
const char *auth,
186 const char *proxyauth);
202 const char *path, *proxy_path, *lower_proto =
"tcp", *local_path;
203 char *env_http_proxy, *env_no_proxy;
205 char hostname[1024], hoststr[1024], proto[10];
206 char auth[1024], proxyauth[1024] =
"";
209 int port, use_proxy, err = 0;
213 hostname,
sizeof(hostname), &port,
214 path1,
sizeof(path1),
s->location);
218 proxy_path =
s->http_proxy ?
s->http_proxy : env_http_proxy;
225 if (!strcmp(proto,
"https")) {
240 hashmark = strchr(path1,
'#');
244 if (path1[0] ==
'\0') {
246 }
else if (path1[0] ==
'?') {
247 snprintf(sanitized_path,
sizeof(sanitized_path),
"/%s", path1);
248 path = sanitized_path;
260 hostname,
sizeof(hostname), &port,
NULL, 0, proxy_path);
268 h->protocol_whitelist,
h->protocol_blacklist,
h);
274 h, path, local_path, hoststr, auth, proxyauth);
279 const char *status_group;
288 status_group =
"4xx";
292 status_group =
"5xx";
296 return s->reconnect_on_network_error;
299 if (!
s->reconnect_on_http_error)
302 if (
av_match_list(status_group,
s->reconnect_on_http_error,
',') > 0)
305 snprintf(http_code,
sizeof(http_code),
"%d",
s->http_code);
307 return av_match_list(http_code,
s->reconnect_on_http_error,
',') > 0;
321 delim = strchr(
re->value,
';');
326 expiry = strtoll(
re->value,
NULL, 10);
327 if (time(
NULL) > expiry) {
356 int ret, attempts = 0, redirects = 0;
357 int reconnect_delay = 0;
376 cur_auth_type =
s->auth_state.auth_type;
377 cur_proxy_auth_type =
s->auth_state.auth_type;
383 reconnect_delay >
s->reconnect_delay_max)
390 reconnect_delay = 1 + 2 * reconnect_delay;
400 if (
s->http_code == 401) {
408 if (
s->http_code == 407) {
409 if ((cur_proxy_auth_type ==
HTTP_AUTH_NONE ||
s->proxy_auth_state.stale) &&
416 if ((
s->http_code == 301 ||
s->http_code == 302 ||
417 s->http_code == 303 ||
s->http_code == 307 ||
s->http_code == 308) &&
425 s->expires = (
s->http_code == 301 ||
s->http_code == 308) ? INT64_MAX : -1;
433 s->location =
s->new_location;
434 s->new_location =
NULL;
438 memset(&
s->auth_state, 0,
sizeof(
s->auth_state));
461 char hostname1[1024], hostname2[1024], proto1[10], proto2[10];
465 !(!strcmp(
h->prot->name,
"http") ||
466 !strcmp(
h->prot->name,
"https")))
470 hostname1,
sizeof(hostname1), &port1,
471 NULL, 0,
s->location);
473 hostname2,
sizeof(hostname2), &port2,
475 if (port1 != port2 || strncmp(hostname1, hostname2,
sizeof(hostname2)) != 0) {
476 av_log(
h,
AV_LOG_ERROR,
"Cannot reuse HTTP connection for different host: %s:%d != %s:%d\n",
483 if (!
s->end_chunked_post) {
492 s->end_chunked_post = 0;
495 s->icy_data_read = 0;
518 switch (status_code) {
525 if (status_code >= 400 && status_code <= 499)
527 else if (status_code >= 500)
530 return default_averror;
535 int ret,
body = 0, reply_code, message_len;
536 const char *reply_text, *content_type;
539 content_type =
"text/plain";
543 switch (status_code) {
547 reply_text =
"Bad Request";
552 reply_text =
"Forbidden";
557 reply_text =
"Not Found";
562 content_type =
s->content_type ?
s->content_type :
"application/octet-stream";
567 reply_text =
"Internal server error";
575 "HTTP/1.1 %03d %s\r\n"
576 "Content-Type: %s\r\n"
584 strlen(reply_text) + 6,
585 s->headers ?
s->headers :
"",
591 "HTTP/1.1 %03d %s\r\n"
592 "Content-Type: %s\r\n"
593 "Transfer-Encoding: chunked\r\n"
599 s->headers ?
s->headers :
"");
653 char hostname[1024], proto[10];
655 const char *lower_proto =
"tcp";
657 av_url_split(proto,
sizeof(proto),
NULL, 0, hostname,
sizeof(hostname), &port,
659 if (!strcmp(proto,
"https"))
661 ff_url_join(lower_url,
sizeof(lower_url), lower_proto,
NULL, hostname, port,
667 h->protocol_whitelist,
h->protocol_blacklist,
h
687 if(
s->seekable == 1 )
692 s->filesize = UINT64_MAX;
706 int len = strlen(
s->headers);
707 if (
len < 2 || strcmp(
"\r\n",
s->headers +
len - 2)) {
709 "No trailing CRLF found in HTTP header. Adding it.\n");
713 s->headers[
len] =
'\r';
714 s->headers[
len + 1] =
'\n';
715 s->headers[
len + 2] =
'\0';
745 cc = (*c)->priv_data;
761 if (
s->buf_ptr >=
s->buf_end) {
765 }
else if (
len == 0) {
768 s->buf_ptr =
s->buffer;
769 s->buf_end =
s->buffer +
len;
772 return *
s->buf_ptr++;
787 if (q >
line && q[-1] ==
'\r')
793 if ((q -
line) < line_size - 1)
804 if (http_code >= 400 && http_code < 600 &&
806 (http_code != 407 ||
s->proxy_auth_state.auth_type !=
HTTP_AUTH_NONE)) {
820 s->new_location =
av_strdup(redirected_location);
821 if (!
s->new_location)
832 if (!strncmp(p,
"bytes ", 6)) {
834 s->off = strtoull(p,
NULL, 10);
835 if ((slash = strchr(p,
'/')) && strlen(slash) > 0)
836 s->filesize_from_content_range = strtoull(slash + 1,
NULL, 10);
838 if (
s->seekable == -1 && (!
s->is_akamai ||
s->filesize != 2147483647))
850 inflateEnd(&
s->inflate_stream);
851 if (inflateInit2(&
s->inflate_stream, 32 + 15) != Z_OK) {
853 s->inflate_stream.msg);
856 if (zlibCompileFlags() & (1 << 17)) {
858 "Your zlib was compiled without gzip support.\n");
863 "Compressed (%s) content, need zlib with gzip support\n", p);
878 int len = 4 + strlen(p) + strlen(
tag);
879 int is_first = !
s->icy_metadata_headers;
884 if (
s->icy_metadata_headers)
885 len += strlen(
s->icy_metadata_headers);
891 *
s->icy_metadata_headers =
'\0';
905 for (
i = 0, j = 0; exp_str[
i] !=
'\0' && j < exp_buf_len;
i++) {
906 if ((exp_str[
i] >=
'0' && exp_str[
i] <=
'9') ||
907 (exp_str[
i] >=
'A' && exp_str[
i] <=
'Z') ||
908 (exp_str[
i] >=
'a' && exp_str[
i] <=
'z')) {
909 exp_buf[j] = exp_str[
i];
917 while ((*expiry < '0' || *expiry >
'9') && *expiry !=
'\0')
925 char *param, *next_param, *cstr, *back;
926 char *saveptr =
NULL;
935 back = &cstr[strlen(cstr)-1];
944 while ((param =
av_strtok(next_param,
";", &saveptr))) {
972 if (!cookie_entry || !cookie_entry->
value) {
979 struct tm new_tm = {0};
991 if (e2 && e2->
value) {
995 if (e2 && e2->
value) {
996 struct tm old_tm = {0};
1013 if (!(eql = strchr(p,
'=')))
return AVERROR(EINVAL);
1033 if (*cookies)
av_free(*cookies);
1035 if (!*cookies)
return AVERROR(ENOMEM);
1085 char *
tag, *p, *end, *method, *resource, *
version;
1089 if (
line[0] ==
'\0') {
1095 if (line_count == 0) {
1096 if (
s->is_connected_server) {
1105 av_log(
h,
AV_LOG_ERROR,
"Received and expected HTTP method do not match. (%s expected, %s received)\n",
1114 "(%s autodetected %s received)\n", auto_method, method);
1147 while (*p !=
'/' && *p !=
'\0')
1157 s->http_code = strtol(p, &end, 10);
1165 while (*p !=
'\0' && *p !=
':')
1179 s->filesize == UINT64_MAX) {
1180 s->filesize = strtoull(p,
NULL, 10);
1184 !strncmp(p,
"bytes", 5) &&
1185 s->seekable == -1) {
1189 s->filesize = UINT64_MAX;
1198 if (!strcmp(p,
"close"))
1204 s->is_mediagateway = 1;
1213 s->icy_metaint = strtoull(p,
NULL, 10);
1243 char *cookie, *set_cookies, *next;
1244 char *saveptr =
NULL;
1257 while ((cookie =
av_strtok(next,
"\n", &saveptr)) && !
ret) {
1272 if (!cookie_entry || !cookie_entry->
value)
1277 struct tm tm_buf = {0};
1287 int domain_offset = strlen(domain) - strlen(e->
value);
1288 if (domain_offset < 0)
1305 char *
tmp = *cookies;
1337 s->chunksize = UINT64_MAX;
1338 s->filesize_from_content_range = UINT64_MAX;
1355 if (
s->filesize_from_content_range != UINT64_MAX)
1356 s->filesize =
s->filesize_from_content_range;
1358 if (
s->seekable == -1 &&
s->is_mediagateway &&
s->filesize == 2000000000)
1377 #define NEEDS_ESCAPE(ch) \
1378 ((ch) <= ' ' || (ch) >= '\x7f' || \
1379 (ch) == '"' || (ch) == '%' || (ch) == '<' || (ch) == '>' || (ch) == '\\' || \
1380 (ch) == '^' || (ch) == '`' || (ch) == '{' || (ch) == '}' || (ch) == '|')
1384 while (*path && q - buf <
sizeof(buf) - 4) {
1390 q +=
snprintf(q, 4,
"%%%02X", (uint8_t)*path++);
1400 const char *hoststr,
const char *auth,
1401 const char *proxyauth)
1406 char *authstr =
NULL, *proxyauthstr =
NULL;
1407 uint64_t off =
s->off;
1409 int send_expect_100 = 0;
1420 s->chunked_post = 0;
1426 method = post ?
"POST" :
"GET";
1429 local_path, method);
1431 local_path, method);
1433 if (post && !
s->post_data) {
1434 if (
s->send_expect_100 != -1) {
1435 send_expect_100 =
s->send_expect_100;
1437 send_expect_100 = 0;
1442 if (auth && *auth &&
1444 s->http_code != 401)
1445 send_expect_100 = 1;
1453 if (post &&
s->chunked_post)
1454 av_bprintf(&request,
"Transfer-Encoding: chunked\r\n");
1457 av_bprintf(&request,
"User-Agent: %s\r\n",
s->user_agent);
1461 av_bprintf(&request,
"Referer: %s\r\n",
s->referer);
1468 if (!
has_header(
s->headers,
"\r\nRange: ") && !post && (
s->off > 0 ||
s->end_off ||
s->seekable != 0)) {
1469 av_bprintf(&request,
"Range: bytes=%"PRIu64
"-",
s->off);
1474 if (send_expect_100 && !
has_header(
s->headers,
"\r\nExpect: "))
1475 av_bprintf(&request,
"Expect: 100-continue\r\n");
1478 av_bprintf(&request,
"Connection: %s\r\n",
s->multiple_requests ?
"keep-alive" :
"close");
1481 av_bprintf(&request,
"Host: %s\r\n", hoststr);
1482 if (!
has_header(
s->headers,
"\r\nContent-Length: ") &&
s->post_data)
1483 av_bprintf(&request,
"Content-Length: %d\r\n",
s->post_datalen);
1485 if (!
has_header(
s->headers,
"\r\nContent-Type: ") &&
s->content_type)
1486 av_bprintf(&request,
"Content-Type: %s\r\n",
s->content_type);
1487 if (!
has_header(
s->headers,
"\r\nCookie: ") &&
s->cookies) {
1488 char *cookies =
NULL;
1489 if (!
get_cookies(
s, &cookies, path, hoststr) && cookies) {
1490 av_bprintf(&request,
"Cookie: %s\r\n", cookies);
1494 if (!
has_header(
s->headers,
"\r\nIcy-MetaData: ") &&
s->icy)
1504 av_bprintf(&request,
"Proxy-%s", proxyauthstr);
1515 if ((err =
ffurl_write(
s->hd, request.str, request.len)) < 0)
1519 if ((err =
ffurl_write(
s->hd,
s->post_data,
s->post_datalen)) < 0)
1523 s->buf_ptr =
s->buffer;
1524 s->buf_end =
s->buffer;
1527 s->icy_data_read = 0;
1528 s->filesize = UINT64_MAX;
1530 s->end_chunked_post = 0;
1535 if (post && !
s->post_data && !send_expect_100) {
1549 if (
s->new_location)
1552 err = (off ==
s->off) ? 0 : -1;
1564 if (
s->chunksize != UINT64_MAX) {
1568 if (!
s->chunksize) {
1577 s->chunksize = strtoull(
line,
NULL, 16);
1580 "Chunked encoding data size: %"PRIu64
"\n",
1583 if (!
s->chunksize &&
s->multiple_requests) {
1588 else if (!
s->chunksize) {
1593 else if (
s->chunksize == UINT64_MAX) {
1603 len =
s->buf_end -
s->buf_ptr;
1607 memcpy(buf,
s->buf_ptr,
len);
1610 uint64_t target_end =
s->end_off ?
s->end_off :
s->filesize;
1611 if ((!
s->willclose ||
s->chunksize == UINT64_MAX) &&
s->off >= target_end)
1615 (!
s->willclose ||
s->chunksize == UINT64_MAX) &&
s->off < target_end) {
1617 "Stream ends prematurely at %"PRIu64
", should be %"PRIu64
"\n",
1625 if (
s->chunksize > 0 &&
s->chunksize != UINT64_MAX) {
1627 s->chunksize -=
len;
1634 #define DECOMPRESS_BUF_SIZE (256 * 1024)
1635 static int http_buf_read_compressed(
URLContext *
h, uint8_t *buf,
int size)
1640 if (!
s->inflate_buffer) {
1641 s->inflate_buffer =
av_malloc(DECOMPRESS_BUF_SIZE);
1642 if (!
s->inflate_buffer)
1646 if (
s->inflate_stream.avail_in == 0) {
1650 s->inflate_stream.next_in =
s->inflate_buffer;
1651 s->inflate_stream.avail_in = read;
1654 s->inflate_stream.avail_out =
size;
1655 s->inflate_stream.next_out = buf;
1658 if (
ret != Z_OK &&
ret != Z_STREAM_END)
1660 ret,
s->inflate_stream.msg);
1662 return size -
s->inflate_stream.avail_out;
1673 int reconnect_delay = 0;
1678 if (
s->end_chunked_post && !
s->end_header) {
1686 return http_buf_read_compressed(
h, buf,
size);
1689 while (read_ret < 0) {
1690 uint64_t target =
h->is_streamed ? 0 :
s->off;
1695 if (
h->is_streamed && !
s->reconnect_streamed)
1698 if (!(
s->reconnect &&
s->filesize > 0 &&
s->off <
s->filesize) &&
1702 if (reconnect_delay >
s->reconnect_delay_max)
1707 if (err !=
AVERROR(ETIMEDOUT))
1709 reconnect_delay = 1 + 2*reconnect_delay;
1711 if (seek_ret >= 0 && seek_ret != target) {
1749 end = strstr(
val,
"';");
1770 if (
s->icy_metaint <
s->icy_data_read)
1772 remaining =
s->icy_metaint -
s->icy_data_read;
1784 char data[255 * 16 + 1];
1795 s->icy_data_read = 0;
1796 remaining =
s->icy_metaint;
1806 if (
s->icy_metaint > 0) {
1814 s->icy_data_read +=
size;
1823 char crlf[] =
"\r\n";
1826 if (!
s->chunked_post) {
1848 char footer[] =
"0\r\n\r\n";
1863 if (read_ret < 0 && read_ret !=
AVERROR(EAGAIN)) {
1868 s->end_chunked_post = 1;
1880 inflateEnd(&
s->inflate_stream);
1884 if (
s->hd && !
s->end_chunked_post)
1902 uint64_t old_off =
s->off;
1904 int old_buf_size,
ret;
1909 else if (!force_reconnect &&
1910 ((whence == SEEK_CUR && off == 0) ||
1911 (whence == SEEK_SET && off ==
s->off)))
1913 else if ((
s->filesize == UINT64_MAX && whence == SEEK_END))
1916 if (whence == SEEK_CUR)
1918 else if (whence == SEEK_END)
1920 else if (whence != SEEK_SET)
1926 if (
s->off &&
h->is_streamed)
1930 if (
s->end_off ||
s->filesize != UINT64_MAX) {
1931 uint64_t end_pos =
s->end_off ?
s->end_off :
s->filesize;
1932 if (
s->off >= end_pos)
1937 if (strcmp(
s->uri,
s->location)) {
1943 s->location = new_uri;
1947 old_buf_size =
s->buf_end -
s->buf_ptr;
1948 memcpy(old_buf,
s->buf_ptr, old_buf_size);
1954 memcpy(
s->buffer, old_buf, old_buf_size);
1955 s->buf_ptr =
s->buffer;
1956 s->buf_end =
s->buffer + old_buf_size;
1980 if (
s->short_seek_size >= 1)
1981 return s->short_seek_size;
1985 #define HTTP_CLASS(flavor) \
1986 static const AVClass flavor ## _context_class = { \
1987 .class_name = # flavor, \
1988 .item_name = av_default_item_name, \
1989 .option = options, \
1990 .version = LIBAVUTIL_VERSION_INT, \
1993 #if CONFIG_HTTP_PROTOCOL
2009 .priv_data_class = &http_context_class,
2011 .default_whitelist =
"http,https,tls,rtp,tcp,udp,crypto,httpproxy,data"
2015 #if CONFIG_HTTPS_PROTOCOL
2029 .priv_data_class = &https_context_class,
2031 .default_whitelist =
"http,https,tls,rtp,tcp,udp,crypto,httpproxy"
2035 #if CONFIG_HTTPPROXY_PROTOCOL
2047 char hostname[1024], hoststr[1024];
2048 char auth[1024], pathbuf[1024], *path;
2049 char lower_url[100];
2050 int port,
ret = 0, attempts = 0;
2054 if(
s->seekable == 1 )
2059 av_url_split(
NULL, 0, auth,
sizeof(auth), hostname,
sizeof(hostname), &port,
2060 pathbuf,
sizeof(pathbuf), uri);
2066 ff_url_join(lower_url,
sizeof(lower_url),
"tcp",
NULL, hostname, port,
2070 &
h->interrupt_callback,
NULL,
2071 h->protocol_whitelist,
h->protocol_blacklist,
h);
2078 "CONNECT %s HTTP/1.1\r\n"
2080 "Connection: close\r\n"
2085 authstr ?
"Proxy-" :
"", authstr ? authstr :
"");
2091 s->buf_ptr =
s->buffer;
2092 s->buf_end =
s->buffer;
2094 s->filesize = UINT64_MAX;
2095 cur_auth_type =
s->proxy_auth_state.auth_type;
2111 if (
s->http_code == 407 &&
2118 if (
s->http_code < 400)
2123 http_proxy_close(
h);
2127 static int http_proxy_write(
URLContext *
h,
const uint8_t *buf,
int size)
2134 .
name =
"httpproxy",
2135 .url_open = http_proxy_open,
2137 .url_write = http_proxy_write,
2138 .url_close = http_proxy_close,
static char * redirect_cache_get(HTTPContext *s)
static void error(const char *err)
@ HTTP_AUTH_BASIC
HTTP 1.0 Basic auth from RFC 1945 (also in RFC 2617)
static av_const int av_isxdigit(int c)
Locale-independent conversion of ASCII isxdigit.
#define AV_LOG_WARNING
Something somehow does not look correct.
static int http_open_cnx(URLContext *h, AVDictionary **options)
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default minimum maximum flags name is the option name
Filter the word “frame” indicates either a video frame or a group of audio as stored in an AVFrame structure Format for each input and each output the list of supported formats For video that means pixel format For audio that means channel sample they are references to shared objects When the negotiation mechanism computes the intersection of the formats supported at each end of a all references to both lists are replaced with a reference to the intersection And when a single format is eventually chosen for a link amongst the remaining all references to the list are updated That means that if a filter requires that its input and output have the same format amongst a supported all it has to do is use a reference to the same list of formats query_formats can leave some formats unset and return AVERROR(EAGAIN) to cause the negotiation mechanism toagain later. That can be used by filters with complex requirements to use the format negotiated on one link to set the formats supported on another. Frame references ownership and permissions
#define AV_OPT_FLAG_READONLY
The option may not be set through the AVOptions API, only read.
static int http_write_reply(URLContext *h, int status_code)
#define URL_PROTOCOL_FLAG_NETWORK
#define AVERROR_HTTP_OTHER_4XX
static int parse_icy(HTTPContext *s, const char *tag, const char *p)
char * av_stristr(const char *s1, const char *s2)
Locate the first case-independent occurrence in the string haystack of the string needle.
#define AVERROR_EOF
End of file.
#define AVIO_FLAG_READ_WRITE
read-write pseudo flag
int av_dict_count(const AVDictionary *m)
Get number of entries in dictionary.
static void bprint_escaped_path(AVBPrint *bp, const char *path)
Escape unsafe characters in path in order to pass them safely to the HTTP request.
static int http_listen(URLContext *h, const char *uri, int flags, AVDictionary **options)
char * av_asprintf(const char *fmt,...)
int seekable
Control seekability, 0 = disable, 1 = enable, -1 = probe.
int av_strcasecmp(const char *a, const char *b)
Locale-independent case-insensitive compare.
static av_const int av_isspace(int c)
Locale-independent conversion of ASCII isspace.
static int http_read(URLContext *h, uint8_t *buf, int size)
static int64_t http_seek_internal(URLContext *h, int64_t off, int whence, int force_reconnect)
static void parse_cache_control(HTTPContext *s, const char *p)
#define AVERROR_HTTP_SERVER_ERROR
#define AVSEEK_SIZE
ORing this as the "whence" parameter to a seek function causes it to return the filesize without seek...
#define AV_DICT_IGNORE_SUFFIX
Return first entry in a dictionary whose first part corresponds to the search key,...
#define AV_LOG_VERBOSE
Detailed information.
static void freeenv_utf8(char *var)
static int http_get_line(HTTPContext *s, char *line, int line_size)
int ffurl_close(URLContext *h)
void av_bprint_append_data(AVBPrint *buf, const char *data, unsigned size)
Append data to a print buffer.
AVDictionary * chained_options
static int parse_location(HTTPContext *s, const char *p)
static int http_read_stream(URLContext *h, uint8_t *buf, int size)
char * ff_http_auth_create_response(HTTPAuthState *state, const char *auth, const char *path, const char *method)
size_t av_strlcatf(char *dst, size_t size, const char *fmt,...)
const URLProtocol ff_httpproxy_protocol
#define AVERROR_HTTP_UNAUTHORIZED
static int get_cookies(HTTPContext *s, char **cookies, const char *path, const char *domain)
Create a string containing cookie values for use as a HTTP cookie header field value for a particular...
@ AV_OPT_TYPE_BINARY
offset must point to a pointer immediately followed by an int for the length
static int check_http_code(URLContext *h, int http_code, const char *end)
#define DEFAULT_USER_AGENT
static void inflate(uint8_t *dst, const uint8_t *p1, int width, int threshold, const uint8_t *coordinates[], int coord, int maxc)
static int cookie_string(AVDictionary *dict, char **cookies)
static int has_header(const char *str, const char *header)
static int redirect_cache_set(HTTPContext *s, const char *source, const char *dest, int64_t expiry)
static double val(void *priv, double ch)
time_t av_timegm(struct tm *tm)
Convert the decomposed UTC time in tm to a time_t value.
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
#define AV_DICT_DONT_STRDUP_VAL
Take ownership of a value that's been allocated with av_malloc() or another memory allocation functio...
#define AV_LOG_TRACE
Extremely verbose debugging, useful for libav* development.
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
#define AVERROR_HTTP_NOT_FOUND
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
int av_opt_set_dict(void *obj, AVDictionary **options)
Set all the options from a given dictionary on an object.
int ffurl_open_whitelist(URLContext **puc, const char *filename, int flags, const AVIOInterruptCB *int_cb, AVDictionary **options, const char *whitelist, const char *blacklist, URLContext *parent)
Create an URLContext for accessing to the resource indicated by url, and open it.
char * cookies
holds newline ( ) delimited Set-Cookie header field values (without the "Set-Cookie: " field name)
char * av_strtok(char *s, const char *delim, char **saveptr)
Split the string into several tokens which can be accessed by successive calls to av_strtok().
int ff_url_join(char *str, int size, const char *proto, const char *authorization, const char *hostname, int port, const char *fmt,...)
#define av_assert0(cond)
assert() equivalent, that is always enabled.
#define AVIO_FLAG_WRITE
write-only
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
static int process_line(URLContext *h, char *line, int line_count)
int reconnect_on_network_error
int av_stristart(const char *str, const char *pfx, const char **ptr)
Return non-zero if pfx is a prefix of str independent of case.
static int parse_cookie(HTTPContext *s, const char *p, AVDictionary **cookies)
int ff_http_match_no_proxy(const char *no_proxy, const char *hostname)
void ff_http_auth_handle_header(HTTPAuthState *state, const char *key, const char *value)
static int parse_content_encoding(URLContext *h, const char *p)
static void handle_http_errors(URLContext *h, int error)
unsigned char buffer[BUFFER_SIZE]
int ff_http_do_new_request(URLContext *h, const char *uri)
Send a new HTTP request, reusing the old connection.
int ffurl_accept(URLContext *s, URLContext **c)
Accept an URLContext c on an URLContext s.
static int http_read_stream_all(URLContext *h, uint8_t *buf, int size)
Describe the class of an AVClass context structure.
static int http_get_short_seek(URLContext *h)
int av_match_list(const char *name, const char *list, char separator)
Check if a name is in a list.
void ff_http_init_auth_state(URLContext *dest, const URLContext *src)
Initialize the authentication state based on another HTTP URLContext.
int ff_http_do_new_request2(URLContext *h, const char *uri, AVDictionary **opts)
Send a new HTTP request, reusing the old connection.
HTTPAuthState proxy_auth_state
static char * getenv_utf8(const char *varname)
static int http_buf_read(URLContext *h, uint8_t *buf, int size)
static int http_shutdown(URLContext *h, int flags)
static void parse_content_range(URLContext *h, const char *p)
#define AVERROR_HTTP_BAD_REQUEST
Undefined Behavior In the C some operations are like signed integer dereferencing freed accessing outside allocated Undefined Behavior must not occur in a C it is not safe even if the output of undefined operations is unused The unsafety may seem nit picking but Optimizing compilers have in fact optimized code on the assumption that no undefined Behavior occurs Optimizing code based on wrong assumptions can and has in some cases lead to effects beyond the output of computations The signed integer overflow problem in speed critical code Code which is highly optimized and works with signed integers sometimes has the problem that often the output of the computation does not c
static int av_bprint_is_complete(const AVBPrint *buf)
Test if the print buffer is complete (not truncated).
HTTP Authentication state structure.
these buffered frames must be flushed immediately if a new input produces new the filter must not call request_frame to get more It must just process the frame or queue it The task of requesting more frames is left to the filter s request_frame method or the application If a filter has several the filter must be ready for frames arriving randomly on any input any filter with several inputs will most likely require some kind of queuing mechanism It is perfectly acceptable to have a limited queue and to drop frames when the inputs are too unbalanced request_frame For filters that do not use the this method is called when a frame is wanted on an output For a source
s EdgeDetect Foobar g libavfilter vf_edgedetect c libavfilter vf_foobar c edit libavfilter and add an entry for foobar following the pattern of the other filters edit libavfilter allfilters and add an entry for foobar following the pattern of the other filters configure make j< whatever > ffmpeg ffmpeg i http
int ff_http_averror(int status_code, int default_averror)
int av_strncasecmp(const char *a, const char *b, size_t n)
Locale-independent case-insensitive compare.
uint64_t filesize_from_content_range
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
static void parse_expires(HTTPContext *s, const char *p)
int av_reallocp(void *ptr, size_t size)
Allocate, reallocate, or free a block of memory through a pointer to a pointer.
static int http_write(URLContext *h, const uint8_t *buf, int size)
static const uint8_t header[24]
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf offset
void av_dict_free(AVDictionary **pm)
Free all the memory allocated for an AVDictionary struct and all keys and values.
int av_strstart(const char *str, const char *pfx, const char **ptr)
Return non-zero if pfx is a prefix of str.
char * icy_metadata_packet
const URLProtocol ff_http_protocol
static int parse_set_cookie_expiry_time(const char *exp_str, struct tm *buf)
#define AV_LOG_INFO
Standard information.
static void update_metadata(URLContext *h, char *data)
void av_bprint_init_for_buffer(AVBPrint *buf, char *buffer, unsigned size)
Init a print buffer using a pre-existing buffer.
int ffurl_get_short_seek(URLContext *h)
Return the current short seek threshold value for this URL.
int ffurl_alloc(URLContext **puc, const char *filename, int flags, const AVIOInterruptCB *int_cb)
Create a URLContext for accessing to the resource indicated by url, but do not initiate the connectio...
static int http_should_reconnect(HTTPContext *s, int err)
static int http_handshake(URLContext *c)
@ HTTP_AUTH_NONE
No authentication specified.
static int http_open(URLContext *h, const char *uri, int flags, AVDictionary **options)
#define i(width, name, range_min, range_max)
static int http_connect(URLContext *h, const char *path, const char *local_path, const char *hoststr, const char *auth, const char *proxyauth)
int ff_network_sleep_interruptible(int64_t timeout, AVIOInterruptCB *int_cb)
Waits for up to 'timeout' microseconds.
static int parse_set_cookie(const char *set_cookie, AVDictionary **dict)
static int64_t http_seek(URLContext *h, int64_t off, int whence)
static const AVOption options[]
it s the only field you need to keep assuming you have a context There is some magic you don t need to care about around this just let it vf default value
void av_url_split(char *proto, int proto_size, char *authorization, int authorization_size, char *hostname, int hostname_size, int *port_ptr, char *path, int path_size, const char *url)
Split a URL string into components.
static int http_open_cnx_internal(URLContext *h, AVDictionary **options)
static int http_close(URLContext *h)
int ffurl_closep(URLContext **hh)
Close the resource accessed by the URLContext h, and free the memory used by it.
HandshakeState handshake_step
const URLProtocol ff_https_protocol
AVIOInterruptCB interrupt_callback
void av_bprintf(AVBPrint *buf, const char *fmt,...)
AVDictionary * cookie_dict
#define AV_DICT_MATCH_CASE
Only get an entry with exact-case key match.
char * av_small_strptime(const char *p, const char *fmt, struct tm *dt)
Simplified version of strptime.
#define AV_OPT_FLAG_EXPORT
The option is intended for exporting values to the caller.
int ffurl_read(URLContext *h, unsigned char *buf, int size)
Read up to size bytes from the resource accessed by h, and store the read bytes in buf.
FFmpeg currently uses a custom build this text attempts to document some of its obscure features and options Makefile the full command issued by make and its output will be shown on the screen DBG Preprocess x86 external assembler files to a dbg asm file in the object which then gets compiled Helps in developing those assembler files DESTDIR Destination directory for the install useful to prepare packages or install FFmpeg in cross environments GEN Set to ‘1’ to generate the missing or mismatched references Makefile builds all the libraries and the executables fate Run the fate test note that you must have installed it fate list List all fate regression test targets install Install headers
static int http_read_header(URLContext *h)
#define AVERROR_HTTP_FORBIDDEN
int ffurl_write(URLContext *h, const unsigned char *buf, int size)
Write size bytes from buf to the resource accessed by h.
#define HTTP_CLASS(flavor)
static void body(uint32_t ABCD[4], const uint8_t *src, size_t nblocks)
static int http_get_file_handle(URLContext *h)
s EdgeDetect Foobar g libavfilter vf_edgedetect c libavfilter vf_foobar c edit libavfilter and add an entry for foobar following the pattern of the other filters edit libavfilter allfilters and add an entry for foobar following the pattern of the other filters configure make j< whatever > ffmpeg ffmpeg i you should get a foobar png with Lena edge detected That s your new playground is ready Some little details about what s going which in turn will define variables for the build system and the and we are assuming vf_foobar is as well We are also assuming vf_foobar is not an edge detector so you can update the boilerplate with your credits Doxy Next chunk is the Doxygen about the file See https
int64_t av_gettime(void)
Get the current time in microseconds.
int av_dict_set_int(AVDictionary **pm, const char *key, int64_t value, int flags)
Convenience wrapper for av_dict_set that converts the value to a string and stores it.
HTTPAuthType
Authentication types, ordered from weakest to strongest.
#define AVIO_FLAG_READ
read-only
char * av_strdup(const char *s)
Duplicate a string.
int ffurl_handshake(URLContext *c)
Perform one step of the protocol handshake to accept a new client.
int ff_make_absolute_url(char *buf, int size, const char *base, const char *rel)
Convert a relative url into an absolute url, given a base url.
#define MAX_CACHED_REDIRECTS
#define AVIO_FLAG_NONBLOCK
Use non-blocking mode.
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
int av_dict_copy(AVDictionary **dst, const AVDictionary *src, int flags)
Copy entries from one AVDictionary struct into another.
static int http_getc(HTTPContext *s)
static int http_accept(URLContext *s, URLContext **c)
#define flags(name, subs,...)
#define AVERROR_INVALIDDATA
Invalid data found when processing input.
#define AVERROR_EXIT
Immediate exit was requested; the called function should not be restarted.
char * icy_metadata_headers
char * av_strndup(const char *s, size_t len)
Duplicate a substring of a string.
AVDictionary * redirect_cache
static int store_icy(URLContext *h, int size)
int ffurl_get_file_handle(URLContext *h)
Return the file descriptor associated with this URL.
The official guide to swscale for confused that consecutive non overlapping rectangles of slice_bottom special converter These generally are unscaled converters of common like for each output line the vertical scaler pulls lines from a ring buffer When the ring buffer does not contain the wanted line
#define AV_DICT_DONT_STRDUP_KEY
Take ownership of a key that's been allocated with av_malloc() or another memory allocation function.
char * reconnect_on_http_error