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	simply as the username
       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 res;
	   curl_easy_setopt(curl, CURLOPT_URL, "https://example.com/foo.bin");

	   curl_easy_setopt(curl, CURLOPT_USERNAME, "clark");

	   res = 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				  2025-06-03		   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+14.3.quarterly>

home | help