54 #define OFFSET(x) offsetof(URLContext,x) 55 #define E AV_OPT_FLAG_ENCODING_PARAM 56 #define D AV_OPT_FLAG_DECODING_PARAM 58 {
"protocol_whitelist",
"List of protocols that are allowed to be used",
OFFSET(protocol_whitelist),
AV_OPT_TYPE_STRING, { .str =
NULL }, 0, 0,
D },
59 {
"protocol_blacklist",
"List of protocols that are not allowed to be used",
OFFSET(protocol_blacklist),
AV_OPT_TYPE_STRING, { .str =
NULL }, 0, 0, D },
70 #if FF_API_CHILD_CLASS_NEXT 71 .child_class_next = ff_urlcontext_child_class_next,
78 const char *filename,
int flags,
90 "Impossible to open the '%s' protocol for reading\n", up->
name);
95 "Impossible to open the '%s' protocol for writing\n", up->
name);
127 if (strcmp(up->
name,
"subfile"))
130 while(ret >= 0 && (key= strchr(p, sep)) && p<key && (val = strchr(key+1, sep))){
132 if (strcmp(p,
"start") && strcmp(p,
"end")) {
148 memmove(start, key+1, strlen(key));
249 #define URL_SCHEME_CHARS \ 250 "abcdefghijklmnopqrstuvwxyz" \ 251 "ABCDEFGHIJKLMNOPQRSTUVWXYZ" \ 257 char proto_str[128], proto_nested[128], *ptr;
261 if (filename[proto_len] !=
':' &&
262 (strncmp(filename,
"subfile,", 8) || !strchr(filename + proto_len + 1,
':')) ||
264 strcpy(proto_str,
"file");
267 FFMIN(proto_len + 1,
sizeof(proto_str)));
269 av_strlcpy(proto_nested, proto_str,
sizeof(proto_nested));
270 if ((ptr = strchr(proto_nested,
'+')))
276 for (i = 0; protocols[
i]; i++) {
278 if (!strcmp(proto_str, up->
name)) {
283 !strcmp(proto_nested, up->
name)) {
291 "openssl, gnutls or securetransport enabled.\n");
311 const char *whitelist,
const char* blacklist,
324 if (options && (*puc)->prot->priv_data_class &&
333 !strcmp(whitelist, e->
value));
336 !strcmp(blacklist, e->
value));
338 if ((ret =
av_dict_set(options,
"protocol_whitelist", whitelist, 0)) < 0)
341 if ((ret =
av_dict_set(options,
"protocol_blacklist", blacklist, 0)) < 0)
357 int size,
int size_min,
363 int fast_retries = 5;
364 int64_t wait_since = 0;
367 while (len < size_min) {
370 ret = transfer_func(h, buf + len, size - len);
393 fast_retries =
FFMAX(fast_retries, 2);
587 if (!(*s) || !(*s)->url_context)
589 h = (*s)->url_context;
599 if (!entry || !*entry)
665 int ff_rename(
const char *url_src,
const char *url_dst,
void *logctx)
int(* url_write)(URLContext *h, const unsigned char *buf, int size)
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. ...
#define URL_PROTOCOL_FLAG_NETWORK
#define AV_LOG_WARNING
Something somehow does not look correct.
#define LIBAVUTIL_VERSION_INT
int ffurl_write(URLContext *h, const unsigned char *buf, int size)
Write size bytes from buf to the resource accessed by h.
int is_streamed
true if streamed (no seek possible), default = false
int ffurl_connect(URLContext *uc, AVDictionary **options)
Connect an URLContext that has been allocated by ffurl_alloc.
AVIOInterruptCB interrupt_callback
void av_opt_set_defaults(void *s)
Set the values of all AVOption fields to their default values.
int(* url_read)(URLContext *h, unsigned char *buf, int size)
Read data from the protocol.
Describes single entry of the directory.
#define AVIO_FLAG_READ
read-only
int64_t rw_timeout
maximum time to wait for (network) read/write operation completion, in mcs
#define AVIO_FLAG_WRITE
write-only
void ff_network_close(void)
int(* url_get_file_handle)(URLContext *h)
void * av_mallocz(size_t size)
Allocate a memory block with alignment suitable for all memory accesses (including vectors if availab...
int av_usleep(unsigned usec)
Sleep for a period of time.
static void * urlcontext_child_next(void *obj, void *prev)
int(* url_get_short_seek)(URLContext *h)
static int url_alloc_for_protocol(URLContext **puc, const URLProtocol *up, const char *filename, int flags, const AVIOInterruptCB *int_cb)
int(* url_open2)(URLContext *h, const char *url, int flags, AVDictionary **options)
This callback is to be used by protocols which open further nested protocols.
int ffurl_shutdown(URLContext *h, int flags)
Signal the URLContext that we are done reading or writing the stream.
int avpriv_io_move(const char *url_src, const char *url_dst)
Move or rename a resource.
const AVClass * priv_data_class
int avio_check(const char *url, int flags)
Return AVIO_FLAG_* access flags corresponding to the access permissions of the resource in url...
const char * class_name
The name of the class; usually it is the same name as the context structure type to which the AVClass...
#define av_assert0(cond)
assert() equivalent, that is always enabled.
static double cb(void *priv, double x, double y)
int ff_network_init(void)
miscellaneous OS support macros and functions.
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
int(* url_shutdown)(URLContext *h, int flags)
int avio_read_dir(AVIODirContext *s, AVIODirEntry **next)
Get next directory entry.
#define AVERROR_PROTOCOL_NOT_FOUND
Protocol not found.
AVDictionaryEntry * av_dict_get(const AVDictionary *m, const char *key, const AVDictionaryEntry *prev, int flags)
Get a dictionary entry with matching key.
#define AVERROR_EOF
End of file.
int(* url_read_dir)(URLContext *h, AVIODirEntry **next)
int(* url_close)(URLContext *h)
#define AV_OPT_FLAG_ENCODING_PARAM
a generic parameter which can be set by the user for muxing or encoding
Callback for checking whether to abort blocking functions.
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...
int(* url_get_multi_file_handle)(URLContext *h, int **handles, int *numhandles)
#define AV_LOG_ERROR
Something went wrong and cannot losslessly be recovered.
int ffurl_get_multi_file_handle(URLContext *h, int **handles, int *numhandles)
Return the file descriptors associated with this URL.
const AVIOInterruptCB int_cb
const char * protocol_whitelist
int av_match_list(const char *name, const char *list, char separator)
Check if a name is in a list.
#define AV_LOG_DEBUG
Stuff which is only useful for libav* developers.
#define URL_PROTOCOL_FLAG_NESTED_SCHEME
simple assert() macros that are a bit more flexible than ISO C assert().
size_t av_strlcpy(char *dst, const char *src, size_t size)
Copy the string src to dst, but no more than size - 1 bytes, and null-terminate dst.
static const char * urlcontext_to_name(void *ptr)
void avio_free_directory_entry(AVIODirEntry **entry)
Free entry allocated by avio_read_dir().
int ff_rename(const char *url_src, const char *url_dst, void *logctx)
Wrap avpriv_io_move and log if error happens.
static const AVOption options[]
static int retry_transfer_wrapper(URLContext *h, uint8_t *buf, int size, int size_min, int(*transfer_func)(URLContext *h, uint8_t *buf, int size))
int(* url_accept)(URLContext *s, URLContext **c)
int ffurl_get_short_seek(URLContext *h)
Return the current short seek threshold value for this URL.
int(* url_move)(URLContext *h_src, URLContext *h_dst)
const AVClass * ff_urlcontext_child_class_iterate(void **iter)
int(* url_check)(URLContext *h, int mask)
#define av_err2str(errnum)
Convenience macro, the return value should be used only directly in function arguments but never stan...
int ffurl_handshake(URLContext *c)
Perform one step of the protocol handshake to accept a new client.
int64_t(* url_seek)(URLContext *h, int64_t pos, int whence)
int ffurl_get_file_handle(URLContext *h)
Return the file descriptor associated with this URL.
int ffurl_accept(URLContext *s, URLContext **c)
Accept an URLContext c on an URLContext s.
#define AVERROR_EXIT
Immediate exit was requested; the called function should not be restarted.
int ffurl_closep(URLContext **hh)
Close the resource accessed by the URLContext h, and free the memory used by it.
char * av_strdup(const char *s)
Duplicate a string.
static int is_dos_path(const char *path)
const char * protocol_blacklist
int ff_check_interrupt(AVIOInterruptCB *cb)
Check if the user has requested to interrupt a blocking function associated with cb.
int av_opt_set_dict(void *obj, AVDictionary **options)
Set all the options from a given dictionary on an object.
#define AVIO_FLAG_NONBLOCK
Use non-blocking mode.
const char * default_whitelist
int avio_open_dir(AVIODirContext **s, const char *url, AVDictionary **options)
Open directory for reading.
int64_t ffurl_size(URLContext *h)
Return the filesize of the resource accessed by h, AVERROR(ENOSYS) if the operation is not supported ...
#define AVIO_FLAG_READ_WRITE
read-write pseudo flag
int av_dict_set(AVDictionary **pm, const char *key, const char *value, int flags)
Set the given entry in *pm, overwriting an existing entry.
Describe the class of an AVClass context structure.
#define AVSEEK_FORCE
Passing this flag as the "whence" parameter to a seek function causes it to seek by any means (like r...
#define AV_OPT_FLAG_DECODING_PARAM
a generic parameter which can be set by the user for demuxing or decoding
const char * avio_find_protocol_name(const char *url)
Return the name of the protocol that will handle the passed URL.
int64_t av_gettime_relative(void)
Get the current time in microseconds since some unspecified starting point.
#define flags(name, subs,...)
const AVClass * av_class
information for av_log().
int ffurl_close(URLContext *h)
const AVClass ffurl_context_class
int av_strstart(const char *str, const char *pfx, const char **ptr)
Return non-zero if pfx is a prefix of str.
int(* url_open)(URLContext *h, const char *url, int flags)
void av_opt_free(void *obj)
Free all allocated objects in obj.
int64_t ffurl_seek(URLContext *h, int64_t pos, int whence)
Change the position that will be used by the next read/write operation on the resource accessed by h...
const struct URLProtocol * prot
int ffurl_read_complete(URLContext *h, unsigned char *buf, int size)
Read as many bytes as possible (up to size), calling the read function multiple times if necessary...
char * filename
specified URL
int av_opt_copy(void *dst, const void *src)
Copy options from src object into dest object.
#define AVSEEK_SIZE
ORing this as the "whence" parameter to a seek function causes it to return the filesize without seek...
int avio_close_dir(AVIODirContext **s)
Close directory.
#define AVERROR_OPTION_NOT_FOUND
Option not found.
int(* url_open_dir)(URLContext *h)
int avpriv_io_delete(const char *url)
Delete a resource.
int max_packet_size
if non zero, the stream is packetized with this max packet size
unbuffered private I/O API
static const struct URLProtocol * url_find_protocol(const char *filename)
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
struct URLContext * url_context
const URLProtocol ** ffurl_get_protocols(const char *whitelist, const char *blacklist)
Construct a list of protocols matching a given whitelist and/or blacklist.
static double val(void *priv, double ch)
int av_opt_set(void *obj, const char *name, const char *val, int search_flags)
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...
int(* url_close_dir)(URLContext *h)
int(* url_delete)(URLContext *h)
int(* url_handshake)(URLContext *c)