Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
CURLOPT_USERNAME(3)	   Library Functions Manual	   CURLOPT_USERNAME(3)

NAME
       CURLOPT_USERNAME	- username to use in authentication

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_USERNAME,
				 char *username);

DESCRIPTION
       Pass  a	char  pointer  as  parameter,  which should be pointing	to the
       null-terminated username	to use for the transfer.

       CURLOPT_USERNAME(3) sets	the username to	be used	in protocol  authenti-
       cation.	You  should not	use this option	together with the (older) CUR-
       LOPT_USERPWD(3) option.

       When using Kerberos V5 authentication with a Windows based server,  you
       should  include the domain name in order	for the	server to successfully
       obtain a	Kerberos Ticket. If you	do not then the	initial	 part  of  the
       authentication handshake	may fail.

       When  using NTLM, the username can be specified without the domain name
       should the server be part of a single domain and	forest.

       To include the domain name use either  Down-Level  Logon	 Name  or  UPN
       (User  Principal	 Name) formats.	For example, EXAMPLEser	and user@exam-
       ple.com respectively.

       Some HTTP servers (on Windows) support inclusion	of the domain for  Ba-
       sic authentication as well.

       To specify the password and login options, along	with the username, use
       the CURLOPT_PASSWORD(3) and CURLOPT_LOGIN_OPTIONS(3) options.

       The  application	 does not have to keep the string around after setting
       this option.

DEFAULT
       blank

PROTOCOLS
       This functionality affects all supported	protocols

EXAMPLE
       int main(void)
       {
	 CURL *curl = curl_easy_init();
	 if(curl) {
	   CURLcode result;
	   curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");

	   curl_easy_setopt(curl, CURLOPT_USERNAME, "clark");

	   result = curl_easy_perform(curl);

	   curl_easy_cleanup(curl);
	 }
       }

AVAILABILITY
       Added in	curl 7.19.1

RETURN VALUE
       curl_easy_setopt(3) returns a CURLcode indicating success or error.

       CURLE_OK	(0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).

SEE ALSO
       CURLOPT_HTTPAUTH(3),  CURLOPT_PASSWORD(3),  CURLOPT_PROXYAUTH(3),  CUR-
       LOPT_USERPWD(3)

libcurl				  2026-06-11		   CURLOPT_USERNAME(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=CURLOPT_USERNAME&sektion=3&manpath=FreeBSD+Ports+15.1.quarterly>

home | help