中文翻译：
1 curl_easy_setopt(3) libcurl 手册 curl_easy_setopt(3) 2 3 名称 4 curl_easy_setopt -curl的设置选项 5 6 概要 7 #include <curl/curl.h> 8 9 CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter); 10 11 描述 12 curl_easy_setopt(3)是用来告诉libcurl如何表现.通过设置适当的选项，应用程序可以改变libcurl的行为。所有选项都设置一个选项，然后由一个参数. 13 这个比较长：一个函数指针，一个对象的指针或curl_off_t，取决于具体方案预计。如果参数的值不符合要求，可能导致libcurl达到理想效果，请仔细阅读本手册。一个典型的应用程序中会使用许多‐curl_easy_setopt（3）来对环境进行设置。此函数调用的选项设置对下面程序进行传输执行的参数设置,这个函数不能对已经设置的函数进行恢复，如果你想回到内部默认的状态，你可以调用curl_easy_reset（3）。 14 15 字符串传递给libcurl作为字符串参数，由图书馆复制，从而对指针参数的字符串储存空间可能会被curl_easy_setopt（3）的返回值覆盖。 16 17 字符串传递给libcurl作为字符串参数，由文件管理系统复制,从而对指针参数关联的字符串存储空间可能会被curl_easy_setopt（3）的返回值覆盖。这个规则的唯一例外是 really 的curlopt_postfields（3），但选择拷贝的字符串curlopt_copypostfields（3）有一定的使用特点需要你读了。 18 19 选项设置的顺序不重要。 20 21 以前的版本7.17.0，字符串不复制。相反，保持用户促使有效直到libcurl不再需要他们。 22 23 处理是从curl_easy_init返回代码（3）或（3）curl_easy_duphandle调用。 24 25 行为选择 26 CURLOPT_VERBOSE 27 如果你想CURL报告每一件意外的事情，设置这个选项为一个非零值。See CURLOPT_VERBOSE(3) 28 29 CURLOPT_HEADER 30 如果你想把一个头包含在输出中,设置这个选项为一个非零值. See CURLOPT_HEADER(3) 31 32 CURLOPT_NOPROGRESS 33 关闭进度表. See CURLOPT_NOPROGRESS(3) 34 35 CURLOPT_NOSIGNAL 36 不要安装信号处理程序. See CURLOPT_NOSIGNAL(3) 37 38 CURLOPT_WILDCARDMATCH 39 根据文件名模式传输多个文件. See CURLOPT_WILDCARDMATCH(3) 40 41 回调函数的选择 42 CURLOPT_WRITEFUNCTION 43 写入数据的回调. See CURLOPT_WRITEFUNCTION(3) 44 CURLOPT_WRITEDATA 45 数据指针传递给写回调. See CURLOPT_WRITE‐DATA(3) 46 CURLOPT_READFUNCTION 47 读取数据回调. See CURLOPT_READFUNCTION(3) 48 CURLOPT_READDATA 49 数据指针传递给读回调. See CURLOPT_READ‐DATA(3) 50 CURLOPT_IOCTLFUNCTION 51 回调的I/O操作. See CURLOPT_IOCTLFUNCTION(3) 52 CURLOPT_IOCTLDATA 53 数据指针传递给I/O回调. See CURLOPT_IOCTL‐DATA(3) 54 CURLOPT_SEEKFUNCTION 55 寻求操作的回调. See CURLOPT_SEEKFUNCTION(3) 56 CURLOPT_SEEKDATA 57 数据指针传递给寻求回调. See CURLOPT_SEEK‐ DATA(3) 58 CURLOPT_SOCKOPTFUNCTION 59 套接字创建的回调. See CURLOPT_SOCKOPTFUNCTION(3) 60 CURLOPT_SOCKOPTDATA 61 数据指针传递给sockopt回调. See CURLOPT_SOCK‐OPTDATA(3) 62 CURLOPT_OPENSOCKETFUNCTION 63 创建套接字(socket)的回调. See CURLOPT_OPENSOCKETFUNCTION(3) 64 CURLOPT_OPENSOCKETDATA 65 数据指针传递给打开的套接字(socket)回调.See CUR‐LOPT_OPENSOCKETDATA(3) 66 CURLOPT_CLOSESOCKETFUNCTION 67 关闭套接字(socket)的回调. See CURLOPT_CLOSESOCKETFUNCTION(3) 68 CURLOPT_CLOSESOCKETDATA 69 数据指针传递给 关闭套接字回调 70 数据指针传递给关闭套接字(socket)回调. See CUR‐LOPT_CLOSESOCKETDATA(3) 71 CURLOPT_PROGRESSFUNCTION 72 过时的回调进度表(meter). See CURLOPT_PROGRESSFUNC‐TION(3) 73 CURLOPT_PROGRESSDATA 74 数据指针传递给进度表(meter)回调. See CUR‐LOPT_PROGRESSDATA(3) 75 CURLOPT_XFERINFOFUNCTION 76 进度表的回调. See CURLOPT_XFERINFOFUNCTION(3) 77 CURLOPT_XFERINFODATA 78 数据指针传递给进度表回调.See CUR‐LOPT_XFERINFODATA(3) 79 CURLOPT_HEADERFUNCTION 80 写入接收头的回调. See CURLOPT_HEADERFUNC‐TION(3) 81 CURLOPT_HEADERDATA 82 数据指针指向头(header)回调. See CURLOPT_HEADER‐DATA(3) 83 CURLOPT_DEBUGFUNCTION 84 调试信息的回调. See CURLOPT_DEBUGFUNCTION(3) 85 CURLOPT_DEBUGDATA 86 数据指传递向调试回调. See CURLOPT_DEBUG‐DATA(3) 87 CURLOPT_SSL_CTX_FUNCTION 88 ssl上线文逻辑回调. See CURLOPT_SSL_CTX_FUNCTION(3) 89 CURLOPT_SSL_CTX_DATA 90 数据指针传递给SSL上下文回调. See CUR‐LOPT_SSL_CTX_DATA(3) 91 CURLOPT_CONV_TO_NETWORK_FUNCTION 92 代码库转换的回调. See CURLOPT_CONV_TO_NET‐WORK_FUNCTION(3) 93 CURLOPT_CONV_FROM_NETWORK_FUNCTION 94 代码库转换的回调. See CURLOPT_CONV_FROM_NET‐WORK_FUNCTION(3) 95 CURLOPT_CONV_FROM_UTF8_FUNCTION 96 代码库转换的回调. See CUR‐LOPT_CONV_FROM_UTF8_FUNCTION(3) 97 CURLOPT_INTERLEAVEFUNCTION 98 回调RTSP交错的数据. See CURLOPT_INTERLEAVEFUNC‐TION(3) 99 CURLOPT_INTERLEAVEDATA 100 数据指针通过RTSP交织回调. See CUR‐LOPT_INTERLEAVEDATA(3) 101 CURLOPT_CHUNK_BGN_FUNCTION 102 通配符下载启动块回调. See CUR‐LOPT_CHUNK_BGN_FUNCTION(3) 103 CURLOPT_CHUNK_END_FUNCTION 104 对于大块通配符下载结束回调. See CUR‐LOPT_CHUNK_END_FUNCTION(3) 105 CURLOPT_CHUNK_DATA 106 数据指针传递给块回调.See CUR‐LOPT_CHUNK_DATA(3) 107 CURLOPT_FNMATCH_FUNCTION 108 通配符匹配回调. See CURLOPT_FNMATCH_FUNCTION(3) 109 CURLOPT_FNMATCH_DATA 110 数据指针通过通配符匹配回调. See CUR‐LOPT_FNMATCH_DATA(3) 111 错误选择 112 CURLOPT_ERRORBUFFER 113 错误消息缓冲区. See CURLOPT_ERRORBUFFER(3) 114 115 CURLOPT_STDERR 116 标准错误置换流. See CURLOPT_STDERR(3) 117 118 CURLOPT_FAILONERROR 119 在HTTP 4xx 错误失败. CURLOPT_FAILONERROR(3) 120 121 网络选项 122 CURLOPT_URL 123 URL工作. See CURLOPT_URL(3) 124 CURLOPT_PATH_AS_IS 125 禁用挤压/../ 和/../在路径序列. See CUR‐LOPT_PATH_AS_IS(3) 126 CURLOPT_PROTOCOLS 127 协议允许. See CURLOPT_PROTOCOLS(3) 128 CURLOPT_REDIR_PROTOCOLS 129 协议允许重定向到. See CURLOPT_REDIR_PROTOCOLS(3) 130 CURLOPT_DEFAULT_PROTOCOL 131 默认协议. See CURLOPT_DEFAULT_PROTOCOL(3) 132 CURLOPT_PROXY 133 使用代理. See CURLOPT_PROXY(3) 134 CURLOPT_PROXYPORT 135 代理端口使用. See CURLOPT_PROXYPORT(3) 136 CURLOPT_PROXYTYPE 137 代理类型. See CURLOPT_PROXYTYPE(3) 138 CURLOPT_NOPROXY 139 从代理使用筛选主机. CURLOPT_NOPROXY(3) 140 CURLOPT_HTTPPROXYTUNNEL 141 通过HTTP代理隧道. CURLOPT_HTTPPROXYTUNNEL(3) 142 CURLOPT_SOCKS5_GSSAPI_SERVICE 143 Socks5 GSSAPI服务名字. CURLOPT_SOCKS5_GSSAPI_SERVICE(3) 144 CURLOPT_SOCKS5_GSSAPI_NEC 145 Socks5 GSSAPI 无差错校验模式. See CURLOPT_SOCKS5_GSSAPI_NEC(3) 146 CURLOPT_PROXY_SERVICE_NAME 147 代理服务名字. CURLOPT_PROXY_SERVICE_NAME(3) 148 CURLOPT_SERVICE_NAME 149 SPNEGO服务名字. CURLOPT_SERVICE_NAME(3) 150 CURLOPT_INTERFACE 151 绑定本地连接. See CURLOPT_INTERFACE(3) 152 CURLOPT_LOCALPORT 153 绑定本地连接到端口. See CURLOPT_LOCALPORT(3) 154 CURLOPT_LOCALPORTRANGE 155 绑定本地连接绑定到范围端口. See CURLOPT_LOCALPOR‐TRANGE(3) 156 CURLOPT_DNS_CACHE_TIMEOUT 157 DNS缓存超时. See CURLOPT_DNS_CACHE_TIMEOUT(3) 158 CURLOPT_DNS_USE_GLOBAL_CACHE 159 过时的使全局DNS缓存。See CUR‐LOPT_DNS_USE_GLOBAL_CACHE(3) 160 CURLOPT_BUFFERSIZE 161 要求较小的缓冲区大小. See CURLOPT_BUFFERSIZE(3) 162 CURLOPT_PORT 163 端口号连接到. See CURLOPT_PORT(3) 164 CURLOPT_TCP_NODELAY 165 禁用Nagle算法. See CURLOPT_TCP_NODELAY(3) 166 CURLOPT_ADDRESS_SCOPE 167 对于本地地址IPv6范围. See CURLOPT_ADDRESS_SCOPE(3) 168 CURLOPT_TCP_KEEPALIVE 169 启动持久连接(TCP keep-alive). See CURLOPT_TCP_KEEPALIVE(3) 170 CURLOPT_TCP_KEEPIDLE 171 发送前的空闲时间. See CURLOPT_TCP_KEEPIDLE(3) 172 CURLOPT_TCP_KEEPINTVL 173 保持活探针之间的间隔. See CURLOPT_TCP_KEEPINTVL(3) 174 CURLOPT_UNIX_SOCKET_PATH 175 一个Unix域套接字(socket)的路径. See CURLOPT_UNIX_SOCKET_PATH(3) 176 名称和密码选项(身份验证） 177 CURLOPT_NETRC 178 使用.户配置脚本文件解析. See CURLOPT_NETRC(3) 179 CURLOPT_NETRC_FILE 180 .配置脚本文件名. See CURLOPT_NETRC_FILE(3) 181 CURLOPT_USERPWD 182 用户名和密码. See CURLOPT_USERPWD(3) 183 CURLOPT_PROXYUSERPWD 184 代理用户名和密码.See CURLOPT_PROXYUSERPWD(3) 185 CURLOPT_USERNAME 186 用户名. See CURLOPT_USERNAME(3) 187 CURLOPT_PASSWORD 188 密码. See CURLOPT_PASSWORD(3) 189 CURLOPT_LOGIN_OPTIONS 190 登陆选项. See CURLOPT_LOGIN_OPTIONS(3) 191 CURLOPT_PROXYUSERNAME 192 代理用户名. See CURLOPT_PROXYUSERNAME(3) 193 CURLOPT_PROXYPASSWORD 194 代理密码. See CURLOPT_PROXYPASSWORD(3) 195 CURLOPT_HTTPAUTH 196 HTTP服务器的身份验证方法. See CURLOPT_HTTPAUTH(3) 197 CURLOPT_TLSAUTH_USERNAME 198 TLS 验证用户名. See CURLOPT_TLSAUTH_USERNAME(3) 199 CURLOPT_TLSAUTH_PASSWORD 200 TLS 验证密码. See CURLOPT_TLSAUTH_PASSWORD(3) 201 CURLOPT_TLSAUTH_TYPE 202 TLS 身份验证方法. See CURLOPT_TLSAUTH_TYPE(3) 203 CURLOPT_PROXYAUTH 204 HTTP代理验证方法. See CURLOPT_PROXYAUTH(3) 205 CURLOPT_SASL_IR 206 使SASL的初始响应. See CURLOPT_SASL_IR(3) 207 CURLOPT_XOAUTH2_BEARER 208 OAuth2不记名令牌. See CURLOPT_XOAUTH2_BEARER(3) 209 210 HTTP选项 211 CURLOPT_AUTOREFERER 212 自动设置参考；标题. See CURLOPT_AUTOREFERER(3) 213 CURLOPT_ACCEPT_ENCODING 214 接受编码和自动解压缩数据. See CUR‐LOPT_ACCEPT_ENCODING(3) 215 CURLOPT_TRANSFER_ENCODING 216 请求传输编码. See CURLOPT_TRANSFER_ENCODING(3) 217 CURLOPT_FOLLOWLOCATION 218 遵循HTTP重定向. See CURLOPT_FOLLOWLOCATION(3) 219 CURLOPT_UNRESTRICTED_AUTH 220 不限制对原始主机的身份验证. CURLOPT_UNRE‐STRICTED_AUTH(3) 221 CURLOPT_MAXREDIRS 222 跟随重定向的最大数量. See CURLOPT_MAXREDIRS(3) 223 CURLOPT_POSTREDIR 224 如何采取行动后的重定向POST. See CURLOPT_POSTREDIR(3) 225 CURLOPT_PUT 226 发出一个HTTP PUT请求. See CURLOPT_PUT(3) 227 CURLOPT_POST 228 发送一个HTTP POST要求. See CURLOPT_POST(3) 229 CURLOPT_POSTFIELDS 230 用这个数据发送一个POST. See CURLOPT_POSTFIELDS(3) 231 CURLOPT_POSTFIELDSIZE 232 如果你想发送数据POST到服务器没有libcurl做strlen()测量数据的大小，必须使用此选项。使用此选项时你可以把完全的二进制数据，否则可能会失败。如果这个大小设置为1，图书馆将使用strlen()得到尺寸. See CURLOPT_POSTFIELDSIZE(3) 233 CURLOPT_POSTFIELDSIZE_LARGE 234 如果你想发送数据POST到服务器没有libcurl做strlen()测量数据的大小，必须使用此选项。使用此选项时你可以把完全的二进制数据，否则可能会失败。如果这个大小设置为1，图书馆将使用strlen()得到尺寸. See CURLOPT_POSTFIELDSIZE_LARGE(3) 235 CURLOPT_COPYPOSTFIELDS 236 以POST的方式发送一段内容.See CURLOPT_COPYPOST‐FIELDS(3) 237 CURLOPT_HTTPPOST 238 多窗体发送HTTP POST. See CURLOPT_HTTPPOST(3) 239 CURLOPT_REFERER 240 引用:标头. See CURLOPT_REFERER(3) 241 CURLOPT_USERAGENT 242 用户代理:标头. See CURLOPT_USERAGENT(3) 243 CURLOPT_HTTPHEADER 244 自定义HTTP头.See CURLOPT_HTTPHEADER(3) 245 CURLOPT_HEADEROPT 246 控件自定义HTTP头. See CURLOPT_HEADEROPT(3) 247 CURLOPT_PROXYHEADER 248 自定义发送到代理的HTTP头. See CURLOPT_PROXYHEADER(3) 249 CURLOPT_HTTP200ALIASES 250 指定HTTP 200 OK备选匹配.See CURLOPT_HTTP200ALIASES(3) 251 CURLOPT_COOKIE 252 发送小文件. See CURLOPT_COOKIE(3) 253 CURLOPT_COOKIEFILE 254 从文件读取. See CURLOPT_COOKIEFILE(3) 255 CURLOPT_COOKIEJAR 256 向文件写入. See CURLOPT_COOKIEJAR(3) 257 CURLOPT_COOKIESESSION 258 开始一个新的cookie会话. See CURLOPT_COOKIESESSION(3) 259 CURLOPT_COOKIELIST 260 添加或控制cookies. See CURLOPT_COOKIELIST(3) 261 CURLOPT_HTTPGET 262 做一个HTTP GET请求.See CURLOPT_HTTPGET(3) 263 CURLOPT_HTTP_VERSION 264 HTTP版本的使用.CURLOPT_HTTP_VERSION(3) 265 CURLOPT_IGNORE_CONTENT_LENGTH 266 忽略内容长度(Content-Length). See CURLOPT_IGNORE_CONTENT_LENGTH(3) 267 CURLOPT_HTTP_CONTENT_DECODING 268 禁用Content(CSS的一种属性)译码. See CURLOPT_HTTP_CONTENT_DECODING(3) 269 CURLOPT_HTTP_TRANSFER_DECODING 270 禁用传输解码.See CURLOPT_HTTP_TRANSFER_DECODING(3) 271 CURLOPT_EXPECT_100_TIMEOUT_MS 272 100-continue timeout. See CURLOPT_EXPECT_100_TIMEOUT_MS(3) 273 274 CURLOPT_PIPEWAIT 275 Wait on connection to pipeline on it. See CURLOPT_PIPEWAIT(3) 276 277 CURLOPT_STREAM_DEPENDS 278 This HTTP/2 stream depends on another. See CUR‐ 279 LOPT_STREAM_DEPENDS(3) 280 281 CURLOPT_STREAM_DEPENDS_E 282 This HTTP/2 stream depends on another exclusively. See CUR‐ 283 LOPT_STREAM_DEPENDS_E(3) 284 285 CURLOPT_STREAM_WEIGHT 286 Set this HTTP/2 stream's weight. See CURLOPT_STREAM_WEIGHT(3) 287 288 SMTP OPTIONS 289 CURLOPT_MAIL_FROM 290 Address of the sender. See CURLOPT_MAIL_FROM(3) 291 292 CURLOPT_MAIL_RCPT 293 Address of the recipients. See CURLOPT_MAIL_RCPT(3) 294 295 CURLOPT_MAIL_AUTH 296 Authentication address. See CURLOPT_MAIL_AUTH(3) 297 298 TFTP OPTIONS 299 CURLOPT_TFTP_BLKSIZE 300 TFTP block size. See CURLOPT_TFTP_BLKSIZE(3) 301 302 FTP OPTIONS 303 CURLOPT_FTPPORT 304 Use active FTP. See CURLOPT_FTPPORT(3) 305 306 CURLOPT_QUOTE 307 Commands to run before transfer. See CURLOPT_QUOTE(3) 308 309 CURLOPT_POSTQUOTE 310 Commands to run after transfer. See CURLOPT_POSTQUOTE(3) 311 312 CURLOPT_PREQUOTE 313 Commands to run just before transfer. See CURLOPT_PREQUOTE(3) 314 315 CURLOPT_APPEND 316 Append to remote file. See CURLOPT_APPEND(3) 317 318 CURLOPT_FTP_USE_EPRT 319 Use EPTR. See CURLOPT_FTP_USE_EPRT(3) 320 321 CURLOPT_FTP_USE_EPSV 322 Use EPSV. See CURLOPT_FTP_USE_EPSV(3) 323 324 CURLOPT_FTP_USE_PRET 325 Use PRET. See CURLOPT_FTP_USE_PRET(3) 326 327 CURLOPT_FTP_CREATE_MISSING_DIRS 328 Create missing directories on the remote server. See CUR‐ 329 LOPT_FTP_CREATE_MISSING_DIRS(3) 330 331 CURLOPT_FTP_RESPONSE_TIMEOUT 332 Timeout for FTP responses. See CURLOPT_FTP_RESPONSE_TIMEOUT(3) 333 334 CURLOPT_FTP_ALTERNATIVE_TO_USER 335 Alternative to USER. See CURLOPT_FTP_ALTERNATIVE_TO_USER(3) 336 337 CURLOPT_FTP_SKIP_PASV_IP 338 Ignore the IP address in the PASV response. See CUR‐ 339 LOPT_FTP_SKIP_PASV_IP(3) 340 341 CURLOPT_FTPSSLAUTH 342 Control how to do TLS. See CURLOPT_FTPSSLAUTH(3) 343 344 CURLOPT_FTP_SSL_CCC 345 Back to non-TLS again after authentication. See CUR‐ 346 LOPT_FTP_SSL_CCC(3) 347 348 CURLOPT_FTP_ACCOUNT 349 Send ACCT command. See CURLOPT_FTP_ACCOUNT(3) 350 351 CURLOPT_FTP_FILEMETHOD 352 Specify how to reach files. See CURLOPT_FTP_FILEMETHOD(3) 353 354 RTSP OPTIONS 355 CURLOPT_RTSP_REQUEST 356 RTSP request. See CURLOPT_RTSP_REQUEST(3) 357 358 CURLOPT_RTSP_SESSION_ID 359 RTSP session-id. See CURLOPT_RTSP_SESSION_ID(3) 360 361 CURLOPT_RTSP_STREAM_URI 362 RTSP stream URI. See CURLOPT_RTSP_STREAM_URI(3) 363 364 CURLOPT_RTSP_TRANSPORT 365 RTSP Transport: header. See CURLOPT_RTSP_TRANSPORT(3) 366 367 CURLOPT_RTSP_CLIENT_CSEQ 368 Client CSEQ number. See CURLOPT_RTSP_CLIENT_CSEQ(3) 369 370 CURLOPT_RTSP_SERVER_CSEQ 371 CSEQ number for RTSP Server->Client request. See CUR‐ 372 LOPT_RTSP_SERVER_CSEQ(3) 373 374 PROTOCOL OPTIONS 375 CURLOPT_TRANSFERTEXT 376 Use text transfer. See CURLOPT_TRANSFERTEXT(3) 377 378 CURLOPT_PROXY_TRANSFER_MODE 379 Add transfer mode to URL over proxy. See CURLOPT_PROXY_TRANS‐ 380 FER_MODE(3) 381 382 CURLOPT_CRLF 383 Convert newlines. See CURLOPT_CRLF(3) 384 385 CURLOPT_RANGE 386 Range requests. See CURLOPT_RANGE(3) 387 388 CURLOPT_RESUME_FROM 389 Resume a transfer. See CURLOPT_RESUME_FROM(3) 390 391 CURLOPT_RESUME_FROM_LARGE 392 Resume a transfer. See CURLOPT_RESUME_FROM_LARGE(3) 393 394 CURLOPT_CUSTOMREQUEST 395 Custom request/method. See CURLOPT_CUSTOMREQUEST(3) 396 397 CURLOPT_FILETIME 398 Request file modification date and time. See CURLOPT_FILETIME(3) 399 400 CURLOPT_DIRLISTONLY 401 List only. See CURLOPT_DIRLISTONLY(3) 402 403 CURLOPT_NOBODY 404 Do not get the body contents. See CURLOPT_NOBODY(3) 405 406 CURLOPT_INFILESIZE 407 Size of file to send. CURLOPT_INFILESIZE(3) 408 409 CURLOPT_INFILESIZE_LARGE 410 Size of file to send. CURLOPT_INFILESIZE_LARGE(3) 411 412 CURLOPT_UPLOAD 413 Upload data. See CURLOPT_UPLOAD(3) 414 415 CURLOPT_MAXFILESIZE 416 Maximum file size to get. See CURLOPT_MAXFILESIZE(3) 417 418 CURLOPT_MAXFILESIZE_LARGE 419 Maximum file size to get. See CURLOPT_MAXFILESIZE_LARGE(3) 420 421 CURLOPT_TIMECONDITION 422 Make a time conditional request. See CURLOPT_TIMECONDITION(3) 423 424 CURLOPT_TIMEVALUE 425 Time value for the time conditional request. See CUR‐ 426 LOPT_TIMEVALUE(3) 427 428 连接选项 429 CURLOPT_TIMEOUT 430 整个请求的超时时间(s).See CURLOPT_TIMEOUT(3) 431 CURLOPT_TIMEOUT_MS 432 整个请求的超时时间(ms).See CURLOPT_TIME‐OUT_MS(3) 433 CURLOPT_LOW_SPEED_LIMIT 434 低限速中止传输.See CUR‐LOPT_LOW_SPEED_LIMIT(3) 435 CURLOPT_LOW_SPEED_TIME 436 时间低于速度触发低速中止. See CUR‐LOPT_LOW_SPEED_TIME(3) 437 CURLOPT_MAX_SEND_SPEED_LARGE 438 上限上传速度. See CUR‐LOPT_MAX_SEND_SPEED_LARGE(3) 439 CURLOPT_MAX_RECV_SPEED_LARGE 440 下载速度上限. See CUR‐LOPT_MAX_RECV_SPEED_LARGE(3) 441 CURLOPT_MAXCONNECTS 442 连接池中的最大连接数. See CUR‐LOPT_MAXCONNECTS(3) 443 CURLOPT_FRESH_CONNECT 444 使用一个新的连接. CURLOPT_FRESH_CONNECT(3) 445 CURLOPT_FORBID_REUSE 446 防止随后重新连接. See CUR‐LOPT_FORBID_REUSE(3) 447 CURLOPT_CONNECTTIMEOUT 448 连接阶段的超时(m). See CURLOPT_CONNECTTIMEOUT(3) 449 CURLOPT_CONNECTTIMEOUT_MS 450 连接阶段的超时(ms). See CURLOPT_CON‐NECTTIMEOUT_MS(3) 451 CURLOPT_IPRESOLVE 452 IP版本解决. See CURLOPT_IPRESOLVE(3) 453 CURLOPT_CONNECT_ONLY 454 只有连接，没有别的. See CURLOPT_CONNECT_ONLY(3) 455 CURLOPT_USE_SSL 456 使用TLS / SSL. See CURLOPT_USE_SSL(3) 457 CURLOPT_RESOLVE 458 提供自定义主机名到IP地址的解析. See CURLOPT_RESOLVE(3) 459 CURLOPT_DNS_INTERFACE 460 绑定名称解析到这个接口. See CURLOPT_DNS_INTER‐FACE(3) 461 CURLOPT_DNS_LOCAL_IP4 462 绑定名称解析到这个IP4地址. See CUR‐LOPT_DNS_LOCAL_IP4(3) 463 CURLOPT_DNS_LOCAL_IP6 464 绑定名称解析到这个IP6地址. See CUR‐LOPT_DNS_LOCAL_IP6(3) 465 CURLOPT_DNS_SERVERS 466 首选DNS服务器. See CURLOPT_DNS_SERVERS(3) 467 CURLOPT_ACCEPTTIMEOUT_MS 468 等待服务器的连接被接受的超时(ms). See CURLOPT_ACCEPTTIMEOUT_MS(3) 469 SSL和安全选项 470 CURLOPT_SSLCERT 471 客户端证书. See CURLOPT_SSLCERT(3) 472 CURLOPT_SSLCERTTYPE 473 客户端证书类型. See CURLOPT_SSLCERTTYPE(3) 474 CURLOPT_SSLKEY 475 客户端钥匙. See CURLOPT_SSLKEY(3) 476 CURLOPT_SSLKEYTYPE 477 客户端钥匙类型. See CURLOPT_SSLKEYTYPE(3) 478 CURLOPT_KEYPASSWD 479 客户端钥匙密码. See CURLOPT_KEYPASSWD(3) 480 CURLOPT_SSL_ENABLE_ALPN 481 启用ALPN. See CURLOPT_SSL_ENABLE_ALPN(3) 482 CURLOPT_SSL_ENABLE_NPN 483 启用NPN. See CURLOPT_SSL_ENABLE_NPN(3) 484 CURLOPT_SSLENGINE 485 使用SSL引擎标识符. See CURLOPT_SSLENGINE(3) 486 CURLOPT_SSLENGINE_DEFAULT 487 默认的SSL引擎. See CURLOPT_SSLENGINE_DEFAULT(3) 488 CURLOPT_SSL_FALSESTART 489 启用TLS抢跑.See CURLOPT_SSL_FALSESTART(3) 490 CURLOPT_SSLVERSION 491 SSL版本使用.See CURLOPT_SSLVERSION(3) 492 CURLOPT_SSL_VERIFYHOST 493 验证的主机名SSL证书.See CUR‐LOPT_SSL_VERIFYHOST(3) 494 CURLOPT_SSL_VERIFYPEER 495 验证SSL证书. See CURLOPT_SSL_VERIFYPEER(3) 496 CURLOPT_SSL_VERIFYSTATUS 497 验证SSL证书的状态.See CURLOPT_SSL_VERIFYSTA‐TUS(3) 498 CURLOPT_CAINFO 499 捆绑的CA证书. See CURLOPT_CAINFO(3) 500 CURLOPT_ISSUERCERT 501 发行者证书. See CURLOPT_ISSUERCERT(3) 502 CURLOPT_CAPATH 503 捆绑的CA证书路径. See CURLOPT_CAPATH(3) 504 CURLOPT_CRLFILE 505 证书吊销列表. See CURLOPT_CRLFILE(3) 506 CURLOPT_CERTINFO 507 提取证书信息. See CURLOPT_CERTINFO(3) 508 CURLOPT_PINNEDPUBLICKEY 509 设置固定的SSL密钥. See CURLOPT_PINNEDPUBLICKEY(3) 510 CURLOPT_RANDOM_FILE 511 指定一个随机的数据源.See CURLOPT_RAN‐DOM_FILE(3) 512 CURLOPT_EGDSOCKET 513 点对点(EGD)套接字(socket)的路径. See CURLOPT_EGDSOCKET(3) 514 CURLOPT_SSL_CIPHER_LIST 515 使用密码. See CURLOPT_SSL_CIPHER_LIST(3) 516 CURLOPT_SSL_SESSIONID_CACHE 517 禁用SSL会话ID缓存.See CURLOPT_SSL_SESSIONID_CACHE(3) 518 CURLOPT_SSL_OPTIONS 519 SSL行为控制.See CURLOPT_SSL_OPTIONS(3) 520 CURLOPT_KRBLEVEL 521 Kerberos安全水平.See CURLOPT_KRBLEVEL(3) 522 CURLOPT_GSSAPI_DELEGATION 523 禁用GSS-API授权.See CURLOPT_GSSAPI_DELEGATION(3) 524 SSH选择 525 CURLOPT_SSH_AUTH_TYPES 526 SSH认证类型. See CURLOPT_SSH_AUTH_TYPES(3) 527 CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 528 MD5的主机的公钥.See CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3) 529 CURLOPT_SSH_PUBLIC_KEYFILE 530 公共密钥的文件名. See CURLOPT_SSH_PUBLIC_KEYFILE(3) 531 CURLOPT_SSH_PRIVATE_KEYFILE 532 私有密匙的文件名. See CURLOPT_SSH_PRIVATE_KEYFILE(3) 533 CURLOPT_SSH_KNOWNHOSTS 534 已知主机的文件名. See CURLOPT_SSH_KNOWNHOSTS(3) 535 CURLOPT_SSH_KEYFUNCTION 536 回调已知主机处理. See CURLOPT_SSH_KEYFUNC‐TION(3) 537 CURLOPT_SSH_KEYDATA 538 自定义指针通过ssh钥匙的回调. See CURLOPT_SSH_KEY‐DATA(3) 539 其他选项 540 CURLOPT_PRIVATE 541 专用指针存储. See CURLOPT_PRIVATE(3) 542 CURLOPT_SHARE 543 共享对象使用. See CURLOPT_SHARE(3) 544 CURLOPT_NEW_FILE_PERMS 545 创建新远程文件的模式. See CUR‐LOPT_NEW_FILE_PERMS(3) 546 CURLOPT_NEW_DIRECTORY_PERMS 547 创建新的远程目录的模式. See CURLOPT_NEW_DIREC‐TORY_PERMS(3) 548 549 远程登录选项 550 CURLOPT_TELNETOPTIONS 551 远程登录选项. See CURLOPT_TELNETOPTIONS(3) 552 553 返回值 554 CURLE_OK (零)意味着选择了正确的选项, 非零意味着错误发生是<curl/curl.h>定义.详情请见libcurl-errors(3) 操作说明有完整的列表. 555 如果你试图设置一个libcurl的不知道的选项，也许是因为说明手册太老的支持或选择在最近的版本中删除，该函数将返回curle_unknown_option。如果参数不真确在编译时，它将返回curle_not_built_in。 556 557 范例 558 CURL *curl = curl_easy_init(); 559 if(curl) { 560 CURLcode res; 561 curl_easy_setopt(curl, CURLOPT_URL, "http://example.com"); 562 res = curl_easy_perform(curl); 563 curl_easy_cleanup(curl); 564 } 565 566 请参阅 567 curl_easy_init(3), curl_easy_cleanup(3), curl_easy_reset(3), 568 curl_easy_getinfo(3), curl_multi_setopt(3), 569 570 libcurl 7.38.0 25 Jun 2014 curl_easy_setopt(3)
原文：
1 curl_easy_setopt(3) libcurl Manual curl_easy_setopt(3) 2 3 NAME 4 curl_easy_setopt - set options for a curl easy handle 5 6 SYNOPSIS 7 #include <curl/curl.h> 8 9 CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter); 10 11 DESCRIPTION 12 curl_easy_setopt(3) is used to tell libcurl how to behave. By setting 13 the appropriate options, the application can change libcurl's behavior. 14 All options are set with an option followed by a parameter. That param‐ 15 eter can be a long, a function pointer, an object pointer or a 16 curl_off_t, depending on what the specific option expects. Read this 17 manual carefully as bad input values may cause libcurl to behave badly! 18 You can only set one option in each function call. A typical applica‐ 19 tion uses many curl_easy_setopt(3) calls in the setup phase. 20 21 Options set with this function call are valid for all forthcoming 22 transfers performed using this handle. The options are not in any way 23 reset between transfers, so if you want subsequent transfers with dif‐ 24 ferent options, you must change them between the transfers. You can 25 optionally reset all options back to internal default with 26 curl_easy_reset(3). 27 28 Strings passed to libcurl as 'char *' arguments, are copied by the 29 library; thus the string storage associated to the pointer argument may 30 be overwritten after curl_easy_setopt(3) returns. The only exception to 31 this rule is really CURLOPT_POSTFIELDS(3), but the alternative that 32 copies the string CURLOPT_COPYPOSTFIELDS(3) has some usage characteris‐ 33 tics you need to read up on. 34 35 The order in which the options are set does not matter. 36 37 Before version 7.17.0, strings were not copied. Instead the user was 38 forced keep them available until libcurl no longer needed them. 39 40 The handle is the return code from a curl_easy_init(3) or 41 curl_easy_duphandle(3) call. 42 43 BEHAVIOR OPTIONS 44 CURLOPT_VERBOSE 45 Display verbose information. See CURLOPT_VERBOSE(3) 46 47 CURLOPT_HEADER 48 Include the header in the body output. See CURLOPT_HEADER(3) 49 50 CURLOPT_NOPROGRESS 51 Shut off the progress meter. See CURLOPT_NOPROGRESS(3) 52 53 CURLOPT_NOSIGNAL 54 Do not install signal handlers. See CURLOPT_NOSIGNAL(3) 55 56 CURLOPT_WILDCARDMATCH 57 Transfer multiple files according to a file name pattern. See 58 CURLOPT_WILDCARDMATCH(3) 59 60 CALLBACK OPTIONS 61 CURLOPT_WRITEFUNCTION 62 Callback for writing data. See CURLOPT_WRITEFUNCTION(3) 63 64 CURLOPT_WRITEDATA 65 Data pointer to pass to the write callback. See CURLOPT_WRITE‐ 66 DATA(3) 67 68 CURLOPT_READFUNCTION 69 Callback for reading data. See CURLOPT_READFUNCTION(3) 70 71 CURLOPT_READDATA 72 Data pointer to pass to the read callback. See CURLOPT_READ‐ 73 DATA(3) 74 75 CURLOPT_IOCTLFUNCTION 76 Callback for I/O operations. See CURLOPT_IOCTLFUNCTION(3) 77 78 CURLOPT_IOCTLDATA 79 Data pointer to pass to the I/O callback. See CURLOPT_IOCTL‐ 80 DATA(3) 81 82 CURLOPT_SEEKFUNCTION 83 Callback for seek operations. See CURLOPT_SEEKFUNCTION(3) 84 85 CURLOPT_SEEKDATA 86 Data pointer to pass to the seek callback. See CURLOPT_SEEK‐ 87 DATA(3) 88 89 CURLOPT_SOCKOPTFUNCTION 90 Callback for sockopt operations. See CURLOPT_SOCKOPTFUNCTION(3) 91 92 CURLOPT_SOCKOPTDATA 93 Data pointer to pass to the sockopt callback. See CURLOPT_SOCK‐ 94 OPTDATA(3) 95 96 CURLOPT_OPENSOCKETFUNCTION 97 Callback for socket creation. See CURLOPT_OPENSOCKETFUNCTION(3) 98 99 CURLOPT_OPENSOCKETDATA 100 Data pointer to pass to the open socket callback. See CUR‐ 101 LOPT_OPENSOCKETDATA(3) 102 103 CURLOPT_CLOSESOCKETFUNCTION 104 Callback for closing socket. See CURLOPT_CLOSESOCKETFUNCTION(3) 105 106 CURLOPT_CLOSESOCKETDATA 107 Data pointer to pass to the close socket callback. See CUR‐ 108 LOPT_CLOSESOCKETDATA(3) 109 110 CURLOPT_PROGRESSFUNCTION 111 OBSOLETE callback for progress meter. See CURLOPT_PROGRESSFUNC‐ 112 TION(3) 113 114 CURLOPT_PROGRESSDATA 115 Data pointer to pass to the progress meter callback. See CUR‐ 116 LOPT_PROGRESSDATA(3) 117 118 CURLOPT_XFERINFOFUNCTION 119 Callback for progress meter. See CURLOPT_XFERINFOFUNCTION(3) 120 121 CURLOPT_XFERINFODATA 122 Data pointer to pass to the progress meter callback. See CUR‐ 123 LOPT_XFERINFODATA(3) 124 125 CURLOPT_HEADERFUNCTION 126 Callback for writing received headers. See CURLOPT_HEADERFUNC‐ 127 TION(3) 128 129 CURLOPT_HEADERDATA 130 Data pointer to pass to the header callback. See CURLOPT_HEADER‐ 131 DATA(3) 132 133 CURLOPT_DEBUGFUNCTION 134 Callback for debug information. See CURLOPT_DEBUGFUNCTION(3) 135 136 CURLOPT_DEBUGDATA 137 Data pointer to pass to the debug callback. See CURLOPT_DEBUG‐ 138 DATA(3) 139 140 CURLOPT_SSL_CTX_FUNCTION 141 Callback for SSL context logic. See CURLOPT_SSL_CTX_FUNCTION(3) 142 143 CURLOPT_SSL_CTX_DATA 144 Data pointer to pass to the SSL context callback. See CUR‐ 145 LOPT_SSL_CTX_DATA(3) 146 147 CURLOPT_CONV_TO_NETWORK_FUNCTION 148 Callback for code base conversion. See CURLOPT_CONV_TO_NET‐ 149 WORK_FUNCTION(3) 150 151 CURLOPT_CONV_FROM_NETWORK_FUNCTION 152 Callback for code base conversion. See CURLOPT_CONV_FROM_NET‐ 153 WORK_FUNCTION(3) 154 155 CURLOPT_CONV_FROM_UTF8_FUNCTION 156 Callback for code base conversion. See CUR‐ 157 LOPT_CONV_FROM_UTF8_FUNCTION(3) 158 159 CURLOPT_INTERLEAVEFUNCTION 160 Callback for RTSP interleaved data. See CURLOPT_INTERLEAVEFUNC‐ 161 TION(3) 162 163 CURLOPT_INTERLEAVEDATA 164 Data pointer to pass to the RTSP interleave callback. See CUR‐ 165 LOPT_INTERLEAVEDATA(3) 166 167 CURLOPT_CHUNK_BGN_FUNCTION 168 Callback for wildcard download start of chunk. See CUR‐ 169 LOPT_CHUNK_BGN_FUNCTION(3) 170 171 CURLOPT_CHUNK_END_FUNCTION 172 Callback for wildcard download end of chunk. See CUR‐ 173 LOPT_CHUNK_END_FUNCTION(3) 174 175 CURLOPT_CHUNK_DATA 176 Data pointer to pass to the chunk callbacks. See CUR‐ 177 LOPT_CHUNK_DATA(3) 178 179 CURLOPT_FNMATCH_FUNCTION 180 Callback for wildcard matching. See CURLOPT_FNMATCH_FUNCTION(3) 181 182 CURLOPT_FNMATCH_DATA 183 Data pointer to pass to the wildcard matching callback. See CUR‐ 184 LOPT_FNMATCH_DATA(3) 185 186 ERROR OPTIONS 187 CURLOPT_ERRORBUFFER 188 Error message buffer. See CURLOPT_ERRORBUFFER(3) 189 190 CURLOPT_STDERR 191 stderr replacement stream. See CURLOPT_STDERR(3) 192 193 CURLOPT_FAILONERROR 194 Fail on HTTP 4xx errors. CURLOPT_FAILONERROR(3) 195 196 NETWORK OPTIONS 197 CURLOPT_URL 198 URL to work on. See CURLOPT_URL(3) 199 200 CURLOPT_PATH_AS_IS 201 Disable squashing /../ and /./ sequences in the path. See CUR‐ 202 LOPT_PATH_AS_IS(3) 203 204 CURLOPT_PROTOCOLS 205 Allowed protocols. See CURLOPT_PROTOCOLS(3) 206 207 CURLOPT_REDIR_PROTOCOLS 208 Protocols to allow redirects to. See CURLOPT_REDIR_PROTOCOLS(3) 209 210 CURLOPT_DEFAULT_PROTOCOL 211 Default protocol. See CURLOPT_DEFAULT_PROTOCOL(3) 212 213 CURLOPT_PROXY 214 Proxy to use. See CURLOPT_PROXY(3) 215 216 CURLOPT_PROXYPORT 217 Proxy port to use. See CURLOPT_PROXYPORT(3) 218 219 CURLOPT_PROXYTYPE 220 Proxy type. See CURLOPT_PROXYTYPE(3) 221 222 CURLOPT_NOPROXY 223 Filter out hosts from proxy use. CURLOPT_NOPROXY(3) 224 225 CURLOPT_HTTPPROXYTUNNEL 226 Tunnel through the HTTP proxy. CURLOPT_HTTPPROXYTUNNEL(3) 227 228 CURLOPT_SOCKS5_GSSAPI_SERVICE 229 Socks5 GSSAPI service name. CURLOPT_SOCKS5_GSSAPI_SERVICE(3) 230 231 CURLOPT_SOCKS5_GSSAPI_NEC 232 Socks5 GSSAPI NEC mode. See CURLOPT_SOCKS5_GSSAPI_NEC(3) 233 234 CURLOPT_PROXY_SERVICE_NAME 235 Proxy service name. CURLOPT_PROXY_SERVICE_NAME(3) 236 237 CURLOPT_SERVICE_NAME 238 SPNEGO service name. CURLOPT_SERVICE_NAME(3) 239 240 CURLOPT_INTERFACE 241 Bind connection locally to this. See CURLOPT_INTERFACE(3) 242 243 CURLOPT_LOCALPORT 244 Bind connection locally to this port. See CURLOPT_LOCALPORT(3) 245 246 CURLOPT_LOCALPORTRANGE 247 Bind connection locally to port range. See CURLOPT_LOCALPOR‐ 248 TRANGE(3) 249 250 CURLOPT_DNS_CACHE_TIMEOUT 251 Timeout for DNS cache. See CURLOPT_DNS_CACHE_TIMEOUT(3) 252 253 CURLOPT_DNS_USE_GLOBAL_CACHE 254 OBSOLETE Enable global DNS cache. See CUR‐ 255 LOPT_DNS_USE_GLOBAL_CACHE(3) 256 257 CURLOPT_BUFFERSIZE 258 Ask for smaller buffer size. See CURLOPT_BUFFERSIZE(3) 259 260 CURLOPT_PORT 261 Port number to connect to. See CURLOPT_PORT(3) 262 263 CURLOPT_TCP_NODELAY 264 Disable the Nagle algorithm. See CURLOPT_TCP_NODELAY(3) 265 266 CURLOPT_ADDRESS_SCOPE 267 IPv6 scope for local addresses. See CURLOPT_ADDRESS_SCOPE(3) 268 269 CURLOPT_TCP_KEEPALIVE 270 Enable TCP keep-alive. See CURLOPT_TCP_KEEPALIVE(3) 271 272 CURLOPT_TCP_KEEPIDLE 273 Idle time before sending keep-alive. See CURLOPT_TCP_KEEPIDLE(3) 274 275 CURLOPT_TCP_KEEPINTVL 276 Interval between keep-alive probes. See CURLOPT_TCP_KEEPINTVL(3) 277 278 CURLOPT_UNIX_SOCKET_PATH 279 Path to a Unix domain socket. See CURLOPT_UNIX_SOCKET_PATH(3) 280 281 NAMES and PASSWORDS OPTIONS (Authentication) 282 CURLOPT_NETRC 283 Enable .netrc parsing. See CURLOPT_NETRC(3) 284 285 CURLOPT_NETRC_FILE 286 .netrc file name. See CURLOPT_NETRC_FILE(3) 287 288 CURLOPT_USERPWD 289 User name and password. See CURLOPT_USERPWD(3) 290 291 CURLOPT_PROXYUSERPWD 292 Proxy user name and password. See CURLOPT_PROXYUSERPWD(3) 293 294 CURLOPT_USERNAME 295 User name. See CURLOPT_USERNAME(3) 296 297 CURLOPT_PASSWORD 298 Password. See CURLOPT_PASSWORD(3) 299 300 CURLOPT_LOGIN_OPTIONS 301 Login options. See CURLOPT_LOGIN_OPTIONS(3) 302 303 CURLOPT_PROXYUSERNAME 304 Proxy user name. See CURLOPT_PROXYUSERNAME(3) 305 306 CURLOPT_PROXYPASSWORD 307 Proxy password. See CURLOPT_PROXYPASSWORD(3) 308 309 CURLOPT_HTTPAUTH 310 HTTP server authentication methods. See CURLOPT_HTTPAUTH(3) 311 312 CURLOPT_TLSAUTH_USERNAME 313 TLS authentication user name. See CURLOPT_TLSAUTH_USERNAME(3) 314 315 CURLOPT_TLSAUTH_PASSWORD 316 TLS authentication password. See CURLOPT_TLSAUTH_PASSWORD(3) 317 318 CURLOPT_TLSAUTH_TYPE 319 TLS authentication methods. See CURLOPT_TLSAUTH_TYPE(3) 320 321 CURLOPT_PROXYAUTH 322 HTTP proxy authentication methods. See CURLOPT_PROXYAUTH(3) 323 324 CURLOPT_SASL_IR 325 Enable SASL initial response. See CURLOPT_SASL_IR(3) 326 327 CURLOPT_XOAUTH2_BEARER 328 OAuth2 bearer token. See CURLOPT_XOAUTH2_BEARER(3) 329 330 HTTP OPTIONS 331 CURLOPT_AUTOREFERER 332 Automatically set Referer: header. See CURLOPT_AUTOREFERER(3) 333 334 CURLOPT_ACCEPT_ENCODING 335 Accept-Encoding and automatic decompressing data. See CUR‐ 336 LOPT_ACCEPT_ENCODING(3) 337 338 CURLOPT_TRANSFER_ENCODING 339 Request Transfer-Encoding. See CURLOPT_TRANSFER_ENCODING(3) 340 341 CURLOPT_FOLLOWLOCATION 342 Follow HTTP redirects. See CURLOPT_FOLLOWLOCATION(3) 343 344 CURLOPT_UNRESTRICTED_AUTH 345 Do not restrict authentication to original host. CURLOPT_UNRE‐ 346 STRICTED_AUTH(3) 347 348 CURLOPT_MAXREDIRS 349 Maximum number of redirects to follow. See CURLOPT_MAXREDIRS(3) 350 351 CURLOPT_POSTREDIR 352 How to act on redirects after POST. See CURLOPT_POSTREDIR(3) 353 354 CURLOPT_PUT 355 Issue a HTTP PUT request. See CURLOPT_PUT(3) 356 357 CURLOPT_POST 358 Issue a HTTP POST request. See CURLOPT_POST(3) 359 360 CURLOPT_POSTFIELDS 361 Send a POST with this data. See CURLOPT_POSTFIELDS(3) 362 363 CURLOPT_POSTFIELDSIZE 364 The POST data is this big. See CURLOPT_POSTFIELDSIZE(3) 365 366 CURLOPT_POSTFIELDSIZE_LARGE 367 The POST data is this big. See CURLOPT_POSTFIELDSIZE_LARGE(3) 368 369 CURLOPT_COPYPOSTFIELDS 370 Send a POST with this data - and copy it. See CURLOPT_COPYPOST‐ 371 FIELDS(3) 372 373 CURLOPT_HTTPPOST 374 Multipart formpost HTTP POST. See CURLOPT_HTTPPOST(3) 375 376 CURLOPT_REFERER 377 Referer: header. See CURLOPT_REFERER(3) 378 379 CURLOPT_USERAGENT 380 User-Agent: header. See CURLOPT_USERAGENT(3) 381 382 CURLOPT_HTTPHEADER 383 Custom HTTP headers. See CURLOPT_HTTPHEADER(3) 384 385 CURLOPT_HEADEROPT 386 Control custom headers. See CURLOPT_HEADEROPT(3) 387 388 CURLOPT_PROXYHEADER 389 Custom HTTP headers sent to proxy. See CURLOPT_PROXYHEADER(3) 390 391 CURLOPT_HTTP200ALIASES 392 Alternative versions of 200 OK. See CURLOPT_HTTP200ALIASES(3) 393 394 CURLOPT_COOKIE 395 Cookie(s) to send. See CURLOPT_COOKIE(3) 396 397 CURLOPT_COOKIEFILE 398 File to read cookies from. See CURLOPT_COOKIEFILE(3) 399 400 CURLOPT_COOKIEJAR 401 File to write cookies to. See CURLOPT_COOKIEJAR(3) 402 403 CURLOPT_COOKIESESSION 404 Start a new cookie session. See CURLOPT_COOKIESESSION(3) 405 406 CURLOPT_COOKIELIST 407 Add or control cookies. See CURLOPT_COOKIELIST(3) 408 409 CURLOPT_HTTPGET 410 Do a HTTP GET request. See CURLOPT_HTTPGET(3) 411 412 CURLOPT_HTTP_VERSION 413 HTTP version to use. CURLOPT_HTTP_VERSION(3) 414 415 CURLOPT_IGNORE_CONTENT_LENGTH 416 Ignore Content-Length. See CURLOPT_IGNORE_CONTENT_LENGTH(3) 417 418 CURLOPT_HTTP_CONTENT_DECODING 419 Disable Content decoding. See CURLOPT_HTTP_CONTENT_DECODING(3) 420 421 CURLOPT_HTTP_TRANSFER_DECODING 422 Disable Transfer decoding. See CURLOPT_HTTP_TRANSFER_DECODING(3) 423 424 CURLOPT_EXPECT_100_TIMEOUT_MS 425 100-continue timeout. See CURLOPT_EXPECT_100_TIMEOUT_MS(3) 426 427 CURLOPT_PIPEWAIT 428 Wait on connection to pipeline on it. See CURLOPT_PIPEWAIT(3) 429 430 CURLOPT_STREAM_DEPENDS 431 This HTTP/2 stream depends on another. See CUR‐ 432 LOPT_STREAM_DEPENDS(3) 433 434 CURLOPT_STREAM_DEPENDS_E 435 This HTTP/2 stream depends on another exclusively. See CUR‐ 436 LOPT_STREAM_DEPENDS_E(3) 437 438 CURLOPT_STREAM_WEIGHT 439 Set this HTTP/2 stream's weight. See CURLOPT_STREAM_WEIGHT(3) 440 441 SMTP OPTIONS 442 CURLOPT_MAIL_FROM 443 Address of the sender. See CURLOPT_MAIL_FROM(3) 444 445 CURLOPT_MAIL_RCPT 446 Address of the recipients. See CURLOPT_MAIL_RCPT(3) 447 448 CURLOPT_MAIL_AUTH 449 Authentication address. See CURLOPT_MAIL_AUTH(3) 450 451 TFTP OPTIONS 452 CURLOPT_TFTP_BLKSIZE 453 TFTP block size. See CURLOPT_TFTP_BLKSIZE(3) 454 455 FTP OPTIONS 456 CURLOPT_FTPPORT 457 Use active FTP. See CURLOPT_FTPPORT(3) 458 459 CURLOPT_QUOTE 460 Commands to run before transfer. See CURLOPT_QUOTE(3) 461 462 CURLOPT_POSTQUOTE 463 Commands to run after transfer. See CURLOPT_POSTQUOTE(3) 464 465 CURLOPT_PREQUOTE 466 Commands to run just before transfer. See CURLOPT_PREQUOTE(3) 467 468 CURLOPT_APPEND 469 Append to remote file. See CURLOPT_APPEND(3) 470 471 CURLOPT_FTP_USE_EPRT 472 Use EPTR. See CURLOPT_FTP_USE_EPRT(3) 473 474 CURLOPT_FTP_USE_EPSV 475 Use EPSV. See CURLOPT_FTP_USE_EPSV(3) 476 477 CURLOPT_FTP_USE_PRET 478 Use PRET. See CURLOPT_FTP_USE_PRET(3) 479 480 CURLOPT_FTP_CREATE_MISSING_DIRS 481 Create missing directories on the remote server. See CUR‐ 482 LOPT_FTP_CREATE_MISSING_DIRS(3) 483 484 CURLOPT_FTP_RESPONSE_TIMEOUT 485 Timeout for FTP responses. See CURLOPT_FTP_RESPONSE_TIMEOUT(3) 486 487 CURLOPT_FTP_ALTERNATIVE_TO_USER 488 Alternative to USER. See CURLOPT_FTP_ALTERNATIVE_TO_USER(3) 489 490 CURLOPT_FTP_SKIP_PASV_IP 491 Ignore the IP address in the PASV response. See CUR‐ 492 LOPT_FTP_SKIP_PASV_IP(3) 493 494 CURLOPT_FTPSSLAUTH 495 Control how to do TLS. See CURLOPT_FTPSSLAUTH(3) 496 497 CURLOPT_FTP_SSL_CCC 498 Back to non-TLS again after authentication. See CUR‐ 499 LOPT_FTP_SSL_CCC(3) 500 501 CURLOPT_FTP_ACCOUNT 502 Send ACCT command. See CURLOPT_FTP_ACCOUNT(3) 503 504 CURLOPT_FTP_FILEMETHOD 505 Specify how to reach files. See CURLOPT_FTP_FILEMETHOD(3) 506 507 RTSP OPTIONS 508 CURLOPT_RTSP_REQUEST 509 RTSP request. See CURLOPT_RTSP_REQUEST(3) 510 511 CURLOPT_RTSP_SESSION_ID 512 RTSP session-id. See CURLOPT_RTSP_SESSION_ID(3) 513 514 CURLOPT_RTSP_STREAM_URI 515 RTSP stream URI. See CURLOPT_RTSP_STREAM_URI(3) 516 517 CURLOPT_RTSP_TRANSPORT 518 RTSP Transport: header. See CURLOPT_RTSP_TRANSPORT(3) 519 520 CURLOPT_RTSP_CLIENT_CSEQ 521 Client CSEQ number. See CURLOPT_RTSP_CLIENT_CSEQ(3) 522 523 CURLOPT_RTSP_SERVER_CSEQ 524 CSEQ number for RTSP Server->Client request. See CUR‐ 525 LOPT_RTSP_SERVER_CSEQ(3) 526 527 PROTOCOL OPTIONS 528 CURLOPT_TRANSFERTEXT 529 Use text transfer. See CURLOPT_TRANSFERTEXT(3) 530 531 CURLOPT_PROXY_TRANSFER_MODE 532 Add transfer mode to URL over proxy. See CURLOPT_PROXY_TRANS‐ 533 FER_MODE(3) 534 535 CURLOPT_CRLF 536 Convert newlines. See CURLOPT_CRLF(3) 537 538 CURLOPT_RANGE 539 Range requests. See CURLOPT_RANGE(3) 540 541 CURLOPT_RESUME_FROM 542 Resume a transfer. See CURLOPT_RESUME_FROM(3) 543 544 CURLOPT_RESUME_FROM_LARGE 545 Resume a transfer. See CURLOPT_RESUME_FROM_LARGE(3) 546 547 CURLOPT_CUSTOMREQUEST 548 Custom request/method. See CURLOPT_CUSTOMREQUEST(3) 549 550 CURLOPT_FILETIME 551 Request file modification date and time. See CURLOPT_FILETIME(3) 552 553 CURLOPT_DIRLISTONLY 554 List only. See CURLOPT_DIRLISTONLY(3) 555 556 CURLOPT_NOBODY 557 Do not get the body contents. See CURLOPT_NOBODY(3) 558 559 CURLOPT_INFILESIZE 560 Size of file to send. CURLOPT_INFILESIZE(3) 561 562 CURLOPT_INFILESIZE_LARGE 563 Size of file to send. CURLOPT_INFILESIZE_LARGE(3) 564 565 CURLOPT_UPLOAD 566 Upload data. See CURLOPT_UPLOAD(3) 567 568 CURLOPT_MAXFILESIZE 569 Maximum file size to get. See CURLOPT_MAXFILESIZE(3) 570 571 CURLOPT_MAXFILESIZE_LARGE 572 Maximum file size to get. See CURLOPT_MAXFILESIZE_LARGE(3) 573 574 CURLOPT_TIMECONDITION 575 Make a time conditional request. See CURLOPT_TIMECONDITION(3) 576 577 CURLOPT_TIMEVALUE 578 Time value for the time conditional request. See CUR‐ 579 LOPT_TIMEVALUE(3) 580 581 CONNECTION OPTIONS 582 CURLOPT_TIMEOUT 583 Timeout for the entire request. See CURLOPT_TIMEOUT(3) 584 585 CURLOPT_TIMEOUT_MS 586 Millisecond timeout for the entire request. See CURLOPT_TIME‐ 587 OUT_MS(3) 588 589 CURLOPT_LOW_SPEED_LIMIT 590 Low speed limit to abort transfer. See CUR‐ 591 LOPT_LOW_SPEED_LIMIT(3) 592 593 CURLOPT_LOW_SPEED_TIME 594 Time to be below the speed to trigger low speed abort. See CUR‐ 595 LOPT_LOW_SPEED_TIME(3) 596 597 CURLOPT_MAX_SEND_SPEED_LARGE 598 Cap the upload speed to this. See CUR‐ 599 LOPT_MAX_SEND_SPEED_LARGE(3) 600 601 CURLOPT_MAX_RECV_SPEED_LARGE 602 Cap the download speed to this. See CUR‐ 603 LOPT_MAX_RECV_SPEED_LARGE(3) 604 605 CURLOPT_MAXCONNECTS 606 Maximum number of connections in the connection pool. See CUR‐ 607 LOPT_MAXCONNECTS(3) 608 609 CURLOPT_FRESH_CONNECT 610 Use a new connection. CURLOPT_FRESH_CONNECT(3) 611 612 CURLOPT_FORBID_REUSE 613 Prevent subsequent connections from re-using this. See CUR‐ 614 LOPT_FORBID_REUSE(3) 615 616 CURLOPT_CONNECTTIMEOUT 617 Timeout for the connection phase. See CURLOPT_CONNECTTIMEOUT(3) 618 619 CURLOPT_CONNECTTIMEOUT_MS 620 Millisecond timeout for the connection phase. See CURLOPT_CON‐ 621 NECTTIMEOUT_MS(3) 622 623 CURLOPT_IPRESOLVE 624 IP version to resolve to. See CURLOPT_IPRESOLVE(3) 625 626 CURLOPT_CONNECT_ONLY 627 Only connect, nothing else. See CURLOPT_CONNECT_ONLY(3) 628 629 CURLOPT_USE_SSL 630 Use TLS/SSL. See CURLOPT_USE_SSL(3) 631 632 CURLOPT_RESOLVE 633 Provide fixed/fake name resolves. See CURLOPT_RESOLVE(3) 634 635 CURLOPT_DNS_INTERFACE 636 Bind name resolves to this interface. See CURLOPT_DNS_INTER‐ 637 FACE(3) 638 639 CURLOPT_DNS_LOCAL_IP4 640 Bind name resolves to this IP4 address. See CUR‐ 641 LOPT_DNS_LOCAL_IP4(3) 642 643 CURLOPT_DNS_LOCAL_IP6 644 Bind name resolves to this IP6 address. See CUR‐ 645 LOPT_DNS_LOCAL_IP6(3) 646 647 CURLOPT_DNS_SERVERS 648 Preferred DNS servers. See CURLOPT_DNS_SERVERS(3) 649 650 CURLOPT_ACCEPTTIMEOUT_MS 651 Timeout for waiting for the server's connect back to be 652 accepted. See CURLOPT_ACCEPTTIMEOUT_MS(3) 653 654 SSL and SECURITY OPTIONS 655 CURLOPT_SSLCERT 656 Client cert. See CURLOPT_SSLCERT(3) 657 658 CURLOPT_SSLCERTTYPE 659 Client cert type. See CURLOPT_SSLCERTTYPE(3) 660 661 CURLOPT_SSLKEY 662 Client key. See CURLOPT_SSLKEY(3) 663 664 CURLOPT_SSLKEYTYPE 665 Client key type. See CURLOPT_SSLKEYTYPE(3) 666 667 CURLOPT_KEYPASSWD 668 Client key password. See CURLOPT_KEYPASSWD(3) 669 670 CURLOPT_SSL_ENABLE_ALPN 671 Enable use of ALPN. See CURLOPT_SSL_ENABLE_ALPN(3) 672 673 CURLOPT_SSL_ENABLE_NPN 674 Enable use of NPN. See CURLOPT_SSL_ENABLE_NPN(3) 675 676 CURLOPT_SSLENGINE 677 Use identifier with SSL engine. See CURLOPT_SSLENGINE(3) 678 679 CURLOPT_SSLENGINE_DEFAULT 680 Default SSL engine. See CURLOPT_SSLENGINE_DEFAULT(3) 681 682 CURLOPT_SSL_FALSESTART 683 Enable TLS False Start. See CURLOPT_SSL_FALSESTART(3) 684 685 CURLOPT_SSLVERSION 686 SSL version to use. See CURLOPT_SSLVERSION(3) 687 688 CURLOPT_SSL_VERIFYHOST 689 Verify the host name in the SSL certificate. See CUR‐ 690 LOPT_SSL_VERIFYHOST(3) 691 692 CURLOPT_SSL_VERIFYPEER 693 Verify the SSL certificate. See CURLOPT_SSL_VERIFYPEER(3) 694 695 CURLOPT_SSL_VERIFYSTATUS 696 Verify the SSL certificate's status. See CURLOPT_SSL_VERIFYSTA‐ 697 TUS(3) 698 699 CURLOPT_CAINFO 700 CA cert bundle. See CURLOPT_CAINFO(3) 701 702 CURLOPT_ISSUERCERT 703 Issuer certificate. See CURLOPT_ISSUERCERT(3) 704 705 CURLOPT_CAPATH 706 Path to CA cert bundle. See CURLOPT_CAPATH(3) 707 708 CURLOPT_CRLFILE 709 Certificate Revocation List. See CURLOPT_CRLFILE(3) 710 711 CURLOPT_CERTINFO 712 Extract certificate info. See CURLOPT_CERTINFO(3) 713 714 CURLOPT_PINNEDPUBLICKEY 715 Set pinned SSL public key . See CURLOPT_PINNEDPUBLICKEY(3) 716 717 CURLOPT_RANDOM_FILE 718 Provide source for entropy random data. See CURLOPT_RAN‐ 719 DOM_FILE(3) 720 721 CURLOPT_EGDSOCKET 722 Identify EGD socket for entropy. See CURLOPT_EGDSOCKET(3) 723 724 CURLOPT_SSL_CIPHER_LIST 725 Ciphers to use. See CURLOPT_SSL_CIPHER_LIST(3) 726 727 CURLOPT_SSL_SESSIONID_CACHE 728 Disable SSL session-id cache. See CURLOPT_SSL_SESSIONID_CACHE(3) 729 730 CURLOPT_SSL_OPTIONS 731 Control SSL behavior. See CURLOPT_SSL_OPTIONS(3) 732 733 CURLOPT_KRBLEVEL 734 Kerberos security level. See CURLOPT_KRBLEVEL(3) 735 736 CURLOPT_GSSAPI_DELEGATION 737 Disable GSS-API delegation. See CURLOPT_GSSAPI_DELEGATION(3) 738 739 SSH OPTIONS 740 CURLOPT_SSH_AUTH_TYPES 741 SSH authentication types. See CURLOPT_SSH_AUTH_TYPES(3) 742 743 CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 744 MD5 of host's public key. See CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3) 745 746 CURLOPT_SSH_PUBLIC_KEYFILE 747 File name of public key. See CURLOPT_SSH_PUBLIC_KEYFILE(3) 748 749 CURLOPT_SSH_PRIVATE_KEYFILE 750 File name of private key. See CURLOPT_SSH_PRIVATE_KEYFILE(3) 751 752 CURLOPT_SSH_KNOWNHOSTS 753 File name with known hosts. See CURLOPT_SSH_KNOWNHOSTS(3) 754 755 CURLOPT_SSH_KEYFUNCTION 756 Callback for known hosts handling. See CURLOPT_SSH_KEYFUNC‐ 757 TION(3) 758 759 CURLOPT_SSH_KEYDATA 760 Custom pointer to pass to ssh key callback. See CURLOPT_SSH_KEY‐ 761 DATA(3) 762 763 OTHER OPTIONS 764 CURLOPT_PRIVATE 765 Private pointer to store. See CURLOPT_PRIVATE(3) 766 767 CURLOPT_SHARE 768 Share object to use. See CURLOPT_SHARE(3) 769 770 CURLOPT_NEW_FILE_PERMS 771 Mode for creating new remote files. See CUR‐ 772 LOPT_NEW_FILE_PERMS(3) 773 774 CURLOPT_NEW_DIRECTORY_PERMS 775 Mode for creating new remote directories. See CURLOPT_NEW_DIREC‐ 776 TORY_PERMS(3) 777 778 TELNET OPTIONS 779 CURLOPT_TELNETOPTIONS 780 TELNET options. See CURLOPT_TELNETOPTIONS(3) 781 782 RETURN VALUE 783 CURLE_OK (zero) means that the option was set properly, non-zero means 784 an error occurred as <curl/curl.h> defines. See the libcurl-errors(3) 785 man page for the full list with descriptions. 786 787 If you try to set an option that libcurl doesn't know about, perhaps 788 because the library is too old to support it or the option was removed 789 in a recent version, this function will return CURLE_UNKNOWN_OPTION. If 790 support for the option was disabled at compile-time, it will return 791 CURLE_NOT_BUILT_IN. 792 793 EXAMPLE 794 CURL *curl = curl_easy_init(); 795 if(curl) { 796 CURLcode res; 797 curl_easy_setopt(curl, CURLOPT_URL, "http://example.com"); 798 res = curl_easy_perform(curl); 799 curl_easy_cleanup(curl); 800 } 801 802 SEE ALSO 803 curl_easy_init(3), curl_easy_cleanup(3), curl_easy_reset(3), 804 curl_easy_getinfo(3), curl_multi_setopt(3), 805 806 libcurl 7.38.0 25 Jun 2014 curl_easy_setopt(3)