Name
easy:SetOpt -- get options for a curl easy handle
Synopsis
easy:SetOpt(option, parameter)
easy:SetOpt(table)
Function
easy:SetOpt() is used to tell libcurl how to behave. By setting the appropriate options, the application can change libcurl's behavior. All options are get with an option followed by a parameter. That parameter can be a number, a string, a table, or a function reference, depending on what the specific option expects. Read this manual carefully as bad input values may cause libcurl to behave badly!

Options get 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().

easy:SetOpt() can be used in two different ways: You can either get a single option by passing the option and parameter arguments or you can get multiple options at once by passing a table argument to easy:SetOpt(). See below for an example.

The order in which the options are get does not matter.

The following option types are currently supported:

#CURLOPT_ABSTRACT_UNIX_SOCKET
Path to an abstract Unix domain socket. See easy:SetOpt_Abstract_Unix_Socket for details.
#CURLOPT_ACCEPT_ENCODING
Accept-Encoding and automatic decompressing data. See easy:SetOpt_Accept_Encoding for details.
#CURLOPT_ACCEPTTIMEOUT_MS
Timeout for waiting for the server's connect back to be accepted. See easy:SetOpt_AcceptTimeout_MS for details.
#CURLOPT_ADDRESS_SCOPE
IPv6 scope for local addresses. See easy:SetOpt_Address_Scope for details.
#CURLOPT_ALTSVC
Specify the Alt-Svc: cache file name. See easy:SetOpt_AltSvc for details. (V2.0)
#CURLOPT_ALTSVC_CTRL
Enable and configure Alt-Svc: treatment. See easy:SetOpt_AltSvc_Ctrl for details. (V2.0)
#CURLOPT_APPEND
Append to remote file. See easy:SetOpt_Append for details.
#CURLOPT_AUTOREFERER
Automatically get Referer: header. See easy:SetOpt_AutoReferer for details.
#CURLOPT_AWS_SIGV4
AWS HTTP V4 Signature. See easy:SetOpt_AWS_SigV4 for details. (V2.0)
#CURLOPT_BUFFERSIZE
Ask for alternate buffer size. See easy:SetOpt_BufferSize for details.
#CURLOPT_CA_CACHE_TIMEOUT
Timeout for CA cache. See easy:SetOpt_CA_Cache_Timeout for details. (V2.0)
#CURLOPT_CAINFO
CA cert bundle. See easy:SetOpt_CAInfo for details.
#CURLOPT_CAINFO_BLOB
CA cert bundle memory buffer. See easy:SetOpt_CAInfo_Blob for details. (V2.0)
#CURLOPT_CAPATH
Path to CA cert bundle. See easy:SetOpt_CAPath for details.
#CURLOPT_CERTINFO
Extract certificate info. See easy:SetOpt_CertInfo for details.
#CURLOPT_CHUNK_BGN_FUNCTION
Callback for wildcard download start of chunk. See easy:SetOpt_Chunk_BGN_Function for details.
#CURLOPT_CHUNK_END_FUNCTION
Callback for wildcard download end of chunk. See easy:SetOpt_Chunk_End_Function for details.
#CURLOPT_CONNECT_ONLY
Only connect, nothing else. See easy:SetOpt_Connect_Only for details.
#CURLOPT_CONNECT_TO
Connect to a specific host and port. See easy:SetOpt_Connect_To for details.
#CURLOPT_CONNECTTIMEOUT
Timeout for the connection phase. See easy:SetOpt_ConnectTimeout for details.
#CURLOPT_CONNECTTIMEOUT_MS
Millisecond timeout for the connection phase. See easy:SetOpt_ConnectTimeout_MS for details.
#CURLOPT_COOKIE
Cookie(s) to send. See easy:SetOpt_Cookie for details.
#CURLOPT_COOKIEFILE
File to read cookies from. See easy:SetOpt_CookieFile for details.
#CURLOPT_COOKIEJAR
File to write cookies to. See easy:SetOpt_CookieJar for details.
#CURLOPT_COOKIELIST
Add or control cookies. See easy:SetOpt_CookieList for details.
#CURLOPT_COOKIESESSION
Start a new cookie session. See easy:SetOpt_CookieSession for details.
#CURLOPT_CRLF
Convert newlines. See easy:SetOpt_CRLF for details.
#CURLOPT_CRLFILE
Certificate Revocation List. See easy:SetOpt_CRLFile for details.
#CURLOPT_CURLU
Set URL to work on with a URL handle. See easy:SetOpt_CURLU for details. (V2.0)
#CURLOPT_CUSTOMREQUEST
Custom request/method. See easy:SetOpt_CustomRequest for details.
#CURLOPT_DEBUGFUNCTION
Callback for debug information. See easy:SetOpt_DebugFunction for details.
#CURLOPT_DEFAULT_PROTOCOL
Default protocol. See easy:SetOpt_Default_Protocol for details.
#CURLOPT_DIRLISTONLY
List only. See easy:SetOpt_DirListOnly for details.
#CURLOPT_DNS_CACHE_TIMEOUT
Timeout for DNS cache. See easy:SetOpt_DNS_Cache_Timeout for details.
#CURLOPT_DNS_INTERFACE
Bind name resolves to this interface. See easy:SetOpt_DNS_Interface for details.
#CURLOPT_DNS_LOCAL_IP4
Bind name resolves to this IP4 address. See easy:SetOpt_DNS_Local_IP4 for details.
#CURLOPT_DNS_LOCAL_IP6
Bind name resolves to this IP6 address. See easy:SetOpt_DNS_Local_IP6 for details.
#CURLOPT_DNS_SERVERS
Preferred DNS servers. See easy:SetOpt_DNS_Servers for details.
#CURLOPT_DNS_SHUFFLE_ADDRESSES
Shuffle addresses before use. See easy:SetOpt_DNS_Shuffle_Addresses for details. (V2.0)
#CURLOPT_DNS_USE_GLOBAL_CACHE
OBSOLETE Enable global DNS cache. See easy:SetOpt_DNS_Use_Global_Cache for details.
#CURLOPT_DISALLOW_USERNAME_IN_URL
Do not allow username in URL. See easy:SetOpt_Disallow_Username_In_URL for details. (V2.0)
#CURLOPT_DOH_SSL_VERIFYHOST
Verify the host name in the DoH (DNS-over-HTTPS) SSL certificate. See easy:SetOpt_DoH_SSL_VerifyHost for details. (V2.0)
#CURLOPT_DOH_SSL_VERIFYPEER
Verify the DoH (DNS-over-HTTPS) SSL certificate. See easy:SetOpt_DoH_SSL_VerifyPeer for details. (V2.0)
#CURLOPT_DOH_SSL_VERIFYSTATUS
Verify the DoH (DNS-over-HTTPS) SSL certificate's status. See easy:SetOpt_DoH_SSL_VerifyStatus for details. (V2.0)
#CURLOPT_DOH_URL
Use this DoH server for name resolves. See easy:SetOpt_DoH_URL for details. (V2.0)
#CURLOPT_EGDSOCKET
Identify EGD socket for entropy. See easy:SetOpt_EGDSocket for details.
#CURLOPT_EXPECT_100_TIMEOUT_MS
100-continue timeout. See easy:SetOpt_Expect_100_Timeout_MS for details.
#CURLOPT_FAILONERROR
Fail on HTTP 4xx errors. See easy:SetOpt_FailOnError for details.
#CURLOPT_FILETIME
Request file modification date and time. See easy:SetOpt_FileTime for details.
#CURLOPT_FNMATCH_FUNCTION
Callback for wildcard matching. See easy:SetOpt_FNMatch_Function for details.
#CURLOPT_FOLLOWLOCATION
Follow HTTP redirects. See easy:SetOpt_FollowLocation for details.
#CURLOPT_FORBID_REUSE
Prevent subsequent connections from re-using this. See easy:SetOpt_Forbid_Reuse for details.
#CURLOPT_FRESH_CONNECT
Use a new connection. See easy:SetOpt_Fresh_Connect for details.
#CURLOPT_FTP_ACCOUNT
Send ACCT command. See easy:SetOpt_FTP_Account for details.
#CURLOPT_FTP_ALTERNATIVE_TO_USER
Alternative to USER. See easy:SetOpt_FTP_Alternative_To_User for details.
#CURLOPT_FTP_CREATE_MISSING_DIRS
Create missing directories on the remote server. See easy:SetOpt_FTP_Create_Missing_Dirs for details.
#CURLOPT_FTP_FILEMETHOD
Specify how to reach files. See easy:SetOpt_FTP_FileMethod for details.
#CURLOPT_FTP_RESPONSE_TIMEOUT
Timeout for FTP responses. See easy:SetOpt_FTP_Response_Timeout for details.
#CURLOPT_FTP_SKIP_PASV_IP
Ignore the IP address in the PASV response. See easy:SetOpt_FTP_Skip_PASV_IP for details.
#CURLOPT_FTP_SSL_CCC
Back to non-TLS again after authentication. See easy:SetOpt_FTP_SSL_CCC for details.
#CURLOPT_FTP_USE_EPRT
Use EPTR. See easy:SetOpt_FTP_Use_Eprt for details.
#CURLOPT_FTP_USE_EPSV
Use EPSV. See easy:SetOpt_FTP_Use_Epsv for details.
#CURLOPT_FTP_USE_PRET
Use PRET. See easy:SetOpt_FTP_Use_Pret for details.
#CURLOPT_FTPPORT
Use active FTP. See easy:SetOpt_FTPPort for details.
#CURLOPT_FTPSSLAUTH
Control how to do TLS. See easy:SetOpt_FTPSSLAuth for details.
#CURLOPT_GSSAPI_DELEGATION
Disable GSS-API delegation. See easy:SetOpt_GSSAPI_Delegation for details.
#CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS
Timeout for happy eyeballs. See easy:SetOpt_Happy_Eyeballs_Timeout_MS for details. (V2.0)
#CURLOPT_HAPROXYPROTOCOL
Send an HAProxy PROXY protocol v1 header. See easy:SetOpt_HAProxyProtocol for details. (V2.0)
#CURLOPT_HEADER
Include the header in the body output. See easy:SetOpt_Header for details.
#CURLOPT_HEADERFUNCTION
Callback for writing received headers. See easy:SetOpt_HeaderFunction for details.
#CURLOPT_HEADEROPT
Control custom headers. See easy:SetOpt_HeaderOpt for details.
#CURLOPT_HSTS
Set HSTS cache file. See easy:SetOpt_HSTS for details. (V2.0)
#CURLOPT_HSTS_CTRL
Enable HSTS. See easy:SetOpt_HSTS_Ctrl for details. (V2.0)
#CURLOPT_HSTSREADFUNCTION
Set HSTS read callback. See easy:SetOpt_HSTSReadFunction for details. (V2.0)
#CURLOPT_HSTSWRITEFUNCTION
Set HSTS write callback. See easy:SetOpt_HSTSWriteFunction for details. (V2.0)
#CURLOPT_HTTP09_ALLOWED
Allow HTTP/0. See easy:SetOpt_HTTP09_Allowed for details. (V2.0)
#CURLOPT_HTTP200ALIASES
Alternative versions of 200 OK. See easy:SetOpt_HTTP200Aliases for details.
#CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See easy:SetOpt_HTTP_Content_Decoding for details.
#CURLOPT_HTTP_TRANSFER_DECODING
Disable Transfer decoding. See easy:SetOpt_HTTP_Transfer_Decoding for details.
#CURLOPT_HTTP_VERSION
HTTP version to use. See easy:SetOpt_HTTP_Version for details.
#CURLOPT_HTTPAUTH
HTTP server authentication methods. See easy:SetOpt_HTTPAuth for details.
#CURLOPT_HTTPGET
Do an HTTP GET request. See easy:SetOpt_HTTPGet for details.
#CURLOPT_HTTPHEADER
Custom HTTP headers. See easy:SetOpt_HTTPHeader for details.
#CURLOPT_HTTPPOST
Multipart formpost HTTP POST. See easy:SetOpt_HTTPPost for details.
#CURLOPT_HTTPPROXYTUNNEL
Tunnel through the HTTP proxy. See easy:SetOpt_HTTPProxyTunnel for details.
#CURLOPT_IGNORE_CONTENT_LENGTH
Ignore Content-Length. See easy:SetOpt_Ignore_Content_Length for details.
#CURLOPT_INFILESIZE
Size of file to send. See easy:SetOpt_InFileSize for details.
#CURLOPT_INFILESIZE_LARGE
Size of file to send. See easy:SetOpt_InFileSize_Large for details.
#CURLOPT_INTERFACE
Bind connection locally to this. See easy:SetOpt_Interface for details.
#CURLOPT_IPRESOLVE
IP version to resolve to. See easy:SetOpt_IPResolve for details.
#CURLOPT_ISSUERCERT
Issuer certificate. See easy:SetOpt_IssuerCert for details.
#CURLOPT_ISSUERCERT_BLOB
Issuer certificate memory buffer. See easy:SetOpt_IssuerCert_Blob for details. (V2.0)
#CURLOPT_KEEP_SENDING_ON_ERROR
Keep sending on HTTP >= 300 errors. See easy:SetOpt_Keep_Sending_On_Error for details.
#CURLOPT_KEYPASSWD
Client key password. See easy:SetOpt_KeyPasswd for details.
#CURLOPT_KRBLEVEL
Kerberos security level. See easy:SetOpt_KRBLevel for details.
#CURLOPT_LOCALPORT
Bind connection locally to this port. See easy:SetOpt_LocalPort for details.
#CURLOPT_LOCALPORTRANGE
Bind connection locally to port range. See easy:SetOpt_LocalPortRange for details.
#CURLOPT_LOGIN_OPTIONS
Login options. See easy:SetOpt_Login_Options for details.
#CURLOPT_LOW_SPEED_LIMIT
Low speed limit to abort transfer. See easy:SetOpt_Low_Speed_Limit for details.
#CURLOPT_LOW_SPEED_TIME
Time to be below the speed to trigger low speed abort. See easy:SetOpt_Low_Speed_Time for details.
#CURLOPT_MAIL_AUTH
Authentication address. See easy:SetOpt_Mail_Auth for details.
#CURLOPT_MAIL_FROM
Address of the sender. See easy:SetOpt_Mail_From for details.
#CURLOPT_MAIL_RCPT
Address of the recipients. See easy:SetOpt_Mail_RCPT for details.
#CURLOPT_MAIL_RCPT_ALLOWFAILS
Allow RCPT TO command to fail for some recipients. See easy:SetOpt_Mail_RCPT_AllowFails for details. (V2.0)
#CURLOPT_MAXAGE_CONN
Limit the age (idle time) of connections for reuse. See easy:SetOpt_MaxAge_Conn for details. (V2.0)
#CURLOPT_MAXLIFETIME_CONN
Limit the age (since creation) of connections for reuse. See easy:SetOpt_MaxLifeTime_Conn for details. (V2.0)
#CURLOPT_PREREQFUNCTION
Callback to be called after a connection is established but before a request is made on that connection. See easy:SetOpt_PreReqFunction for details. (V2.0)
#CURLOPT_MAX_RECV_SPEED_LARGE
Cap the download speed to this. See easy:SetOpt_Max_Recv_Speed_Large for details.
#CURLOPT_MAX_SEND_SPEED_LARGE
Cap the upload speed to this. See easy:SetOpt_Max_Send_Speed_Large for details.
#CURLOPT_MAXCONNECTS
Maximum number of connections in the connection pool. See easy:SetOpt_MaxConnects for details.
#CURLOPT_MAXFILESIZE
Maximum file size to get. See easy:SetOpt_MaxFileSize for details.
#CURLOPT_MAXFILESIZE_LARGE
Maximum file size to get. See easy:SetOpt_MaxFileSize_Large for details.
#CURLOPT_MAXREDIRS
Maximum number of redirects to follow. See easy:SetOpt_MaxRedirs for details.
#CURLOPT_MIME_OPTIONS
Set MIME option flags. See easy:SetOpt_MIME_Options for details. (V2.0)
#CURLOPT_MIMEPOST
Post/send MIME data. See easy:SetOpt_MIMEPost for details. (V2.0)
#CURLOPT_NETRC
Enable .netrc parsing. See easy:SetOpt_Netrc for details.
#CURLOPT_NETRC_FILE
.netrc file name. See easy:SetOpt_Netrc_File for details.
#CURLOPT_NEW_DIRECTORY_PERMS
Mode for creating new remote directories. See easy:SetOpt_New_Directory_Perms for details.
#CURLOPT_NEW_FILE_PERMS
Mode for creating new remote files. See easy:SetOpt_New_File_Perms for details.
#CURLOPT_NOBODY
Do not get the body contents. See easy:SetOpt_Nobody for details.
#CURLOPT_NOPROGRESS
Shut off the progress meter. See easy:SetOpt_NoProgress for details.
#CURLOPT_NOPROXY
Filter out hosts from proxy use. See easy:SetOpt_NoProxy for details.
#CURLOPT_NOSIGNAL
Do not install signal handlers. See easy:SetOpt_NoSignal for details.
#CURLOPT_PASSWORD
Password. See easy:SetOpt_Password for details.
#CURLOPT_PATH_AS_IS
Disable squashing /. See easy:SetOpt_Path_As_Is for details.
#CURLOPT_PINNEDPUBLICKEY
Set pinned SSL public key . See easy:SetOpt_PinnedPublicKey for details.
#CURLOPT_PIPEWAIT
Wait on connection to pipeline on it. See easy:SetOpt_PipeWait for details.
#CURLOPT_PORT
Port number to connect to. See easy:SetOpt_Port for details.
#CURLOPT_POST
How to act on redirects after POST. See easy:SetOpt_Post for details.
#CURLOPT_POSTFIELDS
Send a POST with this data. See easy:SetOpt_PostFields for details.
#CURLOPT_POSTQUOTE
Commands to run after transfer. See easy:SetOpt_PostQuote for details.
#CURLOPT_POSTREDIR
How to act on redirects after POST. See easy:SetOpt_PostRedir for details.
#CURLOPT_PRE_PROXY
Socks proxy to use. See easy:SetOpt_Pre_Proxy for details.
#CURLOPT_PREQUOTE
Commands to run just before transfer. See easy:SetOpt_Prequote for details.
#CURLOPT_PROGRESSFUNCTION
Callback for progress meter. See easy:SetOpt_ProgressFunction for details.
#CURLOPT_PROTOCOLS
Allowed protocols. See easy:SetOpt_Protocols for details.
#CURLOPT_PROTOCOLS_STR
Allowed protocols. See easy:SetOpt_Protocols_Str for details. (V2.0)
#CURLOPT_PROXY
Proxy to use. See easy:SetOpt_Proxy for details.
#CURLOPT_PROXY_CAINFO
Proxy CA cert bundle. See easy:SetOpt_Proxy_CAInfo for details.
#CURLOPT_PROXY_CAINFO_BLOB
Proxy CA cert bundle memory buffer. See easy:SetOpt_Proxy_CAInfo_Blob for details. (V2.0)
#CURLOPT_PROXY_CAPATH
Path to proxy CA cert bundle. See easy:SetOpt_Proxy_CAPath for details.
#CURLOPT_PROXY_CRLFILE
Proxy Certificate Revocation List. See easy:SetOpt_Proxy_CRLFile for details.
#CURLOPT_PROXY_ISSUERCERT
Proxy issuer certificate. See easy:SetOpt_Proxy_IssuerCert for details. (V2.0)
#CURLOPT_PROXY_ISSUERCERT_BLOB
Proxy issuer certificate memory buffer. See easy:SetOpt_Proxy_IssuerCert_Blob for details. (V2.0)
#CURLOPT_PROXY_KEYPASSWD
Proxy client key password. See easy:SetOpt_Proxy_KeyPasswd for details.
#CURLOPT_PROXY_PINNEDPUBLICKEY
Set the proxy's pinned SSL public key. See easy:SetOpt_Proxy_PinnedPublicKey for details.
#CURLOPT_PROXY_SERVICE_NAME
Proxy authentication service name. See easy:SetOpt_Proxy_Service_Name for details.
#CURLOPT_PROXY_SSLCERT
Proxy client cert. See easy:SetOpt_Proxy_SSLCert for details.
#CURLOPT_PROXY_SSLCERT_BLOB
Proxy client cert memory buffer. See easy:SetOpt_Proxy_SSLCert_Blob for details. (V2.0)
#CURLOPT_PROXY_SSLCERTTYPE
Proxy client cert type. See easy:SetOpt_Proxy_SSLCertType for details.
#CURLOPT_PROXY_SSL_CIPHER_LIST
Proxy ciphers to use. See easy:SetOpt_Proxy_SSL_Cipher_List for details.
#CURLOPT_PROXY_SSLKEY
Proxy client key. See easy:SetOpt_Proxy_SSLKey for details.
#CURLOPT_PROXY_SSLKEY_BLOB
Proxy client key. See easy:SetOpt_Proxy_SSLKey_Blob for details. (V2.0)
#CURLOPT_PROXY_SSLKEYTYPE
Proxy client key type. See easy:SetOpt_Proxy_SSLKeyType for details.
#CURLOPT_PROXY_SSL_OPTIONS
Control proxy SSL behavior. See easy:SetOpt_Proxy_SSL_Options for details.
#CURLOPT_PROXY_SSL_VERIFYHOST
Verify the host name in the proxy SSL certificate. See easy:SetOpt_Proxy_SSL_VerifyHost for details.
#CURLOPT_PROXY_SSL_VERIFYPEER
Verify the proxy SSL certificate. See easy:SetOpt_Proxy_SSL_VerifyPeer for details.
#CURLOPT_PROXY_SSLVERSION
Proxy SSL version to use. See easy:SetOpt_Proxy_SSLVersion for details.
#CURLOPT_PROXY_TLSAUTH_PASSWORD
Proxy TLS authentication password. See easy:SetOpt_Proxy_TLSAuth_Password for details.
#CURLOPT_PROXY_TLSAUTH_TYPE
Proxy TLS authentication methods. See easy:SetOpt_Proxy_TLSAuth_Type for details.
#CURLOPT_PROXY_TLSAUTH_USERNAME
Proxy TLS authentication user name. See easy:SetOpt_Proxy_TLSAuth_UserName for details.
#CURLOPT_PROXY_TRANSFER_MODE
Add transfer mode to URL over proxy. See easy:SetOpt_Proxy_Transfer_Mode for details.
#CURLOPT_PROXYAUTH
HTTP proxy authentication methods. See easy:SetOpt_ProxyAuth for details.
#CURLOPT_PROXYHEADER
Custom HTTP headers sent to proxy. See easy:SetOpt_ProxyHeader for details.
#CURLOPT_PROXYPASSWORD
Proxy password. See easy:SetOpt_ProxyPassword for details.
#CURLOPT_PROXYPORT
Proxy port to use. See easy:SetOpt_ProxyPort for details.
#CURLOPT_PROXYTYPE
Proxy type. See easy:SetOpt_ProxyType for details.
#CURLOPT_PROXYUSERNAME
Proxy user name. See easy:SetOpt_ProxyUserName for details.
#CURLOPT_PROXYUSERPWD
Proxy user name and password. See easy:SetOpt_ProxyUserPwd for details.
#CURLOPT_PUT
Issue an HTTP PUT request. See easy:SetOpt_Put for details.
#CURLOPT_QUICK_EXIT
To be get by toplevel tools like "curl" to skip lengthy cleanups when they are about to call exit() anyway. See easy:SetOpt_Quick_Exit for details. (V2.0)
#CURLOPT_QUOTE
Commands to run before transfer. See easy:SetOpt_Quote for details.
#CURLOPT_RANDOM_FILE
Provide source for entropy random data. See easy:SetOpt_Random_File for details.
#CURLOPT_RANGE
Range requests. See easy:SetOpt_Range for details.
#CURLOPT_READFUNCTION
Callback for reading data. See easy:SetOpt_ReadFunction for details.
#CURLOPT_REDIR_PROTOCOLS
Protocols to allow redirects to. See easy:SetOpt_Redir_Protocols for details.
#CURLOPT_REDIR_PROTOCOLS_STR
Protocols to allow redirects to. See easy:SetOpt_Redir_Protocols_Str for details. (V2.0)
#CURLOPT_REFERER
Referer: header. See easy:SetOpt_Referer for details.
#CURLOPT_REQUEST_TARGET
Set the request target. See easy:SetOpt_Request_Target for details.
#CURLOPT_RESOLVE
Callback to be called before a new resolve request is started. See easy:SetOpt_Resolve for details.
#CURLOPT_RESOLVER_START_FUNCTION
Callback to be called before a new resolve request is started. See easy:SetOpt_Resolver_Start_Function for details. (V2.0)
#CURLOPT_RESUME_FROM
Resume a transfer. See easy:SetOpt_Resume_From for details.
#CURLOPT_RESUME_FROM_LARGE
Resume a transfer. See easy:SetOpt_Resume_From_Large for details.
#CURLOPT_RTSP_CLIENT_CSEQ
Client CSEQ number. See easy:SetOpt_RTSP_Client_CSeq for details.
#CURLOPT_RTSP_REQUEST
RTSP request. See easy:SetOpt_RTSP_Request for details.
#CURLOPT_RTSP_SERVER_CSEQ
CSEQ number for RTSP Server->Client request. See easy:SetOpt_RTSP_Server_CSeq for details.
#CURLOPT_RTSP_SESSION_ID
RTSP session-id. See easy:SetOpt_RTSP_Session_ID for details.
#CURLOPT_RTSP_STREAM_URI
RTSP stream URI. See easy:SetOpt_RTSP_Stream_URI for details.
#CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See easy:SetOpt_RTSP_Transport for details.
#CURLOPT_SASL_AUTHZID
SASL authorization identity (identity to act as). See easy:SetOpt_SASL_AuthZID for details. (V2.0)
#CURLOPT_SASL_IR
Enable SASL initial response. See easy:SetOpt_SASL_IR for details.
#CURLOPT_SEEKFUNCTION
Callback for seek operations. See easy:SetOpt_SeekFunction for details.
#CURLOPT_SERVICE_NAME
Authentication service name. See easy:SetOpt_Service_Name for details.
#CURLOPT_SHARE
Share object to use. See easy:SetOpt_Share for details.
#CURLOPT_SOCKS5_AUTH
Socks5 authentication methods. See easy:SetOpt_Socks5_Auth for details.
#CURLOPT_SOCKS5_GSSAPI_NEC
Socks5 GSSAPI NEC mode. See easy:SetOpt_Socks5_GSSAPI_NEC for details.
#CURLOPT_SOCKS5_GSSAPI_SERVICE
Socks5 GSSAPI service name. See easy:SetOpt_Socks5_GSSAPI_Service for details.
#CURLOPT_SSH_AUTH_TYPES
SSH authentication types. See easy:SetOpt_SSH_Auth_Types for details.
#CURLOPT_SSH_COMPRESSION
Enable SSH compression. See easy:SetOpt_SSH_Compression for details. (V2.0)
#CURLOPT_SSH_HOSTKEYFUNCTION
Callback for checking host key handling. See easy:SetOpt_SSH_HostKeyFunction for details. (V2.0)
#CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
MD5 of host's public key. See easy:SetOpt_SSH_Host_Public_Key_MD5 for details.
#CURLOPT_SSH_KNOWNHOSTS
File name with known hosts. See easy:SetOpt_SSH_KnownHosts for details.
#CURLOPT_SSH_PRIVATE_KEYFILE
File name of private key. See easy:SetOpt_SSH_Private_KeyFile for details.
#CURLOPT_SSH_PUBLIC_KEYFILE
File name of public key. See easy:SetOpt_SSH_Public_KeyFile for details.
#CURLOPT_SSLCERT
Client cert. See easy:SetOpt_SSLCert for details.
#CURLOPT_SSLCERT_BLOB
Client cert memory buffer. See easy:SetOpt_SSLCert_Blob for details. (V2.0)
#CURLOPT_SSLCERTTYPE
Client cert type. See easy:SetOpt_SSLCertType for details.
#CURLOPT_SSL_CIPHER_LIST
Ciphers to use. See easy:SetOpt_SSL_Cipher_List for details.
#CURLOPT_SSL_EC_CURVES
Set key exchange curves. See easy:SetOpt_SSL_EC_Curves for details. (V2.0)
#CURLOPT_SSL_ENABLE_ALPN
Enable use of ALPN. See easy:SetOpt_SSL_Enable_Alpn for details.
#CURLOPT_SSL_ENABLE_NPN
Enable use of NPN. See easy:SetOpt_SSL_Enable_Npn for details.
#CURLOPT_SSLENGINE
Use identifier with SSL engine. See easy:SetOpt_SSLEngine for details.
#CURLOPT_SSLENGINE_DEFAULT
Default SSL engine. See easy:SetOpt_SSLEngine_Default for details.
#CURLOPT_SSL_FALSESTART
Enable TLS False Start. See easy:SetOpt_SSL_FalseStart for details.
#CURLOPT_SSLKEY
Client key. See easy:SetOpt_SSLKey for details.
#CURLOPT_SSLKEY_BLOB
Client key memory buffer. See easy:SetOpt_SSLKey_Blob for details. (V2.0)
#CURLOPT_SSLKEYTYPE
Client key type. See easy:SetOpt_SSLKeyType for details.
#CURLOPT_SSL_OPTIONS
Control SSL behavior. See easy:SetOpt_SSL_Options for details.
#CURLOPT_SSL_SESSIONID_CACHE
Disable SSL session-id cache. See easy:SetOpt_SSL_SessionID_Cache for details.
#CURLOPT_SSL_VERIFYHOST
Verify the host name in the SSL certificate. See easy:SetOpt_SSL_VerifyHost for details.
#CURLOPT_SSL_VERIFYPEER
Verify the SSL certificate. See easy:SetOpt_SSL_VerifyPeer for details.
#CURLOPT_SSL_VERIFYSTATUS
Verify the SSL certificate's status. See easy:SetOpt_SSL_VerifyStatus for details.
#CURLOPT_SSLVERSION
SSL version to use. See easy:SetOpt_SSLVersion for details.
#CURLOPT_STREAM_DEPENDS
This HTTP/2 stream depends on another. See easy:SetOpt_Stream_Depends for details.
#CURLOPT_STREAM_DEPENDS_E
This HTTP/2 stream depends on another exclusively. See easy:SetOpt_Stream_Depends_e for details.
#CURLOPT_STREAM_WEIGHT
Set this HTTP/2 stream's weight. See easy:SetOpt_Stream_Weight for details.
#CURLOPT_SUPPRESS_CONNECT_HEADERS
Suppress proxy CONNECT response headers from user callbacks. See easy:SetOpt_Suppress_Connect_Headers for details.
#CURLOPT_TCP_FASTOPEN
Enable TFO, TCP Fast Open. See easy:SetOpt_TCP_FastOpen for details.
#CURLOPT_TCP_KEEPALIVE
Enable TCP keep-alive. See easy:SetOpt_TCP_KeepAlive for details.
#CURLOPT_TCP_KEEPIDLE
Idle time before sending keep-alive. See easy:SetOpt_TCP_KeepIdle for details.
#CURLOPT_TCP_KEEPINTVL
Interval between keep-alive probes. See easy:SetOpt_TCP_KeepIntvl for details.
#CURLOPT_TCP_NODELAY
Disable the Nagle algorithm. See easy:SetOpt_TCP_NoDelay for details.
#CURLOPT_TELNETOPTIONS
TELNET options. See easy:SetOpt_TelnetOptions for details.
#CURLOPT_TFTP_BLKSIZE
TFTP block size. See easy:SetOpt_TFTP_BlkSize for details.
#CURLOPT_TFTP_NO_OPTIONS
Do not send TFTP options requests. See easy:SetOpt_TFTP_No_Options for details.
#CURLOPT_TIMECONDITION
Make a time conditional request. See easy:SetOpt_TimeCondition for details.
#CURLOPT_TIMEOUT
Timeout for the entire request. See easy:SetOpt_Timeout for details.
#CURLOPT_TIMEOUT_MS
Millisecond timeout for the entire request. See easy:SetOpt_Timeout_MS for details.
#CURLOPT_TIMEVALUE
Time value for the time conditional request. See easy:SetOpt_TimeValue for details.
#CURLOPT_TIMEVALUE_LARGE
Time value for the time conditional request. See easy:SetOpt_TimeValue_Large for details. (V2.0)
#CURLOPT_TLS13_CIPHERS
Ciphers suites to use for TLS 1.3. See easy:SetOpt_TLS13_Ciphers for details. (V2.0)
#CURLOPT_TLSAUTH_PASSWORD
TLS authentication password. See easy:SetOpt_TLSAuth_Password for details.
#CURLOPT_TLSAUTH_TYPE
TLS authentication methods. See easy:SetOpt_TLSAuth_Type for details.
#CURLOPT_TLSAUTH_USERNAME
TLS authentication user name. See easy:SetOpt_TLSAuth_UserName for details.
#CURLOPT_TRAILERFUNCTION
Set callback for sending trailing headers. See easy:SetOpt_TrailerFunction for details. (V2.0)
#CURLOPT_TRANSFER_ENCODING
Request Transfer-Encoding. See easy:SetOpt_Transfer_Encoding for details.
#CURLOPT_TRANSFERTEXT
Use text transfer. See easy:SetOpt_TransferText for details.
#CURLOPT_UNIX_SOCKET_PATH
Path to a Unix domain socket. See easy:SetOpt_Unix_Socket_Path for details.
#CURLOPT_UNRESTRICTED_AUTH
Do not restrict authentication to original host. See easy:SetOpt_Unrestricted_Auth for details.
#CURLOPT_UPKEEP_INTERVAL_MS
Sets the interval at which connection upkeep are performed. See easy:SetOpt_Upkeep_Interval_MS for details. (V2.0)
#CURLOPT_UPLOAD
Upload data. See easy:SetOpt_Upload for details.
#CURLOPT_UPLOAD_BUFFERSIZE
Set upload buffer size. See easy:SetOpt_Upload_Buffersize for details. (V2.0)
#CURLOPT_URL
URL to work on. See easy:SetOpt_URL for details.
#CURLOPT_USE_SSL
Use TLS/SSL. See easy:SetOpt_Use_SSL for details.
#CURLOPT_USERAGENT
User-Agent: header. See easy:SetOpt_UserAgent for details.
#CURLOPT_USERNAME
User name. See easy:SetOpt_UserName for details.
#CURLOPT_USERPWD
User name and password. See easy:SetOpt_UserPwd for details.
#CURLOPT_VERBOSE
Display verbose information. See easy:SetOpt_Verbose for details.
#CURLOPT_WILDCARDMATCH
Transfer multiple files according to a file name pattern. See easy:SetOpt_WildcardMatch for details.
#CURLOPT_WRITEFUNCTION
Callback for writing data. See easy:SetOpt_WriteFunction for details.
#CURLOPT_WS_OPTIONS
Set WebSocket options. See easy:SetOpt_WS_Options for details. (V2.0)
#CURLOPT_XOAUTH2_BEARER
OAuth2 bearer token. See easy:SetOpt_XOAuth2_Bearer for details.

Inputs
option
option type to get
parameter
value to get option to
Example
e:SetOpt(#CURLOPT_URL, "http://www.hollywood-mal.com")
e:SetOpt(#CURLOPT_VERBOSE, True)
e:SetOpt(#CURLOPT_FOLLOWLOCATION, True)
The code above sets some options on an easy handle.


e:SetOpt({URL = "http://www.hollywood-mal.com",
    Verbose = True, FollowLocation = True})
The code above does the same as the first code snippet but instead of setting the options consecutively, it sets them all at once. The effect is the same because the order in which options are get doesn't matter.

Show TOC