CURLOPT_PASSWORD.md (1450B)
1 --- 2 c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al. 3 SPDX-License-Identifier: curl 4 Title: CURLOPT_PASSWORD 5 Section: 3 6 Source: libcurl 7 See-also: 8 - CURLOPT_HTTPAUTH (3) 9 - CURLOPT_PROXYAUTH (3) 10 - CURLOPT_USERNAME (3) 11 - CURLOPT_USERPWD (3) 12 Protocol: 13 - All 14 Added-in: 7.19.1 15 --- 16 17 # NAME 18 19 CURLOPT_PASSWORD - password to use in authentication 20 21 # SYNOPSIS 22 23 ~~~c 24 #include <curl/curl.h> 25 26 CURLcode curl_easy_setopt(CURL *handle, CURLOPT_PASSWORD, char *pwd); 27 ~~~ 28 29 # DESCRIPTION 30 31 Pass a char pointer as parameter, which should be pointing to the 32 null-terminated password to use for the transfer. 33 34 The CURLOPT_PASSWORD(3) option should be used in conjunction with the 35 CURLOPT_USERNAME(3) option. 36 37 The application does not have to keep the string around after setting this 38 option. 39 40 Using this option multiple times makes the last set string override the 41 previous ones. Set it to NULL to disable its use again. 42 43 # DEFAULT 44 45 blank 46 47 # %PROTOCOLS% 48 49 # EXAMPLE 50 51 ~~~c 52 int main(void) 53 { 54 CURL *curl = curl_easy_init(); 55 if(curl) { 56 CURLcode res; 57 curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin"); 58 59 curl_easy_setopt(curl, CURLOPT_PASSWORD, "qwerty"); 60 61 res = curl_easy_perform(curl); 62 63 curl_easy_cleanup(curl); 64 } 65 } 66 ~~~ 67 68 # %AVAILABILITY% 69 70 # RETURN VALUE 71 72 curl_easy_setopt(3) returns a CURLcode indicating success or error. 73 74 CURLE_OK (0) means everything was OK, non-zero means an error occurred, see 75 libcurl-errors(3).