smtp.c File Reference

Send email to an SMTP server. More...

#include "config.h"
#include <netdb.h>
#include <netinet/in.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>
#include <unistd.h>
#include "mutt/lib.h"
#include "address/lib.h"
#include "email/lib.h"
#include "conn/lib.h"
#include "smtp.h"
#include "globals.h"
#include "init.h"
#include "mutt_account.h"
#include "mutt_socket.h"
#include "progress.h"
#include "sendlib.h"
#include "config/lib.h"
#include <sasl/sasl.h>
#include <sasl/saslutil.h>
#include "options.h"

Include dependency graph for smtp.c:

Go to the source code of this file.

Macros
#define	smtp_success(x)   ((x) / 100 == 2)
#define	SMTP_READY   334
#define	SMTP_CONTINUE   354
#define	SMTP_ERR_READ   -2
#define	SMTP_ERR_WRITE   -3
#define	SMTP_ERR_CODE   -4
#define	SMTP_PORT   25
#define	SMTPS_PORT   465
#define	SMTP_AUTH_SUCCESS   0
#define	SMTP_AUTH_UNAVAIL   1
#define	SMTP_AUTH_FAIL   -1
#define	SMTP_CAP_NO_FLAGS   0
	No flags are set. More...
#define	SMTP_CAP_STARTTLS   (1 << 0)
	Server supports STARTTLS command. More...
#define	SMTP_CAP_AUTH   (1 << 1)
	Server supports AUTH command. More...
#define	SMTP_CAP_DSN   (1 << 2)
	Server supports Delivery Status Notification. More...
#define	SMTP_CAP_EIGHTBITMIME   (1 << 3)
	Server supports 8-bit MIME content. More...
#define	SMTP_CAP_SMTPUTF8   (1 << 4)
	Server accepts UTF-8 strings. More...
#define	SMTP_CAP_ALL   ((1 << 5) - 1)

Typedefs
typedef uint8_t	SmtpCapFlags
	SMTP server capabilities. More...

Functions
static bool	valid_smtp_code (char *buf, size_t buflen, int *n)
	Is the is a valid SMTP return code? More...
static int	smtp_get_resp (struct Connection *conn)
	Read a command response from the SMTP server. More...
static int	smtp_rcpt_to (struct Connection *conn, const struct AddressList *al)
	Set the recipient to an Address. More...
static int	smtp_data (struct Connection *conn, const char *msgfile)
	Send data to an SMTP server. More...
static bool	address_uses_unicode (const char *a)
	Do any addresses use Unicode. More...
static bool	addresses_use_unicode (const struct AddressList *al)
	Do any of a list of addresses use Unicode. More...
static const char *	smtp_get_field (enum ConnAccountField field)
	Get connection login credentials - Implements ConnAccount::get_field() More...
static int	smtp_fill_account (struct ConnAccount *cac)
	Create ConnAccount object from SMTP Url. More...
static int	smtp_helo (struct Connection *conn, bool esmtp)
	Say hello to an SMTP Server. More...
static int	smtp_auth_sasl (struct Connection *conn, const char *mechlist)
	Authenticate using SASL. More...
static int	smtp_auth_oauth (struct Connection *conn)
	Authenticate an SMTP connection using OAUTHBEARER. More...
static int	smtp_auth_plain (struct Connection *conn)
	Authenticate using plain text. More...
static int	smtp_auth (struct Connection *conn)
	Authenticate to an SMTP server. More...
static int	smtp_open (struct Connection *conn, bool esmtp)
	Open an SMTP Connection. More...
int	mutt_smtp_send (const struct AddressList *from, const struct AddressList *to, const struct AddressList *cc, const struct AddressList *bcc, const char *msgfile, bool eightbit)
	Send a message using SMTP. More...

Variables
struct Slist *	C_SmtpAuthenticators
	Config: (smtp) List of allowed authentication methods. More...
char *	C_SmtpOauthRefreshCommand
	Config: (smtp) External command to generate OAUTH refresh token. More...
char *	C_SmtpPass
	Config: (smtp) Password for the SMTP server. More...
char *	C_SmtpUser
	Config: (smtp) Username for the SMTP server. More...
static char *	AuthMechs = NULL
static SmtpCapFlags	Capabilities

Detailed Description

Send email to an SMTP server.

Authors

• Michael R. Elkins
• Brendan Cully
• Pietro Cerutti

Copyright

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.

Definition in file smtp.c.

Macro Definition Documentation

smtp_success

#define smtp_success

(

x

)

((x) / 100 == 2)

Definition at line 68 of file smtp.c.

SMTP_READY

#define SMTP_READY   334

Definition at line 69 of file smtp.c.

SMTP_CONTINUE

#define SMTP_CONTINUE   354

Definition at line 70 of file smtp.c.

SMTP_ERR_READ

#define SMTP_ERR_READ   -2

Definition at line 72 of file smtp.c.

SMTP_ERR_WRITE

#define SMTP_ERR_WRITE   -3

Definition at line 73 of file smtp.c.

SMTP_ERR_CODE

#define SMTP_ERR_CODE   -4

Definition at line 74 of file smtp.c.

SMTP_PORT

#define SMTP_PORT   25

Definition at line 76 of file smtp.c.

SMTPS_PORT

#define SMTPS_PORT   465

Definition at line 77 of file smtp.c.

SMTP_AUTH_SUCCESS

#define SMTP_AUTH_SUCCESS   0

Definition at line 79 of file smtp.c.

SMTP_AUTH_UNAVAIL

#define SMTP_AUTH_UNAVAIL   1

Definition at line 80 of file smtp.c.

SMTP_AUTH_FAIL

#define SMTP_AUTH_FAIL   -1

Definition at line 81 of file smtp.c.

SMTP_CAP_NO_FLAGS

#define SMTP_CAP_NO_FLAGS   0

No flags are set.

Definition at line 88 of file smtp.c.

SMTP_CAP_STARTTLS

#define SMTP_CAP_STARTTLS   (1 << 0)

Server supports STARTTLS command.

Definition at line 89 of file smtp.c.

SMTP_CAP_AUTH

#define SMTP_CAP_AUTH   (1 << 1)

Server supports AUTH command.

Definition at line 90 of file smtp.c.

SMTP_CAP_DSN

#define SMTP_CAP_DSN   (1 << 2)

Server supports Delivery Status Notification.

Definition at line 91 of file smtp.c.

SMTP_CAP_EIGHTBITMIME

#define SMTP_CAP_EIGHTBITMIME   (1 << 3)

Server supports 8-bit MIME content.

Definition at line 92 of file smtp.c.

SMTP_CAP_SMTPUTF8

#define SMTP_CAP_SMTPUTF8   (1 << 4)

Server accepts UTF-8 strings.

Definition at line 93 of file smtp.c.

SMTP_CAP_ALL

#define SMTP_CAP_ALL   ((1 << 5) - 1)

Definition at line 95 of file smtp.c.

Typedef Documentation

SmtpCapFlags

typedef uint8_t SmtpCapFlags

SMTP server capabilities.

Flags, e.g. SMTP_CAP_STARTTLS

Definition at line 87 of file smtp.c.

Function Documentation

valid_smtp_code()

static bool valid_smtp_code ( char *  buf, size_t  buflen, int *  n  )

static

Is the is a valid SMTP return code?

Parameters

[in]	buf	String to check
[in]	buflen	Length of string
[out]	n	Numeric value of code

Return values

true	Valid number

Definition at line 108 of file smtp.c.

{
  char code[4];

  if (buflen < 4)
    return false;
  code[0] = buf[0];
  code[1] = buf[1];
  code[2] = buf[2];
  code[3] = '\0';
  if (mutt_str_atoi(code, n) < 0)
    return false;
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_get_resp()

static int smtp_get_resp ( struct Connection *  conn )

static

Read a command response from the SMTP server.

Parameters

conn	SMTP connection

Return values

0	Success (2xx code) or continue (354 code)
-1	Write error, or any other response code

Definition at line 129 of file smtp.c.

{
  int n;
  char buf[1024];

  do
  {
    n = mutt_socket_readln(buf, sizeof(buf), conn);
    if (n < 4)
    {
      /* read error, or no response code */
      return SMTP_ERR_READ;
    }
    const char *s = buf + 4; /* Skip the response code and the space/dash */
    size_t plen;

    if (mutt_istr_startswith(s, "8BITMIME"))
      Capabilities |= SMTP_CAP_EIGHTBITMIME;
    else if ((plen = mutt_istr_startswith(s, "AUTH ")))
    {
      Capabilities |= SMTP_CAP_AUTH;
      FREE(&AuthMechs);
      AuthMechs = mutt_str_dup(s + plen);
    }
    else if (mutt_istr_startswith(s, "DSN"))
      Capabilities |= SMTP_CAP_DSN;
    else if (mutt_istr_startswith(s, "STARTTLS"))
      Capabilities |= SMTP_CAP_STARTTLS;
    else if (mutt_istr_startswith(s, "SMTPUTF8"))
      Capabilities |= SMTP_CAP_SMTPUTF8;

    if (!valid_smtp_code(buf, n, &n))
      return SMTP_ERR_CODE;

  } while (buf[3] == '-');

  if (smtp_success(n) || (n == SMTP_CONTINUE))
    return 0;

  mutt_error(_("SMTP session failed: %s"), buf);
  return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_rcpt_to()

static int smtp_rcpt_to ( struct Connection *  conn, const struct AddressList *  al  )

static

Set the recipient to an Address.

Parameters

conn	Server Connection
al	AddressList to use

Return values

0	Success
<0	Error, e.g. SMTP_ERR_WRITE

Definition at line 179 of file smtp.c.

{
  if (!al)
    return 0;

  struct Address *a = NULL;
  TAILQ_FOREACH(a, al, entries)
  {
    /* weed out group mailboxes, since those are for display only */
    if (!a->mailbox || a->group)
    {
      continue;
    }
    char buf[1024];
    if ((Capabilities & SMTP_CAP_DSN) && C_DsnNotify)
      snprintf(buf, sizeof(buf), "RCPT TO:<%s> NOTIFY=%s\r\n", a->mailbox, C_DsnNotify);
    else
      snprintf(buf, sizeof(buf), "RCPT TO:<%s>\r\n", a->mailbox);
    if (mutt_socket_send(conn, buf) == -1)
      return SMTP_ERR_WRITE;
    int rc = smtp_get_resp(conn);
    if (rc != 0)
      return rc;
  }

  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_data()

static int smtp_data ( struct Connection *  conn, const char *  msgfile  )

static

Send data to an SMTP server.

Parameters

conn	SMTP Connection
msgfile	Filename containing data

Return values

0	Success
<0	Error, e.g. SMTP_ERR_WRITE

Definition at line 214 of file smtp.c.

{
  char buf[1024];
  struct Progress progress;
  struct stat st;
  int rc, term = 0;
  size_t buflen = 0;

  FILE *fp = fopen(msgfile, "r");
  if (!fp)
  {
    mutt_error(_("SMTP session failed: unable to open %s"), msgfile);
    return -1;
  }
  stat(msgfile, &st);
  unlink(msgfile);
  mutt_progress_init(&progress, _("Sending message..."), MUTT_PROGRESS_NET, st.st_size);

  snprintf(buf, sizeof(buf), "DATA\r\n");
  if (mutt_socket_send(conn, buf) == -1)
  {
    mutt_file_fclose(&fp);
    return SMTP_ERR_WRITE;
  }
  rc = smtp_get_resp(conn);
  if (rc != 0)
  {
    mutt_file_fclose(&fp);
    return rc;
  }

  while (fgets(buf, sizeof(buf) - 1, fp))
  {
    buflen = mutt_str_len(buf);
    term = buflen && buf[buflen - 1] == '\n';
    if (term && ((buflen == 1) || (buf[buflen - 2] != '\r')))
      snprintf(buf + buflen - 1, sizeof(buf) - buflen + 1, "\r\n");
    if (buf[0] == '.')
    {
      if (mutt_socket_send_d(conn, ".", MUTT_SOCK_LOG_FULL) == -1)
      {
        mutt_file_fclose(&fp);
        return SMTP_ERR_WRITE;
      }
    }
    if (mutt_socket_send_d(conn, buf, MUTT_SOCK_LOG_FULL) == -1)
    {
      mutt_file_fclose(&fp);
      return SMTP_ERR_WRITE;
    }
    mutt_progress_update(&progress, ftell(fp), -1);
  }
  if (!term && buflen && (mutt_socket_send_d(conn, "\r\n", MUTT_SOCK_LOG_FULL) == -1))
  {
    mutt_file_fclose(&fp);
    return SMTP_ERR_WRITE;
  }
  mutt_file_fclose(&fp);

  /* terminate the message body */
  if (mutt_socket_send(conn, ".\r\n") == -1)
    return SMTP_ERR_WRITE;

  rc = smtp_get_resp(conn);
  if (rc != 0)
    return rc;

  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

address_uses_unicode()

static bool address_uses_unicode ( const char *  a )

static

Do any addresses use Unicode.

Parameters

a	Address list to check

Return values

true	if any of the string of addresses use 8-bit characters

Definition at line 289 of file smtp.c.

{
  if (!a)
    return false;

  while (*a)
  {
    if ((unsigned char) *a & (1 << 7))
      return true;
    a++;
  }

  return false;
}

Here is the caller graph for this function:

addresses_use_unicode()

static bool addresses_use_unicode ( const struct AddressList *  al )

static

Do any of a list of addresses use Unicode.

Parameters

al	Address list to check

Return values

true	if any use 8-bit characters

Definition at line 309 of file smtp.c.

{
  if (!al)
  {
    return false;
  }

  struct Address *a = NULL;
  TAILQ_FOREACH(a, al, entries)
  {
    if (a->mailbox && !a->group && address_uses_unicode(a->mailbox))
      return true;
  }
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_get_field()

static const char* smtp_get_field ( enum ConnAccountField  field )

static

Get connection login credentials - Implements ConnAccount::get_field()

Definition at line 328 of file smtp.c.

{
  switch (field)
  {
    case MUTT_CA_LOGIN:
    case MUTT_CA_USER:
      return C_SmtpUser;
    case MUTT_CA_PASS:
      return C_SmtpPass;
    case MUTT_CA_OAUTH_CMD:
      return C_SmtpOauthRefreshCommand;
    case MUTT_CA_HOST:
    default:
      return NULL;
  }
}

Here is the caller graph for this function:

smtp_fill_account()

static int smtp_fill_account ( struct ConnAccount *  cac )

static

Create ConnAccount object from SMTP Url.

Parameters

cac	ConnAccount to populate

Return values

0	Success
-1	Error

Definition at line 351 of file smtp.c.

{
  cac->flags = 0;
  cac->port = 0;
  cac->type = MUTT_ACCT_TYPE_SMTP;
  cac->service = "smtp";
  cac->get_field = smtp_get_field;

  struct Url *url = url_parse(C_SmtpUrl);
  if (!url || ((url->scheme != U_SMTP) && (url->scheme != U_SMTPS)) ||
      !url->host || (mutt_account_fromurl(cac, url) < 0))
  {
    url_free(&url);
    mutt_error(_("Invalid SMTP URL: %s"), C_SmtpUrl);
    return -1;
  }

  if (url->scheme == U_SMTPS)
    cac->flags |= MUTT_ACCT_SSL;

  if (cac->port == 0)
  {
    if (cac->flags & MUTT_ACCT_SSL)
      cac->port = SMTPS_PORT;
    else
    {
      static unsigned short SmtpPort = 0;
      if (SmtpPort == 0)
      {
        struct servent *service = getservbyname("smtp", "tcp");
        if (service)
          SmtpPort = ntohs(service->s_port);
        else
          SmtpPort = SMTP_PORT;
        mutt_debug(LL_DEBUG3, "Using default SMTP port %d\n", SmtpPort);
      }
      cac->port = SmtpPort;
    }
  }

  url_free(&url);
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_helo()

static int smtp_helo ( struct Connection *  conn, bool  esmtp  )

static

Say hello to an SMTP Server.

Parameters

conn	SMTP Connection
esmtp	If true, use ESMTP

Return values

0	Success
<0	Error, e.g. SMTP_ERR_WRITE

Definition at line 402 of file smtp.c.

{
  Capabilities = 0;

  if (!esmtp)
  {
    /* if TLS or AUTH are requested, use EHLO */
    if (conn->account.flags & MUTT_ACCT_USER)
      esmtp = true;
#ifdef USE_SSL
    if (C_SslForceTls || (C_SslStarttls != MUTT_NO))
      esmtp = true;
#endif
  }

  const char *fqdn = mutt_fqdn(false);
  if (!fqdn)
    fqdn = NONULL(ShortHostname);

  char buf[1024];
  snprintf(buf, sizeof(buf), "%s %s\r\n", esmtp ? "EHLO" : "HELO", fqdn);
  /* XXX there should probably be a wrapper in mutt_socket.c that
   * repeatedly calls conn->write until all data is sent.  This
   * currently doesn't check for a short write.  */
  if (mutt_socket_send(conn, buf) == -1)
    return SMTP_ERR_WRITE;
  return smtp_get_resp(conn);
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_auth_sasl()

static int smtp_auth_sasl ( struct Connection *  conn, const char *  mechlist  )

static

Authenticate using SASL.

Parameters

conn	SMTP Connection
mechlist	List of mechanisms to use

Return values

0	Success
<0	Error, e.g. SMTP_AUTH_FAIL

Definition at line 439 of file smtp.c.

{
  sasl_conn_t *saslconn = NULL;
  sasl_interact_t *interaction = NULL;
  const char *mech = NULL;
  const char *data = NULL;
  unsigned int len;
  char *buf = NULL;
  size_t bufsize = 0;
  int rc, saslrc;

  if (mutt_sasl_client_new(conn, &saslconn) < 0)
    return SMTP_AUTH_FAIL;

  do
  {
    rc = sasl_client_start(saslconn, mechlist, &interaction, &data, &len, &mech);
    if (rc == SASL_INTERACT)
      mutt_sasl_interact(interaction);
  } while (rc == SASL_INTERACT);

  if ((rc != SASL_OK) && (rc != SASL_CONTINUE))
  {
    mutt_debug(LL_DEBUG2, "%s unavailable\n", mech);
    sasl_dispose(&saslconn);
    return SMTP_AUTH_UNAVAIL;
  }

  if (!OptNoCurses)
    mutt_message(_("Authenticating (%s)..."), mech);

  bufsize = MAX((len * 2), 1024);
  buf = mutt_mem_malloc(bufsize);

  snprintf(buf, bufsize, "AUTH %s", mech);
  if (len)
  {
    mutt_str_cat(buf, bufsize, " ");
    if (sasl_encode64(data, len, buf + mutt_str_len(buf),
                      bufsize - mutt_str_len(buf), &len) != SASL_OK)
    {
      mutt_debug(LL_DEBUG1, "#1 error base64-encoding client response\n");
      goto fail;
    }
  }
  mutt_str_cat(buf, bufsize, "\r\n");

  do
  {
    if (mutt_socket_send(conn, buf) < 0)
      goto fail;
    rc = mutt_socket_readln_d(buf, bufsize, conn, MUTT_SOCK_LOG_FULL);
    if (rc < 0)
      goto fail;
    if (!valid_smtp_code(buf, rc, &rc))
      goto fail;

    if (rc != SMTP_READY)
      break;

    if (sasl_decode64(buf + 4, strlen(buf + 4), buf, bufsize - 1, &len) != SASL_OK)
    {
      mutt_debug(LL_DEBUG1, "error base64-decoding server response\n");
      goto fail;
    }

    do
    {
      saslrc = sasl_client_step(saslconn, buf, len, &interaction, &data, &len);
      if (saslrc == SASL_INTERACT)
        mutt_sasl_interact(interaction);
    } while (saslrc == SASL_INTERACT);

    if (len)
    {
      if ((len * 2) > bufsize)
      {
        bufsize = len * 2;
        mutt_mem_realloc(&buf, bufsize);
      }
      if (sasl_encode64(data, len, buf, bufsize, &len) != SASL_OK)
      {
        mutt_debug(LL_DEBUG1, "#2 error base64-encoding client response\n");
        goto fail;
      }
    }
    mutt_str_copy(buf + len, "\r\n", bufsize - len);
  } while (rc == SMTP_READY && saslrc != SASL_FAIL);

  if (smtp_success(rc))
  {
    mutt_sasl_setup_conn(conn, saslconn);
    FREE(&buf);
    return SMTP_AUTH_SUCCESS;
  }

fail:
  sasl_dispose(&saslconn);
  FREE(&buf);
  return SMTP_AUTH_FAIL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_auth_oauth()

static int smtp_auth_oauth ( struct Connection *  conn )

static

Authenticate an SMTP connection using OAUTHBEARER.

Parameters

conn	Connection info

Return values

num	Result, e.g. SMTP_AUTH_SUCCESS

Definition at line 547 of file smtp.c.

{
  mutt_message(_("Authenticating (OAUTHBEARER)..."));

  /* We get the access token from the smtp_oauth_refresh_command */
  char *oauthbearer = mutt_account_getoauthbearer(&conn->account);
  if (!oauthbearer)
    return SMTP_AUTH_FAIL;

  size_t ilen = strlen(oauthbearer) + 30;
  char *ibuf = mutt_mem_malloc(ilen);
  snprintf(ibuf, ilen, "AUTH OAUTHBEARER %s\r\n", oauthbearer);

  int rc = mutt_socket_send(conn, ibuf);
  FREE(&oauthbearer);
  FREE(&ibuf);

  if (rc == -1)
    return SMTP_AUTH_FAIL;
  if (smtp_get_resp(conn) != 0)
    return SMTP_AUTH_FAIL;

  return SMTP_AUTH_SUCCESS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_auth_plain()

static int smtp_auth_plain ( struct Connection *  conn )

static

Authenticate using plain text.

Parameters

conn	SMTP Connection

Return values

0	Success
<0	Error, e.g. SMTP_AUTH_FAIL

Definition at line 578 of file smtp.c.

{
  char buf[1024];

  /* Get username and password. Bail out of any can't be retrieved. */
  if ((mutt_account_getuser(&conn->account) < 0) ||
      (mutt_account_getpass(&conn->account) < 0))
  {
    goto error;
  }

  /* Build the initial client response. */
  size_t len = mutt_sasl_plain_msg(buf, sizeof(buf), "AUTH PLAIN", conn->account.user,
                                   conn->account.user, conn->account.pass);

  /* Terminate as per SMTP protocol. Bail out if there's no room left. */
  if (snprintf(buf + len, sizeof(buf) - len, "\r\n") != 2)
  {
    goto error;
  }

  /* Send request, receive response (with a check for OK code). */
  if ((mutt_socket_send(conn, buf) < 0) || smtp_get_resp(conn))
  {
    goto error;
  }

  /* If we got here, auth was successful. */
  return 0;

error:
  mutt_error(_("SASL authentication failed"));
  return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_auth()

static int smtp_auth ( struct Connection *  conn )

static

Authenticate to an SMTP server.

Parameters

conn	SMTP Connection

Return values

0	Success
<0	Error, e.g. SMTP_AUTH_FAIL

Definition at line 619 of file smtp.c.

{
  int r = SMTP_AUTH_UNAVAIL;

  if (C_SmtpAuthenticators)
  {
    struct ListNode *np = NULL;
    STAILQ_FOREACH(np, &C_SmtpAuthenticators->head, entries)
    {
      mutt_debug(LL_DEBUG2, "Trying method %s\n", np->data);

      if (strcmp(np->data, "oauthbearer") == 0)
      {
        r = smtp_auth_oauth(conn);
      }
      else if (strcmp(np->data, "plain") == 0)
      {
        r = smtp_auth_plain(conn);
      }
      else
      {
#ifdef USE_SASL
        r = smtp_auth_sasl(conn, np->data);
#else
        mutt_error(_("SMTP authentication method %s requires SASL"), np->data);
        continue;
#endif
      }

      if ((r == SMTP_AUTH_FAIL) && (C_SmtpAuthenticators->count > 1))
      {
        mutt_error(_("%s authentication failed, trying next method"), np->data);
      }
      else if (r != SMTP_AUTH_UNAVAIL)
        break;
    }
  }
  else
  {
#ifdef USE_SASL
    r = smtp_auth_sasl(conn, AuthMechs);
#else
    mutt_error(_("SMTP authentication requires SASL"));
    r = SMTP_AUTH_UNAVAIL;
#endif
  }

  if (r != SMTP_AUTH_SUCCESS)
    mutt_account_unsetpass(&conn->account);

  if (r == SMTP_AUTH_FAIL)
  {
    mutt_error(_("SASL authentication failed"));
  }
  else if (r == SMTP_AUTH_UNAVAIL)
  {
    mutt_error(_("No authenticators available"));
  }

  return (r == SMTP_AUTH_SUCCESS) ? 0 : -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

smtp_open()

static int smtp_open ( struct Connection *  conn, bool  esmtp  )

static

Open an SMTP Connection.

Parameters

conn	SMTP Connection
esmtp	If true, use ESMTP

Return values

0	Success
-1	Error

Definition at line 688 of file smtp.c.

{
  int rc;

  if (mutt_socket_open(conn))
    return -1;

  /* get greeting string */
  rc = smtp_get_resp(conn);
  if (rc != 0)
    return rc;

  rc = smtp_helo(conn, esmtp);
  if (rc != 0)
    return rc;

#ifdef USE_SSL
  enum QuadOption ans = MUTT_NO;
  if (conn->ssf)
    ans = MUTT_NO;
  else if (C_SslForceTls)
    ans = MUTT_YES;
  else if ((Capabilities & SMTP_CAP_STARTTLS) &&
           ((ans = query_quadoption(C_SslStarttls,
                                    _("Secure connection with TLS?"))) == MUTT_ABORT))
  {
    return -1;
  }

  if (ans == MUTT_YES)
  {
    if (mutt_socket_send(conn, "STARTTLS\r\n") < 0)
      return SMTP_ERR_WRITE;
    rc = smtp_get_resp(conn);
    // Clear any data after the STARTTLS acknowledgement
    mutt_socket_empty(conn);
    if (rc != 0)
      return rc;

    if (mutt_ssl_starttls(conn))
    {
      mutt_error(_("Could not negotiate TLS connection"));
      return -1;
    }

    /* re-EHLO to get authentication mechanisms */
    rc = smtp_helo(conn, esmtp);
    if (rc != 0)
      return rc;
  }
#endif

  if (conn->account.flags & MUTT_ACCT_USER)
  {
    if (!(Capabilities & SMTP_CAP_AUTH))
    {
      mutt_error(_("SMTP server does not support authentication"));
      return -1;
    }

    return smtp_auth(conn);
  }

  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_smtp_send()

int mutt_smtp_send	(	const struct AddressList *	from,
		const struct AddressList *	to,
		const struct AddressList *	cc,
		const struct AddressList *	bcc,
		const char *	msgfile,
		bool	eightbit
	)

Send a message using SMTP.

Parameters

from	From Address
to	To Address
cc	Cc Address
bcc	Bcc Address
msgfile	Message to send to the server
eightbit	If true, try for an 8-bit friendly connection

Return values

0	Success
-1	Error

Definition at line 765 of file smtp.c.

{
  struct Connection *conn = NULL;
  struct ConnAccount cac = { { 0 } };
  const char *envfrom = NULL;
  char buf[1024];
  int rc = -1;

  /* it might be better to synthesize an envelope from from user and host
   * but this condition is most likely arrived at accidentally */
  if (C_EnvelopeFromAddress)
    envfrom = C_EnvelopeFromAddress->mailbox;
  else if (from && !TAILQ_EMPTY(from))
    envfrom = TAILQ_FIRST(from)->mailbox;
  else
  {
    mutt_error(_("No from address given"));
    return -1;
  }

  if (smtp_fill_account(&cac) < 0)
    return rc;

  conn = mutt_conn_find(&cac);
  if (!conn)
    return -1;

  do
  {
    /* send our greeting */
    rc = smtp_open(conn, eightbit);
    if (rc != 0)
      break;
    FREE(&AuthMechs);

    /* send the sender's address */
    int len = snprintf(buf, sizeof(buf), "MAIL FROM:<%s>", envfrom);
    if (eightbit && (Capabilities & SMTP_CAP_EIGHTBITMIME))
    {
      mutt_strn_cat(buf, sizeof(buf), " BODY=8BITMIME", 15);
      len += 14;
    }
    if (C_DsnReturn && (Capabilities & SMTP_CAP_DSN))
      len += snprintf(buf + len, sizeof(buf) - len, " RET=%s", C_DsnReturn);
    if ((Capabilities & SMTP_CAP_SMTPUTF8) &&
        (address_uses_unicode(envfrom) || addresses_use_unicode(to) ||
         addresses_use_unicode(cc) || addresses_use_unicode(bcc)))
    {
      snprintf(buf + len, sizeof(buf) - len, " SMTPUTF8");
    }
    mutt_strn_cat(buf, sizeof(buf), "\r\n", 3);
    if (mutt_socket_send(conn, buf) == -1)
    {
      rc = SMTP_ERR_WRITE;
      break;
    }
    rc = smtp_get_resp(conn);
    if (rc != 0)
      break;

    /* send the recipient list */
    if ((rc = smtp_rcpt_to(conn, to)) || (rc = smtp_rcpt_to(conn, cc)) ||
        (rc = smtp_rcpt_to(conn, bcc)))
    {
      break;
    }

    /* send the message data */
    rc = smtp_data(conn, msgfile);
    if (rc != 0)
      break;

    mutt_socket_send(conn, "QUIT\r\n");

    rc = 0;
  } while (false);

  mutt_socket_close(conn);
  FREE(&conn);

  if (rc == SMTP_ERR_READ)
    mutt_error(_("SMTP session failed: read error"));
  else if (rc == SMTP_ERR_WRITE)
    mutt_error(_("SMTP session failed: write error"));
  else if (rc == SMTP_ERR_CODE)
    mutt_error(_("Invalid server response"));

  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

C_SmtpAuthenticators

struct Slist* C_SmtpAuthenticators

Config: (smtp) List of allowed authentication methods.

Definition at line 63 of file smtp.c.

C_SmtpOauthRefreshCommand

char* C_SmtpOauthRefreshCommand

Config: (smtp) External command to generate OAUTH refresh token.

Definition at line 64 of file smtp.c.

C_SmtpPass

char* C_SmtpPass

Config: (smtp) Password for the SMTP server.

Definition at line 65 of file smtp.c.

C_SmtpUser

char* C_SmtpUser

Config: (smtp) Username for the SMTP server.

Definition at line 66 of file smtp.c.

AuthMechs

char* AuthMechs = NULL

static

Definition at line 98 of file smtp.c.

Capabilities

SmtpCapFlags Capabilities

static

Definition at line 99 of file smtp.c.