curl_easy_setopt.md (30979B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: curl_easy_setopt 5 Section: 3 6 Source: libcurl 7 See-also: 8 - curl_easy_cleanup (3) 9 - curl_easy_getinfo (3) 10 - curl_easy_init (3) 11 - curl_easy_option_by_id (3) 12 - curl_easy_option_by_name (3) 13 - curl_easy_option_next (3) 14 - curl_easy_reset (3) 15 - curl_multi_setopt (3) 16 Protocol: 17 - All 18 Added-in: 7.1 19 --- 20 21 # NAME 22 23 curl_easy_setopt - set options for a curl easy handle 24 25 # SYNOPSIS 26 27 ~~~c 28 #include <curl/curl.h> 29 30 CURLcode curl_easy_setopt(CURL *handle, CURLoption option, parameter); 31 ~~~ 32 33 # DESCRIPTION 34 35 curl_easy_setopt(3) is used to tell libcurl how to behave. By setting the 36 appropriate options, the application can change libcurl's behavior. All 37 options are set with an *option* followed by a *parameter*. That parameter can 38 be a **long**, a **function pointer**, an **object pointer** or a 39 **curl_off_t**, depending on what the specific option expects. Read this 40 manual carefully as bad input values may cause libcurl to behave badly. You 41 can only set one option in each function call. A typical application uses many 42 curl_easy_setopt(3) calls in the setup phase. 43 44 The *handle* argument is the return code from a curl_easy_init(3) or 45 curl_easy_duphandle(3) call. 46 47 Options set with this function call are sticky. They remain set for all 48 forthcoming transfers performed using this *handle*. The options are not in 49 any way reset between transfers, so if you want subsequent transfers with 50 different options, you must change them between the transfers. You can 51 optionally reset all options back to internal default with curl_easy_reset(3). 52 53 The order in which the options are set does not matter. 54 55 # STRINGS 56 57 Strings passed to libcurl as 'char *' arguments, are copied by the library; 58 the string storage associated to the pointer argument may be discarded or 59 reused after curl_easy_setopt(3) returns. The only exception to this rule is 60 really CURLOPT_POSTFIELDS(3), but the alternative that copies the string 61 CURLOPT_COPYPOSTFIELDS(3) has some usage characteristics you need to read up 62 on. 63 64 This function does not accept input strings longer than 65 **CURL_MAX_INPUT_LENGTH** (8 MB). 66 67 libcurl does little to no verification of the contents of provided strings. 68 Passing in "creative octets" like newlines where they are not expected might 69 trigger unexpected results. 70 71 Before version 7.17.0, strings were not copied. Instead the user was forced 72 keep them available until libcurl no longer needed them. 73 74 # OPTIONS 75 76 ## CURLOPT_ABSTRACT_UNIX_SOCKET 77 78 Path to an abstract Unix domain socket. See CURLOPT_ABSTRACT_UNIX_SOCKET(3) 79 80 ## CURLOPT_ACCEPTTIMEOUT_MS 81 82 Timeout for waiting for the server's connect back to be accepted. See 83 CURLOPT_ACCEPTTIMEOUT_MS(3) 84 85 ## CURLOPT_ACCEPT_ENCODING 86 87 Accept-Encoding and automatic decompressing data. See 88 CURLOPT_ACCEPT_ENCODING(3) 89 90 ## CURLOPT_ADDRESS_SCOPE 91 92 IPv6 scope for local addresses. See CURLOPT_ADDRESS_SCOPE(3) 93 94 ## CURLOPT_ALTSVC 95 96 Specify the Alt-Svc: cache filename. See CURLOPT_ALTSVC(3) 97 98 ## CURLOPT_ALTSVC_CTRL 99 100 Enable and configure Alt-Svc: treatment. See CURLOPT_ALTSVC_CTRL(3) 101 102 ## CURLOPT_APPEND 103 104 Append to remote file. See CURLOPT_APPEND(3) 105 106 ## CURLOPT_AUTOREFERER 107 108 Automatically set Referer: header. See CURLOPT_AUTOREFERER(3) 109 110 ## CURLOPT_AWS_SIGV4 111 112 AWS HTTP V4 Signature. See CURLOPT_AWS_SIGV4(3) 113 114 ## CURLOPT_BUFFERSIZE 115 116 Ask for alternate buffer size. See CURLOPT_BUFFERSIZE(3) 117 118 ## CURLOPT_CAINFO 119 120 CA cert bundle. See CURLOPT_CAINFO(3) 121 122 ## CURLOPT_CAINFO_BLOB 123 124 CA cert bundle memory buffer. See CURLOPT_CAINFO_BLOB(3) 125 126 ## CURLOPT_CAPATH 127 128 Path to CA cert bundle. See CURLOPT_CAPATH(3) 129 130 ## CURLOPT_CA_CACHE_TIMEOUT 131 132 Timeout for CA cache. See CURLOPT_CA_CACHE_TIMEOUT(3) 133 134 ## CURLOPT_CERTINFO 135 136 Extract certificate info. See CURLOPT_CERTINFO(3) 137 138 ## CURLOPT_CHUNK_BGN_FUNCTION 139 140 Callback for wildcard download start of chunk. See 141 CURLOPT_CHUNK_BGN_FUNCTION(3) 142 143 ## CURLOPT_CHUNK_DATA 144 145 Data pointer to pass to the chunk callbacks. See CURLOPT_CHUNK_DATA(3) 146 147 ## CURLOPT_CHUNK_END_FUNCTION 148 149 Callback for wildcard download end of chunk. See CURLOPT_CHUNK_END_FUNCTION(3) 150 151 ## CURLOPT_CLOSESOCKETDATA 152 153 Data pointer to pass to the close socket callback. See 154 CURLOPT_CLOSESOCKETDATA(3) 155 156 ## CURLOPT_CLOSESOCKETFUNCTION 157 158 Callback for closing socket. See CURLOPT_CLOSESOCKETFUNCTION(3) 159 160 ## CURLOPT_CONNECTTIMEOUT 161 162 Timeout for the connection phase. See CURLOPT_CONNECTTIMEOUT(3) 163 164 ## CURLOPT_CONNECTTIMEOUT_MS 165 166 Millisecond timeout for the connection phase. See CURLOPT_CONNECTTIMEOUT_MS(3) 167 168 ## CURLOPT_CONNECT_ONLY 169 170 Only connect, nothing else. See CURLOPT_CONNECT_ONLY(3) 171 172 ## CURLOPT_CONNECT_TO 173 174 Connect to a specific host and port. See CURLOPT_CONNECT_TO(3) 175 176 ## CURLOPT_CONV_FROM_NETWORK_FUNCTION 177 178 **OBSOLETE** Callback for code base conversion. 179 See CURLOPT_CONV_FROM_NETWORK_FUNCTION(3) 180 181 ## CURLOPT_CONV_FROM_UTF8_FUNCTION 182 183 **OBSOLETE** Callback for code base conversion. 184 See CURLOPT_CONV_FROM_UTF8_FUNCTION(3) 185 186 ## CURLOPT_CONV_TO_NETWORK_FUNCTION 187 188 **OBSOLETE** Callback for code base conversion. 189 See CURLOPT_CONV_TO_NETWORK_FUNCTION(3) 190 191 ## CURLOPT_COOKIE 192 193 Cookie(s) to send. See CURLOPT_COOKIE(3) 194 195 ## CURLOPT_COOKIEFILE 196 197 File to read cookies from. See CURLOPT_COOKIEFILE(3) 198 199 ## CURLOPT_COOKIEJAR 200 201 File to write cookies to. See CURLOPT_COOKIEJAR(3) 202 203 ## CURLOPT_COOKIELIST 204 205 Add or control cookies. See CURLOPT_COOKIELIST(3) 206 207 ## CURLOPT_COOKIESESSION 208 209 Start a new cookie session. See CURLOPT_COOKIESESSION(3) 210 211 ## CURLOPT_COPYPOSTFIELDS 212 213 Send a POST with this data - and copy it. See CURLOPT_COPYPOSTFIELDS(3) 214 215 ## CURLOPT_CRLF 216 217 Convert newlines. See CURLOPT_CRLF(3) 218 219 ## CURLOPT_CRLFILE 220 221 Certificate Revocation List. See CURLOPT_CRLFILE(3) 222 223 ## CURLOPT_CURLU 224 225 Set URL to work on with a URL handle. See CURLOPT_CURLU(3) 226 227 ## CURLOPT_CUSTOMREQUEST 228 229 Custom request/method. See CURLOPT_CUSTOMREQUEST(3) 230 231 ## CURLOPT_DEBUGDATA 232 233 Data pointer to pass to the debug callback. See CURLOPT_DEBUGDATA(3) 234 235 ## CURLOPT_DEBUGFUNCTION 236 237 Callback for debug information. See CURLOPT_DEBUGFUNCTION(3) 238 239 ## CURLOPT_DEFAULT_PROTOCOL 240 241 Default protocol. See CURLOPT_DEFAULT_PROTOCOL(3) 242 243 ## CURLOPT_DIRLISTONLY 244 245 List only. See CURLOPT_DIRLISTONLY(3) 246 247 ## CURLOPT_DISALLOW_USERNAME_IN_URL 248 249 Do not allow username in URL. See CURLOPT_DISALLOW_USERNAME_IN_URL(3) 250 251 ## CURLOPT_DNS_CACHE_TIMEOUT 252 253 Timeout for DNS cache. See CURLOPT_DNS_CACHE_TIMEOUT(3) 254 255 ## CURLOPT_DNS_INTERFACE 256 257 Bind name resolves to this interface. See CURLOPT_DNS_INTERFACE(3) 258 259 ## CURLOPT_DNS_LOCAL_IP4 260 261 Bind name resolves to this IP4 address. See CURLOPT_DNS_LOCAL_IP4(3) 262 263 ## CURLOPT_DNS_LOCAL_IP6 264 265 Bind name resolves to this IP6 address. See CURLOPT_DNS_LOCAL_IP6(3) 266 267 ## CURLOPT_DNS_SERVERS 268 269 Preferred DNS servers. See CURLOPT_DNS_SERVERS(3) 270 271 ## CURLOPT_DNS_SHUFFLE_ADDRESSES 272 273 Shuffle addresses before use. See CURLOPT_DNS_SHUFFLE_ADDRESSES(3) 274 275 ## CURLOPT_DNS_USE_GLOBAL_CACHE 276 277 **OBSOLETE** Enable global DNS cache. See CURLOPT_DNS_USE_GLOBAL_CACHE(3) 278 279 ## CURLOPT_DOH_SSL_VERIFYHOST 280 281 Verify the hostname in the DoH (DNS-over-HTTPS) SSL certificate. See 282 CURLOPT_DOH_SSL_VERIFYHOST(3) 283 284 ## CURLOPT_DOH_SSL_VERIFYPEER 285 286 Verify the DoH (DNS-over-HTTPS) SSL certificate. See 287 CURLOPT_DOH_SSL_VERIFYPEER(3) 288 289 ## CURLOPT_DOH_SSL_VERIFYSTATUS 290 291 Verify the DoH (DNS-over-HTTPS) SSL certificate's status. See 292 CURLOPT_DOH_SSL_VERIFYSTATUS(3) 293 294 ## CURLOPT_DOH_URL 295 296 Use this DoH server for name resolves. See CURLOPT_DOH_URL(3) 297 298 ## CURLOPT_ECH 299 300 Set the configuration for ECH. See CURLOPT_ECH(3) 301 302 ## CURLOPT_EGDSOCKET 303 304 **OBSOLETE** Identify EGD socket for entropy. See CURLOPT_EGDSOCKET(3) 305 306 ## CURLOPT_ERRORBUFFER 307 308 Error message buffer. See CURLOPT_ERRORBUFFER(3) 309 310 ## CURLOPT_EXPECT_100_TIMEOUT_MS 311 312 100-continue timeout. See CURLOPT_EXPECT_100_TIMEOUT_MS(3) 313 314 ## CURLOPT_FAILONERROR 315 316 Fail on HTTP 4xx errors. CURLOPT_FAILONERROR(3) 317 318 ## CURLOPT_FILETIME 319 320 Request file modification date and time. See CURLOPT_FILETIME(3) 321 322 ## CURLOPT_FNMATCH_DATA 323 324 Data pointer to pass to the wildcard matching callback. See 325 CURLOPT_FNMATCH_DATA(3) 326 327 ## CURLOPT_FNMATCH_FUNCTION 328 329 Callback for wildcard matching. See CURLOPT_FNMATCH_FUNCTION(3) 330 331 ## CURLOPT_FOLLOWLOCATION 332 333 Follow HTTP redirects. See CURLOPT_FOLLOWLOCATION(3) 334 335 ## CURLOPT_FORBID_REUSE 336 337 Prevent subsequent connections from reusing this. See CURLOPT_FORBID_REUSE(3) 338 339 ## CURLOPT_FRESH_CONNECT 340 341 Use a new connection. CURLOPT_FRESH_CONNECT(3) 342 343 ## CURLOPT_FTPPORT 344 345 Use active FTP. See CURLOPT_FTPPORT(3) 346 347 ## CURLOPT_FTPSSLAUTH 348 349 Control how to do TLS. See CURLOPT_FTPSSLAUTH(3) 350 351 ## CURLOPT_FTP_ACCOUNT 352 353 Send ACCT command. See CURLOPT_FTP_ACCOUNT(3) 354 355 ## CURLOPT_FTP_ALTERNATIVE_TO_USER 356 357 Alternative to USER. See CURLOPT_FTP_ALTERNATIVE_TO_USER(3) 358 359 ## CURLOPT_FTP_CREATE_MISSING_DIRS 360 361 Create missing directories on the remote server. See 362 CURLOPT_FTP_CREATE_MISSING_DIRS(3) 363 364 ## CURLOPT_FTP_FILEMETHOD 365 366 Specify how to reach files. See CURLOPT_FTP_FILEMETHOD(3) 367 368 ## CURLOPT_FTP_SKIP_PASV_IP 369 370 Ignore the IP address in the PASV response. See CURLOPT_FTP_SKIP_PASV_IP(3) 371 372 ## CURLOPT_FTP_SSL_CCC 373 374 Back to non-TLS again after authentication. See CURLOPT_FTP_SSL_CCC(3) 375 376 ## CURLOPT_FTP_USE_EPRT 377 378 Use EPRT. See CURLOPT_FTP_USE_EPRT(3) 379 380 ## CURLOPT_FTP_USE_EPSV 381 382 Use EPSV. See CURLOPT_FTP_USE_EPSV(3) 383 384 ## CURLOPT_FTP_USE_PRET 385 386 Use PRET. See CURLOPT_FTP_USE_PRET(3) 387 388 ## CURLOPT_GSSAPI_DELEGATION 389 390 Disable GSS-API delegation. See CURLOPT_GSSAPI_DELEGATION(3) 391 392 ## CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS 393 394 Timeout for happy eyeballs. See CURLOPT_HAPPY_EYEBALLS_TIMEOUT_MS(3) 395 396 ## CURLOPT_HAPROXYPROTOCOL 397 398 Send an HAProxy PROXY protocol v1 header. See CURLOPT_HAPROXYPROTOCOL(3) 399 400 ## CURLOPT_HAPROXY_CLIENT_IP 401 402 Spoof the client IP in an HAProxy PROXY protocol v1 header. See 403 CURLOPT_HAPROXY_CLIENT_IP(3) 404 405 ## CURLOPT_HEADER 406 407 Include the header in the body output. See CURLOPT_HEADER(3) 408 409 ## CURLOPT_HEADERDATA 410 411 Data pointer to pass to the header callback. See CURLOPT_HEADERDATA(3) 412 413 ## CURLOPT_HEADERFUNCTION 414 415 Callback for writing received headers. See CURLOPT_HEADERFUNCTION(3) 416 417 ## CURLOPT_HEADEROPT 418 419 Control custom headers. See CURLOPT_HEADEROPT(3) 420 421 ## CURLOPT_HSTS 422 423 Set HSTS cache file. See CURLOPT_HSTS(3) 424 425 ## CURLOPT_HSTSREADDATA 426 427 Pass pointer to the HSTS read callback. See CURLOPT_HSTSREADDATA(3) 428 429 ## CURLOPT_HSTSREADFUNCTION 430 431 Set HSTS read callback. See CURLOPT_HSTSREADFUNCTION(3) 432 433 ## CURLOPT_HSTSWRITEDATA 434 435 Pass pointer to the HSTS write callback. See CURLOPT_HSTSWRITEDATA(3) 436 437 ## CURLOPT_HSTSWRITEFUNCTION 438 439 Set HSTS write callback. See CURLOPT_HSTSWRITEFUNCTION(3) 440 441 ## CURLOPT_HSTS_CTRL 442 443 Enable HSTS. See CURLOPT_HSTS_CTRL(3) 444 445 ## CURLOPT_HTTP09_ALLOWED 446 447 Allow HTTP/0.9 responses. CURLOPT_HTTP09_ALLOWED(3) 448 449 ## CURLOPT_HTTP200ALIASES 450 451 Alternative versions of 200 OK. See CURLOPT_HTTP200ALIASES(3) 452 453 ## CURLOPT_HTTPAUTH 454 455 HTTP server authentication methods. See CURLOPT_HTTPAUTH(3) 456 457 ## CURLOPT_HTTPGET 458 459 Do an HTTP GET request. See CURLOPT_HTTPGET(3) 460 461 ## CURLOPT_HTTPHEADER 462 463 Custom HTTP headers. See CURLOPT_HTTPHEADER(3) 464 465 ## CURLOPT_HTTPPOST 466 467 **Deprecated option** Multipart formpost HTTP POST. 468 See CURLOPT_HTTPPOST(3) 469 470 ## CURLOPT_HTTPPROXYTUNNEL 471 472 Tunnel through the HTTP proxy. CURLOPT_HTTPPROXYTUNNEL(3) 473 474 ## CURLOPT_HTTP_CONTENT_DECODING 475 476 Disable Content decoding. See CURLOPT_HTTP_CONTENT_DECODING(3) 477 478 ## CURLOPT_HTTP_TRANSFER_DECODING 479 480 Disable Transfer decoding. See CURLOPT_HTTP_TRANSFER_DECODING(3) 481 482 ## CURLOPT_HTTP_VERSION 483 484 HTTP version to use. CURLOPT_HTTP_VERSION(3) 485 486 ## CURLOPT_IGNORE_CONTENT_LENGTH 487 488 Ignore Content-Length. See CURLOPT_IGNORE_CONTENT_LENGTH(3) 489 490 ## CURLOPT_INFILESIZE 491 492 Size of file to send. CURLOPT_INFILESIZE(3) 493 494 ## CURLOPT_INFILESIZE_LARGE 495 496 Size of file to send. CURLOPT_INFILESIZE_LARGE(3) 497 498 ## CURLOPT_INTERFACE 499 500 Bind connection locally to this. See CURLOPT_INTERFACE(3) 501 502 ## CURLOPT_INTERLEAVEDATA 503 504 Data pointer to pass to the RTSP interleave callback. See 505 CURLOPT_INTERLEAVEDATA(3) 506 507 ## CURLOPT_INTERLEAVEFUNCTION 508 509 Callback for RTSP interleaved data. See CURLOPT_INTERLEAVEFUNCTION(3) 510 511 ## CURLOPT_IOCTLDATA 512 513 **Deprecated option** Data pointer to pass to the I/O callback. 514 See CURLOPT_IOCTLDATA(3) 515 516 ## CURLOPT_IOCTLFUNCTION 517 518 **Deprecated option** Callback for I/O operations. 519 See CURLOPT_IOCTLFUNCTION(3) 520 521 ## CURLOPT_IPRESOLVE 522 523 IP version to use. See CURLOPT_IPRESOLVE(3) 524 525 ## CURLOPT_ISSUERCERT 526 527 Issuer certificate. See CURLOPT_ISSUERCERT(3) 528 529 ## CURLOPT_ISSUERCERT_BLOB 530 531 Issuer certificate memory buffer. See CURLOPT_ISSUERCERT_BLOB(3) 532 533 ## CURLOPT_KEEP_SENDING_ON_ERROR 534 535 Keep sending on HTTP \>= 300 errors. CURLOPT_KEEP_SENDING_ON_ERROR(3) 536 537 ## CURLOPT_KEYPASSWD 538 539 Client key password. See CURLOPT_KEYPASSWD(3) 540 541 ## CURLOPT_KRBLEVEL 542 543 Kerberos security level. See CURLOPT_KRBLEVEL(3) 544 545 ## CURLOPT_LOCALPORT 546 547 Bind connection locally to this port. See CURLOPT_LOCALPORT(3) 548 549 ## CURLOPT_LOCALPORTRANGE 550 551 Bind connection locally to port range. See CURLOPT_LOCALPORTRANGE(3) 552 553 ## CURLOPT_LOGIN_OPTIONS 554 555 Login options. See CURLOPT_LOGIN_OPTIONS(3) 556 557 ## CURLOPT_LOW_SPEED_LIMIT 558 559 Low speed limit to abort transfer. See CURLOPT_LOW_SPEED_LIMIT(3) 560 561 ## CURLOPT_LOW_SPEED_TIME 562 563 Time to be below the speed to trigger low speed abort. See 564 CURLOPT_LOW_SPEED_TIME(3) 565 566 ## CURLOPT_MAIL_AUTH 567 568 Authentication address. See CURLOPT_MAIL_AUTH(3) 569 570 ## CURLOPT_MAIL_FROM 571 572 Address of the sender. See CURLOPT_MAIL_FROM(3) 573 574 ## CURLOPT_MAIL_RCPT 575 576 Address of the recipients. See CURLOPT_MAIL_RCPT(3) 577 578 ## CURLOPT_MAIL_RCPT_ALLOWFAILS 579 580 Allow RCPT TO command to fail for some recipients. See 581 CURLOPT_MAIL_RCPT_ALLOWFAILS(3) 582 583 ## CURLOPT_MAXAGE_CONN 584 585 Limit the age (idle time) of connections for reuse. See CURLOPT_MAXAGE_CONN(3) 586 587 ## CURLOPT_MAXCONNECTS 588 589 Maximum number of connections in the connection pool. See 590 CURLOPT_MAXCONNECTS(3) 591 592 ## CURLOPT_MAXFILESIZE 593 594 Maximum file size to get. See CURLOPT_MAXFILESIZE(3) 595 596 ## CURLOPT_MAXFILESIZE_LARGE 597 598 Maximum file size to get. See CURLOPT_MAXFILESIZE_LARGE(3) 599 600 ## CURLOPT_MAXLIFETIME_CONN 601 602 Limit the age (since creation) of connections for reuse. See 603 CURLOPT_MAXLIFETIME_CONN(3) 604 605 ## CURLOPT_MAXREDIRS 606 607 Maximum number of redirects to follow. See CURLOPT_MAXREDIRS(3) 608 609 ## CURLOPT_MAX_RECV_SPEED_LARGE 610 611 Cap the download speed to this. See CURLOPT_MAX_RECV_SPEED_LARGE(3) 612 613 ## CURLOPT_MAX_SEND_SPEED_LARGE 614 615 Cap the upload speed to this. See CURLOPT_MAX_SEND_SPEED_LARGE(3) 616 617 ## CURLOPT_MIMEPOST 618 619 Post/send MIME data. See CURLOPT_MIMEPOST(3) 620 621 ## CURLOPT_MIME_OPTIONS 622 623 Set MIME option flags. See CURLOPT_MIME_OPTIONS(3) 624 625 ## CURLOPT_NETRC 626 627 Enable .netrc parsing. See CURLOPT_NETRC(3) 628 629 ## CURLOPT_NETRC_FILE 630 631 .netrc filename. See CURLOPT_NETRC_FILE(3) 632 633 ## CURLOPT_NEW_DIRECTORY_PERMS 634 635 Mode for creating new remote directories. See CURLOPT_NEW_DIRECTORY_PERMS(3) 636 637 ## CURLOPT_NEW_FILE_PERMS 638 639 Mode for creating new remote files. See CURLOPT_NEW_FILE_PERMS(3) 640 641 ## CURLOPT_NOBODY 642 643 Do not get the body contents. See CURLOPT_NOBODY(3) 644 645 ## CURLOPT_NOPROGRESS 646 647 Shut off the progress meter. See CURLOPT_NOPROGRESS(3) 648 649 ## CURLOPT_NOPROXY 650 651 Filter out hosts from proxy use. CURLOPT_NOPROXY(3) 652 653 ## CURLOPT_NOSIGNAL 654 655 Do not install signal handlers. See CURLOPT_NOSIGNAL(3) 656 657 ## CURLOPT_OPENSOCKETDATA 658 659 Data pointer to pass to the open socket callback. See CURLOPT_OPENSOCKETDATA(3) 660 661 ## CURLOPT_OPENSOCKETFUNCTION 662 663 Callback for socket creation. See CURLOPT_OPENSOCKETFUNCTION(3) 664 665 ## CURLOPT_PASSWORD 666 667 Password. See CURLOPT_PASSWORD(3) 668 669 ## CURLOPT_PATH_AS_IS 670 671 Disable squashing /../ and /./ sequences in the path. See CURLOPT_PATH_AS_IS(3) 672 673 ## CURLOPT_PINNEDPUBLICKEY 674 675 Set pinned SSL public key . See CURLOPT_PINNEDPUBLICKEY(3) 676 677 ## CURLOPT_PIPEWAIT 678 679 Wait on connection to pipeline on it. See CURLOPT_PIPEWAIT(3) 680 681 ## CURLOPT_PORT 682 683 Port number to connect to. See CURLOPT_PORT(3) 684 685 ## CURLOPT_POST 686 687 Make an HTTP POST. See CURLOPT_POST(3) 688 689 ## CURLOPT_POSTFIELDSIZE 690 691 The POST data is this big. See CURLOPT_POSTFIELDSIZE(3) 692 693 ## CURLOPT_POSTFIELDSIZE_LARGE 694 695 The POST data is this big. See CURLOPT_POSTFIELDSIZE_LARGE(3) 696 697 ## CURLOPT_POSTQUOTE 698 699 Commands to run after transfer. See CURLOPT_POSTQUOTE(3) 700 701 ## CURLOPT_POSTREDIR 702 703 How to act on redirects after POST. See CURLOPT_POSTREDIR(3) 704 705 ## CURLOPT_PREQUOTE 706 707 Commands to run just before transfer. See CURLOPT_PREQUOTE(3) 708 709 ## CURLOPT_PREREQDATA 710 711 Data pointer to pass to the CURLOPT_PREREQFUNCTION callback. See 712 CURLOPT_PREREQDATA(3) 713 714 ## CURLOPT_PREREQFUNCTION 715 716 Callback to be called after a connection is established but before a request 717 is made on that connection. See CURLOPT_PREREQFUNCTION(3) 718 719 ## CURLOPT_PRE_PROXY 720 721 Socks proxy to use. See CURLOPT_PRE_PROXY(3) 722 723 ## CURLOPT_PRIVATE 724 725 Private pointer to store. See CURLOPT_PRIVATE(3) 726 727 ## CURLOPT_PROGRESSDATA 728 729 Data pointer to pass to the progress meter callback. See 730 CURLOPT_PROGRESSDATA(3) 731 732 ## CURLOPT_PROGRESSFUNCTION 733 734 **OBSOLETE** callback for progress meter. See CURLOPT_PROGRESSFUNCTION(3) 735 736 ## CURLOPT_PROTOCOLS 737 738 **Deprecated option** Allowed protocols. See CURLOPT_PROTOCOLS(3) 739 740 ## CURLOPT_PROTOCOLS_STR 741 742 Allowed protocols. See CURLOPT_PROTOCOLS_STR(3) 743 744 ## CURLOPT_PROXY 745 746 Proxy to use. See CURLOPT_PROXY(3) 747 748 ## CURLOPT_PROXYAUTH 749 750 HTTP proxy authentication methods. See CURLOPT_PROXYAUTH(3) 751 752 ## CURLOPT_PROXYHEADER 753 754 Custom HTTP headers sent to proxy. See CURLOPT_PROXYHEADER(3) 755 756 ## CURLOPT_PROXYPASSWORD 757 758 Proxy password. See CURLOPT_PROXYPASSWORD(3) 759 760 ## CURLOPT_PROXYPORT 761 762 Proxy port to use. See CURLOPT_PROXYPORT(3) 763 764 ## CURLOPT_PROXYTYPE 765 766 Proxy type. See CURLOPT_PROXYTYPE(3) 767 768 ## CURLOPT_PROXYUSERNAME 769 Proxy username. See CURLOPT_PROXYUSERNAME(3) 770 771 ## CURLOPT_PROXYUSERPWD 772 773 Proxy username and password. See CURLOPT_PROXYUSERPWD(3) 774 775 ## CURLOPT_PROXY_CAINFO 776 777 Proxy CA cert bundle. See CURLOPT_PROXY_CAINFO(3) 778 779 ## CURLOPT_PROXY_CAINFO_BLOB 780 781 Proxy CA cert bundle memory buffer. See CURLOPT_PROXY_CAINFO_BLOB(3) 782 783 ## CURLOPT_PROXY_CAPATH 784 785 Path to proxy CA cert bundle. See CURLOPT_PROXY_CAPATH(3) 786 787 ## CURLOPT_PROXY_CRLFILE 788 789 Proxy Certificate Revocation List. See CURLOPT_PROXY_CRLFILE(3) 790 791 ## CURLOPT_PROXY_ISSUERCERT 792 793 Proxy issuer certificate. See CURLOPT_PROXY_ISSUERCERT(3) 794 795 ## CURLOPT_PROXY_ISSUERCERT_BLOB 796 797 Proxy issuer certificate memory buffer. See CURLOPT_PROXY_ISSUERCERT_BLOB(3) 798 799 ## CURLOPT_PROXY_KEYPASSWD 800 801 Proxy client key password. See CURLOPT_PROXY_KEYPASSWD(3) 802 803 ## CURLOPT_PROXY_PINNEDPUBLICKEY 804 805 Set the proxy's pinned SSL public key. See 806 CURLOPT_PROXY_PINNEDPUBLICKEY(3) 807 808 ## CURLOPT_PROXY_SERVICE_NAME 809 810 Proxy authentication service name. CURLOPT_PROXY_SERVICE_NAME(3) 811 812 ## CURLOPT_PROXY_SSLCERT 813 814 Proxy client cert. See CURLOPT_PROXY_SSLCERT(3) 815 816 ## CURLOPT_PROXY_SSLCERTTYPE 817 818 Proxy client cert type. See CURLOPT_PROXY_SSLCERTTYPE(3) 819 820 ## CURLOPT_PROXY_SSLCERT_BLOB 821 822 Proxy client cert memory buffer. See CURLOPT_PROXY_SSLCERT_BLOB(3) 823 824 ## CURLOPT_PROXY_SSLKEY 825 826 Proxy client key. See CURLOPT_PROXY_SSLKEY(3) 827 828 ## CURLOPT_PROXY_SSLKEYTYPE 829 830 Proxy client key type. See CURLOPT_PROXY_SSLKEYTYPE(3) 831 832 ## CURLOPT_PROXY_SSLKEY_BLOB 833 834 Proxy client key. See CURLOPT_PROXY_SSLKEY_BLOB(3) 835 836 ## CURLOPT_PROXY_SSLVERSION 837 838 Proxy SSL version to use. See CURLOPT_PROXY_SSLVERSION(3) 839 840 ## CURLOPT_PROXY_SSL_CIPHER_LIST 841 842 Proxy ciphers to use. See CURLOPT_PROXY_SSL_CIPHER_LIST(3) 843 844 ## CURLOPT_PROXY_SSL_OPTIONS 845 846 Control proxy SSL behavior. See CURLOPT_PROXY_SSL_OPTIONS(3) 847 848 ## CURLOPT_PROXY_SSL_VERIFYHOST 849 850 Verify the hostname in the proxy SSL certificate. See 851 CURLOPT_PROXY_SSL_VERIFYHOST(3) 852 853 ## CURLOPT_PROXY_SSL_VERIFYPEER 854 855 Verify the proxy SSL certificate. See CURLOPT_PROXY_SSL_VERIFYPEER(3) 856 857 ## CURLOPT_PROXY_TLS13_CIPHERS 858 859 Proxy TLS 1.3 cipher suites to use. See CURLOPT_PROXY_TLS13_CIPHERS(3) 860 861 ## CURLOPT_PROXY_TLSAUTH_PASSWORD 862 863 Proxy TLS authentication password. See CURLOPT_PROXY_TLSAUTH_PASSWORD(3) 864 865 ## CURLOPT_PROXY_TLSAUTH_TYPE 866 867 Proxy TLS authentication methods. See CURLOPT_PROXY_TLSAUTH_TYPE(3) 868 869 ## CURLOPT_PROXY_TLSAUTH_USERNAME 870 871 Proxy TLS authentication username. See CURLOPT_PROXY_TLSAUTH_USERNAME(3) 872 873 ## CURLOPT_PROXY_TRANSFER_MODE 874 875 Add transfer mode to URL over proxy. See CURLOPT_PROXY_TRANSFER_MODE(3) 876 877 ## CURLOPT_PUT 878 879 **Deprecated option** Issue an HTTP PUT request. See CURLOPT_PUT(3) 880 881 ## CURLOPT_QUICK_EXIT 882 883 To be set by toplevel tools like "curl" to skip lengthy cleanups when they are 884 about to call exit() anyway. See CURLOPT_QUICK_EXIT(3) 885 886 ## CURLOPT_QUOTE 887 888 Commands to run before transfer. See CURLOPT_QUOTE(3) 889 890 ## CURLOPT_RANDOM_FILE 891 892 **OBSOLETE** Provide source for entropy random data. 893 See CURLOPT_RANDOM_FILE(3) 894 895 ## CURLOPT_RANGE 896 897 Range requests. See CURLOPT_RANGE(3) 898 899 ## CURLOPT_READDATA 900 901 Data pointer to pass to the read callback. See CURLOPT_READDATA(3) 902 903 ## CURLOPT_READFUNCTION 904 905 Callback for reading data. See CURLOPT_READFUNCTION(3) 906 907 ## CURLOPT_REDIR_PROTOCOLS 908 909 **Deprecated option** Protocols to allow redirects to. See 910 CURLOPT_REDIR_PROTOCOLS(3) 911 912 ## CURLOPT_REDIR_PROTOCOLS_STR 913 914 Protocols to allow redirects to. See CURLOPT_REDIR_PROTOCOLS_STR(3) 915 916 ## CURLOPT_REFERER 917 918 Referer: header. See CURLOPT_REFERER(3) 919 920 ## CURLOPT_REQUEST_TARGET 921 922 Set the request target. CURLOPT_REQUEST_TARGET(3) 923 924 ## CURLOPT_RESOLVE 925 926 Provide fixed/fake name resolves. See CURLOPT_RESOLVE(3) 927 928 ## CURLOPT_RESOLVER_START_DATA 929 930 Data pointer to pass to resolver start callback. See 931 CURLOPT_RESOLVER_START_DATA(3) 932 933 ## CURLOPT_RESOLVER_START_FUNCTION 934 935 Callback to be called before a new resolve request is started. See 936 CURLOPT_RESOLVER_START_FUNCTION(3) 937 938 ## CURLOPT_RESUME_FROM 939 940 Resume a transfer. See CURLOPT_RESUME_FROM(3) 941 942 ## CURLOPT_RESUME_FROM_LARGE 943 944 Resume a transfer. See CURLOPT_RESUME_FROM_LARGE(3) 945 946 ## CURLOPT_RTSP_CLIENT_CSEQ 947 948 Client CSEQ number. See CURLOPT_RTSP_CLIENT_CSEQ(3) 949 950 ## CURLOPT_RTSP_REQUEST 951 952 RTSP request. See CURLOPT_RTSP_REQUEST(3) 953 954 ## CURLOPT_RTSP_SERVER_CSEQ 955 956 CSEQ number for RTSP Server-\>Client request. See CURLOPT_RTSP_SERVER_CSEQ(3) 957 958 ## CURLOPT_RTSP_SESSION_ID 959 960 RTSP session-id. See CURLOPT_RTSP_SESSION_ID(3) 961 962 ## CURLOPT_RTSP_STREAM_URI 963 964 RTSP stream URI. See CURLOPT_RTSP_STREAM_URI(3) 965 966 ## CURLOPT_RTSP_TRANSPORT 967 968 RTSP Transport: header. See CURLOPT_RTSP_TRANSPORT(3) 969 970 ## CURLOPT_SASL_AUTHZID 971 972 SASL authorization identity (identity to act as). See CURLOPT_SASL_AUTHZID(3) 973 974 ## CURLOPT_SASL_IR 975 976 Enable SASL initial response. See CURLOPT_SASL_IR(3) 977 978 ## CURLOPT_SEEKDATA 979 980 Data pointer to pass to the seek callback. See CURLOPT_SEEKDATA(3) 981 982 ## CURLOPT_SEEKFUNCTION 983 984 Callback for seek operations. See CURLOPT_SEEKFUNCTION(3) 985 986 ## CURLOPT_SERVER_RESPONSE_TIMEOUT 987 988 Timeout for server responses. See CURLOPT_SERVER_RESPONSE_TIMEOUT(3) 989 990 ## CURLOPT_SERVER_RESPONSE_TIMEOUT_MS 991 992 Timeout for server responses. See CURLOPT_SERVER_RESPONSE_TIMEOUT_MS(3) 993 994 ## CURLOPT_SERVICE_NAME 995 996 Authentication service name. CURLOPT_SERVICE_NAME(3) 997 998 ## CURLOPT_SHARE 999 1000 Share object to use. See CURLOPT_SHARE(3) 1001 1002 ## CURLOPT_SOCKOPTDATA 1003 1004 Data pointer to pass to the sockopt callback. See CURLOPT_SOCKOPTDATA(3) 1005 1006 ## CURLOPT_SOCKOPTFUNCTION 1007 1008 Callback for sockopt operations. See CURLOPT_SOCKOPTFUNCTION(3) 1009 1010 ## CURLOPT_SOCKS5_AUTH 1011 1012 Socks5 authentication methods. See CURLOPT_SOCKS5_AUTH(3) 1013 1014 ## CURLOPT_SOCKS5_GSSAPI_NEC 1015 1016 Socks5 GSSAPI NEC mode. See CURLOPT_SOCKS5_GSSAPI_NEC(3) 1017 1018 ## CURLOPT_SOCKS5_GSSAPI_SERVICE 1019 1020 **Deprecated option** Socks5 GSSAPI service name. 1021 See CURLOPT_SOCKS5_GSSAPI_SERVICE(3) 1022 1023 ## CURLOPT_SSH_AUTH_TYPES 1024 1025 SSH authentication types. See CURLOPT_SSH_AUTH_TYPES(3) 1026 1027 ## CURLOPT_SSH_COMPRESSION 1028 1029 Enable SSH compression. See CURLOPT_SSH_COMPRESSION(3) 1030 1031 ## CURLOPT_SSH_HOSTKEYDATA 1032 1033 Custom pointer to pass to ssh host key callback. See CURLOPT_SSH_HOSTKEYDATA(3) 1034 1035 ## CURLOPT_SSH_HOSTKEYFUNCTION 1036 1037 Callback for checking host key handling. See CURLOPT_SSH_HOSTKEYFUNCTION(3) 1038 1039 ## CURLOPT_SSH_HOST_PUBLIC_KEY_MD5 1040 1041 MD5 of host's public key. See CURLOPT_SSH_HOST_PUBLIC_KEY_MD5(3) 1042 1043 ## CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256 1044 1045 SHA256 of host's public key. See CURLOPT_SSH_HOST_PUBLIC_KEY_SHA256(3) 1046 1047 ## CURLOPT_SSH_KEYDATA 1048 1049 Custom pointer to pass to ssh key callback. See CURLOPT_SSH_KEYDATA(3) 1050 1051 ## CURLOPT_SSH_KEYFUNCTION 1052 1053 Callback for known hosts handling. See CURLOPT_SSH_KEYFUNCTION(3) 1054 1055 ## CURLOPT_SSH_KNOWNHOSTS 1056 1057 Filename with known hosts. See CURLOPT_SSH_KNOWNHOSTS(3) 1058 1059 ## CURLOPT_SSH_PRIVATE_KEYFILE 1060 1061 Filename of the private key. See CURLOPT_SSH_PRIVATE_KEYFILE(3) 1062 1063 ## CURLOPT_SSH_PUBLIC_KEYFILE 1064 1065 Filename of the public key. See CURLOPT_SSH_PUBLIC_KEYFILE(3) 1066 1067 ## CURLOPT_SSLCERT 1068 1069 Client cert. See CURLOPT_SSLCERT(3) 1070 1071 ## CURLOPT_SSLCERTTYPE 1072 1073 Client cert type. See CURLOPT_SSLCERTTYPE(3) 1074 1075 ## CURLOPT_SSLCERT_BLOB 1076 1077 Client cert memory buffer. See CURLOPT_SSLCERT_BLOB(3) 1078 1079 ## CURLOPT_SSLENGINE 1080 1081 Use identifier with SSL engine. See CURLOPT_SSLENGINE(3) 1082 1083 ## CURLOPT_SSLENGINE_DEFAULT 1084 1085 Default SSL engine. See CURLOPT_SSLENGINE_DEFAULT(3) 1086 1087 ## CURLOPT_SSLKEY 1088 1089 Client key. See CURLOPT_SSLKEY(3) 1090 1091 ## CURLOPT_SSLKEYTYPE 1092 1093 Client key type. See CURLOPT_SSLKEYTYPE(3) 1094 1095 ## CURLOPT_SSLKEY_BLOB 1096 1097 Client key memory buffer. See CURLOPT_SSLKEY_BLOB(3) 1098 1099 ## CURLOPT_SSLVERSION 1100 1101 SSL version to use. See CURLOPT_SSLVERSION(3) 1102 1103 ## CURLOPT_SSL_CIPHER_LIST 1104 1105 Ciphers to use. See CURLOPT_SSL_CIPHER_LIST(3) 1106 1107 ## CURLOPT_SSL_CTX_DATA 1108 1109 Data pointer to pass to the SSL context callback. See CURLOPT_SSL_CTX_DATA(3) 1110 1111 ## CURLOPT_SSL_CTX_FUNCTION 1112 1113 Callback for SSL context logic. See CURLOPT_SSL_CTX_FUNCTION(3) 1114 1115 ## CURLOPT_SSL_EC_CURVES 1116 1117 Set key exchange curves. See CURLOPT_SSL_EC_CURVES(3) 1118 1119 ## CURLOPT_SSL_ENABLE_ALPN 1120 1121 Enable use of ALPN. See CURLOPT_SSL_ENABLE_ALPN(3) 1122 1123 ## CURLOPT_SSL_ENABLE_NPN 1124 1125 **OBSOLETE** Enable use of NPN. See CURLOPT_SSL_ENABLE_NPN(3) 1126 1127 ## CURLOPT_SSL_FALSESTART 1128 1129 **Deprecated option** Enable TLS False Start. See CURLOPT_SSL_FALSESTART(3) 1130 1131 ## CURLOPT_SSL_OPTIONS 1132 1133 Control SSL behavior. See CURLOPT_SSL_OPTIONS(3) 1134 1135 ## CURLOPT_SSL_SESSIONID_CACHE 1136 1137 Disable SSL session-id cache. See CURLOPT_SSL_SESSIONID_CACHE(3) 1138 1139 ## CURLOPT_SSL_SIGNATURE_ALGORITHMS 1140 1141 TLS signature algorithms to use. See CURLOPT_SSL_SIGNATURE_ALGORITHMS(3) 1142 1143 ## CURLOPT_SSL_VERIFYHOST 1144 1145 Verify the hostname in the SSL certificate. See CURLOPT_SSL_VERIFYHOST(3) 1146 1147 ## CURLOPT_SSL_VERIFYPEER 1148 1149 Verify the SSL certificate. See CURLOPT_SSL_VERIFYPEER(3) 1150 1151 ## CURLOPT_SSL_VERIFYSTATUS 1152 1153 Verify the SSL certificate's status. See CURLOPT_SSL_VERIFYSTATUS(3) 1154 1155 ## CURLOPT_STDERR 1156 1157 Redirect stderr to another stream. See CURLOPT_STDERR(3) 1158 1159 ## CURLOPT_STREAM_DEPENDS 1160 1161 This HTTP/2 stream depends on another. See CURLOPT_STREAM_DEPENDS(3) 1162 1163 ## CURLOPT_STREAM_DEPENDS_E 1164 1165 This HTTP/2 stream depends on another exclusively. See 1166 CURLOPT_STREAM_DEPENDS_E(3) 1167 1168 ## CURLOPT_STREAM_WEIGHT 1169 1170 Set this HTTP/2 stream's weight. See CURLOPT_STREAM_WEIGHT(3) 1171 1172 ## CURLOPT_SUPPRESS_CONNECT_HEADERS 1173 1174 Suppress proxy CONNECT response headers from user callbacks. See 1175 CURLOPT_SUPPRESS_CONNECT_HEADERS(3) 1176 1177 ## CURLOPT_TCP_FASTOPEN 1178 1179 Enable TCP Fast Open. See CURLOPT_TCP_FASTOPEN(3) 1180 1181 ## CURLOPT_TCP_KEEPALIVE 1182 1183 Enable TCP keep-alive. See CURLOPT_TCP_KEEPALIVE(3) 1184 1185 ## CURLOPT_TCP_KEEPCNT 1186 1187 Maximum number of keep-alive probes. See CURLOPT_TCP_KEEPCNT(3) 1188 1189 ## CURLOPT_TCP_KEEPIDLE 1190 1191 Idle time before sending keep-alive. See CURLOPT_TCP_KEEPIDLE(3) 1192 1193 ## CURLOPT_TCP_KEEPINTVL 1194 1195 Interval between keep-alive probes. See CURLOPT_TCP_KEEPINTVL(3) 1196 1197 ## CURLOPT_TCP_NODELAY 1198 1199 Disable the Nagle algorithm. See CURLOPT_TCP_NODELAY(3) 1200 1201 ## CURLOPT_TELNETOPTIONS 1202 1203 TELNET options. See CURLOPT_TELNETOPTIONS(3) 1204 1205 ## CURLOPT_TFTP_BLKSIZE 1206 1207 TFTP block size. See CURLOPT_TFTP_BLKSIZE(3) 1208 1209 ## CURLOPT_TFTP_NO_OPTIONS 1210 1211 Do not send TFTP options requests. See CURLOPT_TFTP_NO_OPTIONS(3) 1212 1213 ## CURLOPT_TIMECONDITION 1214 1215 Make a time conditional request. See CURLOPT_TIMECONDITION(3) 1216 1217 ## CURLOPT_TIMEOUT 1218 1219 Timeout for the entire request. See CURLOPT_TIMEOUT(3) 1220 1221 ## CURLOPT_TIMEOUT_MS 1222 1223 Millisecond timeout for the entire request. See CURLOPT_TIMEOUT_MS(3) 1224 1225 ## CURLOPT_TIMEVALUE 1226 1227 Time value for the time conditional request. See CURLOPT_TIMEVALUE(3) 1228 1229 ## CURLOPT_TIMEVALUE_LARGE 1230 1231 Time value for the time conditional request. See CURLOPT_TIMEVALUE_LARGE(3) 1232 1233 ## CURLOPT_TLS13_CIPHERS 1234 1235 TLS 1.3 cipher suites to use. See CURLOPT_TLS13_CIPHERS(3) 1236 1237 ## CURLOPT_TLSAUTH_PASSWORD 1238 1239 TLS authentication password. See CURLOPT_TLSAUTH_PASSWORD(3) 1240 1241 ## CURLOPT_TLSAUTH_TYPE 1242 1243 TLS authentication methods. See CURLOPT_TLSAUTH_TYPE(3) 1244 1245 ## CURLOPT_TLSAUTH_USERNAME 1246 1247 TLS authentication username. See CURLOPT_TLSAUTH_USERNAME(3) 1248 1249 ## CURLOPT_TRAILERDATA 1250 1251 Custom pointer passed to the trailing headers callback. See 1252 CURLOPT_TRAILERDATA(3) 1253 1254 ## CURLOPT_TRAILERFUNCTION 1255 1256 Set callback for sending trailing headers. See 1257 CURLOPT_TRAILERFUNCTION(3) 1258 1259 ## CURLOPT_TRANSFERTEXT 1260 1261 Use text transfer. See CURLOPT_TRANSFERTEXT(3) 1262 1263 ## CURLOPT_TRANSFER_ENCODING 1264 1265 Request Transfer-Encoding. See CURLOPT_TRANSFER_ENCODING(3) 1266 1267 ## CURLOPT_UNIX_SOCKET_PATH 1268 1269 Path to a Unix domain socket. See CURLOPT_UNIX_SOCKET_PATH(3) 1270 1271 ## CURLOPT_UNRESTRICTED_AUTH 1272 1273 Do not restrict authentication to original host. CURLOPT_UNRESTRICTED_AUTH(3) 1274 1275 ## CURLOPT_UPKEEP_INTERVAL_MS 1276 1277 Sets the interval at which connection upkeep are performed. See 1278 CURLOPT_UPKEEP_INTERVAL_MS(3) 1279 1280 ## CURLOPT_UPLOAD 1281 1282 Upload data. See CURLOPT_UPLOAD(3) 1283 1284 ## CURLOPT_UPLOAD_BUFFERSIZE 1285 1286 Set upload buffer size. See CURLOPT_UPLOAD_BUFFERSIZE(3) 1287 1288 ## CURLOPT_UPLOAD_FLAGS 1289 1290 Set upload flags. See CURLOPT_UPLOAD_FLAGS(3) 1291 1292 ## CURLOPT_URL 1293 1294 URL to work on. See CURLOPT_URL(3) 1295 1296 ## CURLOPT_USERAGENT 1297 1298 User-Agent: header. See CURLOPT_USERAGENT(3) 1299 1300 ## CURLOPT_USERNAME 1301 1302 Username. See CURLOPT_USERNAME(3) 1303 1304 ## CURLOPT_USERPWD 1305 1306 Username and password. See CURLOPT_USERPWD(3) 1307 1308 ## CURLOPT_USE_SSL 1309 1310 Use TLS/SSL. See CURLOPT_USE_SSL(3) 1311 1312 ## CURLOPT_VERBOSE 1313 1314 Display verbose information. See CURLOPT_VERBOSE(3) 1315 1316 ## CURLOPT_WILDCARDMATCH 1317 1318 Transfer multiple files according to a filename pattern. See 1319 CURLOPT_WILDCARDMATCH(3) 1320 1321 ## CURLOPT_WRITEDATA 1322 1323 Data pointer to pass to the write callback. See CURLOPT_WRITEDATA(3) 1324 1325 ## CURLOPT_WRITEFUNCTION 1326 1327 Callback for writing data. See CURLOPT_WRITEFUNCTION(3) 1328 1329 ## CURLOPT_WS_OPTIONS 1330 1331 Set WebSocket options. See CURLOPT_WS_OPTIONS(3) 1332 1333 ## CURLOPT_XFERINFODATA 1334 1335 Data pointer to pass to the progress meter callback. See 1336 CURLOPT_XFERINFODATA(3) 1337 1338 ## CURLOPT_XFERINFOFUNCTION 1339 1340 Callback for progress meter. See CURLOPT_XFERINFOFUNCTION(3) 1341 1342 ## CURLOPT_XOAUTH2_BEARER 1343 1344 OAuth2 bearer token. See CURLOPT_XOAUTH2_BEARER(3) 1345 1346 # %PROTOCOLS% 1347 1348 # EXAMPLE 1349 1350 ~~~c 1351 int main(void) 1352 { 1353 CURL *curl = curl_easy_init(); 1354 if(curl) { 1355 CURLcode res; 1356 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com"); 1357 res = curl_easy_perform(curl); 1358 curl_easy_cleanup(curl); 1359 } 1360 } 1361 ~~~ 1362 1363 # %AVAILABILITY% 1364 1365 # RETURN VALUE 1366 1367 This function returns a CURLcode indicating success or error. 1368 1369 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 1370 libcurl-errors(3). If CURLOPT_ERRORBUFFER(3) was set with curl_easy_setopt(3) 1371 there can be an error message stored in the error buffer when non-zero is 1372 returned. 1373 1374 Strings passed on to libcurl must be shorter than 8000000 bytes, otherwise 1375 curl_easy_setopt(3) returns **CURLE_BAD_FUNCTION_ARGUMENT** (added in 7.65.0). 1376 1377 **CURLE_BAD_FUNCTION_ARGUMENT** is returned when the argument to an option is 1378 invalid, like perhaps out of range. 1379 1380 If you try to set an option that libcurl does not know about, perhaps because 1381 the library is too old to support it or the option was removed in a recent 1382 version, this function returns *CURLE_UNKNOWN_OPTION*. If support for the 1383 option was disabled at compile-time, it returns *CURLE_NOT_BUILT_IN*.