external.c File Reference

Manage where the email is piped to external commands. More...

#include "config.h"
#include <limits.h>
#include <stdbool.h>
#include <stdio.h>
#include <sys/stat.h>
#include <sys/types.h>
#include "mutt/lib.h"
#include "address/lib.h"
#include "config/lib.h"
#include "email/lib.h"
#include "core/lib.h"
#include "alias/lib.h"
#include "gui/lib.h"
#include "mutt.h"
#include "external.h"
#include "attach/lib.h"
#include "browser/lib.h"
#include "complete/lib.h"
#include "editor/lib.h"
#include "history/lib.h"
#include "hooks/lib.h"
#include "imap/lib.h"
#include "ncrypt/lib.h"
#include "parse/lib.h"
#include "progress/lib.h"
#include "question/lib.h"
#include "send/lib.h"
#include "globals.h"
#include "mutt_logging.h"
#include "mutt_mailbox.h"
#include "muttlib.h"
#include "mx.h"
#include "notmuch/lib.h"
#include <libintl.h>

Include dependency graph for external.c:

Go to the source code of this file.

Functions
void	external_cleanup (void)
	Clean up commands globals.
void	index_bounce_message (struct Mailbox *m, struct EmailArray *ea)
	Bounce an email.
static void	pipe_set_flags (bool decode, bool print, CopyMessageFlags *cmflags, CopyHeaderFlags *chflags)
	Generate flags for copy header/message.
static void	pipe_msg (struct Mailbox *m, struct Email *e, struct Message *msg, FILE *fp, bool decode, bool print)
	Pipe a message.
static int	pipe_message (struct Mailbox *m, struct EmailArray *ea, const char *cmd, bool decode, bool print, bool split, const char *sep)
	Pipe message to a command.
void	mutt_pipe_message (struct Mailbox *m, struct EmailArray *ea)
	Pipe a message.
bool	mutt_print_message (struct Mailbox *m, struct EmailArray *ea)
	Print a message.
bool	mutt_select_sort (bool reverse)
	Ask the user for a sort method.
bool	mutt_shell_escape (void)
	Invoke a command in a subshell.
void	mutt_enter_command (struct MuttWindow *win)
	Enter a neomutt command.
void	mutt_display_address (struct Envelope *env)
	Display the address of a message.
static void	set_copy_flags (struct Email *e, enum MessageTransformOpt transform_opt, CopyMessageFlags *cmflags, CopyHeaderFlags *chflags)
	Set the flags for a message copy.
int	mutt_save_message_mbox (struct Mailbox *m_src, struct Email *e, enum MessageSaveOpt save_opt, enum MessageTransformOpt transform_opt, struct Mailbox *m_dst)
	Save a message to a given mailbox.
int	mutt_save_message (struct Mailbox *m, struct EmailArray *ea, enum MessageSaveOpt save_opt, enum MessageTransformOpt transform_opt)
	Save an email.
bool	mutt_edit_content_type (struct Email *e, struct Body *b, FILE *fp)
	Edit the content type of an attachment.
static bool	check_traditional_pgp (struct Mailbox *m, struct Email *e)
	Check for an inline PGP content.
bool	mutt_check_traditional_pgp (struct Mailbox *m, struct EmailArray *ea)
	Check if a message has inline PGP content.

Variables
static struct Buffer	LastSaveFolder = { 0 }
	The folder the user last saved to. Used by ci_save_message().

Detailed Description

Manage where the email is piped to external commands.

Authors

• Richard Russon
• Pietro Cerutti
• Eric Blake
• Ihor Antonov

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

Function Documentation

external_cleanup()

void external_cleanup

(

void

)

Clean up commands globals.

Definition at line 77 of file external.c.

{
  buf_dealloc(&LastSaveFolder);
}

Here is the call graph for this function:

Here is the caller graph for this function:

index_bounce_message()

void index_bounce_message	(	struct Mailbox *	m,
		struct EmailArray *	ea )

Bounce an email.

Parameters

m	Mailbox
ea	Array of Emails to bounce

Definition at line 87 of file external.c.

{
  if (!m || !ea || ARRAY_EMPTY(ea))
    return;
 
  struct Buffer *buf = buf_pool_get();
  struct Buffer *prompt = buf_pool_get();
  struct AddressList al = TAILQ_HEAD_INITIALIZER(al);
  char *err = NULL;
  int rc;
  int msg_count = 0;
 
  struct Email **ep = NULL;
  ARRAY_FOREACH(ep, ea)
  {
    struct Email *e = *ep;
    /* RFC5322 mandates a From: header,
     * so warn before bouncing messages without one */
    if (TAILQ_EMPTY(&e->env->from))
      mutt_error(_("Warning: message contains no From: header"));
 
    msg_count++;
  }
 
  if (msg_count == 1)
    buf_strcpy(prompt, _("Bounce message to: "));
  else
    buf_strcpy(prompt, _("Bounce tagged messages to: "));
 
  rc = mw_get_field(buf_string(prompt), buf, MUTT_COMP_NONE, HC_ALIAS,
                    &CompleteAliasOps, NULL);
  if ((rc != 0) || buf_is_empty(buf))
    goto done;
 
  mutt_addrlist_parse2(&al, buf_string(buf));
  if (TAILQ_EMPTY(&al))
  {
    mutt_error(_("Error parsing address"));
    goto done;
  }
 
  mutt_expand_aliases(&al);
 
  if (mutt_addrlist_to_intl(&al, &err) < 0)
  {
    mutt_error(_("Bad IDN: '%s'"), err);
    FREE(&err);
    goto done;
  }
 
  buf_reset(buf);
  mutt_addrlist_write(&al, buf, true);
 
  buf_printf(prompt, ngettext("Bounce message to %s?", "Bounce messages to %s?", msg_count),
             buf_string(buf));
 
  if (query_quadoption(buf_string(prompt), NeoMutt->sub, "bounce") != MUTT_YES)
  {
    msgwin_clear_text(NULL);
    mutt_message(ngettext("Message not bounced", "Messages not bounced", msg_count));
    goto done;
  }
 
  msgwin_clear_text(NULL);
 
  struct Message *msg = NULL;
  ARRAY_FOREACH(ep, ea)
  {
    struct Email *e = *ep;
    msg = mx_msg_open(m, e);
    if (!msg)
    {
      rc = -1;
      break;
    }
 
    rc = mutt_bounce_message(msg->fp, m, e, &al, NeoMutt->sub);
    mx_msg_close(m, &msg);
 
    if (rc < 0)
      break;
  }
 
  /* If no error, or background, display message. */
  if ((rc == 0) || (rc == S_BKG))
    mutt_message(ngettext("Message bounced", "Messages bounced", msg_count));
 
done:
  mutt_addrlist_clear(&al);
  buf_pool_release(&buf);
  buf_pool_release(&prompt);
}

Here is the call graph for this function:

Here is the caller graph for this function:

pipe_set_flags()

void pipe_set_flags ( bool decode, bool print, CopyMessageFlags * cmflags, CopyHeaderFlags * chflags )

static

Generate flags for copy header/message.

Parameters

[in]	decode	If true decode the message
[in]	print	If true, mark the message for printing
[out]	cmflags	Flags, see CopyMessageFlags
[out]	chflags	Flags, see CopyHeaderFlags

Definition at line 187 of file external.c.

{
  if (decode)
  {
    *chflags |= CH_DECODE | CH_REORDER;
    *cmflags |= MUTT_CM_DECODE | MUTT_CM_CHARCONV;
 
    const bool c_print_decode_weed = cs_subset_bool(NeoMutt->sub, "print_decode_weed");
    const bool c_pipe_decode_weed = cs_subset_bool(NeoMutt->sub, "pipe_decode_weed");
    if (print ? c_print_decode_weed : c_pipe_decode_weed)
    {
      *chflags |= CH_WEED;
      *cmflags |= MUTT_CM_WEED;
    }
 
    /* Just as with copy-decode, we need to update the mime fields to avoid
     * confusing programs that may process the email.  However, we don't want
     * to force those fields to appear in printouts. */
    if (!print)
      *chflags |= CH_MIME | CH_TXTPLAIN;
  }
 
  if (print)
    *cmflags |= MUTT_CM_PRINTING;
}

Here is the call graph for this function:

Here is the caller graph for this function:

pipe_msg()

void pipe_msg ( struct Mailbox * m, struct Email * e, struct Message * msg, FILE * fp, bool decode, bool print )

static

Pipe a message.

Parameters

m	Mailbox
e	Email to pipe
msg	Message
fp	File to write to
decode	If true, decode the message
print	If true, message is for printing

Definition at line 223 of file external.c.

{
  CopyMessageFlags cmflags = MUTT_CM_NONE;
  CopyHeaderFlags chflags = CH_FROM;
 
  pipe_set_flags(decode, print, &cmflags, &chflags);
 
  if ((WithCrypto != 0) && decode && e->security & SEC_ENCRYPT)
  {
    if (!crypt_valid_passphrase(e->security))
      return;
    mutt_endwin();
  }
 
  const bool own_msg = !msg;
  if (own_msg)
  {
    msg = mx_msg_open(m, e);
    if (!msg)
    {
      return;
    }
  }
 
  if (decode)
  {
    mutt_parse_mime_message(e, msg->fp);
  }
 
  mutt_copy_message(fp, e, msg, cmflags, chflags, 0);
 
  if (own_msg)
  {
    mx_msg_close(m, &msg);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

pipe_message()

int pipe_message ( struct Mailbox * m, struct EmailArray * ea, const char * cmd, bool decode, bool print, bool split, const char * sep )

static

Pipe message to a command.

Parameters

m	Mailbox
ea	Array of Emails to pipe
cmd	Command to pipe to
decode	Should the message be decrypted
print	True if this is a print job
split	Should a separator be sent between messages?
sep	Separator string

Return values

0	Success
1	Error

The following code is shared between printing and piping.

Definition at line 275 of file external.c.

{
  if (!m || !ea || ARRAY_EMPTY(ea))
    return 1;
 
  int rc = 0;
  pid_t pid;
  FILE *fp_out = NULL;
 
  if (ARRAY_SIZE(ea) == 1)
  {
    struct Email *e = *ARRAY_GET(ea, 0);
    /* handle a single message */
    exec_message_hook(m, e, CMD_MESSAGE_HOOK);
 
    struct Message *msg = mx_msg_open(m, e);
    if (msg && (WithCrypto != 0) && decode)
    {
      mutt_parse_mime_message(e, msg->fp);
      if ((e->security & SEC_ENCRYPT) && !crypt_valid_passphrase(e->security))
      {
        mx_msg_close(m, &msg);
        return 1;
      }
    }
    mutt_endwin();
 
    pid = filter_create(cmd, &fp_out, NULL, NULL, NeoMutt->env);
    if (pid < 0)
    {
      mutt_perror(_("Can't create filter process"));
      mx_msg_close(m, &msg);
      return 1;
    }
 
    OptKeepQuiet = true;
    pipe_msg(m, e, msg, fp_out, decode, print);
    mx_msg_close(m, &msg);
    mutt_file_fclose(&fp_out);
    rc = filter_wait(pid);
    OptKeepQuiet = false;
  }
  else
  {
    /* handle tagged messages */
    if ((WithCrypto != 0) && decode)
    {
      struct Email **ep = NULL;
      ARRAY_FOREACH(ep, ea)
      {
        struct Email *e = *ep;
        struct Message *msg = mx_msg_open(m, e);
        if (msg)
        {
          mutt_parse_mime_message(e, msg->fp);
          exec_message_hook(m, e, CMD_MESSAGE_HOOK);
          mx_msg_close(m, &msg);
        }
        if ((e->security & SEC_ENCRYPT) && !crypt_valid_passphrase(e->security))
        {
          return 1;
        }
      }
    }
 
    if (split)
    {
      struct Email **ep = NULL;
      ARRAY_FOREACH(ep, ea)
      {
        struct Email *e = *ep;
        exec_message_hook(m, e, CMD_MESSAGE_HOOK);
        mutt_endwin();
        pid = filter_create(cmd, &fp_out, NULL, NULL, NeoMutt->env);
        if (pid < 0)
        {
          mutt_perror(_("Can't create filter process"));
          return 1;
        }
        OptKeepQuiet = true;
        pipe_msg(m, e, NULL, fp_out, decode, print);
        /* add the message separator */
        if (sep)
          fputs(sep, fp_out);
        mutt_file_fclose(&fp_out);
        if (filter_wait(pid) != 0)
          rc = 1;
        OptKeepQuiet = false;
      }
    }
    else
    {
      mutt_endwin();
      pid = filter_create(cmd, &fp_out, NULL, NULL, NeoMutt->env);
      if (pid < 0)
      {
        mutt_perror(_("Can't create filter process"));
        return 1;
      }
      OptKeepQuiet = true;
      struct Email **ep = NULL;
      ARRAY_FOREACH(ep, ea)
      {
        struct Email *e = *ep;
        exec_message_hook(m, e, CMD_MESSAGE_HOOK);
        pipe_msg(m, e, NULL, fp_out, decode, print);
        /* add the message separator */
        if (sep)
          fputs(sep, fp_out);
      }
      mutt_file_fclose(&fp_out);
      if (filter_wait(pid) != 0)
        rc = 1;
      OptKeepQuiet = false;
    }
  }
 
  const bool c_wait_key = cs_subset_bool(NeoMutt->sub, "wait_key");
  if ((rc != 0) || c_wait_key)
    mutt_any_key_to_continue(NULL);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_pipe_message()

void mutt_pipe_message	(	struct Mailbox *	m,
		struct EmailArray *	ea )

Pipe a message.

Parameters

m	Mailbox
ea	Array of Emails to pipe

Definition at line 404 of file external.c.

{
  if (!m || !ea)
    return;
 
  struct Buffer *buf = buf_pool_get();
 
  if (mw_get_field(_("Pipe to command: "), buf, MUTT_COMP_NONE, HC_EXT_COMMAND,
                   &CompleteFileOps, NULL) != 0)
  {
    goto cleanup;
  }
 
  if (buf_is_empty(buf))
    goto cleanup;
 
  expand_path(buf, false);
  const bool c_pipe_decode = cs_subset_bool(NeoMutt->sub, "pipe_decode");
  const bool c_pipe_split = cs_subset_bool(NeoMutt->sub, "pipe_split");
  const char *const c_pipe_sep = cs_subset_string(NeoMutt->sub, "pipe_sep");
  pipe_message(m, ea, buf_string(buf), c_pipe_decode, false, c_pipe_split, c_pipe_sep);
 
cleanup:
  buf_pool_release(&buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_print_message()

bool mutt_print_message	(	struct Mailbox *	m,
		struct EmailArray *	ea )

Print a message.

Parameters

m	Mailbox
ea	Array of Emails to print

Return values

true	The messages were printed
false	Printing was cancelled or failed

Definition at line 437 of file external.c.

{
  if (!m || !ea)
    return false;
 
  const enum QuadOption c_print = cs_subset_quad(NeoMutt->sub, "print");
  const char *const c_print_command = cs_subset_string(NeoMutt->sub, "print_command");
  if (c_print && !c_print_command)
  {
    mutt_message(_("No printing command has been defined"));
    return false;
  }
 
  int msg_count = ARRAY_SIZE(ea);
  const char *msg = ngettext("Print message?", "Print tagged messages?", msg_count);
  if (query_quadoption(msg, NeoMutt->sub, "print") != MUTT_YES)
  {
    return false;
  }
 
  const bool c_print_decode = cs_subset_bool(NeoMutt->sub, "print_decode");
  const bool c_print_split = cs_subset_bool(NeoMutt->sub, "print_split");
  if (pipe_message(m, ea, c_print_command, c_print_decode, true, c_print_split, "\f") == 0)
  {
    mutt_message(ngettext("Message printed", "Messages printed", msg_count));
    return true;
  }
 
  mutt_message(ngettext("Message could not be printed",
                        "Messages could not be printed", msg_count));
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_select_sort()

bool mutt_select_sort

(

bool

reverse

)

Ask the user for a sort method.

Parameters

reverse

If true make it a reverse sort

Return values

true	The sort type changed

Definition at line 475 of file external.c.

{
  enum EmailSortType sort = EMAIL_SORT_DATE;
 
  switch (mw_multi_choice(reverse ?
                              /* L10N: The highlighted letters must match the "Sort" options */
                              _("Rev-Sort (d)ate,(f)rm,(r)ecv,(s)ubj,t(o),(t)hread,(u)nsort,si(z)e,s(c)ore,s(p)am,(l)abel?") :
                              /* L10N: The highlighted letters must match the "Rev-Sort" options */
                              _("Sort (d)ate,(f)rm,(r)ecv,(s)ubj,t(o),(t)hread,(u)nsort,si(z)e,s(c)ore,s(p)am,(l)abel?"),
                          /* L10N: These must match the highlighted letters from "Sort" and "Rev-Sort" */
                          _("dfrsotuzcpl")))
  {
    case -1: /* abort - don't resort */
      return false;
 
    case 1: /* (d)ate */
      sort = EMAIL_SORT_DATE;
      break;
 
    case 2: /* (f)rm */
      sort = EMAIL_SORT_FROM;
      break;
 
    case 3: /* (r)ecv */
      sort = EMAIL_SORT_DATE_RECEIVED;
      break;
 
    case 4: /* (s)ubj */
      sort = EMAIL_SORT_SUBJECT;
      break;
 
    case 5: /* t(o) */
      sort = EMAIL_SORT_TO;
      break;
 
    case 6: /* (t)hread */
      sort = EMAIL_SORT_THREADS;
      break;
 
    case 7: /* (u)nsort */
      sort = EMAIL_SORT_UNSORTED;
      break;
 
    case 8: /* si(z)e */
      sort = EMAIL_SORT_SIZE;
      break;
 
    case 9: /* s(c)ore */
      sort = EMAIL_SORT_SCORE;
      break;
 
    case 10: /* s(p)am */
      sort = EMAIL_SORT_SPAM;
      break;
 
    case 11: /* (l)abel */
      sort = EMAIL_SORT_LABEL;
      break;
 
    default:
      return false;
  }
 
  const unsigned char c_use_threads = cs_subset_enum(NeoMutt->sub, "use_threads");
  const enum EmailSortType c_sort = cs_subset_sort(NeoMutt->sub, "sort");
  int rc = CSR_ERR_CODE;
  if ((sort != EMAIL_SORT_THREADS) || (c_use_threads == UT_UNSET))
  {
    if ((sort != EMAIL_SORT_THREADS) && (c_sort & SORT_LAST))
      sort |= SORT_LAST;
    if (reverse)
      sort |= SORT_REVERSE;
 
    rc = cs_subset_str_native_set(NeoMutt->sub, "sort", sort, NULL);
  }
  else
  {
    ASSERT((c_sort & SORT_MASK) != EMAIL_SORT_THREADS); /* See index_config_observer() */
    /* Preserve the value of $sort, and toggle whether we are threaded. */
    switch (c_use_threads)
    {
      case UT_FLAT:
        rc = cs_subset_str_native_set(NeoMutt->sub, "use_threads",
                                      reverse ? UT_REVERSE : UT_THREADS, NULL);
        break;
      case UT_THREADS:
        rc = cs_subset_str_native_set(NeoMutt->sub, "use_threads",
                                      reverse ? UT_REVERSE : UT_FLAT, NULL);
        break;
      case UT_REVERSE:
        rc = cs_subset_str_native_set(NeoMutt->sub, "use_threads",
                                      reverse ? UT_FLAT : UT_THREADS, NULL);
        break;
      default:
        ASSERT(false);
    }
  }
 
  return ((CSR_RESULT(rc) == CSR_SUCCESS) && !(rc & CSR_SUC_NO_CHANGE));
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_shell_escape()

bool mutt_shell_escape

(

void

)

Invoke a command in a subshell.

Return values

true	A command was invoked (no matter what its result)
false	No command was invoked

Definition at line 581 of file external.c.

{
  bool rc = false;
  struct Buffer *buf = buf_pool_get();
 
  if (mw_get_field(_("Shell command: "), buf, MUTT_COMP_NONE, HC_EXT_COMMAND,
                   &CompleteFileOps, NULL) != 0)
  {
    goto done;
  }
 
  if (buf_is_empty(buf))
  {
    const char *const c_shell = cs_subset_string(NeoMutt->sub, "shell");
    buf_strcpy(buf, c_shell);
  }
 
  if (buf_is_empty(buf))
  {
    goto done;
  }
 
  msgwin_clear_text(NULL);
  mutt_endwin();
  fflush(stdout);
  int rc2 = mutt_system(buf_string(buf));
  if (rc2 == -1)
    mutt_debug(LL_DEBUG1, "Error running \"%s\"\n", buf_string(buf));
 
  const bool c_wait_key = cs_subset_bool(NeoMutt->sub, "wait_key");
  if ((rc2 != 0) || c_wait_key)
    mutt_any_key_to_continue(NULL);
 
  rc = true;
done:
  buf_pool_release(&buf);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_enter_command()

void mutt_enter_command

(

struct MuttWindow *

win

)

Enter a neomutt command.

Parameters

win	Focused Window

Definition at line 624 of file external.c.

{
  struct Buffer *buf = buf_pool_get();
  struct ParseContext *pc = parse_context_new();
  struct ParseError *pe = parse_error_new();
 
  window_redraw(NULL);
 
  /* if enter is pressed after : with no command, just return */
  struct FileCompletionData cdata = { false, NULL, NULL, NULL, win };
  if ((mw_get_field(":", buf, MUTT_COMP_NONE, HC_NEO_COMMAND, &CompleteCommandOps, &cdata) != 0) ||
      buf_is_empty(buf))
  {
    goto done;
  }
 
  enum CommandResult rc = parse_rc_line(buf, pc, pe);
  if (!buf_is_empty(pe->message))
  {
    if (rc == MUTT_CMD_SUCCESS) /* command succeeded with message */
      mutt_message("%s", buf_string(pe->message));
    else if (rc == MUTT_CMD_ERROR)
      mutt_error("%s", buf_string(pe->message));
    else if (rc == MUTT_CMD_WARNING)
      mutt_warning("%s", buf_string(pe->message));
  }
 
  if (NeoMutt)
  {
    // Running commands could cause anything to change, so let others know
    notify_send(NeoMutt->notify, NT_GLOBAL, NT_GLOBAL_COMMAND, NULL);
  }
 
done:
  buf_pool_release(&buf);
  parse_context_free(&pc);
  parse_error_free(&pe);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_display_address()

void mutt_display_address

(

struct Envelope *

env

)

Display the address of a message.

Parameters

env	Envelope containing address

Definition at line 667 of file external.c.

{
  const char *pfx = NULL;
 
  struct AddressList *al = mutt_get_address(env, &pfx);
  if (!al)
    return;
 
  /* Note: We don't convert IDNA to local representation this time.
   * That is intentional, so the user has an opportunity to copy &
   * paste the on-the-wire form of the address to other, IDN-unable
   * software.  */
  struct Buffer *buf = buf_pool_get();
  mutt_addrlist_write(al, buf, false);
  mutt_message("%s: %s", pfx, buf_string(buf));
  buf_pool_release(&buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

set_copy_flags()

void set_copy_flags ( struct Email * e, enum MessageTransformOpt transform_opt, CopyMessageFlags * cmflags, CopyHeaderFlags * chflags )

static

Set the flags for a message copy.

Parameters

[in]	e	Email
[in]	transform_opt	Transformation, e.g. TRANSFORM_DECRYPT
[out]	cmflags	Flags, see CopyMessageFlags
[out]	chflags	Flags, see CopyHeaderFlags

Definition at line 692 of file external.c.

{
  *cmflags = MUTT_CM_NONE;
  *chflags = CH_UPDATE_LEN;
 
  const bool need_decrypt = (transform_opt == TRANSFORM_DECRYPT) &&
                            (e->security & SEC_ENCRYPT);
  const bool want_pgp = (WithCrypto & APPLICATION_PGP);
  const bool want_smime = (WithCrypto & APPLICATION_SMIME);
  const bool is_pgp = mutt_is_application_pgp(e->body) & SEC_ENCRYPT;
  const bool is_smime = mutt_is_application_smime(e->body) & SEC_ENCRYPT;
 
  if (need_decrypt && want_pgp && mutt_is_multipart_encrypted(e->body))
  {
    *chflags = CH_NONEWLINE | CH_XMIT | CH_MIME;
    *cmflags = MUTT_CM_DECODE_PGP;
  }
  else if (need_decrypt && want_pgp && is_pgp)
  {
    *chflags = CH_XMIT | CH_MIME | CH_TXTPLAIN;
    *cmflags = MUTT_CM_DECODE | MUTT_CM_CHARCONV;
  }
  else if (need_decrypt && want_smime && is_smime)
  {
    *chflags = CH_NONEWLINE | CH_XMIT | CH_MIME;
    *cmflags = MUTT_CM_DECODE_SMIME;
  }
  else if (transform_opt == TRANSFORM_DECODE)
  {
    *chflags = CH_XMIT | CH_MIME | CH_TXTPLAIN | CH_DECODE; // then decode RFC2047
    *cmflags = MUTT_CM_DECODE | MUTT_CM_CHARCONV;
    const bool c_copy_decode_weed = cs_subset_bool(NeoMutt->sub, "copy_decode_weed");
    if (c_copy_decode_weed)
    {
      *chflags |= CH_WEED; // and respect $weed
      *cmflags |= MUTT_CM_WEED;
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_save_message_mbox()

int mutt_save_message_mbox	(	struct Mailbox *	m_src,
		struct Email *	e,
		enum MessageSaveOpt	save_opt,
		enum MessageTransformOpt	transform_opt,
		struct Mailbox *	m_dst )

Save a message to a given mailbox.

Parameters

m_src	Mailbox to copy from
e	Email
save_opt	Copy or move, e.g. SAVE_MOVE
transform_opt	Transformation, e.g. TRANSFORM_DECRYPT
m_dst	Mailbox to save to

Return values

0	Success
-1	Error

Definition at line 743 of file external.c.

{
  CopyMessageFlags cmflags = MUTT_CM_NONE;
  CopyHeaderFlags chflags = CH_NONE;
  int rc;
 
  set_copy_flags(e, transform_opt, &cmflags, &chflags);
 
  struct Message *msg = mx_msg_open(m_src, e);
  if (msg && transform_opt != TRANSFORM_NONE)
  {
    mutt_parse_mime_message(e, msg->fp);
  }
 
  rc = mutt_append_message(m_dst, m_src, e, msg, cmflags, chflags);
  mx_msg_close(m_src, &msg);
  if (rc != 0)
    return rc;
 
  if (save_opt == SAVE_MOVE)
  {
    mutt_set_flag(m_src, e, MUTT_DELETE, true, true);
    mutt_set_flag(m_src, e, MUTT_PURGE, true, true);
    const bool c_delete_untag = cs_subset_bool(NeoMutt->sub, "delete_untag");
    if (c_delete_untag)
      mutt_set_flag(m_src, e, MUTT_TAG, false, true);
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_save_message()

int mutt_save_message	(	struct Mailbox *	m,
		struct EmailArray *	ea,
		enum MessageSaveOpt	save_opt,
		enum MessageTransformOpt	transform_opt )

Save an email.

Parameters

m	Mailbox
ea	Array of Emails to save
save_opt	Copy or move, e.g. SAVE_MOVE
transform_opt	Transformation, e.g. TRANSFORM_DECRYPT

Return values

0	Copy/save was successful
-1	Error/abort

Definition at line 784 of file external.c.

{
  if (!ea || ARRAY_EMPTY(ea))
    return -1;
 
  int rc = -1;
  int tagged_progress_count = 0;
  unsigned int msg_count = ARRAY_SIZE(ea);
  struct Mailbox *m_save = NULL;
 
  struct Buffer *buf = buf_pool_get();
  struct stat st = { 0 };
  struct Email *e_cur = *ARRAY_GET(ea, 0);
 
  const SecurityFlags security_flags = WithCrypto ? e_cur->security : SEC_NONE;
  const bool is_passphrase_needed = security_flags & SEC_ENCRYPT;
 
  const char *prompt = NULL;
  const char *progress_msg = NULL;
 
  // Set prompt and progress_msg
  switch (save_opt)
  {
    case SAVE_COPY:
      // L10N: Progress meter message when copying tagged messages
      progress_msg = (msg_count > 1) ? _("Copying tagged messages...") : NULL;
      switch (transform_opt)
      {
        case TRANSFORM_NONE:
          prompt = (msg_count > 1) ? _("Copy tagged to mailbox") : _("Copy to mailbox");
          break;
        case TRANSFORM_DECRYPT:
          prompt = (msg_count > 1) ? _("Decrypt-copy tagged to mailbox") :
                                     _("Decrypt-copy to mailbox");
          break;
        case TRANSFORM_DECODE:
          prompt = (msg_count > 1) ? _("Decode-copy tagged to mailbox") :
                                     _("Decode-copy to mailbox");
          break;
      }
      break;
 
    case SAVE_MOVE:
      // L10N: Progress meter message when saving tagged messages
      progress_msg = (msg_count > 1) ? _("Saving tagged messages...") : NULL;
      switch (transform_opt)
      {
        case TRANSFORM_NONE:
          prompt = (msg_count > 1) ? _("Save tagged to mailbox") : _("Save to mailbox");
          break;
        case TRANSFORM_DECRYPT:
          prompt = (msg_count > 1) ? _("Decrypt-save tagged to mailbox") :
                                     _("Decrypt-save to mailbox");
          break;
        case TRANSFORM_DECODE:
          prompt = (msg_count > 1) ? _("Decode-save tagged to mailbox") :
                                     _("Decode-save to mailbox");
          break;
      }
      break;
  }
 
  exec_message_hook(m, e_cur, CMD_MESSAGE_HOOK);
  mutt_default_save(buf, e_cur);
  pretty_mailbox(buf);
 
  if (mw_enter_fname(prompt, buf, false, NULL, false, NULL, NULL, MUTT_SEL_NONE) == -1)
  {
    goto cleanup;
  }
 
  size_t pathlen = buf_len(buf);
  if (pathlen == 0)
    goto cleanup;
 
  mutt_path_tidy(buf, true);
 
  /* This is an undocumented feature of ELM pointed out to me by Felix von
   * Leitner <leitner@prz.fu-berlin.de> */
  if (buf_is_empty(&LastSaveFolder))
    buf_alloc(&LastSaveFolder, PATH_MAX);
  if (mutt_str_equal(buf_string(buf), "."))
    buf_copy(buf, &LastSaveFolder);
  else
    buf_strcpy(&LastSaveFolder, buf_string(buf));
 
  expand_path(buf, false);
 
  /* check to make sure that this file is really the one the user wants */
  if (mutt_save_confirm(buf_string(buf), &st) != 0)
    goto cleanup;
 
  if (is_passphrase_needed && (transform_opt != TRANSFORM_NONE) &&
      !crypt_valid_passphrase(security_flags))
  {
    rc = -1;
    goto errcleanup;
  }
 
  mutt_message(_("Copying to %s..."), buf_string(buf));
 
  enum MailboxType mailbox_type = imap_path_probe(buf_string(buf), NULL);
  if ((m->type == MUTT_IMAP) && (transform_opt == TRANSFORM_NONE) && (mailbox_type == MUTT_IMAP))
  {
    rc = imap_copy_messages(m, ea, buf_string(buf), save_opt);
    switch (rc)
    {
      /* success */
      case 0:
        mutt_clear_error();
        rc = 0;
        if (save_opt == SAVE_MOVE)
        {
          const bool c_delete_untag = cs_subset_bool(NeoMutt->sub, "delete_untag");
          if (c_delete_untag)
          {
            struct Email **ep = NULL;
            ARRAY_FOREACH(ep, ea)
            {
              mutt_set_flag(m, *ep, MUTT_TAG, false, true);
            }
          }
        }
        goto cleanup;
      /* non-fatal error: continue to fetch/append */
      case 1:
        break;
      /* fatal error, abort */
      case -1:
      default:
        goto errcleanup;
    }
  }
 
  mutt_file_resolve_symlink(buf);
  m_save = mx_path_resolve(buf_string(buf));
  bool old_append = m_save->append;
  OpenMailboxFlags mbox_flags = MUTT_APPEND;
  /* Display a tagged message progress counter, rather than (for
   * IMAP) a per-message progress counter */
  if (msg_count > 1)
    mbox_flags |= MUTT_QUIET;
  if (!mx_mbox_open(m_save, mbox_flags))
  {
    rc = -1;
    mailbox_free(&m_save);
    goto errcleanup;
  }
  m_save->append = true;
 
  /* If we're saving to a compressed mailbox, the stats won't be updated
   * until the next open.  Until then, improvise. */
  struct Mailbox *m_comp = NULL;
  if (m_save->compress_info)
  {
    m_comp = mailbox_find(m_save->realpath);
  }
  /* We probably haven't been opened yet */
  if (m_comp && (m_comp->msg_count == 0))
    m_comp = NULL;
 
  if (msg_count == 1)
  {
    rc = mutt_save_message_mbox(m, e_cur, save_opt, transform_opt, m_save);
    if (rc != 0)
    {
      mx_mbox_close(m_save);
      m_save->append = old_append;
      goto errcleanup;
    }
 
    if (m_comp)
    {
      m_comp->msg_count++;
      if (!e_cur->read)
      {
        m_comp->msg_unread++;
        if (!e_cur->old)
          m_comp->msg_new++;
      }
      if (e_cur->flagged)
        m_comp->msg_flagged++;
    }
  }
  else
  {
    rc = 0;
 
#ifdef USE_NOTMUCH
    if (m->type == MUTT_NOTMUCH)
      nm_db_longrun_init(m, true);
#endif
    struct Progress *progress = progress_new(MUTT_PROGRESS_WRITE, msg_count);
    progress_set_message(progress, "%s", progress_msg);
    struct Email **ep = NULL;
    ARRAY_FOREACH(ep, ea)
    {
      struct Email *e = *ep;
      progress_update(progress, ++tagged_progress_count, -1);
      exec_message_hook(m, e, CMD_MESSAGE_HOOK);
      rc = mutt_save_message_mbox(m, e, save_opt, transform_opt, m_save);
      if (rc != 0)
        break;
 
      if (m_comp)
      {
        struct Email *e2 = e;
        m_comp->msg_count++;
        if (!e2->read)
        {
          m_comp->msg_unread++;
          if (!e2->old)
            m_comp->msg_new++;
        }
        if (e2->flagged)
          m_comp->msg_flagged++;
      }
    }
    progress_free(&progress);
 
#ifdef USE_NOTMUCH
    if (m->type == MUTT_NOTMUCH)
      nm_db_longrun_done(m);
#endif
    if (rc != 0)
    {
      mx_mbox_close(m_save);
      m_save->append = old_append;
      goto errcleanup;
    }
  }
 
  const bool need_mailbox_cleanup = ((m_save->type == MUTT_MBOX) ||
                                     (m_save->type == MUTT_MMDF));
 
  mx_mbox_close(m_save);
  m_save->append = old_append;
 
  if (need_mailbox_cleanup)
    mailbox_restore_timestamp(buf_string(buf), &st);
 
  mutt_clear_error();
  rc = 0;
 
errcleanup:
  if (rc != 0)
  {
    switch (save_opt)
    {
      case SAVE_MOVE:
        if (msg_count > 1)
        {
          // L10N: Message when an index tagged save operation fails for some reason
          mutt_error(_("Error saving tagged messages"));
        }
        else
        {
          // L10N: Message when an index/pager save operation fails for some reason
          mutt_error(_("Error saving message"));
        }
        break;
      case SAVE_COPY:
        if (msg_count > 1)
        {
          // L10N: Message when an index tagged copy operation fails for some reason
          mutt_error(_("Error copying tagged messages"));
        }
        else
        {
          // L10N: Message when an index/pager copy operation fails for some reason
          mutt_error(_("Error copying message"));
        }
        break;
    }
  }
 
  mailbox_free(&m_save);
 
cleanup:
  buf_pool_release(&buf);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_edit_content_type()

bool mutt_edit_content_type	(	struct Email *	e,
		struct Body *	b,
		FILE *	fp )

Edit the content type of an attachment.

Parameters

e	Email
b	Attachment
fp	File handle to the attachment

Return values

true	A Any change is made

recvattach requires the return code to know when to regenerate the actx.

Definition at line 1077 of file external.c.

{
  struct Buffer *buf = buf_pool_get();
  struct Buffer *charset = buf_pool_get();
  struct Buffer *obuf = buf_pool_get();
  struct Buffer *tmp = buf_pool_get();
 
  bool rc = false;
  bool charset_changed = false;
  bool type_changed = false;
  bool structure_changed = false;
 
  char *cp = mutt_param_get(&b->parameter, "charset");
  buf_strcpy(charset, cp);
 
  buf_printf(buf, "%s/%s", BODY_TYPE(b), b->subtype);
  buf_copy(obuf, buf);
  if (!TAILQ_EMPTY(&b->parameter))
  {
    struct Parameter *np = NULL;
    TAILQ_FOREACH(np, &b->parameter, entries)
    {
      mutt_addr_cat(tmp->data, tmp->dsize, np->value, MimeSpecials);
      buf_add_printf(buf, "; %s=%s", np->attribute, buf_string(tmp));
    }
  }
 
  if ((mw_get_field("Content-Type: ", buf, MUTT_COMP_NONE, HC_OTHER, NULL, NULL) != 0) ||
      buf_is_empty(buf))
  {
    goto done;
  }
 
  /* clean up previous junk */
  mutt_param_free(&b->parameter);
  FREE(&b->subtype);
 
  mutt_parse_content_type(buf_string(buf), b);
 
  buf_printf(tmp, "%s/%s", BODY_TYPE(b), NONULL(b->subtype));
  type_changed = !mutt_istr_equal(buf_string(tmp), buf_string(obuf));
  charset_changed = !mutt_istr_equal(buf_string(charset),
                                     mutt_param_get(&b->parameter, "charset"));
 
  /* if in send mode, check for conversion - current setting is default. */
 
  if (!e && (b->type == TYPE_TEXT) && charset_changed)
  {
    buf_printf(tmp, _("Convert to %s upon sending?"),
               mutt_param_get(&b->parameter, "charset"));
    enum QuadOption ans = query_yesorno(buf_string(tmp), b->noconv ? MUTT_NO : MUTT_YES);
    if (ans != MUTT_ABORT)
      b->noconv = (ans == MUTT_NO);
  }
 
  /* inform the user */
 
  buf_printf(tmp, "%s/%s", BODY_TYPE(b), NONULL(b->subtype));
  if (type_changed)
    mutt_message(_("Content-Type changed to %s"), buf_string(tmp));
  if ((b->type == TYPE_TEXT) && charset_changed)
  {
    if (type_changed)
      mutt_sleep(1);
    mutt_message(b->noconv ? _("Character set changed to %s; not converting") :
                             _("Character set changed to %s; converting"),
                 mutt_param_get(&b->parameter, "charset"));
  }
 
  b->force_charset |= charset_changed;
 
  if (!is_multipart(b) && b->parts)
  {
    structure_changed = true;
    mutt_body_free(&b->parts);
  }
  if (!mutt_is_message_type(b->type, b->subtype) && b->email)
  {
    structure_changed = true;
    b->email->body = NULL;
    email_free(&b->email);
  }
 
  if (fp && !b->parts && (is_multipart(b) || mutt_is_message_type(b->type, b->subtype)))
  {
    structure_changed = true;
    mutt_parse_part(fp, b);
  }
 
  if ((WithCrypto != 0) && e)
  {
    if (e->body == b)
      e->security = SEC_NONE;
 
    e->security |= crypt_query(b);
  }
 
  rc = structure_changed | type_changed;
 
done:
  buf_pool_release(&buf);
  buf_pool_release(&charset);
  buf_pool_release(&obuf);
  buf_pool_release(&tmp);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

check_traditional_pgp()

bool check_traditional_pgp ( struct Mailbox * m, struct Email * e )

static

Check for an inline PGP content.

Parameters

m	Mailbox
e	Email to check

Return values

true	Message contains inline PGP content

Definition at line 1190 of file external.c.

{
  bool rc = false;
 
  e->security |= PGP_TRADITIONAL_CHECKED;
 
  struct Message *msg = mx_msg_open(m, e);
  if (msg)
  {
    mutt_parse_mime_message(e, msg->fp);
    if (crypt_pgp_check_traditional(msg->fp, e->body, false))
    {
      e->security = crypt_query(e->body);
      rc = true;
    }
 
    e->security |= PGP_TRADITIONAL_CHECKED;
    mx_msg_close(m, &msg);
  }
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_check_traditional_pgp()

bool mutt_check_traditional_pgp	(	struct Mailbox *	m,
		struct EmailArray *	ea )

Check if a message has inline PGP content.

Parameters

m	Mailbox
ea	Array of Emails to check

Return values

true	Message contains inline PGP content

Definition at line 1218 of file external.c.

{
  bool rc = false;
 
  struct Email **ep = NULL;
  ARRAY_FOREACH(ep, ea)
  {
    struct Email *e = *ep;
    if (!(e->security & PGP_TRADITIONAL_CHECKED))
      rc = check_traditional_pgp(m, e) || rc;
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

LastSaveFolder

struct Buffer LastSaveFolder = { 0 }

static

The folder the user last saved to. Used by ci_save_message().

Definition at line 72 of file external.c.

{ 0 };