Artifactspublic-v0

curl

master
ply4 git calls130 ms288 KiB2 cachedprotocol v2
91 lines2.4 KiBRaw

NAME

CURLOPT_MAIL_RCPT - list of SMTP mail recipients

SYNOPSIS

c
#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.

libcurl does not copy the list, it needs to be kept around until after the transfer has completed.

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

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

When performing an address verification (VRFY command), each recipient should be specified as the username or username plus domain (as per Section 3.5 of RFC 5321).

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

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

DEFAULT

NULL

%PROTOCOLS%

EXAMPLE

c
int main(void)
{
  CURL *curl = curl_easy_init();
  if(curl) {
    CURLcode result;
    struct curl_slist *list;
    list = curl_slist_append(NULL, "root@localhost");
    list = curl_slist_append(list, "person@example.com");
    list = curl_slist_append(list, "<other@example.com> NOTIFY=SUCCESS");
    curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
    curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, list);
    result = curl_easy_perform(curl);
    curl_slist_free_all(list);
    curl_easy_cleanup(curl);
  }
}

%AVAILABILITY%

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).

1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Title: CURLOPT_MAIL_RCPT
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_MAIL_AUTH (3)
9 - CURLOPT_MAIL_FROM (3)
10Protocol:
11 - SMTP
12Added-in: 7.20.0
13---
15# NAME
17CURLOPT_MAIL_RCPT - list of SMTP mail recipients
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_RCPT,
25 struct curl_slist *rcpts);
26~~~
28# DESCRIPTION
30Pass a pointer to a linked list of recipients to pass to the server in your
31SMTP mail request. The linked list should be a fully valid list of
32**struct curl_slist** structs properly filled in. Use curl_slist_append(3) to
33create the list and curl_slist_free_all(3) to clean up an entire list.
35libcurl does not copy the list, it needs to be kept around until after the
36transfer has completed.
38When performing a mail transfer, each recipient should be specified within a
39pair of angled brackets (\<\>). Should you not use an angled bracket as the
40first character, libcurl assumes you provided a single email address and
41encloses that address within brackets for you.
43In order to specify DSN parameters (as per RFC 3461), the address has to be
44written in angled brackets, followed by the parameters.
46When performing an address verification (**VRFY** command), each recipient
47should be specified as the username or username plus domain (as per Section
483.5 of RFC 5321).
50When performing a mailing list expand (**EXPN** command), each recipient
51should be specified using the mailing list name, such as `Friends` or
52`London-Office`.
54Using this option multiple times makes the last set list override the previous
55ones. Set it to NULL to disable its use again.
57# DEFAULT
59NULL
61# %PROTOCOLS%
63# EXAMPLE
65~~~c
66int main(void)
68 CURL *curl = curl_easy_init();
69 if(curl) {
70 CURLcode result;
71 struct curl_slist *list;
72 list = curl_slist_append(NULL, "root@localhost");
73 list = curl_slist_append(list, "person@example.com");
74 list = curl_slist_append(list, "<other@example.com> NOTIFY=SUCCESS");
75 curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
76 curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, list);
77 result = curl_easy_perform(curl);
78 curl_slist_free_all(list);
79 curl_easy_cleanup(curl);
80 }
82~~~
84# %AVAILABILITY%
86# RETURN VALUE
88curl_easy_setopt(3) returns a CURLcode indicating success or error.
90CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
91libcurl-errors(3).
Diagnostics4 git calls · 130 ms
CallStatusSizeTime0130 ms
discover200152 B2 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=2
git.response.bytes=152
git.server.agent=gitty/1.0
git.server.object_format=sha1
git.server.caps=agent ls-refs fetch object-format
git.server.fetch=shallow filter sideband-all
git.protocol.version=2
git.pkt.frames=8
git.pkt.data=6
git.pkt.flush=2
git.pkt.delim=0
git.pkt.bytes=152
git.pkt.payload.max=34
ls-refs200149 B · hit2 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=2
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=2
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=149
git.pkt.payload.max=78
git.ls_refs.count=2
git.ls_refs.head=refs/heads/master
fetchblob:none · deepen 10200287 KiB · hit2 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=126
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=2
git.fetch.filter=blob:none
git.fetch.filter.requested=tree:0
git.fetch.filter.fallback=blob:none
git.fetch.filter.learned=false
git.fetch.wants=31c911efe5652725e930f4d2e60c9060e5f6646d
git.fetch.haves.count=0
git.fetch.deepen=10
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=10
git.pkt.data=8
git.pkt.flush=1
git.pkt.delim=1
git.pkt.bytes=293470
git.pkt.payload.max=65516
git.sideband.band1.bytes=293354
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0
git.pack.objects=87
git.pack.bytes=293354
git.pack.ofs_delta=0
git.pack.ref_delta=1
git.pack.chain.max=1
git.pack.trailer=6a646bcda6740bab42e321b51998b52ea15146c0
git.pack.full=86
Open pack map
fetch2001.3 KiB126 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1304
git.response.cache=MISS
git.response.duration_ms=126
git.fetch.wants=49dd618faecf7ad28919c9b2d2d0b46471465c4d
git.fetch.haves.count=0
git.fetch.deepen=0
git.fetch.thin_pack=false
git.fetch.ofs_delta=true
git.protocol.version=2
git.pkt.frames=3
git.pkt.data=2
git.pkt.flush=1
git.pkt.delim=0
git.pkt.bytes=1304
git.pkt.payload.max=1283
git.sideband.band1.bytes=1282
git.sideband.band2.bytes=0
git.sideband.band3.bytes=0

Each row is one HTTP round trip ply made to the git server for this page, on one timeline. discover asks what the server speaks, ls-refs lists branch tips, fetch brings objects by id. A hit was served by Workers Cache. Tap a row for its wire details.

Remote
https://5ad2236b39de4c8bd8f6270ea63f3ea9.artifacts.cloudflare.net/git/public-v0/curl.git
Ref
refs/heads/master
Commit
31c911efe5652725e930f4d2e60c9060e5f6646d
cf-ray
a5e3646bcd21b23b
Request
c9bb220b…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format