NeoMutt  2022-04-29-323-g5fcc6c
Teaching an old dog new tricks
DOXYGEN
smtp.h File Reference

Send email to an SMTP server. More...

#include "config.h"
#include <stdbool.h>
+ Include dependency graph for smtp.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions

bool smtp_auth_is_valid (const char *authenticator)
 Check if string is a valid smtp authentication method. 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, struct ConfigSubset *sub)
 Send a message using SMTP. More...
 

Detailed Description

Send email to an SMTP server.

Authors
  • Richard Russon
  • Pietro Cerutti

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

Function Documentation

◆ smtp_auth_is_valid()

bool smtp_auth_is_valid ( const char *  authenticator)

Check if string is a valid smtp authentication method.

Parameters
authenticatorAuthenticator string to check
Return values
trueArgument is a valid auth method

Validate whether an input string is an accepted smtp authentication method as defined by SmtpAuthenticators.

Definition at line 921 of file smtp.c.

922{
923 for (size_t i = 0; i < mutt_array_size(SmtpAuthenticators); i++)
924 {
925 const struct SmtpAuth *auth = &SmtpAuthenticators[i];
926 if (auth->method && mutt_istr_equal(auth->method, authenticator))
927 return true;
928 }
929
930 return false;
931}
#define mutt_array_size(x)
Definition: memory.h:36
bool mutt_istr_equal(const char *a, const char *b)
Compare two strings, ignoring case.
Definition: string.c:819
static const struct SmtpAuth SmtpAuthenticators[]
Accepted authentication methods.
Definition: smtp.c:898
SMTP authentication multiplexor.
Definition: smtp.c:109
const char * method
Name of authentication method supported, NULL means variable.
Definition: smtp.c:118
+ 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,
struct ConfigSubset sub 
)

Send a message using SMTP.

Parameters
fromFrom Address
toTo Address
ccCc Address
bccBcc Address
msgfileMessage to send to the server
eightbitIf true, try for an 8-bit friendly connection
subConfig Subset
Return values
0Success
-1Error

Definition at line 1086 of file smtp.c.

1089{
1090 struct SmtpAccountData adata = { 0 };
1091 struct ConnAccount cac = { { 0 } };
1092 const char *envfrom = NULL;
1093 char buf[1024] = { 0 };
1094 int rc = -1;
1095
1096 adata.sub = sub;
1097 adata.fqdn = mutt_fqdn(false, adata.sub);
1098 if (!adata.fqdn)
1099 adata.fqdn = NONULL(ShortHostname);
1100
1101 const struct Address *c_envelope_from_address = cs_subset_address(adata.sub, "envelope_from_address");
1102
1103 /* it might be better to synthesize an envelope from from user and host
1104 * but this condition is most likely arrived at accidentally */
1105 if (c_envelope_from_address)
1106 envfrom = c_envelope_from_address->mailbox;
1107 else if (from && !TAILQ_EMPTY(from))
1108 envfrom = TAILQ_FIRST(from)->mailbox;
1109 else
1110 {
1111 mutt_error(_("No from address given"));
1112 return -1;
1113 }
1114
1115 if (smtp_fill_account(&adata, &cac) < 0)
1116 return rc;
1117
1118 adata.conn = mutt_conn_find(&cac);
1119 if (!adata.conn)
1120 return -1;
1121
1122 const char *const c_dsn_return = cs_subset_string(adata.sub, "dsn_return");
1123
1124 do
1125 {
1126 /* send our greeting */
1127 rc = smtp_open(&adata, eightbit);
1128 if (rc != 0)
1129 break;
1130 FREE(&adata.auth_mechs);
1131
1132 /* send the sender's address */
1133 int len = snprintf(buf, sizeof(buf), "MAIL FROM:<%s>", envfrom);
1134 if (eightbit && (adata.capabilities & SMTP_CAP_EIGHTBITMIME))
1135 {
1136 mutt_strn_cat(buf, sizeof(buf), " BODY=8BITMIME", 15);
1137 len += 14;
1138 }
1139 if (c_dsn_return && (adata.capabilities & SMTP_CAP_DSN))
1140 len += snprintf(buf + len, sizeof(buf) - len, " RET=%s", c_dsn_return);
1141 if ((adata.capabilities & SMTP_CAP_SMTPUTF8) &&
1144 {
1145 snprintf(buf + len, sizeof(buf) - len, " SMTPUTF8");
1146 }
1147 mutt_strn_cat(buf, sizeof(buf), "\r\n", 3);
1148 if (mutt_socket_send(adata.conn, buf) == -1)
1149 {
1150 rc = SMTP_ERR_WRITE;
1151 break;
1152 }
1153 rc = smtp_get_resp(&adata);
1154 if (rc != 0)
1155 break;
1156
1157 /* send the recipient list */
1158 if ((rc = smtp_rcpt_to(&adata, to)) || (rc = smtp_rcpt_to(&adata, cc)) ||
1159 (rc = smtp_rcpt_to(&adata, bcc)))
1160 {
1161 break;
1162 }
1163
1164 /* send the message data */
1165 rc = smtp_data(&adata, msgfile);
1166 if (rc != 0)
1167 break;
1168
1169 mutt_socket_send(adata.conn, "QUIT\r\n");
1170
1171 rc = 0;
1172 } while (false);
1173
1174 mutt_socket_close(adata.conn);
1175 FREE(&adata.conn);
1176
1177 if (rc == SMTP_ERR_READ)
1178 mutt_error(_("SMTP session failed: read error"));
1179 else if (rc == SMTP_ERR_WRITE)
1180 mutt_error(_("SMTP session failed: write error"));
1181 else if (rc == SMTP_ERR_CODE)
1182 mutt_error(_("Invalid server response"));
1183
1184 return rc;
1185}
bool mutt_addrlist_uses_unicode(const struct AddressList *al)
Do any of a list of addresses use Unicode characters.
Definition: address.c:1532
bool mutt_addr_uses_unicode(const char *str)
Does this address use Unicode character.
Definition: address.c:1512
const char * cs_subset_string(const struct ConfigSubset *sub, const char *name)
Get a string config item by name.
Definition: helpers.c:317
const struct Address * cs_subset_address(const struct ConfigSubset *sub, const char *name)
Get an Address config item by name.
Definition: helpers.c:49
#define mutt_error(...)
Definition: logging.h:87
#define FREE(x)
Definition: memory.h:43
#define _(a)
Definition: message.h:28
char * mutt_strn_cat(char *d, size_t l, const char *s, size_t sl)
Concatenate two strings.
Definition: string.c:294
char * ShortHostname
Short version of the hostname.
Definition: mutt_globals.h:50
struct Connection * mutt_conn_find(const struct ConnAccount *cac)
Find a connection from a list.
Definition: mutt_socket.c:89
#define TAILQ_FIRST(head)
Definition: queue.h:723
#define TAILQ_EMPTY(head)
Definition: queue.h:721
const char * mutt_fqdn(bool may_hide_host, const struct ConfigSubset *sub)
Get the Fully-Qualified Domain Name.
Definition: sendlib.c:698
static int smtp_get_resp(struct SmtpAccountData *adata)
Read a command response from the SMTP server.
Definition: smtp.c:140
#define SMTP_ERR_READ
Definition: smtp.c:67
#define SMTP_ERR_CODE
Definition: smtp.c:69
#define SMTP_CAP_EIGHTBITMIME
Server supports 8-bit MIME content.
Definition: smtp.c:87
static int smtp_data(struct SmtpAccountData *adata, const char *msgfile)
Send data to an SMTP server.
Definition: smtp.c:227
#define SMTP_ERR_WRITE
Definition: smtp.c:68
static int smtp_fill_account(struct SmtpAccountData *adata, struct ConnAccount *cac)
Create ConnAccount object from SMTP Url.
Definition: smtp.c:344
#define SMTP_CAP_SMTPUTF8
Server accepts UTF-8 strings.
Definition: smtp.c:88
#define SMTP_CAP_DSN
Server supports Delivery Status Notification.
Definition: smtp.c:86
static int smtp_rcpt_to(struct SmtpAccountData *adata, const struct AddressList *al)
Set the recipient to an Address.
Definition: smtp.c:190
static int smtp_open(struct SmtpAccountData *adata, bool esmtp)
Open an SMTP Connection.
Definition: smtp.c:1004
int mutt_socket_close(struct Connection *conn)
Close a socket.
Definition: socket.c:101
#define mutt_socket_send(conn, buf)
Definition: socket.h:59
#define NONULL(x)
Definition: string2.h:37
An email address.
Definition: address.h:36
char * mailbox
Mailbox and host address.
Definition: address.h:38
Login details for a remote server.
Definition: connaccount.h:53
Server connection data.
Definition: smtp.c:97
const char * fqdn
Fully-qualified domain name.
Definition: smtp.c:102
struct ConfigSubset * sub
Config scope.
Definition: smtp.c:101
struct Connection * conn
Server Connection.
Definition: smtp.c:100
const char * auth_mechs
Allowed authorisation mechanisms.
Definition: smtp.c:98
SmtpCapFlags capabilities
Server capabilities.
Definition: smtp.c:99
+ Here is the call graph for this function:
+ Here is the caller graph for this function: