The Linux Manuals (man pages) document is an important part of Linux documents. Linux Manuals are organized as several sections. Each section has a group of commands for a specific area in Linux usage, administration or development.
CURLOPT_TLSAUTH_PASSWORD – password to use for TLS authentication Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TLSAUTH_PASSWORD, char *pwd); Description Pass a char * as parameter, which should point to the zero terminated password to use for the TLS authentication method specified with the CURLOPT_TLSAUTH_TYPE(3) option. Requires that the CURLOPT_TLSAUTH_USERNAME(3) option also be set. Default NULL Protocols…
CURLOPT_TIMEVALUE – set time value for conditional Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEVALUE, long val); Description Pass a long val as parameter. This should be the time counted as seconds since 1 Jan 1970, and the time will be used in a condition as specified with CURLOPT_TIMECONDITION(3). Default 0 Protocols HTTP, FTP, RTSP, and…
CURLOPT_TIMEOUT_MS – set maximum time the request is allowed to take Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEOUT_MS, long timeout); Description Pass a long as parameter containing timeout – the maximum time in milliseconds that you allow the libcurl transfer operation to take. Normally, name lookups can take a considerable time and limiting operations to…
CURLOPT_TIMEOUT – set maximum time the request is allowed to take Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMEOUT, long timeout); Description Pass a long as parameter containing timeout – the maximum time in seconds that you allow the libcurl transfer operation to take. Normally, name lookups can take a considerable time and limiting operations to…
CURLOPT_TIMECONDITION – select condition for a time request Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TIMECONDITION, long cond); Description Pass a long as parameter. This defines how the CURLOPT_TIMEVALUE(3) time value is treated. You can set this parameter to CURL_TIMECOND_IFMODSINCE or CURL_TIMECOND_IFUNMODSINCE. The last modification time of a file is not always known and in such…
CURLOPT_TFTP_BLKSIZE – TFTP block size Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TFTP_BLKSIZE, long blocksize); Description Specify blocksize to use for TFTP data transmission. Valid range as per RFC2348 is 8-65464 bytes. The default of 512 bytes will be used if this option is not specified. The specified block size will only be used pending support…
CURLOPT_TELNETOPTIONS – custom telnet options Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TELNETOPTIONS, struct curl_slist *cmds); Description Provide a pointer to a curl_slist with variables to pass to the telnet negotiations. The variables should be in the format <option=value>. libcurl supports the options ‘TTYPE’, ‘XDISPLOC’ and ‘NEW_ENV’. See the TELNET standard for details. Default NULL Protocols TELNET…
CURLOPT_TCP_NODELAY – set the TCP_NODELAY option Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_NODELAY, long nodelay); Description Pass a long specifying whether the TCP_NODELAY option is to be set or cleared (1 = set, 0 = clear). The option is cleared by default. This will have no effect after the connection has been established. Setting this…
CURLOPT_TCP_KEEPINTVL – set TCP keep-alive interval Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPINTVL, long interval); Description Pass a long. Sets the interval, in seconds, that the operating system will wait between sending keepalive probes. Not all operating systems support this option. (Added in 7.25.0) Default Protocols Example TODO Availability Always Return Value Returns CURLE_OK if…
CURLOPT_TCP_KEEPIDLE – set TCP keep-alive idle time wait Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPIDLE, long delay); Description Pass a long. Sets the delay, in seconds, that the operating system will wait while the connection is idle before sending keepalive probes. Not all operating systems support this option. Default ? Protocols All Example TODO Availability…
CURLOPT_TCP_KEEPALIVE – enable TCP keep-alive probing Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_TCP_KEEPALIVE, long probe); Description Pass a long. If set to 1, TCP keepalive probes will be sent. The delay and frequency of these probes can be controlled by the CURLOPT_TCP_KEEPIDLE(3) and CURLOPT_TCP_KEEPINTVL(3) options, provided the operating system supports them. Set to 0 (default…
CURLOPT_STDERR – redirect stderr to another stream Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_STDERR, FILE *stream); Description Pass a FILE * as parameter. Tell libcurl to use this stream instead of stderr when showing the progress meter and displaying CURLOPT_VERBOSE(3) data. Default stderr Protocols All Example TODO Availability Always Return Value Returns CURLE_OK See Also…
CURLOPT_SSL_VERIFYPEER – verify the peer’s SSL certificate Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYPEER, long verify); Description Pass a long as parameter to enable or disable. This option determines whether curl verifies the authenticity of the peer’s certificate. A value of 1 means curl verifies; 0 (zero) means it doesn’t. When negotiating a TLS or…
CURLOPT_SSL_VERIFYHOST – verify the certificate’s name against host Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_VERIFYHOST, long verify); Description Pass a long as parameter specifying what to verify. This option determines whether libcurl verifies that the server cert is for the server it is known as. When negotiating TLS and SSL connections, the server sends a…
CURLOPT_SSL_SESSIONID_CACHE – enable/disable use of the SSL session-ID cache Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_SESSIONID_CACHE, long enabled); Description Pass a long set to 0 to disable libcurl’s use of SSL session-ID caching. Set this to 1 to enable it. By default all transfers are done using the cache enabled. While nothing ever should get…
CURLOPT_SSL_OPTIONS – set SSL behavior options Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_OPTIONS, long bitmask); Description Pass a long with a bitmask to tell libcurl about specific SSL behaviors. CURLSSLOPT_ALLOW_BEAST is the only supported bit and by setting this the user will tell libcurl to not attempt to use any workarounds for a security flaw…
CURLOPT_SSL_ENABLE_NPN – enable NPN Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_NPN, long npn); Description Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This option enables/disables NPN in the SSL handshake (if the SSL backend libcurl is built to use supports it), which can be used to…
CURLOPT_SSL_ENABLE_ALPN – enable ALPN Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_ENABLE_ALPN, long npn); Description Pass a long as parameter, 0 or 1 where 1 is for enable and 0 for disable. This option enables/disables ALPN in the SSL handshake (if the SSL backend libcurl is built to use supports it), which can be used to…
CURLOPT_SSL_CTX_FUNCTION – openssl specific callback to do SSL magic Synopsis #include <curl/curl.h> CURLcode ssl_ctx_callback(CURL *curl, void *ssl_ctx, void *userptr); CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CTX_FUNCTION, ssl_ctx_callback); Description This option only works for libcurl powered by OpenSSL. If libcurl was built against another SSL library, this functionality is absent. Pass a pointer to your callback function, which should…
CURLOPT_SSL_CTX_DATA – custom pointer passed to ssl_ctx callback Synopsis #include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLOPT_SSL_CTX_DATA, void *pointer); Description Data pointer to pass to the ssl context callback set by the option CURLOPT_SSL_CTX_FUNCTION(3), this is the pointer you’ll get as third parameter. Default NULL Protocols All TLS based protocols: HTTPS, FTPS, IMAPS, POP3, SMTPS etc. Example…