DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_NETRC_FILE(3)




CURLOPT_NETRC_FILE(3)curl_easy_setopt optionCURLOPT_NETRC_FILE(3)


NAME

     CURLOPT_NETRC_FILE - file name to read .netrc info from


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL *handle,  CURLOPT_NETRC_FILE,
     char *file);


DESCRIPTION

     Pass a char * as parameter, pointing to  a  zero  terminated
     string  containing  the  full path name to the file you want
     libcurl to use as .netrc file. If this  option  is  omitted,
     and  CURLOPT_NETRC(3) is set, libcurl will attempt to find a
     .netrc file in the current user's home directory.

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


DEFAULT

     NULL


PROTOCOLS

     All


EXAMPLE

     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);
       curl_easy_setopt(curl, CURLOPT_NETRC_FILE, "/tmp/magic-netrc");
       ret = curl_easy_perform(curl);
     }


AVAILABILITY

     Added in 7.10.9


RETURN VALUE

     Returns   CURLE_OK   if    the    option    is    supported,
     CURLE_UNKNOWN_OPTION if not, or CURLE_OUT_OF_MEMORY if there
     was insufficient heap space.


SEE ALSO

     CURLOPT_NETRC(3), CURLOPT_USERNAME(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html