Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

curlopt_interleavefunction(3) [mojave man page]

CURLOPT_INTERLEAVEFUNCTION(3)				     curl_easy_setopt options				     CURLOPT_INTERLEAVEFUNCTION(3)

NAME
CURLOPT_INTERLEAVEFUNCTION - callback function for RTSP interleaved data SYNOPSIS
#include <curl/curl.h> size_t interleave_callback(void *ptr, size_t size, size_t nmemb, void *userdata); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_INTERLEAVEFUNCTION, interleave_callback); DESCRIPTION
Pass a pointer to your callback function, which should match the prototype shown above. This callback function gets called by libcurl as soon as it has received interleaved RTP data. This function gets called for each $ block and therefore contains exactly one upper-layer protocol unit (e.g. one RTP packet). Curl writes the interleaved header as well as the included data for each call. The first byte is always an ASCII dollar sign. The dollar sign is followed by a one byte channel identifier and then a 2 byte integer length in network byte order. See RFC2326 Section 10.12 for more information on how RTP interleaving behaves. If unset or set to NULL, curl will use the default write function. Interleaved RTP poses some challenges for the client application. Since the stream data is sharing the RTSP control connection, it is crit- ical to service the RTP in a timely fashion. If the RTP data is not handled quickly, subsequent response processing may become unreasonably delayed and the connection may close. The application may use CURL_RTSPREQ_RECEIVE to service RTP data when no requests are desired. If the application makes a request, (e.g. CURL_RTSPREQ_PAUSE) then the response handler will process any pending RTP data before marking the request as finished. DEFAULT
NULL PROTOCOLS
RTSP EXAMPLE
TODO AVAILABILITY
Added in 7.20.0 RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. SEE ALSO
CURLOPT_INTERLEAVEFUNCTION(3), CURLOPT_RTSP_REQUEST(3), libcurl 7.54.0 February 03, 2016 CURLOPT_INTERLEAVEFUNCTION(3)

Check Out this Related Man Page

CURLOPT_CONV_FROM_UTF8_FUNCTION(3)			     curl_easy_setopt options				CURLOPT_CONV_FROM_UTF8_FUNCTION(3)

NAME
CURLOPT_CONV_FROM_UTF8_FUNCTION - convert data from UTF8 to host encoding SYNOPSIS
#include <curl/curl.h> CURLcode conv_callback(char *ptr, size_t length); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_CONV_FROM_UTF8_FUNCTION, conv_callback); DESCRIPTION
Pass a pointer to your callback function, which should match the prototype shown above. Applies to non-ASCII platforms. curl_version_info(3) will return the CURL_VERSION_CONV feature bit set if this option is provided. The data to be converted is in a buffer pointed to by the ptr parameter. The amount of data to convert is indicated by the length parame- ter. The converted data overlays the input data in the buffer pointed to by the ptr parameter. CURLE_OK must be returned upon successful conversion. A CURLcode return value defined by curl.h, such as CURLE_CONV_FAILED, should be returned if an error was encountered. CURLOPT_CONV_FROM_UTF8_FUNCTION converts to host encoding from UTF8 encoding. It is required only for SSL processing. If you set a callback pointer to NULL, or don't set it at all, the built-in libcurl iconv functions will be used. If HAVE_ICONV was not defined when libcurl was built, and no callback has been established, conversion will return the CURLE_CONV_REQD error code. If HAVE_ICONV is defined, CURL_ICONV_CODESET_OF_HOST must also be defined. For example: #define CURL_ICONV_CODESET_OF_HOST "IBM-1047" The iconv code in libcurl will default the network and UTF8 codeset names as follows: #define CURL_ICONV_CODESET_OF_NETWORK "ISO8859-1" #define CURL_ICONV_CODESET_FOR_UTF8 "UTF-8" You will need to override these definitions if they are different on your system. DEFAULT
NULL PROTOCOLS
TLS-based protocols. EXAMPLE
TODO AVAILABILITY
Available only if CURL_DOES_CONVERSIONS was defined when libcurl was built. RETURN VALUE
Returns CURLE_OK if the option is supported, and CURLE_UNKNOWN_OPTION if not. SEE ALSO
CURLOPT_CONV_TO_NETWORK_FUNCTION(3), CURLOPT_CONV_FROM_NETWORK_FUNCTION(3), libcurl 7.54.0 February 03, 2016 CURLOPT_CONV_FROM_UTF8_FUNCTION(3)
Man Page