DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

CURLOPT_MAIL_FROM(3)




CURLOPT_MAIL_FROM(3)curl_easy_setopt options CURLOPT_MAIL_FROM(3)


NAME

     CURLOPT_MAIL_FROM - SMTP sender address


SYNOPSIS

     #include <curl/curl.h>

     CURLcode curl_easy_setopt(CURL  *handle,  CURLOPT_MAIL_FROM,
     char *from);


DESCRIPTION

     Pass a pointer to a zero  terminated  string  as  parameter.
     This  should  be  used to specify the sender's email address
     when sending SMTP mail with libcurl.

     An originator email address should be specified with  angled
     brackets  (<>)  around  it,  which  if not specified will be
     added automatically.

     If this parameter is not specified  then  an  empty  address
     will be sent to the mail server which may cause the email to
     be rejected.

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


DEFAULT

     blank


PROTOCOLS

     SMTP


EXAMPLE

     CURL *curl = curl_easy_init();
     if(curl) {
       curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
       curl_easy_setopt(curl, CURLOPT_MAIL_FROM, "president@example.com");
       ret = curl_easy_perform(curl);
       curl_easy_cleanup(curl);
     }


AVAILABILITY

     Added in 7.20.0


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_MAIL_RCPT(3), CURLOPT_MAIL_AUTH(3),

libcurl 7.58.0      Last change: May 31, 2017                   1


Man(1) output converted with man2html