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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_MAIL_FROM(3)	    Library Functions Manual	    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 null-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 are added automatically.

     In order to specify DSN parameters (as per RFC 3461), the address has to be
     written in angled brackets, followed by the parameters.

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

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

     Using this option multiple times makes the last  set  string  override  the
     previous ones. Set it to NULL to disable its use again.

DEFAULT
     blank

PROTOCOLS
     This functionality affects smtp only

EXAMPLE
     int main(void)
     {
       CURL *curl = curl_easy_init();
       if(curl) {
	 CURLcode result;
	 curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
	 curl_easy_setopt(curl, CURLOPT_MAIL_FROM, "president@example.com");
	 result = curl_easy_perform(curl);
	 curl_easy_cleanup(curl);
       }
     }

AVAILABILITY
     Added in curl 7.20.0

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_MAIL_AUTH(3), CURLOPT_MAIL_RCPT(3)

libcurl 			   2026-06-11		    CURLOPT_MAIL_FROM(3)

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

home | help