NeoMutt
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
sendmail.c File Reference

Send email using sendmail. More...

#include "config.h"
#include <errno.h>
#include <fcntl.h>
#include <limits.h>
#include <regex.h>
#include <signal.h>
#include <stdbool.h>
#include <string.h>
#include <sys/stat.h>
#include <sys/wait.h>
#include <unistd.h>
#include "mutt/lib.h"
#include "address/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "gui/lib.h"
#include "sendmail.h"
#include "pager/lib.h"
#include "format_flags.h"
#include "globals.h"
#include "muttlib.h"
#include "nntp/lib.h"
+ Include dependency graph for sendmail.c:

Go to the source code of this file.

Macros

#define EX_OK   0
 

Functions

 ARRAY_HEAD (SendmailArgArray, const char *)
 
static void alarm_handler (int sig)
 Async notification of an alarm signal.
 
static int send_msg (const char *path, struct SendmailArgArray *args, const char *msg, char **tempfile, int wait_time)
 Invoke sendmail in a subshell.
 
static void add_args_one (struct SendmailArgArray *args, const struct Address *addr)
 Add an Address to a dynamic array.
 
static void add_args (struct SendmailArgArray *args, struct AddressList *al)
 Add a list of Addresses to a dynamic array.
 
int mutt_invoke_sendmail (struct Mailbox *m, struct AddressList *from, struct AddressList *to, struct AddressList *cc, struct AddressList *bcc, const char *msg, bool eightbit, struct ConfigSubset *sub)
 Run sendmail.
 

Variables

char ** environ
 
static SIG_ATOMIC_VOLATILE_T SigAlrm
 true after SIGALRM is received
 

Detailed Description

Send email using sendmail.

Authors
  • Richard Russon

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

Macro Definition Documentation

◆ EX_OK

#define EX_OK   0

Definition at line 56 of file sendmail.c.

Function Documentation

◆ ARRAY_HEAD()

ARRAY_HEAD ( SendmailArgArray  ,
const char *   
)

◆ alarm_handler()

static void alarm_handler ( int  sig)
static

Async notification of an alarm signal.

Parameters
sigSignal, (SIGALRM)

Definition at line 72 of file sendmail.c.

73{
74 SigAlrm = 1;
75}
static SIG_ATOMIC_VOLATILE_T SigAlrm
true after SIGALRM is received
Definition: sendmail.c:64
+ Here is the caller graph for this function:

◆ send_msg()

static int send_msg ( const char *  path,
struct SendmailArgArray *  args,
const char *  msg,
char **  tempfile,
int  wait_time 
)
static

Invoke sendmail in a subshell.

Parameters
[in]pathPath to program to execute
[in]argsArguments to pass to program
[in]msgTemp file containing message to send
[out]tempfileIf sendmail is put in the background, this points to the temporary file containing the stdout of the child process. If it is NULL, stderr and stdout are not redirected.
[in]wait_timeHow long to wait for sendmail, $sendmail_wait
Return values
0Success
>0Failure, return code from sendmail

Definition at line 90 of file sendmail.c.

92{
93 sigset_t set;
94 int st;
95
97
98 sigemptyset(&set);
99 /* we also don't want to be stopped right now */
100 sigaddset(&set, SIGTSTP);
101 sigprocmask(SIG_BLOCK, &set, NULL);
102
103 if ((wait_time >= 0) && tempfile)
104 {
105 struct Buffer *tmp = buf_pool_get();
106 buf_mktemp(tmp);
107 *tempfile = buf_strdup(tmp);
108 buf_pool_release(&tmp);
109 }
110
111 pid_t pid = fork();
112 if (pid == 0)
113 {
114 struct sigaction act = { 0 };
115 struct sigaction oldalrm = { 0 };
116
117 /* save parent's ID before setsid() */
118 pid_t ppid = getppid();
119
120 /* we want the delivery to continue even after the main process dies,
121 * so we put ourselves into another session right away */
122 setsid();
123
124 /* next we close all open files */
125 close(0);
126#ifdef OPEN_MAX
127 for (int fd = tempfile ? 1 : 3; fd < OPEN_MAX; fd++)
128 close(fd);
129#elif defined(_POSIX_OPEN_MAX)
130 for (int fd = tempfile ? 1 : 3; fd < _POSIX_OPEN_MAX; fd++)
131 close(fd);
132#else
133 if (tempfile)
134 {
135 close(1);
136 close(2);
137 }
138#endif
139
140 /* now the second fork() */
141 pid = fork();
142 if (pid == 0)
143 {
144 /* "msg" will be opened as stdin */
145 if (open(msg, O_RDONLY, 0) < 0)
146 {
147 unlink(msg);
148 _exit(S_ERR);
149 }
150 unlink(msg);
151
152 if ((wait_time >= 0) && tempfile && *tempfile)
153 {
154 /* *tempfile will be opened as stdout */
155 if (open(*tempfile, O_WRONLY | O_APPEND | O_CREAT | O_EXCL, 0600) < 0)
156 _exit(S_ERR);
157 /* redirect stderr to *tempfile too */
158 if (dup(1) < 0)
159 _exit(S_ERR);
160 }
161 else if (tempfile)
162 {
163 if (open("/dev/null", O_WRONLY | O_APPEND) < 0) /* stdout */
164 _exit(S_ERR);
165 if (open("/dev/null", O_RDWR | O_APPEND) < 0) /* stderr */
166 _exit(S_ERR);
167 }
168
169 /* execvpe is a glibc extension, so just manually set environ */
171 execvp(path, (char **) args->entries);
172 _exit(S_ERR);
173 }
174 else if (pid == -1)
175 {
176 unlink(msg);
177 FREE(tempfile);
178 _exit(S_ERR);
179 }
180
181 /* wait_time > 0: interrupt waitpid() after wait_time seconds
182 * wait_time = 0: wait forever
183 * wait_time < 0: don't wait */
184 if (wait_time > 0)
185 {
186 SigAlrm = 0;
187 act.sa_handler = alarm_handler;
188#ifdef SA_INTERRUPT
189 /* need to make sure waitpid() is interrupted on SIGALRM */
190 act.sa_flags = SA_INTERRUPT;
191#else
192 act.sa_flags = 0;
193#endif
194 sigemptyset(&act.sa_mask);
195 sigaction(SIGALRM, &act, &oldalrm);
196 alarm(wait_time);
197 }
198 else if (wait_time < 0)
199 {
200 _exit(0xff & EX_OK);
201 }
202
203 if (waitpid(pid, &st, 0) > 0)
204 {
205 st = WIFEXITED(st) ? WEXITSTATUS(st) : S_ERR;
206 if (wait_time && (st == (0xff & EX_OK)) && tempfile && *tempfile)
207 {
208 unlink(*tempfile); /* no longer needed */
209 FREE(tempfile);
210 }
211 }
212 else
213 {
214 st = ((wait_time > 0) && (errno == EINTR) && SigAlrm) ? S_BKG : S_ERR;
215 if ((wait_time > 0) && tempfile && *tempfile)
216 {
217 unlink(*tempfile);
218 FREE(tempfile);
219 }
220 }
221
222 if (wait_time > 0)
223 {
224 /* reset alarm; not really needed, but... */
225 alarm(0);
226 sigaction(SIGALRM, &oldalrm, NULL);
227 }
228
229 if ((kill(ppid, 0) == -1) && (errno == ESRCH) && tempfile && *tempfile)
230 {
231 /* the parent is already dead */
232 unlink(*tempfile);
233 FREE(tempfile);
234 }
235
236 _exit(st);
237 }
238
239 sigprocmask(SIG_UNBLOCK, &set, NULL);
240
241 if ((pid != -1) && (waitpid(pid, &st, 0) > 0))
242 st = WIFEXITED(st) ? WEXITSTATUS(st) : S_ERR; /* return child status */
243 else
244 st = S_ERR; /* error */
245
247
248 return st;
249}
char * buf_strdup(const struct Buffer *buf)
Copy a Buffer's string.
Definition: buffer.c:542
char ** EnvList
Private copy of the environment variables.
Definition: globals.c:85
#define FREE(x)
Definition: memory.h:45
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition: pool.c:81
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition: pool.c:94
static void alarm_handler(int sig)
Async notification of an alarm signal.
Definition: sendmail.c:72
char ** environ
#define EX_OK
Definition: sendmail.c:56
void mutt_sig_block_system(void)
Block signals before calling exec()
Definition: signal.c:196
void mutt_sig_unblock_system(bool restore)
Restore previously blocked signals.
Definition: signal.c:220
#define S_ERR
Definition: string2.h:40
#define S_BKG
Definition: string2.h:41
String manipulation buffer.
Definition: buffer.h:34
#define buf_mktemp(buf)
Definition: tmp.h:33
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ add_args_one()

static void add_args_one ( struct SendmailArgArray *  args,
const struct Address addr 
)
static

Add an Address to a dynamic array.

Parameters
[in,out]argsArray to add to
[in]addrAddress to add

Definition at line 256 of file sendmail.c.

257{
258 /* weed out group mailboxes, since those are for display only */
259 if (addr->mailbox && !addr->group)
260 {
261 ARRAY_ADD(args, buf_string(addr->mailbox));
262 }
263}
#define ARRAY_ADD(head, elem)
Add an element at the end of the array.
Definition: array.h:155
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition: buffer.h:93
bool group
Group mailbox?
Definition: address.h:39
struct Buffer * mailbox
Mailbox and host address.
Definition: address.h:38
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ add_args()

static void add_args ( struct SendmailArgArray *  args,
struct AddressList *  al 
)
static

Add a list of Addresses to a dynamic array.

Parameters
[in,out]argsArray to add to
[in]alAddresses to add

Definition at line 270 of file sendmail.c.

271{
272 if (!al)
273 return;
274
275 struct Address *a = NULL;
276 TAILQ_FOREACH(a, al, entries)
277 {
278 add_args_one(args, a);
279 }
280}
#define TAILQ_FOREACH(var, head, field)
Definition: queue.h:725
static void add_args_one(struct SendmailArgArray *args, const struct Address *addr)
Add an Address to a dynamic array.
Definition: sendmail.c:256
An email address.
Definition: address.h:36
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_invoke_sendmail()

int mutt_invoke_sendmail ( struct Mailbox m,
struct AddressList *  from,
struct AddressList *  to,
struct AddressList *  cc,
struct AddressList *  bcc,
const char *  msg,
bool  eightbit,
struct ConfigSubset sub 
)

Run sendmail.

Parameters
mMailbox
fromThe sender
toRecipients
ccRecipients
bccRecipients
msgFile containing message
eightbitMessage contains 8bit chars
subConfig Subset
Return values
0Success
-1Failure
See also
$inews, nntp_format_str()

Definition at line 297 of file sendmail.c.

301{
302 char *ps = NULL, *path = NULL, *s = NULL, *childout = NULL;
303 struct SendmailArgArray args = ARRAY_HEAD_INITIALIZER;
304 struct SendmailArgArray extra_args = ARRAY_HEAD_INITIALIZER;
305 int i;
306
307#ifdef USE_NNTP
308 if (OptNewsSend)
309 {
310 char cmd[1024] = { 0 };
311
312 const char *const c_inews = cs_subset_string(sub, "inews");
313 mutt_expando_format(cmd, sizeof(cmd), 0, sizeof(cmd), NONULL(c_inews),
315 if (*cmd == '\0')
316 {
317 i = nntp_post(m, msg);
318 unlink(msg);
319 return i;
320 }
321
322 s = mutt_str_dup(cmd);
323 }
324 else
325#endif
326 {
327 const char *const c_sendmail = cs_subset_string(sub, "sendmail");
328 s = mutt_str_dup(c_sendmail);
329 }
330
331 if (!s)
332 {
333 mutt_error(_("$sendmail must be set in order to send mail"));
334 return -1;
335 }
336
337 ps = s;
338 i = 0;
339 while ((ps = strtok(ps, " ")))
340 {
341 if (i)
342 {
343 if (mutt_str_equal(ps, "--"))
344 break;
345 ARRAY_ADD(&args, ps);
346 }
347 else
348 {
349 path = mutt_str_dup(ps);
350 ps = strrchr(ps, '/');
351 if (ps)
352 ps++;
353 else
354 ps = path;
355 ARRAY_ADD(&args, ps);
356 }
357 ps = NULL;
358 i++;
359 }
360
361#ifdef USE_NNTP
362 if (!OptNewsSend)
363 {
364#endif
365 /* If $sendmail contained a "--", we save the recipients to append to
366 * args after other possible options added below. */
367 if (ps)
368 {
369 ps = NULL;
370 while ((ps = strtok(ps, " ")))
371 {
372 ARRAY_ADD(&extra_args, ps);
373 ps = NULL;
374 }
375 }
376
377 const bool c_use_8bit_mime = cs_subset_bool(sub, "use_8bit_mime");
378 if (eightbit && c_use_8bit_mime)
379 ARRAY_ADD(&args, "-B8BITMIME");
380
381 const bool c_use_envelope_from = cs_subset_bool(sub, "use_envelope_from");
382 if (c_use_envelope_from)
383 {
384 const struct Address *c_envelope_from_address = cs_subset_address(sub, "envelope_from_address");
385 if (c_envelope_from_address)
386 {
387 ARRAY_ADD(&args, "-f");
388 add_args_one(&args, c_envelope_from_address);
389 }
390 else if (!TAILQ_EMPTY(from) && !TAILQ_NEXT(TAILQ_FIRST(from), entries))
391 {
392 ARRAY_ADD(&args, "-f");
393 add_args(&args, from);
394 }
395 }
396
397 const char *const c_dsn_notify = cs_subset_string(sub, "dsn_notify");
398 if (c_dsn_notify)
399 {
400 ARRAY_ADD(&args, "-N");
401 ARRAY_ADD(&args, c_dsn_notify);
402 }
403
404 const char *const c_dsn_return = cs_subset_string(sub, "dsn_return");
405 if (c_dsn_return)
406 {
407 ARRAY_ADD(&args, "-R");
408 ARRAY_ADD(&args, c_dsn_return);
409 }
410 ARRAY_ADD(&args, "--");
411 const char **e = NULL;
412 ARRAY_FOREACH(e, &extra_args)
413 {
414 ARRAY_ADD(&args, *e);
415 }
416 add_args(&args, to);
417 add_args(&args, cc);
418 add_args(&args, bcc);
419#ifdef USE_NNTP
420 }
421#endif
422
423 ARRAY_ADD(&args, NULL);
424
425 const short c_sendmail_wait = cs_subset_number(sub, "sendmail_wait");
426 i = send_msg(path, &args, msg, OptNoCurses ? NULL : &childout, c_sendmail_wait);
427
428 /* Some user's $sendmail command uses gpg for password decryption,
429 * and is set up to prompt using ncurses pinentry. If we
430 * mutt_endwin() it leaves other users staring at a blank screen.
431 * So instead, just force a hard redraw on the next refresh. */
432 if (!OptNoCurses)
433 {
435 }
436
437 if (i != (EX_OK & 0xff))
438 {
439 if (i != S_BKG)
440 {
441 const char *e = mutt_str_sysexit(i);
442 mutt_error(_("Error sending message, child exited %d (%s)"), i, NONULL(e));
443 if (childout)
444 {
445 struct stat st = { 0 };
446
447 if ((stat(childout, &st) == 0) && (st.st_size > 0))
448 {
449 struct PagerData pdata = { 0 };
450 struct PagerView pview = { &pdata };
451
452 pdata.fname = childout;
453
454 pview.banner = _("Output of the delivery process");
456 pview.mode = PAGER_MODE_OTHER;
457
458 mutt_do_pager(&pview, NULL);
459 }
460 }
461 }
462 }
463 else if (childout)
464 {
465 unlink(childout);
466 }
467
468 FREE(&childout);
469 FREE(&path);
470 FREE(&s);
471 ARRAY_FREE(&args);
472 ARRAY_FREE(&extra_args);
473
474 if (i == (EX_OK & 0xff))
475 i = 0;
476 else if (i == S_BKG)
477 i = 1;
478 else
479 i = -1;
480 return i;
481}
#define ARRAY_FOREACH(elem, head)
Iterate over all elements of the array.
Definition: array.h:211
#define ARRAY_FREE(head)
Release all memory.
Definition: array.h:203
#define ARRAY_HEAD_INITIALIZER
Static initializer for arrays.
Definition: array.h:57
const char * cs_subset_string(const struct ConfigSubset *sub, const char *name)
Get a string config item by name.
Definition: helpers.c:292
short cs_subset_number(const struct ConfigSubset *sub, const char *name)
Get a number config item by name.
Definition: helpers.c:144
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition: helpers.c:48
const struct Address * cs_subset_address(const struct ConfigSubset *sub, const char *name)
Get an Address config item by name.
Definition: config_type.c:262
void mutt_need_hard_redraw(void)
Force a hard refresh.
Definition: curs_lib.c:101
int mutt_do_pager(struct PagerView *pview, struct Email *e)
Display some page-able text to the user (help or attachment)
Definition: do_pager.c:123
#define MUTT_FORMAT_NO_FLAGS
No flags are set.
Definition: format_flags.h:30
bool OptNoCurses
(pseudo) when sending in batch mode
Definition: globals.c:79
bool OptNewsSend
(pseudo) used to change behavior when posting
Definition: globals.c:77
const char * nntp_format_str(char *buf, size_t buflen, size_t col, int cols, char op, const char *src, const char *prec, const char *if_str, const char *else_str, intptr_t data, MuttFormatFlags flags)
Expand the newsrc filename - Implements format_t -.
Definition: newsrc.c:927
void mutt_expando_format(char *buf, size_t buflen, size_t col, int cols, const char *src, format_t callback, intptr_t data, MuttFormatFlags flags)
Expand expandos (x) in a string -.
Definition: muttlib.c:745
#define mutt_error(...)
Definition: logging2.h:92
#define _(a)
Definition: message.h:28
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition: string.c:251
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition: string.c:798
const char * mutt_str_sysexit(int err_num)
Return a string matching an error code.
Definition: string.c:167
int nntp_post(struct Mailbox *m, const char *msg)
Post article.
Definition: nntp.c:1901
#define MUTT_PAGER_NO_FLAGS
No flags are set.
Definition: lib.h:59
@ PAGER_MODE_OTHER
Pager is invoked via 3rd path. Non-email content is likely to be shown.
Definition: lib.h:141
#define TAILQ_FIRST(head)
Definition: queue.h:723
#define TAILQ_NEXT(elm, field)
Definition: queue.h:832
#define TAILQ_EMPTY(head)
Definition: queue.h:721
static void add_args(struct SendmailArgArray *args, struct AddressList *al)
Add a list of Addresses to a dynamic array.
Definition: sendmail.c:270
static int send_msg(const char *path, struct SendmailArgArray *args, const char *msg, char **tempfile, int wait_time)
Invoke sendmail in a subshell.
Definition: sendmail.c:90
#define NONULL(x)
Definition: string2.h:37
Data to be displayed by PagerView.
Definition: lib.h:160
const char * fname
Name of the file to read.
Definition: lib.h:164
Paged view into some data.
Definition: lib.h:171
struct PagerData * pdata
Data that pager displays. NOTNULL.
Definition: lib.h:172
enum PagerMode mode
Pager mode.
Definition: lib.h:173
PagerFlags flags
Additional settings to tweak pager's function.
Definition: lib.h:174
const char * banner
Title to display in status bar.
Definition: lib.h:175
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

Variable Documentation

◆ environ

char** environ
extern

◆ SigAlrm

SIG_ATOMIC_VOLATILE_T SigAlrm
static

true after SIGALRM is received

Definition at line 64 of file sendmail.c.