http.c File Reference

#include "config.h"
#include "libavutil/avstring.h"
#include "libavutil/opt.h"
#include "avformat.h"
#include "http.h"
#include "httpauth.h"
#include "internal.h"
#include "network.h"
#include "os_support.h"
#include "url.h"

Go to the source code of this file.

Data Structures
struct	HTTPContext

Macros
#define	BUFFER_SIZE   MAX_URL_SIZE
#define	MAX_REDIRECTS   8
#define	OFFSET(x)   offsetof(HTTPContext, x)
#define	D   AV_OPT_FLAG_DECODING_PARAM
#define	E   AV_OPT_FLAG_ENCODING_PARAM
#define	DEFAULT_USER_AGENT   "Lavf/" AV_STRINGIFY(LIBAVFORMAT_VERSION)
#define	HTTP_CLASS(flavor)

Functions
static int	http_connect (URLContext *h, const char *path, const char *local_path, const char *hoststr, const char *auth, const char *proxyauth, int *new_location)
void	ff_http_init_auth_state (URLContext *dest, const URLContext *src)
	Initialize the authentication state based on another HTTP URLContext.
static int	http_open_cnx_internal (URLContext *h, AVDictionary **options)
static int	http_open_cnx (URLContext *h, AVDictionary **options)
int	ff_http_do_new_request (URLContext *h, const char *uri)
	Send a new HTTP request, reusing the old connection.
int	ff_http_averror (int status_code, int default_averror)
static int	http_open (URLContext *h, const char *uri, int flags, AVDictionary **options)
static int	http_getc (HTTPContext *s)
static int	http_get_line (HTTPContext *s, char *line, int line_size)
static int	check_http_code (URLContext *h, int http_code, const char *end)
static int	parse_location (HTTPContext *s, const char *p)
static void	parse_content_range (URLContext *h, const char *p)
static int	parse_content_encoding (URLContext *h, const char *p)
static int	parse_icy (HTTPContext *s, const char *tag, const char *p)
static int	process_line (URLContext *h, char *line, int line_count, int *new_location)
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 path and domain from the cookie values stored in the HTTP protocol context.
static int	has_header (const char *str, const char *header)
static int	http_read_header (URLContext *h, int *new_location)
static int	http_buf_read (URLContext *h, uint8_t *buf, int size)
static int	http_read_stream (URLContext *h, uint8_t *buf, int size)
static int	http_read_stream_all (URLContext *h, uint8_t *buf, int size)
static void	update_metadata (HTTPContext *s, char *data)
static int	store_icy (URLContext *h, int size)
static int	http_read (URLContext *h, uint8_t *buf, int size)
static int	http_write (URLContext *h, const uint8_t *buf, int size)
static int	http_shutdown (URLContext *h, int flags)
static int	http_close (URLContext *h)
static int64_t	http_seek (URLContext *h, int64_t off, int whence)
static int	http_get_file_handle (URLContext *h)

Variables
static const AVOption	options []

Macro Definition Documentation

#define BUFFER_SIZE   MAX_URL_SIZE

Definition at line 45 of file http.c.

Referenced by http_getc(), and http_seek().

#define MAX_REDIRECTS   8

Definition at line 46 of file http.c.

Referenced by http_open_cnx().

#define OFFSET

(

x

)

offsetof(HTTPContext, x)

Definition at line 98 of file http.c.

#define D   AV_OPT_FLAG_DECODING_PARAM

Definition at line 99 of file http.c.

#define E   AV_OPT_FLAG_ENCODING_PARAM

Definition at line 100 of file http.c.

#define DEFAULT_USER_AGENT   "Lavf/" AV_STRINGIFY(LIBAVFORMAT_VERSION)

Definition at line 101 of file http.c.

#define HTTP_CLASS

(

flavor

)

Value:

static const AVClass flavor ## _context_class = {   \
    .class_name = # flavor,                         \
    .item_name  = av_default_item_name,             \
    .option     = options,                          \
    .version    = LIBAVUTIL_VERSION_INT,            \
}

Definition at line 1160 of file http.c.

Function Documentation

static int http_connect ( URLContext *  h, const char *  path, const char *  local_path, const char *  hoststr, const char *  auth, const char *  proxyauth, int *  new_location  )

static

Definition at line 697 of file http.c.

Referenced by http_open_cnx_internal().

void ff_http_init_auth_state	(	URLContext *	dest,
		const URLContext *	src
	)

Initialize the authentication state based on another HTTP URLContext.

This can be used to pre-initialize the authentication parameters if they are known beforehand, to avoid having to do an initial failing request just to get the parameters.

Parameters

dest	URL context whose authentication state gets updated
src	URL context whose authentication state gets copied

Definition at line 133 of file http.c.

static int http_open_cnx_internal ( URLContext *  h, AVDictionary **  options  )

static

Definition at line 143 of file http.c.

Referenced by http_open_cnx().

static int http_open_cnx ( URLContext *  h, AVDictionary **  options  )

static

Definition at line 204 of file http.c.

Referenced by ff_http_do_new_request(), http_open(), and http_seek().

int ff_http_do_new_request	(	URLContext *	h,
		const char *	uri
	)

Send a new HTTP request, reusing the old connection.

Parameters

h	pointer to the resource
uri	uri used to perform the request

Returns

a negative value if an error condition occurred, 0 otherwise

Definition at line 260 of file http.c.

Referenced by rtmp_http_send_cmd().

int ff_http_averror	(	int	status_code,
		int	default_averror
	)

Definition at line 278 of file http.c.

Referenced by check_http_code(), ff_rtsp_averror(), and http_open_cnx().

static int http_open ( URLContext *  h, const char *  uri, int  flags, AVDictionary **  options  )

static

Definition at line 295 of file http.c.

static int http_getc ( HTTPContext *  s )

static

Definition at line 326 of file http.c.

Referenced by http_get_line().

static int http_get_line ( HTTPContext *  s, char *  line, int  line_size  )

static

Definition at line 343 of file http.c.

Referenced by http_read_header(), and http_read_stream().

static int check_http_code ( URLContext *  h, int  http_code, const char *  end  )

static

Definition at line 367 of file http.c.

Referenced by process_line().

static int parse_location ( HTTPContext *  s, const char *  p  )

static

Definition at line 382 of file http.c.

Referenced by process_line().

static void parse_content_range ( URLContext *  h, const char *  p  )

static

Definition at line 396 of file http.c.

Referenced by process_line().

static int parse_content_encoding ( URLContext *  h, const char *  p  )

static

Definition at line 411 of file http.c.

Referenced by process_line().

static int parse_icy ( HTTPContext *  s, const char *  tag, const char *  p  )

static

Definition at line 445 of file http.c.

Referenced by process_line().

static int process_line ( URLContext *  h, char *  line, int  line_count, int *  new_location  )

static

Definition at line 467 of file http.c.

Referenced by http_read_header().

static int get_cookies ( HTTPContext *  s, char **  cookies, const char *  path, const char *  domain  )

static

Create a string containing cookie values for use as a HTTP cookie header field value for a particular path and domain from the cookie values stored in the HTTP protocol context.

The cookie string is stored in *cookies.

Returns

a negative value if an error condition occurred, 0 otherwise

Definition at line 571 of file http.c.

Referenced by http_connect().

static int has_header ( const char *  str, const char *  header  )

inlinestatic

Definition at line 661 of file http.c.

Referenced by http_connect().

static int http_read_header ( URLContext *  h, int *  new_location  )

static

Definition at line 669 of file http.c.

Referenced by http_connect(), and http_read_stream().

static int http_buf_read ( URLContext *  h, uint8_t *  buf, int  size  )

static

Definition at line 853 of file http.c.

Referenced by http_read_stream().

static int http_read_stream ( URLContext *  h, uint8_t *  buf, int  size  )

static

Definition at line 911 of file http.c.

Referenced by http_read(), and http_read_stream_all().

static int http_read_stream_all ( URLContext *  h, uint8_t *  buf, int  size  )

static

Definition at line 953 of file http.c.

Referenced by store_icy().

static void update_metadata ( HTTPContext *  s, char *  data  )

static

Definition at line 965 of file http.c.

Referenced by store_icy().

static int store_icy ( URLContext *  h, int  size  )

static

Definition at line 991 of file http.c.

Referenced by http_read().

static int http_read ( URLContext *  h, uint8_t *  buf, int  size  )

static

Definition at line 1028 of file http.c.

static int http_write ( URLContext *  h, const uint8_t *  buf, int  size  )

static

Definition at line 1045 of file http.c.

static int http_shutdown ( URLContext *  h, int  flags  )

static

Definition at line 1071 of file http.c.

Referenced by http_close().

static int http_close ( URLContext *  h )

static

Definition at line 1087 of file http.c.

static int64_t http_seek ( URLContext *  h, int64_t  off, int  whence  )

static

Definition at line 1107 of file http.c.

static int http_get_file_handle ( URLContext *  h )

static

Definition at line 1154 of file http.c.

Variable Documentation

const AVOption options[]

static

Initial value:

= {
    { "seekable", "control seekability of connection", OFFSET(seekable), AV_OPT_TYPE_INT, { .i64 = -1 }, -1, 1, D },
    { "chunked_post", "use chunked transfer-encoding for posts", OFFSET(chunked_post), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, E },
    { "headers", "set custom HTTP headers, can override built in default headers", OFFSET(headers), AV_OPT_TYPE_STRING, { 0 }, 0, 0, D | E },
    { "content_type", "set a specific content type for the POST messages", OFFSET(content_type), AV_OPT_TYPE_STRING, { 0 }, 0, 0, D | E },
    { "user_agent", "override User-Agent header", OFFSET(user_agent), AV_OPT_TYPE_STRING, { .str = DEFAULT_USER_AGENT }, 0, 0, D },
    { "user-agent", "override User-Agent header", OFFSET(user_agent), AV_OPT_TYPE_STRING, { .str = DEFAULT_USER_AGENT }, 0, 0, D },
    { "multiple_requests", "use persistent connections", OFFSET(multiple_requests), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, D | E },
    { "post_data", "set custom HTTP post data", OFFSET(post_data), AV_OPT_TYPE_BINARY, .flags = D | E },
    { "mime_type", "export the MIME type", OFFSET(mime_type), AV_OPT_TYPE_STRING, { 0 }, 0, 0, AV_OPT_FLAG_EXPORT | AV_OPT_FLAG_READONLY },
    { "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, { 0 }, 0, 0, D },
    { "icy", "request ICY metadata", OFFSET(icy), AV_OPT_TYPE_INT, { .i64 = 1 }, 0, 1, D },
    { "icy_metadata_headers", "return ICY metadata headers", OFFSET(icy_metadata_headers), AV_OPT_TYPE_STRING, { 0 }, 0, 0, AV_OPT_FLAG_EXPORT },
    { "icy_metadata_packet", "return current ICY metadata packet", OFFSET(icy_metadata_packet), AV_OPT_TYPE_STRING, { 0 }, 0, 0, AV_OPT_FLAG_EXPORT },
    { "metadata", "metadata read from the bitstream", OFFSET(metadata), AV_OPT_TYPE_DICT, {0}, 0, 0, AV_OPT_FLAG_EXPORT },
    { "auth_type", "HTTP authentication type", OFFSET(auth_state.auth_type), AV_OPT_TYPE_INT, { .i64 = HTTP_AUTH_NONE }, HTTP_AUTH_NONE, HTTP_AUTH_BASIC, D | E, "auth_type"},
    { "none", "No auth method set, autodetect", 0, AV_OPT_TYPE_CONST, { .i64 = HTTP_AUTH_NONE }, 0, 0, D | E, "auth_type"},
    { "basic", "HTTP basic authentication", 0, AV_OPT_TYPE_CONST, { .i64 = HTTP_AUTH_BASIC }, 0, 0, D | E, "auth_type"},
    { "send_expect_100", "Force sending an Expect: 100-continue header for POST", OFFSET(send_expect_100), AV_OPT_TYPE_INT, { .i64 = 0 }, 0, 1, E },
    { "location", "The actual location of the data received", OFFSET(location), AV_OPT_TYPE_STRING, { 0 }, 0, 0, D | E },
    { "offset", "initial byte offset", OFFSET(off), AV_OPT_TYPE_INT64, { .i64 = 0 }, 0, INT64_MAX, D },
    { "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 },
    { "method", "Override the HTTP method", OFFSET(method), AV_OPT_TYPE_STRING, { .str = NULL }, 0, 0, E },
    { NULL }
}

Definition at line 103 of file http.c.