中文翻译：
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)