Sortix main manual
This manual documents Sortix main. You can instead view this document in the latest official manual.
CURLOPT_NETRC(3) | curl_easy_setopt options | CURLOPT_NETRC(3) |
NAME
CURLOPT_NETRC - enable use of .netrcDESCRIPTION
This parameter controls the preference level of libcurl between using user names and passwords from your ~/.netrc file, relative to user names and passwords in the URL supplied with CURLOPT_URL(3).- CURL_NETRC_IGNORED (0)
- The library will ignore the .netrc file. This is the default.
- CURL_NETRC_OPTIONAL (1)
- The use of the .netrc file is optional, and information in the URL is to be preferred. The file will be scanned for the host and user name (to find the password only) or for the host only, to find the first user name and password after that machine, which ever information is not specified.
- CURL_NETRC_REQUIRED (2)
- The use of the .netrc file is required, and any credential information present in the URL is ignored. The file will be scanned for the host and user name (to find the password only) or for the host only, to find the first user name and password after that machine, which ever information is not specified.
FILE FORMAT
The .netrc file format is simple: you specify lines with a machine name and follow the login and password that are associated with that machine.- machine <name>
- Provides credentials for a host called name. libcurl searches the .netrc file for a machine token that matches the host name specified in the URL. Once a match is made, the subsequent tokens are processed, stopping when the end of file is reached or another "machine" is encountered.
- default
-
This is the same as "machine" name except that default matches any name. There can be only one default token, and it must be after all machine tokens. To provide a default anonymous login for hosts that are not otherwise matched, add a line similar to this in the end:
default login anonymous password user@domain
- login <name>
- The user name string for the remote machine.
- password <secret>
- Supply a password. If this token is present, curl will supply the specified string if the remote server requires a password as part of the login process. Note that if this token is present in the .netrc file you really should make sure the file is not readable by anyone besides the user.
- macdef <name>
- Define a macro. This feature is not supported by libcurl. In order for the rest of the .netrc to still work fine, libcurl will properly skip every definition done with "macdef" that it finds.
DEFAULT
CURL_NETRC_IGNOREDPROTOCOLS
MostEXAMPLE
CURL *curl = curl_easy_init();
if(curl) {
CURLcode ret;
curl_easy_setopt(curl, CURLOPT_URL, "ftp://example.com/");
curl_easy_setopt(curl, CURLOPT_NETRC, CURL_NETRC_OPTIONAL);
ret = curl_easy_perform(curl);
}
AVAILABILITY
AlwaysRETURN VALUE
Returns CURLE_OKSEE ALSO
CURLOPT_USERPWD(3), CURLOPT_USERNAME(3), CURLOPT_NETRC_FILE(3),May 17, 2022 | libcurl 7.84.0 |