中文翻译：
curl_easy_setopt() libcurl 手册 curl_easy_setopt() 名称
curl_easy_setopt -curl的设置选项 概要
#include <curl/curl.h> CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter); 描述
curl_easy_setopt()是用来告诉libcurl如何表现.通过设置适当的选项，应用程序可以改变libcurl的行为。所有选项都设置一个选项，然后由一个参数.
这个比较长：一个函数指针，一个对象的指针或curl_off_t，取决于具体方案预计。如果参数的值不符合要求，可能导致libcurl达到理想效果，请仔细阅读本手册。一个典型的应用程序中会使用许多‐curl_easy_setopt（）来对环境进行设置。此函数调用的选项设置对下面程序进行传输执行的参数设置,这个函数不能对已经设置的函数进行恢复，如果你想回到内部默认的状态，你可以调用curl_easy_reset（）。 字符串传递给libcurl作为字符串参数，由图书馆复制，从而对指针参数的字符串储存空间可能会被curl_easy_setopt（）的返回值覆盖。 字符串传递给libcurl作为字符串参数，由文件管理系统复制,从而对指针参数关联的字符串存储空间可能会被curl_easy_setopt（）的返回值覆盖。这个规则的唯一例外是 really 的curlopt_postfields（），但选择拷贝的字符串curlopt_copypostfields（）有一定的使用特点需要你读了。 选项设置的顺序不重要。 以前的版本7.17.0，字符串不复制。相反，保持用户促使有效直到libcurl不再需要他们。 处理是从curl_easy_init返回代码（）或（）curl_easy_duphandle调用。 行为选择
CURLOPT_VERBOSE
如果你想CURL报告每一件意外的事情，设置这个选项为一个非零值。See CURLOPT_VERBOSE() CURLOPT_HEADER
如果你想把一个头包含在输出中,设置这个选项为一个非零值. See CURLOPT_HEADER() CURLOPT_NOPROGRESS
关闭进度表. See CURLOPT_NOPROGRESS() CURLOPT_NOSIGNAL
不要安装信号处理程序. See CURLOPT_NOSIGNAL() CURLOPT_WILDCARDMATCH
根据文件名模式传输多个文件. See CURLOPT_WILDCARDMATCH() 回调函数的选择
CURLOPT_WRITEFUNCTION
写入数据的回调. See CURLOPT_WRITEFUNCTION()
CURLOPT_WRITEDATA
数据指针传递给写回调. See CURLOPT_WRITE‐DATA()
CURLOPT_READFUNCTION
读取数据回调. See CURLOPT_READFUNCTION()
CURLOPT_READDATA
数据指针传递给读回调. See CURLOPT_READ‐DATA()
CURLOPT_IOCTLFUNCTION
回调的I/O操作. See CURLOPT_IOCTLFUNCTION()
CURLOPT_IOCTLDATA
数据指针传递给I/O回调. See CURLOPT_IOCTL‐DATA()
CURLOPT_SEEKFUNCTION
寻求操作的回调. See CURLOPT_SEEKFUNCTION()
CURLOPT_SEEKDATA
数据指针传递给寻求回调. See CURLOPT_SEEK‐ DATA()
CURLOPT_SOCKOPTFUNCTION
套接字创建的回调. See CURLOPT_SOCKOPTFUNCTION()
CURLOPT_SOCKOPTDATA
数据指针传递给sockopt回调. See CURLOPT_SOCK‐OPTDATA()
CURLOPT_OPENSOCKETFUNCTION
创建套接字(socket)的回调. See CURLOPT_OPENSOCKETFUNCTION()
CURLOPT_OPENSOCKETDATA
数据指针传递给打开的套接字(socket)回调.See CUR‐LOPT_OPENSOCKETDATA()
CURLOPT_CLOSESOCKETFUNCTION
关闭套接字(socket)的回调. See CURLOPT_CLOSESOCKETFUNCTION()
CURLOPT_CLOSESOCKETDATA
数据指针传递给 关闭套接字回调
数据指针传递给关闭套接字(socket)回调. See CUR‐LOPT_CLOSESOCKETDATA()
CURLOPT_PROGRESSFUNCTION
过时的回调进度表(meter). See CURLOPT_PROGRESSFUNC‐TION()
CURLOPT_PROGRESSDATA
数据指针传递给进度表(meter)回调. See CUR‐LOPT_PROGRESSDATA()
CURLOPT_XFERINFOFUNCTION
进度表的回调. See CURLOPT_XFERINFOFUNCTION()
CURLOPT_XFERINFODATA
数据指针传递给进度表回调.See CUR‐LOPT_XFERINFODATA()
CURLOPT_HEADERFUNCTION
写入接收头的回调. See CURLOPT_HEADERFUNC‐TION()
CURLOPT_HEADERDATA
数据指针指向头(header)回调. See CURLOPT_HEADER‐DATA()
CURLOPT_DEBUGFUNCTION
调试信息的回调. See CURLOPT_DEBUGFUNCTION()
CURLOPT_DEBUGDATA
数据指传递向调试回调. See CURLOPT_DEBUG‐DATA()
CURLOPT_SSL_CTX_FUNCTION
ssl上线文逻辑回调. See CURLOPT_SSL_CTX_FUNCTION()
CURLOPT_SSL_CTX_DATA
数据指针传递给SSL上下文回调. See CUR‐LOPT_SSL_CTX_DATA()
CURLOPT_CONV_TO_NETWORK_FUNCTION
代码库转换的回调. See CURLOPT_CONV_TO_NET‐WORK_FUNCTION()
CURLOPT_CONV_FROM_NETWORK_FUNCTION
代码库转换的回调. See CURLOPT_CONV_FROM_NET‐WORK_FUNCTION()
CURLOPT_CONV_FROM_UTF8_FUNCTION
代码库转换的回调. See CUR‐LOPT_CONV_FROM_UTF8_FUNCTION()
CURLOPT_INTERLEAVEFUNCTION
回调RTSP交错的数据. See CURLOPT_INTERLEAVEFUNC‐TION()
CURLOPT_INTERLEAVEDATA
数据指针通过RTSP交织回调. See CUR‐LOPT_INTERLEAVEDATA()
CURLOPT_CHUNK_BGN_FUNCTION
通配符下载启动块回调. See CUR‐LOPT_CHUNK_BGN_FUNCTION()
CURLOPT_CHUNK_END_FUNCTION
对于大块通配符下载结束回调. See CUR‐LOPT_CHUNK_END_FUNCTION()
CURLOPT_CHUNK_DATA
数据指针传递给块回调.See CUR‐LOPT_CHUNK_DATA()
CURLOPT_FNMATCH_FUNCTION
通配符匹配回调. See CURLOPT_FNMATCH_FUNCTION()
CURLOPT_FNMATCH_DATA
数据指针通过通配符匹配回调. See CUR‐LOPT_FNMATCH_DATA()
错误选择
CURLOPT_ERRORBUFFER
错误消息缓冲区. See CURLOPT_ERRORBUFFER() CURLOPT_STDERR
标准错误置换流. See CURLOPT_STDERR() CURLOPT_FAILONERROR
在HTTP 4xx 错误失败. CURLOPT_FAILONERROR() 网络选项
CURLOPT_URL
URL工作. See CURLOPT_URL()
CURLOPT_PATH_AS_IS
禁用挤压/../ 和/../在路径序列. See CUR‐LOPT_PATH_AS_IS()
CURLOPT_PROTOCOLS
协议允许. See CURLOPT_PROTOCOLS()
CURLOPT_REDIR_PROTOCOLS
协议允许重定向到. See CURLOPT_REDIR_PROTOCOLS()
CURLOPT_DEFAULT_PROTOCOL
默认协议. See CURLOPT_DEFAULT_PROTOCOL()
CURLOPT_PROXY
使用代理. See CURLOPT_PROXY()
CURLOPT_PROXYPORT
代理端口使用. See CURLOPT_PROXYPORT()
CURLOPT_PROXYTYPE
代理类型. See CURLOPT_PROXYTYPE()
CURLOPT_NOPROXY
从代理使用筛选主机. CURLOPT_NOPROXY()
CURLOPT_HTTPPROXYTUNNEL
通过HTTP代理隧道. CURLOPT_HTTPPROXYTUNNEL()
CURLOPT_SOCKS5_GSSAPI_SERVICE
Socks5 GSSAPI服务名字. CURLOPT_SOCKS5_GSSAPI_SERVICE()
CURLOPT_SOCKS5_GSSAPI_NEC
Socks5 GSSAPI 无差错校验模式. See CURLOPT_SOCKS5_GSSAPI_NEC()
CURLOPT_PROXY_SERVICE_NAME
代理服务名字. CURLOPT_PROXY_SERVICE_NAME()
CURLOPT_SERVICE_NAME
SPNEGO服务名字. CURLOPT_SERVICE_NAME()
CURLOPT_INTERFACE
绑定本地连接. See CURLOPT_INTERFACE()
CURLOPT_LOCALPORT
绑定本地连接到端口. See CURLOPT_LOCALPORT()
CURLOPT_LOCALPORTRANGE
绑定本地连接绑定到范围端口. See CURLOPT_LOCALPOR‐TRANGE()
CURLOPT_DNS_CACHE_TIMEOUT
DNS缓存超时. See CURLOPT_DNS_CACHE_TIMEOUT()
CURLOPT_DNS_USE_GLOBAL_CACHE
过时的使全局DNS缓存。See CUR‐LOPT_DNS_USE_GLOBAL_CACHE()
CURLOPT_BUFFERSIZE
要求较小的缓冲区大小. See CURLOPT_BUFFERSIZE()
CURLOPT_PORT
端口号连接到. See CURLOPT_PORT()
CURLOPT_TCP_NODELAY
禁用Nagle算法. See CURLOPT_TCP_NODELAY()
CURLOPT_ADDRESS_SCOPE
对于本地地址IPv6范围. See CURLOPT_ADDRESS_SCOPE()
CURLOPT_TCP_KEEPALIVE
启动持久连接(TCP keep-alive). See CURLOPT_TCP_KEEPALIVE()
CURLOPT_TCP_KEEPIDLE
发送前的空闲时间. See CURLOPT_TCP_KEEPIDLE()
CURLOPT_TCP_KEEPINTVL
保持活探针之间的间隔. See CURLOPT_TCP_KEEPINTVL()
CURLOPT_UNIX_SOCKET_PATH
一个Unix域套接字(socket)的路径. See CURLOPT_UNIX_SOCKET_PATH()
名称和密码选项(身份验证）
CURLOPT_NETRC
使用.户配置脚本文件解析. See CURLOPT_NETRC()
CURLOPT_NETRC_FILE
.配置脚本文件名. See CURLOPT_NETRC_FILE()
CURLOPT_USERPWD
用户名和密码. See CURLOPT_USERPWD()
CURLOPT_PROXYUSERPWD
代理用户名和密码.See CURLOPT_PROXYUSERPWD()
CURLOPT_USERNAME
用户名. See CURLOPT_USERNAME()
CURLOPT_PASSWORD
密码. See CURLOPT_PASSWORD()
CURLOPT_LOGIN_OPTIONS
登陆选项. See CURLOPT_LOGIN_OPTIONS()
CURLOPT_PROXYUSERNAME
代理用户名. See CURLOPT_PROXYUSERNAME()
CURLOPT_PROXYPASSWORD
代理密码. See CURLOPT_PROXYPASSWORD()
CURLOPT_HTTPAUTH
HTTP服务器的身份验证方法. See CURLOPT_HTTPAUTH()
CURLOPT_TLSAUTH_USERNAME
TLS 验证用户名. See CURLOPT_TLSAUTH_USERNAME()
CURLOPT_TLSAUTH_PASSWORD
TLS 验证密码. See CURLOPT_TLSAUTH_PASSWORD()
CURLOPT_TLSAUTH_TYPE
TLS 身份验证方法. See CURLOPT_TLSAUTH_TYPE()
CURLOPT_PROXYAUTH
HTTP代理验证方法. See CURLOPT_PROXYAUTH()
CURLOPT_SASL_IR
使SASL的初始响应. See CURLOPT_SASL_IR()
CURLOPT_XOAUTH2_BEARER
OAuth2不记名令牌. See CURLOPT_XOAUTH2_BEARER() HTTP选项
CURLOPT_AUTOREFERER
自动设置参考；标题. See CURLOPT_AUTOREFERER()
CURLOPT_ACCEPT_ENCODING
接受编码和自动解压缩数据. See CUR‐LOPT_ACCEPT_ENCODING()
CURLOPT_TRANSFER_ENCODING
请求传输编码. See CURLOPT_TRANSFER_ENCODING()
CURLOPT_FOLLOWLOCATION
遵循HTTP重定向. See CURLOPT_FOLLOWLOCATION()
CURLOPT_UNRESTRICTED_AUTH
不限制对原始主机的身份验证. CURLOPT_UNRE‐STRICTED_AUTH()
CURLOPT_MAXREDIRS
跟随重定向的最大数量. See CURLOPT_MAXREDIRS()
CURLOPT_POSTREDIR
如何采取行动后的重定向POST. See CURLOPT_POSTREDIR()
CURLOPT_PUT
发出一个HTTP PUT请求. See CURLOPT_PUT()
CURLOPT_POST
发送一个HTTP POST要求. See CURLOPT_POST()
CURLOPT_POSTFIELDS
用这个数据发送一个POST. See CURLOPT_POSTFIELDS()
CURLOPT_POSTFIELDSIZE
如果你想发送数据POST到服务器没有libcurl做strlen()测量数据的大小，必须使用此选项。使用此选项时你可以把完全的二进制数据，否则可能会失败。如果这个大小设置为1，图书馆将使用strlen()得到尺寸. See CURLOPT_POSTFIELDSIZE()
CURLOPT_POSTFIELDSIZE_LARGE
如果你想发送数据POST到服务器没有libcurl做strlen()测量数据的大小，必须使用此选项。使用此选项时你可以把完全的二进制数据，否则可能会失败。如果这个大小设置为1，图书馆将使用strlen()得到尺寸. See CURLOPT_POSTFIELDSIZE_LARGE()
CURLOPT_COPYPOSTFIELDS
以POST的方式发送一段内容.See CURLOPT_COPYPOST‐FIELDS()
CURLOPT_HTTPPOST
多窗体发送HTTP POST. See CURLOPT_HTTPPOST()
CURLOPT_REFERER
引用:标头. See CURLOPT_REFERER()
CURLOPT_USERAGENT
用户代理:标头. See CURLOPT_USERAGENT()
CURLOPT_HTTPHEADER
自定义HTTP头.See CURLOPT_HTTPHEADER()
CURLOPT_HEADEROPT
控件自定义HTTP头. See CURLOPT_HEADEROPT()
CURLOPT_PROXYHEADER
自定义发送到代理的HTTP头. See CURLOPT_PROXYHEADER()
CURLOPT_HTTP200ALIASES
指定HTTP OK备选匹配.See CURLOPT_HTTP200ALIASES()
CURLOPT_COOKIE
发送小文件. See CURLOPT_COOKIE()
CURLOPT_COOKIEFILE
从文件读取. See CURLOPT_COOKIEFILE()
CURLOPT_COOKIEJAR
向文件写入. See CURLOPT_COOKIEJAR()
CURLOPT_COOKIESESSION
开始一个新的cookie会话. See CURLOPT_COOKIESESSION()
CURLOPT_COOKIELIST
添加或控制cookies. See CURLOPT_COOKIELIST()
CURLOPT_HTTPGET
做一个HTTP GET请求.See CURLOPT_HTTPGET()
CURLOPT_HTTP_VERSION
HTTP版本的使用.CURLOPT_HTTP_VERSION()
CURLOPT_IGNORE_CONTENT_LENGTH
忽略内容长度(Content-Length). See CURLOPT_IGNORE_CONTENT_LENGTH()
CURLOPT_HTTP_CONTENT_DECODING
禁用Content(CSS的一种属性)译码. See CURLOPT_HTTP_CONTENT_DECODING()
CURLOPT_HTTP_TRANSFER_DECODING
禁用传输解码.See CURLOPT_HTTP_TRANSFER_DECODING()
CURLOPT_EXPECT_100_TIMEOUT_MS
-continue timeout. See CURLOPT_EXPECT_100_TIMEOUT_MS() CURLOPT_PIPEWAIT
Wait on connection to pipeline on it. See CURLOPT_PIPEWAIT() CURLOPT_STREAM_DEPENDS
This HTTP/ stream depends on another. See CUR‐
LOPT_STREAM_DEPENDS() CURLOPT_STREAM_DEPENDS_E
This HTTP/ stream depends on another exclusively. See CUR‐
LOPT_STREAM_DEPENDS_E() CURLOPT_STREAM_WEIGHT
Set this HTTP/ stream's weight. See CURLOPT_STREAM_WEIGHT(3) SMTP OPTIONS
CURLOPT_MAIL_FROM
Address of the sender. See CURLOPT_MAIL_FROM() CURLOPT_MAIL_RCPT
Address of the recipients. See CURLOPT_MAIL_RCPT() CURLOPT_MAIL_AUTH
Authentication address. See CURLOPT_MAIL_AUTH() TFTP OPTIONS
CURLOPT_TFTP_BLKSIZE
TFTP block size. See CURLOPT_TFTP_BLKSIZE() FTP OPTIONS
CURLOPT_FTPPORT
Use active FTP. See CURLOPT_FTPPORT() CURLOPT_QUOTE
Commands to run before transfer. See CURLOPT_QUOTE() CURLOPT_POSTQUOTE
Commands to run after transfer. See CURLOPT_POSTQUOTE() CURLOPT_PREQUOTE
Commands to run just before transfer. See CURLOPT_PREQUOTE() CURLOPT_APPEND
Append to remote file. See CURLOPT_APPEND() CURLOPT_FTP_USE_EPRT
Use EPTR. See CURLOPT_FTP_USE_EPRT() CURLOPT_FTP_USE_EPSV
Use EPSV. See CURLOPT_FTP_USE_EPSV() CURLOPT_FTP_USE_PRET
Use PRET. See CURLOPT_FTP_USE_PRET() CURLOPT_FTP_CREATE_MISSING_DIRS
Create missing directories on the remote server. See CUR‐
LOPT_FTP_CREATE_MISSING_DIRS() CURLOPT_FTP_RESPONSE_TIMEOUT
Timeout for FTP responses. See CURLOPT_FTP_RESPONSE_TIMEOUT() CURLOPT_FTP_ALTERNATIVE_TO_USER
Alternative to USER. See CURLOPT_FTP_ALTERNATIVE_TO_USER() CURLOPT_FTP_SKIP_PASV_IP
Ignore the IP address in the PASV response. See CUR‐
LOPT_FTP_SKIP_PASV_IP() CURLOPT_FTPSSLAUTH
Control how to do TLS. See CURLOPT_FTPSSLAUTH() CURLOPT_FTP_SSL_CCC
Back to non-TLS again after authentication. See CUR‐
LOPT_FTP_SSL_CCC() CURLOPT_FTP_ACCOUNT
Send ACCT command. See CURLOPT_FTP_ACCOUNT() CURLOPT_FTP_FILEMETHOD
Specify how to reach files. See CURLOPT_FTP_FILEMETHOD() RTSP OPTIONS
CURLOPT_RTSP_REQUEST
RTSP request. See CURLOPT_RTSP_REQUEST() CURLOPT_RTSP_SESSION_ID
RTSP session-id. See CURLOPT_RTSP_SESSION_ID() CURLOPT_RTSP_STREAM_URI
RTSP stream URI. See CURLOPT_RTSP_STREAM_URI() CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See CURLOPT_RTSP_TRANSPORT() CURLOPT_RTSP_CLIENT_CSEQ
Client CSEQ number. See CURLOPT_RTSP_CLIENT_CSEQ() CURLOPT_RTSP_SERVER_CSEQ
CSEQ number for RTSP Server->Client request. See CUR‐
LOPT_RTSP_SERVER_CSEQ() PROTOCOL OPTIONS
CURLOPT_TRANSFERTEXT
Use text transfer. See CURLOPT_TRANSFERTEXT() CURLOPT_PROXY_TRANSFER_MODE
Add transfer mode to URL over proxy. See CURLOPT_PROXY_TRANS‐
FER_MODE() CURLOPT_CRLF
Convert newlines. See CURLOPT_CRLF() CURLOPT_RANGE
Range requests. See CURLOPT_RANGE() CURLOPT_RESUME_FROM
Resume a transfer. See CURLOPT_RESUME_FROM() CURLOPT_RESUME_FROM_LARGE
Resume a transfer. See CURLOPT_RESUME_FROM_LARGE() CURLOPT_CUSTOMREQUEST
Custom request/method. See CURLOPT_CUSTOMREQUEST() CURLOPT_FILETIME
Request file modification date and time. See CURLOPT_FILETIME() CURLOPT_DIRLISTONLY
List only. See CURLOPT_DIRLISTONLY() CURLOPT_NOBODY
Do not get the body contents. See CURLOPT_NOBODY() CURLOPT_INFILESIZE
Size of file to send. CURLOPT_INFILESIZE() CURLOPT_INFILESIZE_LARGE
Size of file to send. CURLOPT_INFILESIZE_LARGE() CURLOPT_UPLOAD
Upload data. See CURLOPT_UPLOAD() CURLOPT_MAXFILESIZE
Maximum file size to get. See CURLOPT_MAXFILESIZE() CURLOPT_MAXFILESIZE_LARGE
Maximum file size to get. See CURLOPT_MAXFILESIZE_LARGE() CURLOPT_TIMECONDITION
Make a time conditional request. See CURLOPT_TIMECONDITION() CURLOPT_TIMEVALUE
Time value for the time conditional request. See CUR‐
LOPT_TIMEVALUE() 连接选项
CURLOPT_TIMEOUT
整个请求的超时时间(s).See CURLOPT_TIMEOUT()
CURLOPT_TIMEOUT_MS
整个请求的超时时间(ms).See CURLOPT_TIME‐OUT_MS()
CURLOPT_LOW_SPEED_LIMIT
低限速中止传输.See CUR‐LOPT_LOW_SPEED_LIMIT()
CURLOPT_LOW_SPEED_TIME
时间低于速度触发低速中止. See CUR‐LOPT_LOW_SPEED_TIME()
CURLOPT_MAX_SEND_SPEED_LARGE
上限上传速度. See CUR‐LOPT_MAX_SEND_SPEED_LARGE()
CURLOPT_MAX_RECV_SPEED_LARGE
下载速度上限. See CUR‐LOPT_MAX_RECV_SPEED_LARGE()
CURLOPT_MAXCONNECTS
连接池中的最大连接数. See CUR‐LOPT_MAXCONNECTS()
CURLOPT_FRESH_CONNECT
使用一个新的连接. CURLOPT_FRESH_CONNECT()
CURLOPT_FORBID_REUSE
防止随后重新连接. See CUR‐LOPT_FORBID_REUSE()
CURLOPT_CONNECTTIMEOUT
连接阶段的超时(m). See CURLOPT_CONNECTTIMEOUT()
CURLOPT_CONNECTTIMEOUT_MS
连接阶段的超时(ms). See CURLOPT_CON‐NECTTIMEOUT_MS()
CURLOPT_IPRESOLVE
IP版本解决. See CURLOPT_IPRESOLVE()
CURLOPT_CONNECT_ONLY
只有连接，没有别的. See CURLOPT_CONNECT_ONLY()
CURLOPT_USE_SSL
使用TLS / SSL. See CURLOPT_USE_SSL()
CURLOPT_RESOLVE
提供自定义主机名到IP地址的解析. See CURLOPT_RESOLVE()
CURLOPT_DNS_INTERFACE
绑定名称解析到这个接口. See CURLOPT_DNS_INTER‐FACE()
CURLOPT_DNS_LOCAL_IP4
绑定名称解析到这个IP4地址. See CUR‐LOPT_DNS_LOCAL_IP4()
CURLOPT_DNS_LOCAL_IP6
绑定名称解析到这个IP6地址. See CUR‐LOPT_DNS_LOCAL_IP6()
CURLOPT_DNS_SERVERS
首选DNS服务器. See CURLOPT_DNS_SERVERS()
CURLOPT_ACCEPTTIMEOUT_MS
等待服务器的连接被接受的超时(ms). See CURLOPT_ACCEPTTIMEOUT_MS()
SSL和安全选项
CURLOPT_SSLCERT
客户端证书. See CURLOPT_SSLCERT()
CURLOPT_SSLCERTTYPE
客户端证书类型. See CURLOPT_SSLCERTTYPE()
CURLOPT_SSLKEY
客户端钥匙. See CURLOPT_SSLKEY()
CURLOPT_SSLKEYTYPE
客户端钥匙类型. See CURLOPT_SSLKEYTYPE()
CURLOPT_KEYPASSWD
客户端钥匙密码. See CURLOPT_KEYPASSWD()
CURLOPT_SSL_ENABLE_ALPN
启用ALPN. See CURLOPT_SSL_ENABLE_ALPN()
CURLOPT_SSL_ENABLE_NPN
启用NPN. See CURLOPT_SSL_ENABLE_NPN()
CURLOPT_SSLENGINE
使用SSL引擎标识符. See CURLOPT_SSLENGINE()
CURLOPT_SSLENGINE_DEFAULT
默认的SSL引擎. See CURLOPT_SSLENGINE_DEFAULT()
CURLOPT_SSL_FALSESTART
启用TLS抢跑.See CURLOPT_SSL_FALSESTART()
CURLOPT_SSLVERSION
SSL版本使用.See CURLOPT_SSLVERSION()
CURLOPT_SSL_VERIFYHOST
验证的主机名SSL证书.See CUR‐LOPT_SSL_VERIFYHOST()
CURLOPT_SSL_VERIFYPEER
验证SSL证书. See CURLOPT_SSL_VERIFYPEER()
CURLOPT_SSL_VERIFYSTATUS
验证SSL证书的状态.See CURLOPT_SSL_VERIFYSTA‐TUS()
CURLOPT_CAINFO
捆绑的CA证书. See CURLOPT_CAINFO()
CURLOPT_ISSUERCERT
发行者证书. See CURLOPT_ISSUERCERT()
CURLOPT_CAPATH
捆绑的CA证书路径. See CURLOPT_CAPATH()
CURLOPT_CRLFILE
证书吊销列表. See CURLOPT_CRLFILE()
CURLOPT_CERTINFO
提取证书信息. See CURLOPT_CERTINFO()
CURLOPT_PINNEDPUBLICKEY
设置固定的SSL密钥. See CURLOPT_PINNEDPUBLICKEY()
CURLOPT_RANDOM_FILE
指定一个随机的数据源.See CURLOPT_RAN‐DOM_FILE()
CURLOPT_EGDSOCKET
点对点(EGD)套接字(socket)的路径. See CURLOPT_EGDSOCKET()
CURLOPT_SSL_CIPHER_LIST
使用密码. See CURLOPT_SSL_CIPHER_LIST()
CURLOPT_SSL_SESSIONID_CACHE
禁用SSL会话ID缓存.See CURLOPT_SSL_SESSIONID_CACHE()
CURLOPT_SSL_OPTIONS
SSL行为控制.See CURLOPT_SSL_OPTIONS()
CURLOPT_KRBLEVEL
Kerberos安全水平.See CURLOPT_KRBLEVEL()
CURLOPT_GSSAPI_DELEGATION
禁用GSS-API授权.See CURLOPT_GSSAPI_DELEGATION()
SSH选择
CURLOPT_SSH_AUTH_TYPES
SSH认证类型. See CURLOPT_SSH_AUTH_TYPES()
CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
MD5的主机的公钥.See CURLOPT_SSH_HOST_PUBLIC_KEY_MD5()
CURLOPT_SSH_PUBLIC_KEYFILE
公共密钥的文件名. See CURLOPT_SSH_PUBLIC_KEYFILE()
CURLOPT_SSH_PRIVATE_KEYFILE
私有密匙的文件名. See CURLOPT_SSH_PRIVATE_KEYFILE()
CURLOPT_SSH_KNOWNHOSTS
已知主机的文件名. See CURLOPT_SSH_KNOWNHOSTS()
CURLOPT_SSH_KEYFUNCTION
回调已知主机处理. See CURLOPT_SSH_KEYFUNC‐TION()
CURLOPT_SSH_KEYDATA
自定义指针通过ssh钥匙的回调. See CURLOPT_SSH_KEY‐DATA()
其他选项
CURLOPT_PRIVATE
专用指针存储. See CURLOPT_PRIVATE()
CURLOPT_SHARE
共享对象使用. See CURLOPT_SHARE()
CURLOPT_NEW_FILE_PERMS
创建新远程文件的模式. See CUR‐LOPT_NEW_FILE_PERMS()
CURLOPT_NEW_DIRECTORY_PERMS
创建新的远程目录的模式. See CURLOPT_NEW_DIREC‐TORY_PERMS() 远程登录选项
CURLOPT_TELNETOPTIONS
远程登录选项. See CURLOPT_TELNETOPTIONS() 返回值
CURLE_OK (零)意味着选择了正确的选项, 非零意味着错误发生是<curl/curl.h>定义.详情请见libcurl-errors() 操作说明有完整的列表.
如果你试图设置一个libcurl的不知道的选项，也许是因为说明手册太老的支持或选择在最近的版本中删除，该函数将返回curle_unknown_option。如果参数不真确在编译时，它将返回curle_not_built_in。 范例
CURL *curl = curl_easy_init();
if(curl) {
CURLcode res;
curl_easy_setopt(curl, CURLOPT_URL, "http://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
} 请参阅
curl_easy_init(), curl_easy_cleanup(), curl_easy_reset(),
curl_easy_getinfo(), curl_multi_setopt(), libcurl 7.38. Jun curl_easy_setopt()
原文：
curl_easy_setopt() libcurl Manual curl_easy_setopt() 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
curl_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 set with an option followed by a parameter. That param‐
eter 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 applica‐
tion uses many curl_easy_setopt() 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 dif‐
ferent options, you must change them between the transfers. You can
optionally reset all options back to internal default with
curl_easy_reset(). 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 curl_easy_setopt() returns. The only exception to
this rule is really CURLOPT_POSTFIELDS(), but the alternative that
copies the string CURLOPT_COPYPOSTFIELDS() has some usage characteris‐
tics you need to read up on. The order in which the options are set does not matter. Before version 7.17., 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 curl_easy_init() or
curl_easy_duphandle() call. BEHAVIOR OPTIONS
CURLOPT_VERBOSE
Display verbose information. See CURLOPT_VERBOSE() CURLOPT_HEADER
Include the header in the body output. See CURLOPT_HEADER() CURLOPT_NOPROGRESS
Shut off the progress meter. See CURLOPT_NOPROGRESS() CURLOPT_NOSIGNAL
Do not install signal handlers. See CURLOPT_NOSIGNAL() CURLOPT_WILDCARDMATCH
Transfer multiple files according to a file name pattern. See
CURLOPT_WILDCARDMATCH() CALLBACK OPTIONS
CURLOPT_WRITEFUNCTION
Callback for writing data. See CURLOPT_WRITEFUNCTION() CURLOPT_WRITEDATA
Data pointer to pass to the write callback. See CURLOPT_WRITE‐
DATA() CURLOPT_READFUNCTION
Callback for reading data. See CURLOPT_READFUNCTION() CURLOPT_READDATA
Data pointer to pass to the read callback. See CURLOPT_READ‐
DATA() CURLOPT_IOCTLFUNCTION
Callback for I/O operations. See CURLOPT_IOCTLFUNCTION() CURLOPT_IOCTLDATA
Data pointer to pass to the I/O callback. See CURLOPT_IOCTL‐
DATA() CURLOPT_SEEKFUNCTION
Callback for seek operations. See CURLOPT_SEEKFUNCTION() CURLOPT_SEEKDATA
Data pointer to pass to the seek callback. See CURLOPT_SEEK‐
DATA() CURLOPT_SOCKOPTFUNCTION
Callback for sockopt operations. See CURLOPT_SOCKOPTFUNCTION() CURLOPT_SOCKOPTDATA
Data pointer to pass to the sockopt callback. See CURLOPT_SOCK‐
OPTDATA() CURLOPT_OPENSOCKETFUNCTION
Callback for socket creation. See CURLOPT_OPENSOCKETFUNCTION() CURLOPT_OPENSOCKETDATA
Data pointer to pass to the open socket callback. See CUR‐
LOPT_OPENSOCKETDATA() CURLOPT_CLOSESOCKETFUNCTION
Callback for closing socket. See CURLOPT_CLOSESOCKETFUNCTION() CURLOPT_CLOSESOCKETDATA
Data pointer to pass to the close socket callback. See CUR‐
LOPT_CLOSESOCKETDATA() CURLOPT_PROGRESSFUNCTION
OBSOLETE callback for progress meter. See CURLOPT_PROGRESSFUNC‐
TION() CURLOPT_PROGRESSDATA
Data pointer to pass to the progress meter callback. See CUR‐
LOPT_PROGRESSDATA() CURLOPT_XFERINFOFUNCTION
Callback for progress meter. See CURLOPT_XFERINFOFUNCTION() CURLOPT_XFERINFODATA
Data pointer to pass to the progress meter callback. See CUR‐
LOPT_XFERINFODATA() CURLOPT_HEADERFUNCTION
Callback for writing received headers. See CURLOPT_HEADERFUNC‐
TION() CURLOPT_HEADERDATA
Data pointer to pass to the header callback. See CURLOPT_HEADER‐
DATA() CURLOPT_DEBUGFUNCTION
Callback for debug information. See CURLOPT_DEBUGFUNCTION() CURLOPT_DEBUGDATA
Data pointer to pass to the debug callback. See CURLOPT_DEBUG‐
DATA() CURLOPT_SSL_CTX_FUNCTION
Callback for SSL context logic. See CURLOPT_SSL_CTX_FUNCTION() CURLOPT_SSL_CTX_DATA
Data pointer to pass to the SSL context callback. See CUR‐
LOPT_SSL_CTX_DATA() CURLOPT_CONV_TO_NETWORK_FUNCTION
Callback for code base conversion. See CURLOPT_CONV_TO_NET‐
WORK_FUNCTION() CURLOPT_CONV_FROM_NETWORK_FUNCTION
Callback for code base conversion. See CURLOPT_CONV_FROM_NET‐
WORK_FUNCTION() CURLOPT_CONV_FROM_UTF8_FUNCTION
Callback for code base conversion. See CUR‐
LOPT_CONV_FROM_UTF8_FUNCTION() CURLOPT_INTERLEAVEFUNCTION
Callback for RTSP interleaved data. See CURLOPT_INTERLEAVEFUNC‐
TION() CURLOPT_INTERLEAVEDATA
Data pointer to pass to the RTSP interleave callback. See CUR‐
LOPT_INTERLEAVEDATA() CURLOPT_CHUNK_BGN_FUNCTION
Callback for wildcard download start of chunk. See CUR‐
LOPT_CHUNK_BGN_FUNCTION() CURLOPT_CHUNK_END_FUNCTION
Callback for wildcard download end of chunk. See CUR‐
LOPT_CHUNK_END_FUNCTION() CURLOPT_CHUNK_DATA
Data pointer to pass to the chunk callbacks. See CUR‐
LOPT_CHUNK_DATA() CURLOPT_FNMATCH_FUNCTION
Callback for wildcard matching. See CURLOPT_FNMATCH_FUNCTION() CURLOPT_FNMATCH_DATA
Data pointer to pass to the wildcard matching callback. See CUR‐
LOPT_FNMATCH_DATA() ERROR OPTIONS
CURLOPT_ERRORBUFFER
Error message buffer. See CURLOPT_ERRORBUFFER() CURLOPT_STDERR
stderr replacement stream. See CURLOPT_STDERR() CURLOPT_FAILONERROR
Fail on HTTP 4xx errors. CURLOPT_FAILONERROR() NETWORK OPTIONS
CURLOPT_URL
URL to work on. See CURLOPT_URL() CURLOPT_PATH_AS_IS
Disable squashing /../ and /./ sequences in the path. See CUR‐
LOPT_PATH_AS_IS() CURLOPT_PROTOCOLS
Allowed protocols. See CURLOPT_PROTOCOLS() CURLOPT_REDIR_PROTOCOLS
Protocols to allow redirects to. See CURLOPT_REDIR_PROTOCOLS() CURLOPT_DEFAULT_PROTOCOL
Default protocol. See CURLOPT_DEFAULT_PROTOCOL() CURLOPT_PROXY
Proxy to use. See CURLOPT_PROXY() CURLOPT_PROXYPORT
Proxy port to use. See CURLOPT_PROXYPORT() CURLOPT_PROXYTYPE
Proxy type. See CURLOPT_PROXYTYPE() CURLOPT_NOPROXY
Filter out hosts from proxy use. CURLOPT_NOPROXY() CURLOPT_HTTPPROXYTUNNEL
Tunnel through the HTTP proxy. CURLOPT_HTTPPROXYTUNNEL() CURLOPT_SOCKS5_GSSAPI_SERVICE
Socks5 GSSAPI service name. CURLOPT_SOCKS5_GSSAPI_SERVICE() CURLOPT_SOCKS5_GSSAPI_NEC
Socks5 GSSAPI NEC mode. See CURLOPT_SOCKS5_GSSAPI_NEC() CURLOPT_PROXY_SERVICE_NAME
Proxy service name. CURLOPT_PROXY_SERVICE_NAME() CURLOPT_SERVICE_NAME
SPNEGO service name. CURLOPT_SERVICE_NAME() CURLOPT_INTERFACE
Bind connection locally to this. See CURLOPT_INTERFACE() CURLOPT_LOCALPORT
Bind connection locally to this port. See CURLOPT_LOCALPORT() CURLOPT_LOCALPORTRANGE
Bind connection locally to port range. See CURLOPT_LOCALPOR‐
TRANGE() CURLOPT_DNS_CACHE_TIMEOUT
Timeout for DNS cache. See CURLOPT_DNS_CACHE_TIMEOUT() CURLOPT_DNS_USE_GLOBAL_CACHE
OBSOLETE Enable global DNS cache. See CUR‐
LOPT_DNS_USE_GLOBAL_CACHE() CURLOPT_BUFFERSIZE
Ask for smaller buffer size. See CURLOPT_BUFFERSIZE() CURLOPT_PORT
Port number to connect to. See CURLOPT_PORT() CURLOPT_TCP_NODELAY
Disable the Nagle algorithm. See CURLOPT_TCP_NODELAY() CURLOPT_ADDRESS_SCOPE
IPv6 scope for local addresses. See CURLOPT_ADDRESS_SCOPE() CURLOPT_TCP_KEEPALIVE
Enable TCP keep-alive. See CURLOPT_TCP_KEEPALIVE() CURLOPT_TCP_KEEPIDLE
Idle time before sending keep-alive. See CURLOPT_TCP_KEEPIDLE() CURLOPT_TCP_KEEPINTVL
Interval between keep-alive probes. See CURLOPT_TCP_KEEPINTVL() CURLOPT_UNIX_SOCKET_PATH
Path to a Unix domain socket. See CURLOPT_UNIX_SOCKET_PATH() NAMES and PASSWORDS OPTIONS (Authentication)
CURLOPT_NETRC
Enable .netrc parsing. See CURLOPT_NETRC() CURLOPT_NETRC_FILE
.netrc file name. See CURLOPT_NETRC_FILE() CURLOPT_USERPWD
User name and password. See CURLOPT_USERPWD() CURLOPT_PROXYUSERPWD
Proxy user name and password. See CURLOPT_PROXYUSERPWD() CURLOPT_USERNAME
User name. See CURLOPT_USERNAME() CURLOPT_PASSWORD
Password. See CURLOPT_PASSWORD() CURLOPT_LOGIN_OPTIONS
Login options. See CURLOPT_LOGIN_OPTIONS() CURLOPT_PROXYUSERNAME
Proxy user name. See CURLOPT_PROXYUSERNAME() CURLOPT_PROXYPASSWORD
Proxy password. See CURLOPT_PROXYPASSWORD() CURLOPT_HTTPAUTH
HTTP server authentication methods. See CURLOPT_HTTPAUTH() CURLOPT_TLSAUTH_USERNAME
TLS authentication user name. See CURLOPT_TLSAUTH_USERNAME() CURLOPT_TLSAUTH_PASSWORD
TLS authentication password. See CURLOPT_TLSAUTH_PASSWORD() CURLOPT_TLSAUTH_TYPE
TLS authentication methods. See CURLOPT_TLSAUTH_TYPE() CURLOPT_PROXYAUTH
HTTP proxy authentication methods. See CURLOPT_PROXYAUTH() CURLOPT_SASL_IR
Enable SASL initial response. See CURLOPT_SASL_IR() CURLOPT_XOAUTH2_BEARER
OAuth2 bearer token. See CURLOPT_XOAUTH2_BEARER() HTTP OPTIONS
CURLOPT_AUTOREFERER
Automatically set Referer: header. See CURLOPT_AUTOREFERER() CURLOPT_ACCEPT_ENCODING
Accept-Encoding and automatic decompressing data. See CUR‐
LOPT_ACCEPT_ENCODING() CURLOPT_TRANSFER_ENCODING
Request Transfer-Encoding. See CURLOPT_TRANSFER_ENCODING() CURLOPT_FOLLOWLOCATION
Follow HTTP redirects. See CURLOPT_FOLLOWLOCATION() CURLOPT_UNRESTRICTED_AUTH
Do not restrict authentication to original host. CURLOPT_UNRE‐
STRICTED_AUTH() CURLOPT_MAXREDIRS
Maximum number of redirects to follow. See CURLOPT_MAXREDIRS() CURLOPT_POSTREDIR
How to act on redirects after POST. See CURLOPT_POSTREDIR() CURLOPT_PUT
Issue a HTTP PUT request. See CURLOPT_PUT() CURLOPT_POST
Issue a HTTP POST request. See CURLOPT_POST() CURLOPT_POSTFIELDS
Send a POST with this data. See CURLOPT_POSTFIELDS() CURLOPT_POSTFIELDSIZE
The POST data is this big. See CURLOPT_POSTFIELDSIZE() CURLOPT_POSTFIELDSIZE_LARGE
The POST data is this big. See CURLOPT_POSTFIELDSIZE_LARGE() CURLOPT_COPYPOSTFIELDS
Send a POST with this data - and copy it. See CURLOPT_COPYPOST‐
FIELDS() CURLOPT_HTTPPOST
Multipart formpost HTTP POST. See CURLOPT_HTTPPOST() CURLOPT_REFERER
Referer: header. See CURLOPT_REFERER() CURLOPT_USERAGENT
User-Agent: header. See CURLOPT_USERAGENT() CURLOPT_HTTPHEADER
Custom HTTP headers. See CURLOPT_HTTPHEADER() CURLOPT_HEADEROPT
Control custom headers. See CURLOPT_HEADEROPT() CURLOPT_PROXYHEADER
Custom HTTP headers sent to proxy. See CURLOPT_PROXYHEADER() CURLOPT_HTTP200ALIASES
Alternative versions of OK. See CURLOPT_HTTP200ALIASES() CURLOPT_COOKIE
Cookie(s) to send. See CURLOPT_COOKIE() CURLOPT_COOKIEFILE
File to read cookies from. See CURLOPT_COOKIEFILE() CURLOPT_COOKIEJAR
File to write cookies to. See CURLOPT_COOKIEJAR() CURLOPT_COOKIESESSION
Start a new cookie session. See CURLOPT_COOKIESESSION() CURLOPT_COOKIELIST
Add or control cookies. See CURLOPT_COOKIELIST() CURLOPT_HTTPGET
Do a HTTP GET request. See CURLOPT_HTTPGET() CURLOPT_HTTP_VERSION
HTTP version to use. CURLOPT_HTTP_VERSION() CURLOPT_IGNORE_CONTENT_LENGTH
Ignore Content-Length. See CURLOPT_IGNORE_CONTENT_LENGTH() CURLOPT_HTTP_CONTENT_DECODING
Disable Content decoding. See CURLOPT_HTTP_CONTENT_DECODING() CURLOPT_HTTP_TRANSFER_DECODING
Disable Transfer decoding. See CURLOPT_HTTP_TRANSFER_DECODING() CURLOPT_EXPECT_100_TIMEOUT_MS
-continue timeout. See CURLOPT_EXPECT_100_TIMEOUT_MS() CURLOPT_PIPEWAIT
Wait on connection to pipeline on it. See CURLOPT_PIPEWAIT() CURLOPT_STREAM_DEPENDS
This HTTP/ stream depends on another. See CUR‐
LOPT_STREAM_DEPENDS() CURLOPT_STREAM_DEPENDS_E
This HTTP/ stream depends on another exclusively. See CUR‐
LOPT_STREAM_DEPENDS_E() CURLOPT_STREAM_WEIGHT
Set this HTTP/ stream's weight. See CURLOPT_STREAM_WEIGHT(3) SMTP OPTIONS
CURLOPT_MAIL_FROM
Address of the sender. See CURLOPT_MAIL_FROM() CURLOPT_MAIL_RCPT
Address of the recipients. See CURLOPT_MAIL_RCPT() CURLOPT_MAIL_AUTH
Authentication address. See CURLOPT_MAIL_AUTH() TFTP OPTIONS
CURLOPT_TFTP_BLKSIZE
TFTP block size. See CURLOPT_TFTP_BLKSIZE() FTP OPTIONS
CURLOPT_FTPPORT
Use active FTP. See CURLOPT_FTPPORT() CURLOPT_QUOTE
Commands to run before transfer. See CURLOPT_QUOTE() CURLOPT_POSTQUOTE
Commands to run after transfer. See CURLOPT_POSTQUOTE() CURLOPT_PREQUOTE
Commands to run just before transfer. See CURLOPT_PREQUOTE() CURLOPT_APPEND
Append to remote file. See CURLOPT_APPEND() CURLOPT_FTP_USE_EPRT
Use EPTR. See CURLOPT_FTP_USE_EPRT() CURLOPT_FTP_USE_EPSV
Use EPSV. See CURLOPT_FTP_USE_EPSV() CURLOPT_FTP_USE_PRET
Use PRET. See CURLOPT_FTP_USE_PRET() CURLOPT_FTP_CREATE_MISSING_DIRS
Create missing directories on the remote server. See CUR‐
LOPT_FTP_CREATE_MISSING_DIRS() CURLOPT_FTP_RESPONSE_TIMEOUT
Timeout for FTP responses. See CURLOPT_FTP_RESPONSE_TIMEOUT() CURLOPT_FTP_ALTERNATIVE_TO_USER
Alternative to USER. See CURLOPT_FTP_ALTERNATIVE_TO_USER() CURLOPT_FTP_SKIP_PASV_IP
Ignore the IP address in the PASV response. See CUR‐
LOPT_FTP_SKIP_PASV_IP() CURLOPT_FTPSSLAUTH
Control how to do TLS. See CURLOPT_FTPSSLAUTH() CURLOPT_FTP_SSL_CCC
Back to non-TLS again after authentication. See CUR‐
LOPT_FTP_SSL_CCC() CURLOPT_FTP_ACCOUNT
Send ACCT command. See CURLOPT_FTP_ACCOUNT() CURLOPT_FTP_FILEMETHOD
Specify how to reach files. See CURLOPT_FTP_FILEMETHOD() RTSP OPTIONS
CURLOPT_RTSP_REQUEST
RTSP request. See CURLOPT_RTSP_REQUEST() CURLOPT_RTSP_SESSION_ID
RTSP session-id. See CURLOPT_RTSP_SESSION_ID() CURLOPT_RTSP_STREAM_URI
RTSP stream URI. See CURLOPT_RTSP_STREAM_URI() CURLOPT_RTSP_TRANSPORT
RTSP Transport: header. See CURLOPT_RTSP_TRANSPORT() CURLOPT_RTSP_CLIENT_CSEQ
Client CSEQ number. See CURLOPT_RTSP_CLIENT_CSEQ() CURLOPT_RTSP_SERVER_CSEQ
CSEQ number for RTSP Server->Client request. See CUR‐
LOPT_RTSP_SERVER_CSEQ() PROTOCOL OPTIONS
CURLOPT_TRANSFERTEXT
Use text transfer. See CURLOPT_TRANSFERTEXT() CURLOPT_PROXY_TRANSFER_MODE
Add transfer mode to URL over proxy. See CURLOPT_PROXY_TRANS‐
FER_MODE() CURLOPT_CRLF
Convert newlines. See CURLOPT_CRLF() CURLOPT_RANGE
Range requests. See CURLOPT_RANGE() CURLOPT_RESUME_FROM
Resume a transfer. See CURLOPT_RESUME_FROM() CURLOPT_RESUME_FROM_LARGE
Resume a transfer. See CURLOPT_RESUME_FROM_LARGE() CURLOPT_CUSTOMREQUEST
Custom request/method. See CURLOPT_CUSTOMREQUEST() CURLOPT_FILETIME
Request file modification date and time. See CURLOPT_FILETIME() CURLOPT_DIRLISTONLY
List only. See CURLOPT_DIRLISTONLY() CURLOPT_NOBODY
Do not get the body contents. See CURLOPT_NOBODY() CURLOPT_INFILESIZE
Size of file to send. CURLOPT_INFILESIZE() CURLOPT_INFILESIZE_LARGE
Size of file to send. CURLOPT_INFILESIZE_LARGE() CURLOPT_UPLOAD
Upload data. See CURLOPT_UPLOAD() CURLOPT_MAXFILESIZE
Maximum file size to get. See CURLOPT_MAXFILESIZE() CURLOPT_MAXFILESIZE_LARGE
Maximum file size to get. See CURLOPT_MAXFILESIZE_LARGE() CURLOPT_TIMECONDITION
Make a time conditional request. See CURLOPT_TIMECONDITION() CURLOPT_TIMEVALUE
Time value for the time conditional request. See CUR‐
LOPT_TIMEVALUE() CONNECTION OPTIONS
CURLOPT_TIMEOUT
Timeout for the entire request. See CURLOPT_TIMEOUT() CURLOPT_TIMEOUT_MS
Millisecond timeout for the entire request. See CURLOPT_TIME‐
OUT_MS() CURLOPT_LOW_SPEED_LIMIT
Low speed limit to abort transfer. See CUR‐
LOPT_LOW_SPEED_LIMIT() CURLOPT_LOW_SPEED_TIME
Time to be below the speed to trigger low speed abort. See CUR‐
LOPT_LOW_SPEED_TIME() CURLOPT_MAX_SEND_SPEED_LARGE
Cap the upload speed to this. See CUR‐
LOPT_MAX_SEND_SPEED_LARGE() CURLOPT_MAX_RECV_SPEED_LARGE
Cap the download speed to this. See CUR‐
LOPT_MAX_RECV_SPEED_LARGE() CURLOPT_MAXCONNECTS
Maximum number of connections in the connection pool. See CUR‐
LOPT_MAXCONNECTS() CURLOPT_FRESH_CONNECT
Use a new connection. CURLOPT_FRESH_CONNECT() CURLOPT_FORBID_REUSE
Prevent subsequent connections from re-using this. See CUR‐
LOPT_FORBID_REUSE() CURLOPT_CONNECTTIMEOUT
Timeout for the connection phase. See CURLOPT_CONNECTTIMEOUT() CURLOPT_CONNECTTIMEOUT_MS
Millisecond timeout for the connection phase. See CURLOPT_CON‐
NECTTIMEOUT_MS() CURLOPT_IPRESOLVE
IP version to resolve to. See CURLOPT_IPRESOLVE() CURLOPT_CONNECT_ONLY
Only connect, nothing else. See CURLOPT_CONNECT_ONLY() CURLOPT_USE_SSL
Use TLS/SSL. See CURLOPT_USE_SSL() CURLOPT_RESOLVE
Provide fixed/fake name resolves. See CURLOPT_RESOLVE() CURLOPT_DNS_INTERFACE
Bind name resolves to this interface. See CURLOPT_DNS_INTER‐
FACE() CURLOPT_DNS_LOCAL_IP4
Bind name resolves to this IP4 address. See CUR‐
LOPT_DNS_LOCAL_IP4() CURLOPT_DNS_LOCAL_IP6
Bind name resolves to this IP6 address. See CUR‐
LOPT_DNS_LOCAL_IP6() CURLOPT_DNS_SERVERS
Preferred DNS servers. See CURLOPT_DNS_SERVERS() CURLOPT_ACCEPTTIMEOUT_MS
Timeout for waiting for the server's connect back to be
accepted. See CURLOPT_ACCEPTTIMEOUT_MS() SSL and SECURITY OPTIONS
CURLOPT_SSLCERT
Client cert. See CURLOPT_SSLCERT() CURLOPT_SSLCERTTYPE
Client cert type. See CURLOPT_SSLCERTTYPE() CURLOPT_SSLKEY
Client key. See CURLOPT_SSLKEY() CURLOPT_SSLKEYTYPE
Client key type. See CURLOPT_SSLKEYTYPE() CURLOPT_KEYPASSWD
Client key password. See CURLOPT_KEYPASSWD() CURLOPT_SSL_ENABLE_ALPN
Enable use of ALPN. See CURLOPT_SSL_ENABLE_ALPN() CURLOPT_SSL_ENABLE_NPN
Enable use of NPN. See CURLOPT_SSL_ENABLE_NPN() CURLOPT_SSLENGINE
Use identifier with SSL engine. See CURLOPT_SSLENGINE() CURLOPT_SSLENGINE_DEFAULT
Default SSL engine. See CURLOPT_SSLENGINE_DEFAULT() CURLOPT_SSL_FALSESTART
Enable TLS False Start. See CURLOPT_SSL_FALSESTART() CURLOPT_SSLVERSION
SSL version to use. See CURLOPT_SSLVERSION() CURLOPT_SSL_VERIFYHOST
Verify the host name in the SSL certificate. See CUR‐
LOPT_SSL_VERIFYHOST() CURLOPT_SSL_VERIFYPEER
Verify the SSL certificate. See CURLOPT_SSL_VERIFYPEER() CURLOPT_SSL_VERIFYSTATUS
Verify the SSL certificate's status. See CURLOPT_SSL_VERIFYSTA‐
TUS() CURLOPT_CAINFO
CA cert bundle. See CURLOPT_CAINFO() CURLOPT_ISSUERCERT
Issuer certificate. See CURLOPT_ISSUERCERT() CURLOPT_CAPATH
Path to CA cert bundle. See CURLOPT_CAPATH() CURLOPT_CRLFILE
Certificate Revocation List. See CURLOPT_CRLFILE() CURLOPT_CERTINFO
Extract certificate info. See CURLOPT_CERTINFO() CURLOPT_PINNEDPUBLICKEY
Set pinned SSL public key . See CURLOPT_PINNEDPUBLICKEY() CURLOPT_RANDOM_FILE
Provide source for entropy random data. See CURLOPT_RAN‐
DOM_FILE() CURLOPT_EGDSOCKET
Identify EGD socket for entropy. See CURLOPT_EGDSOCKET() CURLOPT_SSL_CIPHER_LIST
Ciphers to use. See CURLOPT_SSL_CIPHER_LIST() CURLOPT_SSL_SESSIONID_CACHE
Disable SSL session-id cache. See CURLOPT_SSL_SESSIONID_CACHE() CURLOPT_SSL_OPTIONS
Control SSL behavior. See CURLOPT_SSL_OPTIONS() CURLOPT_KRBLEVEL
Kerberos security level. See CURLOPT_KRBLEVEL() CURLOPT_GSSAPI_DELEGATION
Disable GSS-API delegation. See CURLOPT_GSSAPI_DELEGATION() SSH OPTIONS
CURLOPT_SSH_AUTH_TYPES
SSH authentication types. See CURLOPT_SSH_AUTH_TYPES() CURLOPT_SSH_HOST_PUBLIC_KEY_MD5
MD5 of host's public key. See CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3) CURLOPT_SSH_PUBLIC_KEYFILE
File name of public key. See CURLOPT_SSH_PUBLIC_KEYFILE() CURLOPT_SSH_PRIVATE_KEYFILE
File name of private key. See CURLOPT_SSH_PRIVATE_KEYFILE() CURLOPT_SSH_KNOWNHOSTS
File name with known hosts. See CURLOPT_SSH_KNOWNHOSTS() CURLOPT_SSH_KEYFUNCTION
Callback for known hosts handling. See CURLOPT_SSH_KEYFUNC‐
TION() CURLOPT_SSH_KEYDATA
Custom pointer to pass to ssh key callback. See CURLOPT_SSH_KEY‐
DATA() OTHER OPTIONS
CURLOPT_PRIVATE
Private pointer to store. See CURLOPT_PRIVATE() CURLOPT_SHARE
Share object to use. See CURLOPT_SHARE() CURLOPT_NEW_FILE_PERMS
Mode for creating new remote files. See CUR‐
LOPT_NEW_FILE_PERMS() CURLOPT_NEW_DIRECTORY_PERMS
Mode for creating new remote directories. See CURLOPT_NEW_DIREC‐
TORY_PERMS() TELNET OPTIONS
CURLOPT_TELNETOPTIONS
TELNET options. See CURLOPT_TELNETOPTIONS() 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()
man page for the full list with descriptions. 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, "http://example.com");
res = curl_easy_perform(curl);
curl_easy_cleanup(curl);
} SEE ALSO
curl_easy_init(), curl_easy_cleanup(), curl_easy_reset(),
curl_easy_getinfo(), curl_multi_setopt(), libcurl 7.38. Jun curl_easy_setopt()