Artifactspublic-v0

curl

master
ply4 git calls773 ms288 KiB2 cachedprotocol v2
79 lines2.0 KiBRaw

NAME

CURLOPT_MAIL_AUTH - SMTP authentication address

SYNOPSIS

c
#include <curl/curl.h>

CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_AUTH, char *auth);

DESCRIPTION

Pass a pointer to a null-terminated string as parameter. This is used to specify the authentication address (identity) of a submitted message that is being relayed to another server.

This optional parameter allows co-operating agents in a trusted environment to communicate the authentication of individual messages and should only be used by the application program, using libcurl, if the application is itself a mail server acting in such an environment. If the application is operating as such and the AUTH address is not known or is invalid, then an empty string should be used for this parameter.

Unlike CURLOPT_MAIL_FROM(3) and CURLOPT_MAIL_RCPT(3), the address should not be specified within a pair of angled brackets (<>). If an empty string is used, a pair of brackets is sent by libcurl as required by RFC 2554.

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

NULL

%PROTOCOLS%

EXAMPLE

c
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_AUTH, "<secret@cave>");
    result = curl_easy_perform(curl);
    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_AUTH
5Section: 3
6Source: libcurl
7See-also:
8 - CURLOPT_MAIL_FROM (3)
9 - CURLOPT_MAIL_RCPT (3)
10Protocol:
11 - SMTP
12Added-in: 7.25.0
13---
15# NAME
17CURLOPT_MAIL_AUTH - SMTP authentication address
19# SYNOPSIS
21~~~c
22#include <curl/curl.h>
24CURLcode curl_easy_setopt(CURL *handle, CURLOPT_MAIL_AUTH, char *auth);
25~~~
27# DESCRIPTION
29Pass a pointer to a null-terminated string as parameter. This is used to
30specify the authentication address (identity) of a submitted message that is
31being relayed to another server.
33This optional parameter allows co-operating agents in a trusted environment to
34communicate the authentication of individual messages and should only be used
35by the application program, using libcurl, if the application is itself a mail
36server acting in such an environment. If the application is operating as such
37and the AUTH address is not known or is invalid, then an empty string should
38be used for this parameter.
40Unlike CURLOPT_MAIL_FROM(3) and CURLOPT_MAIL_RCPT(3), the address should not
41be specified within a pair of angled brackets (\<\>). If an empty string is
42used, a pair of brackets is sent by libcurl as required by RFC 2554.
44The application does not have to keep the string around after setting this
45option.
47Using this option multiple times makes the last set string override the
48previous ones. Set it to NULL to disable its use again.
50# DEFAULT
52NULL
54# %PROTOCOLS%
56# EXAMPLE
58~~~c
59int main(void)
61 CURL *curl = curl_easy_init();
62 if(curl) {
63 CURLcode result;
64 curl_easy_setopt(curl, CURLOPT_URL, "smtp://example.com/");
65 curl_easy_setopt(curl, CURLOPT_MAIL_AUTH, "<secret@cave>");
66 result = curl_easy_perform(curl);
67 curl_easy_cleanup(curl);
68 }
70~~~
72# %AVAILABILITY%
74# RETURN VALUE
76curl_easy_setopt(3) returns a CURLcode indicating success or error.
78CURLE_OK (0) means everything was OK, non-zero means an error occurred, see
79libcurl-errors(3).
Diagnostics4 git calls · 773 ms
CallStatusSizeTime0773 ms
discover200152 B3 ms
git.upload-pack discover
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=3
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 · hit3 ms
git.upload-pack ls-refs
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=ls-refs
git.upstream.dur_ms=3
git.response.bytes=149
git.response.cache=HIT
git.response.duration_ms=3
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 · hit4 ms
git.upload-pack fetch
http.response.status_code=200
git.upstream.cf_ray=-
git.upstream.phase=fetch
git.upstream.dur_ms=766
git.response.bytes=293470
git.response.cache=HIT
git.response.duration_ms=4
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.1 KiB766 ms
git.upload-pack fetch
http.response.status_code=200
git.response.bytes=1125
git.response.cache=MISS
git.response.duration_ms=766
git.fetch.wants=3a0263a1774730ebe977b83fff491821979200ca
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=1125
git.pkt.payload.max=1104
git.sideband.band1.bytes=1103
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
a5e37706bb614603
Request
fcabb175…
Protocol
v2 · sha1
Agent
gitty/1.0
Filter
advertised
Fetch
shallow filter sideband-all
Capabilities
agent ls-refs fetch object-format