opusfile  0.4
Stand-alone decoder library for .opus files.
 All Data Structures Functions Variables Typedefs Groups
URL Reading Options

URL reading options

Options for op_url_stream_create() and associated functions.

These allow you to provide proxy configuration parameters, skip SSL certificate checks, etc. Options are processed in order, and if the same option is passed multiple times, only the value specified by the last occurrence has an effect (unless otherwise specified). They may be expanded in the future.

#define OP_SSL_SKIP_CERTIFICATE_CHECK_REQUEST   (6464)
#define OP_HTTP_PROXY_HOST_REQUEST   (6528)
#define OP_HTTP_PROXY_PORT_REQUEST   (6592)
#define OP_HTTP_PROXY_USER_REQUEST   (6656)
#define OP_HTTP_PROXY_PASS_REQUEST   (6720)
#define OP_URL_OPT(_request)   ((_request)+(char *)0)
#define OP_CHECK_INT(_x)   ((void)((_x)==(opus_int32)0),(opus_int32)(_x))
#define OP_CHECK_CONST_CHAR_PTR(_x)   ((_x)+((_x)-(const char *)(_x)))
#define OP_SSL_SKIP_CERTIFICATE_CHECK(_b)
 Skip the certificate check when connecting via TLS/SSL (https).
#define OP_HTTP_PROXY_HOST(_host)
 Proxy connections through the given host.
#define OP_HTTP_PROXY_PORT(_port)
 Use the given port when proxying connections.
#define OP_HTTP_PROXY_USER(_user)
 Use the given user name for authentication when proxying connections.
#define OP_HTTP_PROXY_PASS(_pass)
 Use the given password for authentication when proxying connections.

Detailed Description


Macro Definition Documentation

#define OP_SSL_SKIP_CERTIFICATE_CHECK (   _b)

Skip the certificate check when connecting via TLS/SSL (https).

Parameters:
_bopus_int32: Whether or not to skip the certificate check. The check will be skipped if _b is non-zero, and will not be skipped if _b is zero.
#define OP_HTTP_PROXY_HOST (   _host)

Proxy connections through the given host.

If no port is specified via OP_HTTP_PROXY_PORT, the port number defaults to 8080 (http-alt). All proxy parameters are ignored for non-http and non-https URLs.

Parameters:
_hostconst char *: The proxy server hostname. This may be NULL to disable the use of a proxy server.
#define OP_HTTP_PROXY_PORT (   _port)

Use the given port when proxying connections.

This option only has an effect if OP_HTTP_PROXY_HOST is specified with a non-NULL _host. If this option is not provided, the proxy port number defaults to 8080 (http-alt). All proxy parameters are ignored for non-http and non-https URLs.

Parameters:
_portopus_int32: The proxy server port. This must be in the range 0...65535 (inclusive), or the URL function this is passed to will fail.
#define OP_HTTP_PROXY_USER (   _user)

Use the given user name for authentication when proxying connections.

All proxy parameters are ignored for non-http and non-https URLs.

Parameters:
_userconst char *: The proxy server user name. This may be NULL to disable proxy authentication. A non-NULL value only has an effect if OP_HTTP_PROXY_HOST and OP_HTTP_PROXY_PASS are also specified with non-NULL arguments.
#define OP_HTTP_PROXY_PASS (   _pass)

Use the given password for authentication when proxying connections.

All proxy parameters are ignored for non-http and non-https URLs.

Parameters:
_passconst char *: The proxy server password. This may be NULL to disable proxy authentication. A non-NULL value only has an effect if OP_HTTP_PROXY_HOST and OP_HTTP_PROXY_USER are also specified with non-NULL arguments.