curl_easy_setopt(3) libcurl Manual curl_easy_setopt(3)
NAME
curl_easy_setopt - set options for a curl easy handle
SYNOPSIS
#include <curl/curl.h>
CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter);
DESCRIPTION
_easy_setopt§ion=3">curl_easy_setopt(3) is used to tell libcurl how to behave. By setting
the appropriate options, the application can change libcurl's behavior.
All options are set with an option followed by a parameter. That
parameter can be a long, a function pointer, an object pointer or a
curl_off_t, depending on what the specific option expects. Read this
manual carefully as bad input values may cause libcurl to behave badly!
You can only set one option in each function call. A typical
application uses many _easy_setopt§ion=3">curl_easy_setopt(3) calls in the setup phase.
Options set with this function call are valid for all forthcoming
transfers performed using this handle. The options are not in any way
reset between transfers, so if you want subsequent transfers with
different options, you must change them between the transfers. You can
optionally reset all options back to internal default with
_easy_reset§ion=3">curl_easy_reset(3).
Strings passed to libcurl as 'char *' arguments, are copied by the
library; thus the string storage associated to the pointer argument may
be overwritten after _easy_setopt§ion=3">curl_easy_setopt(3) returns. The only exception to
this rule is really _POSTFIELDS§ion=3">CURLOPT_POSTFIELDS(3), but the alternative that
copies the string _COPYPOSTFIELDS§ion=3">CURLOPT_COPYPOSTFIELDS(3) has some usage
characteristics you need to read up on. This function does not accept
input strings longer than CURL_MAX_INPUT_LENGTH (8 MB).
The order in which the options are set does not matter.
Before version 7.17.0, strings were not copied. Instead the user was
forced keep them available until libcurl no longer needed them.
The handle is the return code from a _easy_init§ion=3">curl_easy_init(3) or
_easy_duphandle§ion=3">curl_easy_duphandle(3) call.
BEHAVIOR OPTIONS
CURLOPT_VERBOSE
Display verbose information. See _VERBOSE§ion=3">CURLOPT_VERBOSE(3)
CURLOPT_HEADER
Include the header in the body output. See _HEADER§ion=3">CURLOPT_HEADER(3)
CURLOPT_NOPROGRESS
Shut off the progress meter. See _NOPROGRESS§ion=3">CURLOPT_NOPROGRESS(3)
CURLOPT_NOSIGNAL
Do not install signal handlers. See _NOSIGNAL§ion=3">CURLOPT_NOSIGNAL(3)
CURLOPT_WILDCARDMATCH
Transfer multiple files according to a file name pattern. See
_WILDCARDMATCH§ion=3">CURLOPT_WILDCARDMATCH(3)
CALLBACK OPTIONS
CURLOPT_WRITEFUNCTION
Callback for writing data. See _WRITEFUNCTION§ion=3">CURLOPT_WRITEFUNCTION(3)
CURLOPT_WRITEDATA
Data pointer to pass to the write callback. See
_WRITEDATA§ion=3">CURLOPT_WRITEDATA(3)
CURLOPT_READFUNCTION
Callback for reading data. See _READFUNCTION§ion=3">CURLOPT_READFUNCTION(3)
CURLOPT_READDATA
Data pointer to pass to the read callback. See
_READDATA§ion=3">CURLOPT_READDATA(3)
CURLOPT_IOCTLFUNCTION
Callback for I/O operations. See _IOCTLFUNCTION§ion=3">CURLOPT_IOCTLFUNCTION(3)
CURLOPT_IOCTLDATA
Data pointer to pass to the I/O callback. See
_IOCTLDATA§ion=3">CURLOPT_IOCTLDATA(3)
CURLOPT_SEEKFUNCTION
Callback for seek operations. See _SEEKFUNCTION§ion=3">CURLOPT_SEEKFUNCTION(3)
CURLOPT_SEEKDATA
Data pointer to pass to the seek callback. See
_SEEKDATA§ion=3">CURLOPT_SEEKDATA(3)
CURLOPT_SOCKOPTFUNCTION
Callback for sockopt operations. See _SOCKOPTFUNCTION§ion=3">CURLOPT_SOCKOPTFUNCTION(3)
CURLOPT_SOCKOPTDATA
Data pointer to pass to the sockopt callback. See
_SOCKOPTDATA§ion=3">CURLOPT_SOCKOPTDATA(3)
CURLOPT_OPENSOCKETFUNCTION
Callback for socket creation. See _OPENSOCKETFUNCTION§ion=3">CURLOPT_OPENSOCKETFUNCTION(3)
CURLOPT_OPENSOCKETDATA
Data pointer to pass to the open socket callback. See
_OPENSOCKETDATA§ion=3">CURLOPT_OPENSOCKETDATA(3)
CURLOPT_CLOSESOCKETFUNCTION
Callback for closing socket. See _CLOSESOCKETFUNCTION§ion=3">CURLOPT_CLOSESOCKETFUNCTION(3)
CURLOPT_CLOSESOCKETDATA
Data pointer to pass to the close socket callback. See
_CLOSESOCKETDATA§ion=3">CURLOPT_CLOSESOCKETDATA(3)
CURLOPT_PROGRESSFUNCTION
OBSOLETE callback for progress meter. See
_PROGRESSFUNCTION§ion=3">CURLOPT_PROGRESSFUNCTION(3)
CURLOPT_PROGRESSDATA
Data pointer to pass to the progress meter callback. See
_PROGRESSDATA§ion=3">CURLOPT_PROGRESSDATA(3)
CURLOPT_XFERINFOFUNCTION
Callback for progress meter. See _XFERINFOFUNCTION§ion=3">CURLOPT_XFERINFOFUNCTION(3)
CURLOPT_XFERINFODATA
Data pointer to pass to the progress meter callback. See
_XFERINFODATA§ion=3">CURLOPT_XFERINFODATA(3)
CURLOPT_HEADERFUNCTION
Callback for writing received headers. See
_HEADERFUNCTION§ion=3">CURLOPT_HEADERFUNCTION(3)
CURLOPT_HEADERDATA
Data pointer to pass to the header callback. See
_HEADERDATA§ion=3">CURLOPT_HEADERDATA(3)
CURLOPT_DEBUGFUNCTION
Callback for debug information. See _DEBUGFUNCTION§ion=3">CURLOPT_DEBUGFUNCTION(3)
CURLOPT_DEBUGDATA
Data pointer to pass to the debug callback. See
_DEBUGDATA§ion=3">CURLOPT_DEBUGDATA(3)
CURLOPT_SSL_CTX_FUNCTION
Callback for SSL context logic. See _SSL_CTX_FUNCTION§ion=3">CURLOPT_SSL_CTX_FUNCTION(3)
CURLOPT_SSL_CTX_DATA
Data pointer to pass to the SSL context callback. See
_SSL_CTX_DATA§ion=3">CURLOPT_SSL_CTX_DATA(3)
CURLOPT_CONV_TO_NETWORK_FUNCTION
Callback for code base conversion. See
_CONV_TO_NETWORK_FUNCTION§ion=3">CURLOPT_CONV_TO_NETWORK_FUNCTION(3)
CURLOPT_CONV_FROM_NETWORK_FUNCTION
Callback for code base conversion. See
_CONV_FROM_NETWORK_FUNCTION§ion=3">CURLOPT_CONV_FROM_NETWORK_FUNCTION(3)
CURLOPT_CONV_FROM_UTF8_FUNCTION
Callback for code base conversion. See
_CONV_FROM_UTF8_FUNCTION§ion=3">CURLOPT_CONV_FROM_UTF8_FUNCTION(3)
CURLOPT_INTERLEAVEFUNCTION
Callback for RTSP interleaved data. See
_INTERLEAVEFUNCTION§ion=3">CURLOPT_INTERLEAVEFUNCTION(3)
CURLOPT_INTERLEAVEDATA
Data pointer to pass to the RTSP interleave callback. See
_INTERLEAVEDATA§ion=3">CURLOPT_INTERLEAVEDATA(3)
CURLOPT_CHUNK_BGN_FUNCTION
Callback for wildcard download start of chunk. See
_CHUNK_BGN_FUNCTION§ion=3">CURLOPT_CHUNK_BGN_FUNCTION(3)
CURLOPT_CHUNK_END_FUNCTION
Callback for wildcard download end of chunk. See
_CHUNK_END_FUNCTION§ion=3">CURLOPT_CHUNK_END_FUNCTION(3)
CURLOPT_CHUNK_DATA
Data pointer to pass to the chunk callbacks. See
_CHUNK_DATA§ion=3">CURLOPT_CHUNK_DATA(3)
CURLOPT_FNMATCH_FUNCTION
Callback for wildcard matching. See _FNMATCH_FUNCTION§ion=3">CURLOPT_FNMATCH_FUNCTION(3)
CURLOPT_FNMATCH_DATA
Data pointer to pass to the wildcard matching callback. See
_FNMATCH_DATA§ion=3">CURLOPT_FNMATCH_DATA(3)
CURLOPT_SUPPRESS_CONNECT_HEADERS
Suppress proxy CONNECT response headers from user callbacks. See
_SUPPRESS_CONNECT_HEADERS§ion=3">CURLOPT_SUPPRESS_CONNECT_HEADERS(3)
CURLOPT_RESOLVER_START_FUNCTION
Callback to be called before a new resolve request is started.
See _RESOLVER_START_FUNCTION§ion=3">CURLOPT_RESOLVER_START_FUNCTION(3)
CURLOPT_RESOLVER_START_DATA
Data pointer to pass to resolver start callback. See
_RESOLVER_START_DATA§ion=3">CURLOPT_RESOLVER_START_DATA(3)
ERROR OPTIONS
CURLOPT_ERRORBUFFER
Error message buffer. See _ERRORBUFFER§ion=3">CURLOPT_ERRORBUFFER(3)
CURLOPT_STDERR
stderr replacement stream. See _STDERR§ion=3">CURLOPT_STDERR(3)
CURLOPT_FAILONERROR
Fail on HTTP 4xx errors. _FAILONERROR§ion=3">CURLOPT_FAILONERROR(3)
CURLOPT_KEEP_SENDING_ON_ERROR
Keep sending on HTTP >= 300 errors.
_KEEP_SENDING_ON_ERROR§ion=3">CURLOPT_KEEP_SENDING_ON_ERROR(3)
NETWORK OPTIONS
CURLOPT_URL
URL to work on. See _URL§ion=3">CURLOPT_URL(3)
CURLOPT_PATH_AS_IS
Disable squashing /../ and /./ sequences in the path. See
_PATH_AS_IS§ion=3">CURLOPT_PATH_AS_IS(3)
CURLOPT_PROTOCOLS
Allowed protocols. See _PROTOCOLS§ion=3">CURLOPT_PROTOCOLS(3)
CURLOPT_REDIR_PROTOCOLS
Protocols to allow redirects to. See _REDIR_PROTOCOLS§ion=3">CURLOPT_REDIR_PROTOCOLS(3)
CURLOPT_DEFAULT_PROTOCOL
Default protocol. See _DEFAULT_PROTOCOL§ion=3">CURLOPT_DEFAULT_PROTOCOL(3)
CURLOPT_PROXY
Proxy to use. See _PROXY§ion=3">CURLOPT_PROXY(3)
CURLOPT_PRE_PROXY
Socks proxy to use. See _PRE_PROXY§ion=3">CURLOPT_PRE_PROXY(3)
CURLOPT_PROXYPORT
Proxy port to use. See _PROXYPORT§ion=3">CURLOPT_PROXYPORT(3)
CURLOPT_PROXYTYPE
Proxy type. See _PROXYTYPE§ion=3">CURLOPT_PROXYTYPE(3)
CURLOPT_NOPROXY
Filter out hosts from proxy use. _NOPROXY§ion=3">CURLOPT_NOPROXY(3)
CURLOPT_HTTPPROXYTUNNEL
Tunnel through the HTTP proxy. _HTTPPROXYTUNNEL§ion=3">CURLOPT_HTTPPROXYTUNNEL(3)
CURLOPT_CONNECT_TO
Connect to a specific host and port. See _CONNECT_TO§ion=3">CURLOPT_CONNECT_TO(3)
CURLOPT_SOCKS5_AUTH
Socks5 authentication methods. See _SOCKS5_AUTH§ion=3">CURLOPT_SOCKS5_AUTH(3)
CURLOPT_SOCKS5_GSSAPI_SERVICE
Socks5 GSSAPI service name. _SOCKS5_GSSAPI_SERVICE§ion=3">CURLOPT_SOCKS5_GSSAPI_SERVICE(3)
CURLOPT_SOCKS5_GSSAPI_NEC
Socks5 GSSAPI NEC mode. See _SOCKS5_GSSAPI_NEC§ion=3">CURLOPT_SOCKS5_GSSAPI_NEC(3)
CURLOPT_PROXY_SERVICE_NAME
Proxy authentication service name. _PROXY_SERVICE_NAME§ion=3">CURLOPT_PROXY_SERVICE_NAME(3)
CURLOPT_HAPROXYPROTOCOL
Send an HAProxy PROXY protocol v1 header. See
_HAPROXYPROTOCOL§ion=3">CURLOPT_HAPROXYPROTOCOL(3)
CURLOPT_SERVICE_NAME
Authentication service name. _SERVICE_NAME§ion=3">CURLOPT_SERVICE_NAME(3)
CURLOPT_INTERFACE
Bind connection locally to this. See _INTERFACE§ion=3">CURLOPT_INTERFACE(3)
CURLOPT_LOCALPORT
Bind connection locally to this port. See _LOCALPORT§ion=3">CURLOPT_LOCALPORT(3)
CURLOPT_LOCALPORTRANGE
Bind connection locally to port range. See
_LOCALPORTRANGE§ion=3">CURLOPT_LOCALPORTRANGE(3)
CURLOPT_DNS_CACHE_TIMEOUT
Timeout for DNS cache. See _DNS_CACHE_TIMEOUT§ion=3">CURLOPT_DNS_CACHE_TIMEOUT(3)
CURLOPT_DNS_USE_GLOBAL_CACHE
OBSOLETE Enable global DNS cache. See
_DNS_USE_GLOBAL_CACHE§ion=3">CURLOPT_DNS_USE_GLOBAL_CACHE(3)
CURLOPT_DOH_URL
Use this DOH server for name resolves. See _DOH_URL§ion=3">CURLOPT_DOH_URL(3)
CURLOPT_BUFFERSIZE
Ask for alternate buffer size. See _BUFFERSIZE§ion=3">CURLOPT_BUFFERSIZE(3)
CURLOPT_PORT
Port number to connect to. See _PORT§ion=3">CURLOPT_PORT(3)
CURLOPT_TCP_FASTOPEN
Enable TFO, TCP Fast Open. See _TCP_FASTOPEN§ion=3">CURLOPT_TCP_FASTOPEN(3)
CURLOPT_TCP_NODELAY
Disable the Nagle algorithm. See _TCP_NODELAY§ion=3">CURLOPT_TCP_NODELAY(3)
CURLOPT_ADDRESS_SCOPE
IPv6 scope for local addresses. See _ADDRESS_SCOPE§ion=3">CURLOPT_ADDRESS_SCOPE(3)
CURLOPT_TCP_KEEPALIVE
Enable TCP keep-alive. See _TCP_KEEPALIVE§ion=3">CURLOPT_TCP_KEEPALIVE(3)
CURLOPT_TCP_KEEPIDLE
Idle time before sending keep-alive. See _TCP_KEEPIDLE§ion=3">CURLOPT_TCP_KEEPIDLE(3)
CURLOPT_TCP_KEEPINTVL
Interval between keep-alive probes. See _TCP_KEEPINTVL§ion=3">CURLOPT_TCP_KEEPINTVL(3)
CURLOPT_UNIX_SOCKET_PATH
Path to a Unix domain socket. See _UNIX_SOCKET_PATH§ion=3">CURLOPT_UNIX_SOCKET_PATH(3)
CURLOPT_ABSTRACT_UNIX_SOCKET
Path to an abstract Unix domain socket. See
_ABSTRACT_UNIX_SOCKET§ion=3">CURLOPT_ABSTRACT_UNIX_SOCKET(3)
NAMES and PASSWORDS OPTIONS (Authentication)
CURLOPT_NETRC
Enable .netrc parsing. See _NETRC§ion=3">CURLOPT_NETRC(3)
CURLOPT_NETRC_FILE
.netrc file name. See _NETRC_FILE§ion=3">CURLOPT_NETRC_FILE(3)
CURLOPT_USERPWD
User name and password. See _USERPWD§ion=3">CURLOPT_USERPWD(3)
CURLOPT_PROXYUSERPWD
Proxy user name and password. See _PROXYUSERPWD§ion=3">CURLOPT_PROXYUSERPWD(3)
CURLOPT_USERNAME
User name. See _USERNAME§ion=3">CURLOPT_USERNAME(3)
CURLOPT_PASSWORD
Password. See _PASSWORD§ion=3">CURLOPT_PASSWORD(3)
CURLOPT_LOGIN_OPTIONS
Login options. See _LOGIN_OPTIONS§ion=3">CURLOPT_LOGIN_OPTIONS(3)
CURLOPT_PROXYUSERNAME
Proxy user name. See _PROXYUSERNAME§ion=3">CURLOPT_PROXYUSERNAME(3)
CURLOPT_PROXYPASSWORD
Proxy password. See _PROXYPASSWORD§ion=3">CURLOPT_PROXYPASSWORD(3)
CURLOPT_HTTPAUTH
HTTP server authentication methods. See _HTTPAUTH§ion=3">CURLOPT_HTTPAUTH(3)
CURLOPT_TLSAUTH_USERNAME
TLS authentication user name. See _TLSAUTH_USERNAME§ion=3">CURLOPT_TLSAUTH_USERNAME(3)
CURLOPT_PROXY_TLSAUTH_USERNAME
Proxy TLS authentication user name. See
_PROXY_TLSAUTH_USERNAME§ion=3">CURLOPT_PROXY_TLSAUTH_USERNAME(3)
CURLOPT_TLSAUTH_PASSWORD
TLS authentication password. See _TLSAUTH_PASSWORD§ion=3">CURLOPT_TLSAUTH_PASSWORD(3)
CURLOPT_PROXY_TLSAUTH_PASSWORD
Proxy TLS authentication password. See
_PROXY_TLSAUTH_PASSWORD§ion=3">CURLOPT_PROXY_TLSAUTH_PASSWORD(3)
CURLOPT_TLSAUTH_TYPE
TLS authentication methods. See _TLSAUTH_TYPE§ion=3">CURLOPT_TLSAUTH_TYPE(3)
CURLOPT_PROXY_TLSAUTH_TYPE
Proxy TLS authentication methods. See
_PROXY_TLSAUTH_TYPE§ion=3">CURLOPT_PROXY_TLSAUTH_TYPE(3)
CURLOPT_PROXYAUTH
HTTP proxy authentication methods. See _PROXYAUTH§ion=3">CURLOPT_PROXYAUTH(3)
CURLOPT_SASL_AUTHZID
SASL authorisation identity (identity to act as). See
_SASL_AUTHZID§ion=3">CURLOPT_SASL_AUTHZID(3)
CURLOPT_SASL_IR
Enable SASL initial response. See _SASL_IR§ion=3">CURLOPT_SASL_IR(3)
CURLOPT_XOAUTH2_BEARER
OAuth2 bearer token. See _XOAUTH2_BEARER§ion=3">CURLOPT_XOAUTH2_BEARER(3)
CURLOPT_DISALLOW_USERNAME_IN_URL
Don't allow username in URL. See
_DISALLOW_USERNAME_IN_URL§ion=3">CURLOPT_DISALLOW_USERNAME_IN_URL(3)
HTTP OPTIONS
CURLOPT_AUTOREFERER
Automatically set Referer: header. See _AUTOREFERER§ion=3">CURLOPT_AUTOREFERER(3)
CURLOPT_ACCEPT_ENCODING
Accept-Encoding and automatic decompressing data. See
_ACCEPT_ENCODING§ion=3">CURLOPT_ACCEPT_ENCODING(3)
CURLOPT_TRANSFER_ENCODING
Request Transfer-Encoding. See _TRANSFER_ENCODING§ion=3">CURLOPT_TRANSFER_ENCODING(3)
CURLOPT_FOLLOWLOCATION
Follow HTTP redirects. See _FOLLOWLOCATION§ion=3">CURLOPT_FOLLOWLOCATION(3)
CURLOPT_UNRESTRICTED_AUTH
Do not restrict authentication to original host.
_UNRESTRICTED_AUTH§ion=3">CURLOPT_UNRESTRICTED_AUTH(3)
CURLOPT_MAXREDIRS
Maximum number of redirects to follow. See _MAXREDIRS§ion=3">CURLOPT_MAXREDIRS(3)
CURLOPT_POSTREDIR
How to act on redirects after POST. See _POSTREDIR§ion=3">CURLOPT_POSTREDIR(3)
CURLOPT_PUT
Issue an HTTP PUT request. See _PUT§ion=3">CURLOPT_PUT(3)
CURLOPT_POST
Issue an HTTP POST request. See _POST§ion=3">CURLOPT_POST(3)
CURLOPT_POSTFIELDS
Send a POST with this data. See _POSTFIELDS§ion=3">CURLOPT_POSTFIELDS(3)
CURLOPT_POSTFIELDSIZE
The POST data is this big. See _POSTFIELDSIZE§ion=3">CURLOPT_POSTFIELDSIZE(3)
CURLOPT_POSTFIELDSIZE_LARGE
The POST data is this big. See _POSTFIELDSIZE_LARGE§ion=3">CURLOPT_POSTFIELDSIZE_LARGE(3)
CURLOPT_COPYPOSTFIELDS
Send a POST with this data - and copy it. See
_COPYPOSTFIELDS§ion=3">CURLOPT_COPYPOSTFIELDS(3)
CURLOPT_HTTPPOST
Multipart formpost HTTP POST. See _HTTPPOST§ion=3">CURLOPT_HTTPPOST(3)
CURLOPT_REFERER
Referer: header. See _REFERER§ion=3">CURLOPT_REFERER(3)
CURLOPT_USERAGENT
User-Agent: header. See _USERAGENT§ion=3">CURLOPT_USERAGENT(3)
CURLOPT_HTTPHEADER
Custom HTTP headers. See _HTTPHEADER§ion=3">CURLOPT_HTTPHEADER(3)
CURLOPT_HEADEROPT
Control custom headers. See _HEADEROPT§ion=3">CURLOPT_HEADEROPT(3)
CURLOPT_PROXYHEADER
Custom HTTP headers sent to proxy. See _PROXYHEADER§ion=3">CURLOPT_PROXYHEADER(3)
CURLOPT_HTTP200ALIASES
Alternative versions of 200 OK. See _HTTP200ALIASES§ion=3">CURLOPT_HTTP200ALIASES(3)
CURLOPT_COOKIE
Cookie(s) to send. See _COOKIE§ion=3">CURLOPT_COOKIE(3)
CURLOPT_COOKIEFILE
File to read cookies from. See _COOKIEFILE§ion=3">CURLOPT_COOKIEFILE(3)
CURLOPT_COOKIEJAR
File to write cookies to. See _COOKIEJAR§ion=3">CURLOPT_COOKIEJAR(3)
CURLOPT_COOKIESESSION
Start a new cookie session. See _COOKIESESSION§ion=3">CURLOPT_COOKIESESSION(3)
CURLOPT_COOKIELIST
Add or control cookies. See _COOKIELIST§ion=3">CURLOPT_COOKIELIST(3)
CURLOPT_ALTSVC
Specify the Alt-Svc: cache file name. See _ALTSVC§ion=3">CURLOPT_ALTSVC(3)
CURLOPT_ALTSVC_CTRL
Enable and configure Alt-Svc: treatment. See
_ALTSVC_CTRL§ion=3">CURLOPT_ALTSVC_CTRL(3)
CURLOPT_HSTS
Set HSTS cache file. See _HSTS§ion=3">CURLOPT_HSTS(3)
CURLOPT_HSTS_CTRL
Enable HSTS. See _HSTS_CTRL§ion=3">CURLOPT_HSTS_CTRL(3)
CURLOPT_HSTSREADFUNCTION
Set HSTS read callback. See _HSTSREADFUNCTION§ion=3">CURLOPT_HSTSREADFUNCTION(3)
CURLOPT_HSTSREADDATA
Pass pointer to the HSTS read callback. See
_HSTSREADDATA§ion=3">CURLOPT_HSTSREADDATA(3)
CURLOPT_HSTSWRITEFUNCTION
Set HSTS write callback. See _HSTSWRITEFUNCTION§ion=3">CURLOPT_HSTSWRITEFUNCTION(3)
CURLOPT_HSTSWRITEDATA
Pass pointer to the HSTS write callback. See
_HSTSWRITEDATA§ion=3">CURLOPT_HSTSWRITEDATA(3)
CURLOPT_HTTPGET
Do an HTTP GET request. See _HTTPGET§ion=3">CURLOPT_HTTPGET(3)
CURLOPT_REQUEST_TARGET
Set the request target. _REQUEST_TARGET§ion=3">CURLOPT_REQUEST_TARGET(3)
CURLOPT_HTTP_VERSION
HTTP version to use. _HTTP_VERSION§ion=3">CURLOPT_HTTP_VERSION(3)
CURLOPT_HTTP09_ALLOWED
Allow HTTP/0.9 responses. _HTTP09_ALLOWED§ion=3">CURLOPT_HTTP09_ALLOWED(3)
CURLOPT_IGNORE_CONTENT_LENGTH
Ignore Content-Length. See _IGNORE_CONTENT_LENGTH§ion=3">CURLOPT_IGNORE_CONTENT_LENGTH(3)
CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See _HTTP_CONTENT_DECODING§ion=3">CURLOPT_HTTP_CONTENT_DECODING(3)
CURLOPT_HTTP_TRANSFER_DECODING
Disable Transfer decoding. See _HTTP_TRANSFER_DECODING§ion=3">CURLOPT_HTTP_TRANSFER_DECODING(3)
CURLOPT_EXPECT_100_TIMEOUT_MS
100-continue timeout. See _EXPECT_100_TIMEOUT_MS§ion=3">CURLOPT_EXPECT_100_TIMEOUT_MS(3)
CURLOPT_TRAILERFUNCTION
Set callback for sending trailing headers. See
_TRAILERFUNCTION§ion=3">CURLOPT_TRAILERFUNCTION(3)
CURLOPT_TRAILERDATA
Custom pointer passed to the trailing headers callback. See
_TRAILERDATA§ion=3">CURLOPT_TRAILERDATA(3)
CURLOPT_PIPEWAIT
Wait on connection to pipeline on it. See _PIPEWAIT§ion=3">CURLOPT_PIPEWAIT(3)
CURLOPT_STREAM_DEPENDS
This HTTP/2 stream depends on another. See
_STREAM_DEPENDS§ion=3">CURLOPT_STREAM_DEPENDS(3)
CURLOPT_STREAM_DEPENDS_E
This HTTP/2 stream depends on another exclusively. See
_STREAM_DEPENDS_E§ion=3">CURLOPT_STREAM_DEPENDS_E(3)
CURLOPT_STREAM_WEIGHT
Set this HTTP/2 stream's weight. See _STREAM_WEIGHT§ion=3">CURLOPT_STREAM_WEIGHT(3)
SMTP OPTIONS
CURLOPT_MAIL_FROM
Address of the sender. See _MAIL_FROM§ion=3">CURLOPT_MAIL_FROM(3)
CURLOPT_MAIL_RCPT
Address of the recipients. See _MAIL_RCPT§ion=3">CURLOPT_MAIL_RCPT(3)
CURLOPT_MAIL_AUTH
Authentication address. See _MAIL_AUTH§ion=3">CURLOPT_MAIL_AUTH(3)
CURLOPT_MAIL_RCPT_ALLLOWFAILS
Allow RCPT TO command to fail for some recipients. See
_MAIL_RCPT_ALLLOWFAILS§ion=3">CURLOPT_MAIL_RCPT_ALLLOWFAILS(3)
TFTP OPTIONS
CURLOPT_TFTP_BLKSIZE
TFTP block size. See _TFTP_BLKSIZE§ion=3">CURLOPT_TFTP_BLKSIZE(3)
CURLOPT_TFTP_NO_OPTIONS
Do not send TFTP options requests. See
_TFTP_NO_OPTIONS§ion=3">CURLOPT_TFTP_NO_OPTIONS(3)
FTP OPTIONS
CURLOPT_FTPPORT
Use active FTP. See _FTPPORT§ion=3">CURLOPT_FTPPORT(3)
CURLOPT_QUOTE
Commands to run before transfer. See _QUOTE§ion=3">CURLOPT_QUOTE(3)
CURLOPT_POSTQUOTE
Commands to run after transfer. See _POSTQUOTE§ion=3">CURLOPT_POSTQUOTE(3)
CURLOPT_PREQUOTE
Commands to run just before transfer. See _PREQUOTE§ion=3">CURLOPT_PREQUOTE(3)
CURLOPT_APPEND
Append to remote file. See _APPEND§ion=3">CURLOPT_APPEND(3)
CURLOPT_FTP_USE_EPRT
Use EPTR. See _FTP_USE_EPRT§ion=3">CURLOPT_FTP_USE_EPRT(3)
CURLOPT_FTP_USE_EPSV
Use EPSV. See _FTP_USE_EPSV§ion=3">CURLOPT_FTP_USE_EPSV(3)
CURLOPT_FTP_USE_PRET
Use PRET. See _FTP_USE_PRET§ion=3">CURLOPT_FTP_USE_PRET(3)
CURLOPT_FTP_CREATE_MISSING_DIRS
Create missing directories on the remote server. See
_FTP_CREATE_MISSING_DIRS§ion=3">CURLOPT_FTP_CREATE_MISSING_DIRS(3)
CURLOPT_FTP_RESPONSE_TIMEOUT
Timeout for FTP responses. See _FTP_RESPONSE_TIMEOUT§ion=3">CURLOPT_FTP_RESPONSE_TIMEOUT(3)
CURLOPT_FTP_ALTERNATIVE_TO_USER
Alternative to USER. See _FTP_ALTERNATIVE_TO_USER§ion=3">CURLOPT_FTP_ALTERNATIVE_TO_USER(3)
CURLOPT_FTP_SKIP_PASV_IP
Ignore the IP address in the PASV response. See
_FTP_SKIP_PASV_IP§ion=3">CURLOPT_FTP_SKIP_PASV_IP(3)
CURLOPT_FTPSSLAUTH
Control how to do TLS. See _FTPSSLAUTH§ion=3">CURLOPT_FTPSSLAUTH(3)
CURLOPT_FTP_SSL_CCC
Back to non-TLS again after authentication. See
_FTP_SSL_CCC§ion=3">CURLOPT_FTP_SSL_CCC(3)
CURLOPT_FTP_ACCOUNT
Send ACCT command. See _FTP_ACCOUNT§ion=3">CURLOPT_FTP_ACCOUNT(3)
CURLOPT_FTP_FILEMETHOD
Specify how to reach files. See _FTP_FILEMETHOD§ion=3">CURLOPT_FTP_FILEMETHOD(3)
RTSP OPTIONS
CURLOPT_RTSP_REQUEST
RTSP request. See _RTSP_REQUEST§ion=3">CURLOPT_RTSP_REQUEST(3)
CURLOPT_RTSP_SESSION_ID
RTSP session-id. See _RTSP_SESSION_ID§ion=3">CURLOPT_RTSP_SESSION_ID(3)
CURLOPT_RTSP_STREAM_URI
RTSP stream URI. See _RTSP_STREAM_URI§ion=3">CURLOPT_RTSP_STREAM_URI(3)
CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See _RTSP_TRANSPORT§ion=3">CURLOPT_RTSP_TRANSPORT(3)
CURLOPT_RTSP_CLIENT_CSEQ
Client CSEQ number. See _RTSP_CLIENT_CSEQ§ion=3">CURLOPT_RTSP_CLIENT_CSEQ(3)
CURLOPT_RTSP_SERVER_CSEQ
CSEQ number for RTSP Server->Client request. See
_RTSP_SERVER_CSEQ§ion=3">CURLOPT_RTSP_SERVER_CSEQ(3)
CURLOPT_AWS_SIGV4
AWS HTTP V4 Signature. See _AWS_SIGV4§ion=3">CURLOPT_AWS_SIGV4(3)
PROTOCOL OPTIONS
CURLOPT_TRANSFERTEXT
Use text transfer. See _TRANSFERTEXT§ion=3">CURLOPT_TRANSFERTEXT(3)
CURLOPT_PROXY_TRANSFER_MODE
Add transfer mode to URL over proxy. See
_PROXY_TRANSFER_MODE§ion=3">CURLOPT_PROXY_TRANSFER_MODE(3)
CURLOPT_CRLF
Convert newlines. See _CRLF§ion=3">CURLOPT_CRLF(3)
CURLOPT_RANGE
Range requests. See _RANGE§ion=3">CURLOPT_RANGE(3)
CURLOPT_RESUME_FROM
Resume a transfer. See _RESUME_FROM§ion=3">CURLOPT_RESUME_FROM(3)
CURLOPT_RESUME_FROM_LARGE
Resume a transfer. See _RESUME_FROM_LARGE§ion=3">CURLOPT_RESUME_FROM_LARGE(3)
CURLOPT_CURLU
Set URL to work on with CURLU *. See _CURLU§ion=3">CURLOPT_CURLU(3)
CURLOPT_CUSTOMREQUEST
Custom request/method. See _CUSTOMREQUEST§ion=3">CURLOPT_CUSTOMREQUEST(3)
CURLOPT_FILETIME
Request file modification date and time. See _FILETIME§ion=3">CURLOPT_FILETIME(3)
CURLOPT_DIRLISTONLY
List only. See _DIRLISTONLY§ion=3">CURLOPT_DIRLISTONLY(3)
CURLOPT_NOBODY
Do not get the body contents. See _NOBODY§ion=3">CURLOPT_NOBODY(3)
CURLOPT_INFILESIZE
Size of file to send. _INFILESIZE§ion=3">CURLOPT_INFILESIZE(3)
CURLOPT_INFILESIZE_LARGE
Size of file to send. _INFILESIZE_LARGE§ion=3">CURLOPT_INFILESIZE_LARGE(3)
CURLOPT_UPLOAD
Upload data. See _UPLOAD§ion=3">CURLOPT_UPLOAD(3)
CURLOPT_UPLOAD_BUFFERSIZE
Set upload buffer size. See _UPLOAD_BUFFERSIZE§ion=3">CURLOPT_UPLOAD_BUFFERSIZE(3)
CURLOPT_MIMEPOST
Post/send MIME data. See _MIMEPOST§ion=3">CURLOPT_MIMEPOST(3)
CURLOPT_MAXFILESIZE
Maximum file size to get. See _MAXFILESIZE§ion=3">CURLOPT_MAXFILESIZE(3)
CURLOPT_MAXFILESIZE_LARGE
Maximum file size to get. See _MAXFILESIZE_LARGE§ion=3">CURLOPT_MAXFILESIZE_LARGE(3)
CURLOPT_TIMECONDITION
Make a time conditional request. See _TIMECONDITION§ion=3">CURLOPT_TIMECONDITION(3)
CURLOPT_TIMEVALUE
Time value for the time conditional request. See
_TIMEVALUE§ion=3">CURLOPT_TIMEVALUE(3)
CURLOPT_TIMEVALUE_LARGE
Time value for the time conditional request. See
_TIMEVALUE_LARGE§ion=3">CURLOPT_TIMEVALUE_LARGE(3)
CONNECTION OPTIONS
CURLOPT_TIMEOUT
Timeout for the entire request. See _TIMEOUT§ion=3">CURLOPT_TIMEOUT(3)
CURLOPT_TIMEOUT_MS
Millisecond timeout for the entire request. See
_TIMEOUT_MS§ion=3">CURLOPT_TIMEOUT_MS(3)
CURLOPT_LOW_SPEED_LIMIT
Low speed limit to abort transfer. See
_LOW_SPEED_LIMIT§ion=3">CURLOPT_LOW_SPEED_LIMIT(3)
CURLOPT_LOW_SPEED_TIME
Time to be below the speed to trigger low speed abort. See
_LOW_SPEED_TIME§ion=3">CURLOPT_LOW_SPEED_TIME(3)
CURLOPT_MAX_SEND_SPEED_LARGE
Cap the upload speed to this. See
_MAX_SEND_SPEED_LARGE§ion=3">CURLOPT_MAX_SEND_SPEED_LARGE(3)
CURLOPT_MAX_RECV_SPEED_LARGE
Cap the download speed to this. See
_MAX_RECV_SPEED_LARGE§ion=3">CURLOPT_MAX_RECV_SPEED_LARGE(3)
CURLOPT_MAXCONNECTS
Maximum number of connections in the connection pool. See
_MAXCONNECTS§ion=3">CURLOPT_MAXCONNECTS(3)
CURLOPT_FRESH_CONNECT
Use a new connection. _FRESH_CONNECT§ion=3">CURLOPT_FRESH_CONNECT(3)
CURLOPT_FORBID_REUSE
Prevent subsequent connections from re-using this. See
_FORBID_REUSE§ion=3">CURLOPT_FORBID_REUSE(3)
CURLOPT_MAXAGE_CONN
Limit the age of connections for reuse. See
_MAXAGE_CONN§ion=3">CURLOPT_MAXAGE_CONN(3)
CURLOPT_CONNECTTIMEOUT
Timeout for the connection phase. See _CONNECTTIMEOUT§ion=3">CURLOPT_CONNECTTIMEOUT(3)
CURLOPT_CONNECTTIMEOUT_MS
Millisecond timeout for the connection phase. See
_CONNECTTIMEOUT_MS§ion=3">CURLOPT_CONNECTTIMEOUT_MS(3)
CURLOPT_IPRESOLVE
IP version to use. See _IPRESOLVE§ion=3">CURLOPT_IPRESOLVE(3)
CURLOPT_CONNECT_ONLY
Only connect, nothing else. See _CONNECT_ONLY§ion=3">CURLOPT_CONNECT_ONLY(3)
CURLOPT_USE_SSL
Use TLS/SSL. See _USE_SSL§ion=3">CURLOPT_USE_SSL(3)
CURLOPT_RESOLVE
Provide fixed/fake name resolves. See _RESOLVE§ion=3">CURLOPT_RESOLVE(3)
CURLOPT_DNS_INTERFACE
Bind name resolves to this interface. See
_DNS_INTERFACE§ion=3">CURLOPT_DNS_INTERFACE(3)
CURLOPT_DNS_LOCAL_IP4
Bind name resolves to this IP4 address. See
_DNS_LOCAL_IP4§ion=3">CURLOPT_DNS_LOCAL_IP4(3)
CURLOPT_DNS_LOCAL_IP6
Bind name resolves to this IP6 address. See
_DNS_LOCAL_IP6§ion=3">CURLOPT_DNS_LOCAL_IP6(3)
CURLOPT_DNS_SERVERS
Preferred DNS servers. See _DNS_SERVERS§ion=3">CURLOPT_DNS_SERVERS(3)
CURLOPT_DNS_SHUFFLE_ADDRESSES
Shuffle addresses before use. See
_DNS_SHUFFLE_ADDRESSES§ion=3">CURLOPT_DNS_SHUFFLE_ADDRESSES(3)
CURLOPT_ACCEPTTIMEOUT_MS
Timeout for waiting for the server's connect back to be
accepted. See _ACCEPTTIMEOUT_MS§ion=3">CURLOPT_ACCEPTTIMEOUT_MS(3)
CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
Timeout for happy eyeballs. See
_HAPPY_EYEBALLS_TIMEOUT_MS§ion=3">CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS(3)
CURLOPT_UPKEEP_INTERVAL_MS
Sets the interval at which connection upkeep are performed. See
_UPKEEP_INTERVAL_MS§ion=3">CURLOPT_UPKEEP_INTERVAL_MS(3)
SSL and SECURITY OPTIONS
CURLOPT_SSLCERT
Client cert. See _SSLCERT§ion=3">CURLOPT_SSLCERT(3)
CURLOPT_SSLCERT_BLOB
Client cert memory buffer. See _SSLCERT_BLOB§ion=3">CURLOPT_SSLCERT_BLOB(3)
CURLOPT_PROXY_SSLCERT
Proxy client cert. See _PROXY_SSLCERT§ion=3">CURLOPT_PROXY_SSLCERT(3)
CURLOPT_PROXY_SSLCERT_BLOB
Proxy client cert memory buffer. See
_PROXY_SSLCERT_BLOB§ion=3">CURLOPT_PROXY_SSLCERT_BLOB(3)
CURLOPT_SSLCERTTYPE
Client cert type. See _SSLCERTTYPE§ion=3">CURLOPT_SSLCERTTYPE(3)
CURLOPT_PROXY_SSLCERTTYPE
Proxy client cert type. See _PROXY_SSLCERTTYPE§ion=3">CURLOPT_PROXY_SSLCERTTYPE(3)
CURLOPT_SSLKEY
Client key. See _SSLKEY§ion=3">CURLOPT_SSLKEY(3)
CURLOPT_SSLKEY_BLOB
Client key memory buffer. See _SSLKEY_BLOB§ion=3">CURLOPT_SSLKEY_BLOB(3)
CURLOPT_PROXY_SSLKEY
Proxy client key. See _PROXY_SSLKEY§ion=3">CURLOPT_PROXY_SSLKEY(3)
CURLOPT_PROXY_SSLKEY_BLOB
Proxy client key. See _PROXY_SSLKEY_BLOB§ion=3">CURLOPT_PROXY_SSLKEY_BLOB(3)
CURLOPT_SSLKEYTYPE
Client key type. See _SSLKEYTYPE§ion=3">CURLOPT_SSLKEYTYPE(3)
CURLOPT_PROXY_SSLKEYTYPE
Proxy client key type. See _PROXY_SSLKEYTYPE§ion=3">CURLOPT_PROXY_SSLKEYTYPE(3)
CURLOPT_KEYPASSWD
Client key password. See _KEYPASSWD§ion=3">CURLOPT_KEYPASSWD(3)
CURLOPT_PROXY_KEYPASSWD
Proxy client key password. See _PROXY_KEYPASSWD§ion=3">CURLOPT_PROXY_KEYPASSWD(3)
CURLOPT_SSL_EC_CURVES
Set key exchange curves. See _SSL_EC_CURVES§ion=3">CURLOPT_SSL_EC_CURVES(3)
CURLOPT_SSL_ENABLE_ALPN
Enable use of ALPN. See _SSL_ENABLE_ALPN§ion=3">CURLOPT_SSL_ENABLE_ALPN(3)
CURLOPT_SSL_ENABLE_NPN
Enable use of NPN. See _SSL_ENABLE_NPN§ion=3">CURLOPT_SSL_ENABLE_NPN(3)
CURLOPT_SSLENGINE
Use identifier with SSL engine. See _SSLENGINE§ion=3">CURLOPT_SSLENGINE(3)
CURLOPT_SSLENGINE_DEFAULT
Default SSL engine. See _SSLENGINE_DEFAULT§ion=3">CURLOPT_SSLENGINE_DEFAULT(3)
CURLOPT_SSL_FALSESTART
Enable TLS False Start. See _SSL_FALSESTART§ion=3">CURLOPT_SSL_FALSESTART(3)
CURLOPT_SSLVERSION
SSL version to use. See _SSLVERSION§ion=3">CURLOPT_SSLVERSION(3)
CURLOPT_PROXY_SSLVERSION
Proxy SSL version to use. See _PROXY_SSLVERSION§ion=3">CURLOPT_PROXY_SSLVERSION(3)
CURLOPT_SSL_VERIFYHOST
Verify the host name in the SSL certificate. See
_SSL_VERIFYHOST§ion=3">CURLOPT_SSL_VERIFYHOST(3)
CURLOPT_DOH_SSL_VERIFYHOST
Verify the host name in the DOH (DNS-over-HTTPS) SSL
certificate. See _DOH_SSL_VERIFYHOST§ion=3">CURLOPT_DOH_SSL_VERIFYHOST(3)
CURLOPT_PROXY_SSL_VERIFYHOST
Verify the host name in the proxy SSL certificate. See
_PROXY_SSL_VERIFYHOST§ion=3">CURLOPT_PROXY_SSL_VERIFYHOST(3)
CURLOPT_SSL_VERIFYPEER
Verify the SSL certificate. See _SSL_VERIFYPEER§ion=3">CURLOPT_SSL_VERIFYPEER(3)
CURLOPT_DOH_SSL_VERIFYPEER
Verify the DOH (DNS-over-HTTPS) SSL certificate. See
_DOH_SSL_VERIFYPEER§ion=3">CURLOPT_DOH_SSL_VERIFYPEER(3)
CURLOPT_PROXY_SSL_VERIFYPEER
Verify the proxy SSL certificate. See
_PROXY_SSL_VERIFYPEER§ion=3">CURLOPT_PROXY_SSL_VERIFYPEER(3)
CURLOPT_SSL_VERIFYSTATUS
Verify the SSL certificate's status. See
_SSL_VERIFYSTATUS§ion=3">CURLOPT_SSL_VERIFYSTATUS(3)
CURLOPT_DOH_SSL_VERIFYSTATUS
Verify the DOH (DNS-over-HTTPS) SSL certificate's status. See
_DOH_SSL_VERIFYSTATUS§ion=3">CURLOPT_DOH_SSL_VERIFYSTATUS(3)
CURLOPT_CAINFO
CA cert bundle. See _CAINFO§ion=3">CURLOPT_CAINFO(3)
CURLOPT_CAINFO_BLOB
CA cert bundle memory buffer. See _CAINFO_BLOB§ion=3">CURLOPT_CAINFO_BLOB(3)
CURLOPT_PROXY_CAINFO
Proxy CA cert bundle. See _PROXY_CAINFO§ion=3">CURLOPT_PROXY_CAINFO(3)
CURLOPT_PROXY_CAINFO_BLOB
Proxy CA cert bundle memory buffer. See
_PROXY_CAINFO_BLOB§ion=3">CURLOPT_PROXY_CAINFO_BLOB(3)
CURLOPT_ISSUERCERT
Issuer certificate. See _ISSUERCERT§ion=3">CURLOPT_ISSUERCERT(3)
CURLOPT_ISSUERCERT_BLOB
Issuer certificate memory buffer. See _ISSUERCERT_BLOB§ion=3">CURLOPT_ISSUERCERT_BLOB(3)
CURLOPT_PROXY_ISSUERCERT
Proxy issuer certificate. See _PROXY_ISSUERCERT§ion=3">CURLOPT_PROXY_ISSUERCERT(3)
CURLOPT_PROXY_ISSUERCERT_BLOB
Proxy issuer certificate memory buffer. See
_PROXY_ISSUERCERT_BLOB§ion=3">CURLOPT_PROXY_ISSUERCERT_BLOB(3)
CURLOPT_CAPATH
Path to CA cert bundle. See _CAPATH§ion=3">CURLOPT_CAPATH(3)
CURLOPT_PROXY_CAPATH
Path to proxy CA cert bundle. See _PROXY_CAPATH§ion=3">CURLOPT_PROXY_CAPATH(3)
CURLOPT_CRLFILE
Certificate Revocation List. See _CRLFILE§ion=3">CURLOPT_CRLFILE(3)
CURLOPT_PROXY_CRLFILE
Proxy Certificate Revocation List. See _PROXY_CRLFILE§ion=3">CURLOPT_PROXY_CRLFILE(3)
CURLOPT_CERTINFO
Extract certificate info. See _CERTINFO§ion=3">CURLOPT_CERTINFO(3)
CURLOPT_PINNEDPUBLICKEY
Set pinned SSL public key . See _PINNEDPUBLICKEY§ion=3">CURLOPT_PINNEDPUBLICKEY(3)
CURLOPT_PROXY_PINNEDPUBLICKEY
Set the proxy's pinned SSL public key. See
_PROXY_PINNEDPUBLICKEY§ion=3">CURLOPT_PROXY_PINNEDPUBLICKEY(3)
CURLOPT_RANDOM_FILE
Provide source for entropy random data. See
_RANDOM_FILE§ion=3">CURLOPT_RANDOM_FILE(3)
CURLOPT_EGDSOCKET
Identify EGD socket for entropy. See _EGDSOCKET§ion=3">CURLOPT_EGDSOCKET(3)
CURLOPT_SSL_CIPHER_LIST
Ciphers to use. See _SSL_CIPHER_LIST§ion=3">CURLOPT_SSL_CIPHER_LIST(3)
CURLOPT_PROXY_SSL_CIPHER_LIST
Proxy ciphers to use. See _PROXY_SSL_CIPHER_LIST§ion=3">CURLOPT_PROXY_SSL_CIPHER_LIST(3)
CURLOPT_TLS13_CIPHERS
TLS 1.3 cipher suites to use. See _TLS13_CIPHERS§ion=3">CURLOPT_TLS13_CIPHERS(3)
CURLOPT_PROXY_TLS13_CIPHERS
Proxy TLS 1.3 cipher suites to use. See
_PROXY_TLS13_CIPHERS§ion=3">CURLOPT_PROXY_TLS13_CIPHERS(3)
CURLOPT_SSL_SESSIONID_CACHE
Disable SSL session-id cache. See _SSL_SESSIONID_CACHE§ion=3">CURLOPT_SSL_SESSIONID_CACHE(3)
CURLOPT_SSL_OPTIONS
Control SSL behavior. See _SSL_OPTIONS§ion=3">CURLOPT_SSL_OPTIONS(3)
CURLOPT_PROXY_SSL_OPTIONS
Control proxy SSL behavior. See _PROXY_SSL_OPTIONS§ion=3">CURLOPT_PROXY_SSL_OPTIONS(3)
CURLOPT_KRBLEVEL
Kerberos security level. See _KRBLEVEL§ion=3">CURLOPT_KRBLEVEL(3)
CURLOPT_GSSAPI_DELEGATION
Disable GSS-API delegation. See _GSSAPI_DELEGATION§ion=3">CURLOPT_GSSAPI_DELEGATION(3)
SSH OPTIONS
CURLOPT_SSH_AUTH_TYPES
SSH authentication types. See _SSH_AUTH_TYPES§ion=3">CURLOPT_SSH_AUTH_TYPES(3)
CURLOPT_SSH_COMPRESSION
Enable SSH compression. See _SSH_COMPRESSION§ion=3">CURLOPT_SSH_COMPRESSION(3)
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
MD5 of host's public key. See _SSH_HOST_PUBLIC_KEY_MD5§ion=3">CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3)
CURLOPT_SSH_PUBLIC_KEYFILE
File name of public key. See _SSH_PUBLIC_KEYFILE§ion=3">CURLOPT_SSH_PUBLIC_KEYFILE(3)
CURLOPT_SSH_PRIVATE_KEYFILE
File name of private key. See _SSH_PRIVATE_KEYFILE§ion=3">CURLOPT_SSH_PRIVATE_KEYFILE(3)
CURLOPT_SSH_KNOWNHOSTS
File name with known hosts. See _SSH_KNOWNHOSTS§ion=3">CURLOPT_SSH_KNOWNHOSTS(3)
CURLOPT_SSH_KEYFUNCTION
Callback for known hosts handling. See
_SSH_KEYFUNCTION§ion=3">CURLOPT_SSH_KEYFUNCTION(3)
CURLOPT_SSH_KEYDATA
Custom pointer to pass to ssh key callback. See
_SSH_KEYDATA§ion=3">CURLOPT_SSH_KEYDATA(3)
OTHER OPTIONS
CURLOPT_PRIVATE
Private pointer to store. See _PRIVATE§ion=3">CURLOPT_PRIVATE(3)
CURLOPT_SHARE
Share object to use. See _SHARE§ion=3">CURLOPT_SHARE(3)
CURLOPT_NEW_FILE_PERMS
Mode for creating new remote files. See
_NEW_FILE_PERMS§ion=3">CURLOPT_NEW_FILE_PERMS(3)
CURLOPT_NEW_DIRECTORY_PERMS
Mode for creating new remote directories. See
_NEW_DIRECTORY_PERMS§ion=3">CURLOPT_NEW_DIRECTORY_PERMS(3)
TELNET OPTIONS
CURLOPT_TELNETOPTIONS
TELNET options. See _TELNETOPTIONS§ion=3">CURLOPT_TELNETOPTIONS(3)
RETURN VALUE
CURLE_OK (zero) means that the option was set properly, non-zero means
an error occurred as <curl/curl.h> defines. See the libcurl-errors(3)
man page for the full list with descriptions.
Strings passed on to libcurl must be shorter than 8000000 bytes,
otherwise _easy_setopt§ion=3">curl_easy_setopt(3) returns CURLE_BAD_FUNCTION_ARGUMENT
(added in 7.65.0).
CURLE_BAD_FUNCTION_ARGUMENT is returned when the argument to an option
is invalid, like perhaps out of range.
If you try to set an option that libcurl doesn't know about, perhaps
because the library is too old to support it or the option was removed
in a recent version, this function will return CURLE_UNKNOWN_OPTION. If
support for the option was disabled at compile-time, it will return
CURLE_NOT_BUILT_IN.
EXAMPLE
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "https://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
}
SEE ALSO
curl_easy_init(3), curl_easy_cleanup(3), curl_easy_reset(3),
curl_easy_getinfo(3), curl_multi_setopt(3), curl_easy_option_next(3),
curl_easy_option_by_name(3), curl_easy_option_by_id(3),
libcurl 7.77.0 April 24, 2021 curl_easy_setopt(3)
man2web Home...