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

FreeBSD Manual Pages

  
 
  

home | help
CURLOPT_MAIL_RCPT(3)	   curl_easy_setopt options	  CURLOPT_MAIL_RCPT(3)

NAME
       CURLOPT_MAIL_RCPT - list	of SMTP	mail recipients

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	curl_easy_setopt(CURL *handle, CURLOPT_MAIL_RCPT,
				 struct	curl_slist *rcpts);

DESCRIPTION
       Pass  a pointer to a linked list	of recipients to pass to the server in
       your SMTP mail request. The linked list should be a fully valid list of
       struct  curl_slist structs properly filled in. Use curl_slist_append(3)
       to create the list and curl_slist_free_all(3) to	 clean	up  an	entire
       list.

       When  performing	 a  mail  transfer, each recipient should be specified
       within a	pair of	angled brackets	(<>), however, should you not  use  an
       angled  bracket as the first character libcurl will assume you provided
       a single	email address and enclose that	address	 within	 brackets  for
       you.

       When  performing	an address verification	(VRFY command),	each recipient
       should be specified as the user name or user name and  domain  (as  per
       Section 3.5 of RFC5321).

       When  performing	 a  mailing list expand	(EXPN command),	each recipient
       should be specified using the mailing list name,	such as	 "Friends"  or
       "London-Office".

DEFAULT
       NULL

PROTOCOLS
       SMTP

EXAMPLE
       CURL *curl = curl_easy_init();
       if(curl)	{
	 struct	curl_slist *list;
	 list =	curl_slist_append(NULL,	"root@localhost");
	 list =	curl_slist_append(list,	"person@example.com");
	 curl_easy_setopt(curl,	CURLOPT_URL, "smtp://example.com/");
	 curl_easy_setopt(curl,	CURLOPT_MAIL_RCPT, list);
	 ret = curl_easy_perform(curl);
	 curl_slist_free_all(list);
	 curl_easy_cleanup(curl);
       }

AVAILABILITY
       Added in	7.20.0.	The VRFY and EXPN logic	was added in 7.34.0

RETURN VALUE
       Returns	CURLE_OK  if the option	is supported, and CURLE_UNKNOWN_OPTION
       if not.

SEE ALSO
       CURLOPT_MAIL_FROM(3), CURLOPT_MAIL_AUTH(3),

libcurl	7.54.1			 May 31, 2017		  CURLOPT_MAIL_RCPT(3)

NAME | SYNOPSIS | DESCRIPTION | DEFAULT | PROTOCOLS | EXAMPLE | AVAILABILITY | RETURN VALUE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=CURLOPT_MAIL_RCPT&sektion=3&manpath=FreeBSD+12.0-RELEASE+and+Ports>

home | help