mx.h File Reference

API for mailboxes. More...

#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include "config/lib.h"
#include "core/lib.h"

Include dependency graph for mx.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Macros
#define	MUTT_MSG_NO_FLAGS   0
	No flags are set. More...
#define	MUTT_ADD_FROM   (1 << 0)
	add a From_ line More...
#define	MUTT_SET_DRAFT   (1 << 1)
	set the message draft flag More...

Typedefs
typedef uint8_t	MsgOpenFlags
	Flags for mx_msg_open_new(), e.g. MUTT_ADD_FROM. More...

Functions
enum MxStatus	mx_mbox_check (struct Mailbox *m)
	Check for new mail - Wrapper for MxOps::mbox_check() More...
enum MxStatus	mx_mbox_check_stats (struct Mailbox *m, uint8_t flags)
	Check the statistics for a mailbox - Wrapper for MxOps::mbox_check_stats() More...
enum MxStatus	mx_mbox_close (struct Mailbox *m)
	Save changes and close mailbox. More...
bool	mx_mbox_open (struct Mailbox *m, OpenMailboxFlags flags)
	Open a mailbox and parse it. More...
enum MxStatus	mx_mbox_sync (struct Mailbox *m)
	Save changes to mailbox. More...
int	mx_msg_close (struct Mailbox *m, struct Message **msg)
	Close a message. More...
int	mx_msg_commit (struct Mailbox *m, struct Message *msg)
	Commit a message to a folder - Wrapper for MxOps::msg_commit() More...
struct Message *	mx_msg_open_new (struct Mailbox *m, const struct Email *e, MsgOpenFlags flags)
	Open a new message. More...
struct Message *	mx_msg_open (struct Mailbox *m, int msgno)
	Return a stream pointer for a message. More...
int	mx_msg_padding_size (struct Mailbox *m)
	Bytes of padding between messages - Wrapper for MxOps::msg_padding_size() More...
int	mx_save_hcache (struct Mailbox *m, struct Email *e)
	Save message to the header cache - Wrapper for MxOps::msg_save_hcache() More...
int	mx_path_canon (char *buf, size_t buflen, const char *folder, enum MailboxType *type)
	Canonicalise a mailbox path - Wrapper for MxOps::path_canon() More...
int	mx_path_canon2 (struct Mailbox *m, const char *folder)
	Canonicalise the path to realpath. More...
int	mx_path_parent (const char *buf, size_t buflen)
	Find the parent of a mailbox path - Wrapper for MxOps::path_parent() More...
int	mx_path_pretty (char *buf, size_t buflen, const char *folder)
	Abbreviate a mailbox path - Wrapper for MxOps::path_pretty() More...
enum MailboxType	mx_path_probe (const char *path)
	Find a mailbox that understands a path. More...
struct Mailbox *	mx_path_resolve (const char *path)
	Get a Mailbox for a path. More...
struct Mailbox *	mx_resolve (const char *path_or_name)
	Get a Mailbox from either a path or name. More...
int	mx_tags_commit (struct Mailbox *m, struct Email *e, const char *tags)
	Save tags to the Mailbox - Wrapper for MxOps::tags_commit() More...
int	mx_tags_edit (struct Mailbox *m, const char *tags, struct Buffer *buf)
	Start the tag editor of the mailbox. More...
enum MailboxType	mx_type (struct Mailbox *m)
	Return the type of the Mailbox. More...
struct Account *	mx_ac_find (struct Mailbox *m)
	Find the Account owning a Mailbox. More...
struct Mailbox *	mx_mbox_find (struct Account *a, const char *path)
	Find a Mailbox on an Account. More...
struct Mailbox *	mx_mbox_find2 (const char *path)
	Find a Mailbox on an Account. More...
bool	mx_mbox_ac_link (struct Mailbox *m)
	Link a Mailbox to an existing or new Account. More...
bool	mx_ac_add (struct Account *a, struct Mailbox *m)
	Add a Mailbox to an Account - Wrapper for MxOps::ac_add() More...
int	mx_ac_remove (struct Mailbox *m, bool keep_account)
	Remove a Mailbox from an Account and delete Account if empty. More...
int	mx_access (const char *path, int flags)
	Wrapper for access, checks permissions on a given mailbox. More...
void	mx_alloc_memory (struct Mailbox *m)
	Create storage for the emails. More...
int	mx_path_is_empty (const char *path)
	Is the mailbox empty. More...
void	mx_fastclose_mailbox (struct Mailbox *m, bool keep_account)
	Free up memory associated with the Mailbox. More...
const struct MxOps *	mx_get_ops (enum MailboxType type)
	Get mailbox operations. More...
bool	mx_tags_is_supported (struct Mailbox *m)
	Return true if mailbox support tagging. More...
int	mx_toggle_write (struct Mailbox *m)
	Toggle the mailbox's readonly flag. More...

Variables
const struct MxOps *	mx_ops []
struct EnumDef	MboxTypeDef

Detailed Description

API for mailboxes.

Authors

• Michael R. Elkins
• Thomas Roessler
• Richard Russon

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

Macro Definition Documentation

MUTT_MSG_NO_FLAGS

#define MUTT_MSG_NO_FLAGS   0

No flags are set.

Definition at line 42 of file mx.h.

MUTT_ADD_FROM

#define MUTT_ADD_FROM   (1 << 0)

add a From_ line

Definition at line 43 of file mx.h.

MUTT_SET_DRAFT

#define MUTT_SET_DRAFT   (1 << 1)

set the message draft flag

Definition at line 44 of file mx.h.

Typedef Documentation

MsgOpenFlags

typedef uint8_t MsgOpenFlags

Flags for mx_msg_open_new(), e.g. MUTT_ADD_FROM.

Definition at line 41 of file mx.h.

Function Documentation

mx_mbox_check()

enum MxStatus mx_mbox_check

(

struct Mailbox *

m

)

Check for new mail - Wrapper for MxOps::mbox_check()

Parameters

m

Mailbox

Return values

enum

MxStatus

Definition at line 1133 of file mx.c.

{
  if (!m || !m->mx_ops)
    return MX_STATUS_ERROR;
 
  enum MxStatus rc = m->mx_ops->mbox_check(m);
  if ((rc == MX_STATUS_NEW_MAIL) || (rc == MX_STATUS_REOPENED))
  {
    mailbox_changed(m, NT_MAILBOX_INVALID);
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_check_stats()

enum MxStatus mx_mbox_check_stats	(	struct Mailbox *	m,
		uint8_t	flags
	)

Check the statistics for a mailbox - Wrapper for MxOps::mbox_check_stats()

Note

Emits: NT_MAILBOX_CHANGE

Definition at line 1807 of file mx.c.

{
  if (!m)
    return MX_STATUS_ERROR;
 
  enum MxStatus rc = m->mx_ops->mbox_check_stats(m, flags);
  if (rc != MX_STATUS_ERROR)
  {
    struct EventMailbox ev_m = { m };
    notify_send(m->notify, NT_MAILBOX, NT_MAILBOX_CHANGE, &ev_m);
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_close()

enum MxStatus mx_mbox_close

(

struct Mailbox *

m

)

Save changes and close mailbox.

Parameters

m

Mailbox

Return values

enum

MxStatus

Note

The flag retvals come from a call to a backend sync function

It's very important to ensure the mailbox is properly closed before free'ing the context. For selected mailboxes, IMAP will cache the context inside connection->adata until imap_close_mailbox() removes it. Readonly, dontwrite, and append mailboxes are guaranteed to call mx_fastclose_mailbox(), so for most of NeoMutt's code you won't see return value checks for temporary contexts.

Definition at line 616 of file mx.c.

{
  if (!m)
    return MX_STATUS_ERROR;
 
  const bool c_mail_check_recent = cs_subset_bool(NeoMutt->sub, "mail_check_recent");
  if (c_mail_check_recent && !m->peekonly)
    m->has_new = false;
 
  if (m->readonly || m->dontwrite || m->append || m->peekonly)
  {
    mx_fastclose_mailbox(m, false);
    return 0;
  }
 
  int i, read_msgs = 0;
  enum MxStatus rc = MX_STATUS_ERROR;
  enum QuadOption move_messages = MUTT_NO;
  enum QuadOption purge = MUTT_YES;
  struct Buffer *mbox = NULL;
  struct Buffer *buf = mutt_buffer_pool_get();
 
#ifdef USE_NNTP
  if ((m->msg_unread != 0) && (m->type == MUTT_NNTP))
  {
    struct NntpMboxData *mdata = m->mdata;
 
    if (mdata && mdata->adata && mdata->group)
    {
      const enum QuadOption c_catchup_newsgroup = cs_subset_quad(NeoMutt->sub, "catchup_newsgroup");
      enum QuadOption ans = query_quadoption(c_catchup_newsgroup,
                                             _("Mark all articles read?"));
      if (ans == MUTT_ABORT)
        goto cleanup;
      if (ans == MUTT_YES)
        mutt_newsgroup_catchup(m, mdata->adata, mdata->group);
    }
  }
#endif
 
  const bool c_keep_flagged = cs_subset_bool(NeoMutt->sub, "keep_flagged");
  for (i = 0; i < m->msg_count; i++)
  {
    struct Email *e = m->emails[i];
    if (!e)
      break;
 
    if (!e->deleted && e->read && !(e->flagged && c_keep_flagged))
      read_msgs++;
  }
 
#ifdef USE_NNTP
  /* don't need to move articles from newsgroup */
  if (m->type == MUTT_NNTP)
    read_msgs = 0;
#endif
 
  const enum QuadOption c_move = cs_subset_quad(NeoMutt->sub, "move");
  if ((read_msgs != 0) && (c_move != MUTT_NO))
  {
    bool is_spool;
    mbox = mutt_buffer_pool_get();
 
    char *p = mutt_find_hook(MUTT_MBOX_HOOK, mailbox_path(m));
    if (p)
    {
      is_spool = true;
      mutt_buffer_strcpy(mbox, p);
    }
    else
    {
      const char *const c_mbox = cs_subset_string(NeoMutt->sub, "mbox");
      mutt_buffer_strcpy(mbox, c_mbox);
      is_spool = mutt_is_spool(mailbox_path(m)) &&
                 !mutt_is_spool(mutt_buffer_string(mbox));
    }
 
    if (is_spool && !mutt_buffer_is_empty(mbox))
    {
      mutt_buffer_expand_path(mbox);
      mutt_buffer_printf(buf,
                         /* L10N: The first argument is the number of read messages to be
                            moved, the second argument is the target mailbox. */
                         ngettext("Move %d read message to %s?",
                                  "Move %d read messages to %s?", read_msgs),
                         read_msgs, mutt_buffer_string(mbox));
      move_messages = query_quadoption(c_move, mutt_buffer_string(buf));
      if (move_messages == MUTT_ABORT)
        goto cleanup;
    }
  }
 
  /* There is no point in asking whether or not to purge if we are
   * just marking messages as "trash".  */
  const bool c_maildir_trash = cs_subset_bool(NeoMutt->sub, "maildir_trash");
  if ((m->msg_deleted != 0) && !((m->type == MUTT_MAILDIR) && c_maildir_trash))
  {
    mutt_buffer_printf(buf,
                       ngettext("Purge %d deleted message?",
                                "Purge %d deleted messages?", m->msg_deleted),
                       m->msg_deleted);
    const enum QuadOption c_delete = cs_subset_quad(NeoMutt->sub, "delete");
    purge = query_quadoption(c_delete, mutt_buffer_string(buf));
    if (purge == MUTT_ABORT)
      goto cleanup;
  }
 
  const bool c_mark_old = cs_subset_bool(NeoMutt->sub, "mark_old");
  if (c_mark_old && !m->peekonly)
  {
    for (i = 0; i < m->msg_count; i++)
    {
      struct Email *e = m->emails[i];
      if (!e)
        break;
      if (!e->deleted && !e->old && !e->read)
        mutt_set_flag(m, e, MUTT_OLD, true);
    }
  }
 
  if (move_messages)
  {
    if (m->verbose)
      mutt_message(_("Moving read messages to %s..."), mutt_buffer_string(mbox));
 
#ifdef USE_IMAP
    /* try to use server-side copy first */
    i = 1;
 
    if ((m->type == MUTT_IMAP) && (imap_path_probe(mutt_buffer_string(mbox), NULL) == MUTT_IMAP))
    {
      /* add messages for moving, and clear old tags, if any */
      struct EmailList el = STAILQ_HEAD_INITIALIZER(el);
      for (i = 0; i < m->msg_count; i++)
      {
        struct Email *e = m->emails[i];
        if (!e)
          break;
 
        if (e->read && !e->deleted && !(e->flagged && c_keep_flagged))
        {
          e->tagged = true;
          emaillist_add_email(&el, e);
        }
        else
        {
          e->tagged = false;
        }
      }
 
      i = imap_copy_messages(m, &el, mutt_buffer_string(mbox), SAVE_MOVE);
      emaillist_clear(&el);
    }
 
    if (i == 0) /* success */
      mutt_clear_error();
    else if (i == -1) /* horrible error, bail */
      goto cleanup;
    else /* use regular append-copy mode */
#endif
    {
      struct Mailbox *m_read = mx_path_resolve(mutt_buffer_string(mbox));
      if (!mx_mbox_open(m_read, MUTT_APPEND))
      {
        mailbox_free(&m_read);
        goto cleanup;
      }
 
      for (i = 0; i < m->msg_count; i++)
      {
        struct Email *e = m->emails[i];
        if (!e)
          break;
        if (e->read && !e->deleted && !(e->flagged && c_keep_flagged))
        {
          if (mutt_append_message(m_read, m, e, NULL, MUTT_CM_NO_FLAGS, CH_UPDATE_LEN) == 0)
          {
            mutt_set_flag(m, e, MUTT_DELETE, true);
            mutt_set_flag(m, e, MUTT_PURGE, true);
          }
          else
          {
            mx_mbox_close(m_read);
            goto cleanup;
          }
        }
      }
 
      mx_mbox_close(m_read);
    }
  }
  else if (!m->changed && (m->msg_deleted == 0))
  {
    if (m->verbose)
      mutt_message(_("Mailbox is unchanged"));
    if ((m->type == MUTT_MBOX) || (m->type == MUTT_MMDF))
      mbox_reset_atime(m, NULL);
    mx_fastclose_mailbox(m, false);
    rc = MX_STATUS_OK;
    goto cleanup;
  }
 
  /* copy mails to the trash before expunging */
  const char *const c_trash = cs_subset_string(NeoMutt->sub, "trash");
  const struct Mailbox *m_trash = mx_mbox_find(m->account, c_trash);
  if (purge && (m->msg_deleted != 0) && (m != m_trash))
  {
    if (trash_append(m) != 0)
      goto cleanup;
  }
 
#ifdef USE_IMAP
  /* allow IMAP to preserve the deleted flag across sessions */
  if (m->type == MUTT_IMAP)
  {
    const enum MxStatus check = imap_sync_mailbox(m, (purge != MUTT_NO), true);
    if (check == MX_STATUS_ERROR)
    {
      rc = check;
      goto cleanup;
    }
  }
  else
#endif
  {
    if (purge == MUTT_NO)
    {
      for (i = 0; i < m->msg_count; i++)
      {
        struct Email *e = m->emails[i];
        if (!e)
          break;
 
        e->deleted = false;
        e->purge = false;
      }
      m->msg_deleted = 0;
    }
 
    if (m->changed || (m->msg_deleted != 0))
    {
      enum MxStatus check = sync_mailbox(m);
      if (check != MX_STATUS_OK)
      {
        rc = check;
        goto cleanup;
      }
    }
  }
 
  if (m->verbose)
  {
    if (move_messages)
    {
      mutt_message(_("%d kept, %d moved, %d deleted"),
                   m->msg_count - m->msg_deleted, read_msgs, m->msg_deleted);
    }
    else
    {
      mutt_message(_("%d kept, %d deleted"), m->msg_count - m->msg_deleted, m->msg_deleted);
    }
  }
 
  const bool c_save_empty = cs_subset_bool(NeoMutt->sub, "save_empty");
  if ((m->msg_count == m->msg_deleted) &&
      ((m->type == MUTT_MMDF) || (m->type == MUTT_MBOX)) &&
      !mutt_is_spool(mailbox_path(m)) && !c_save_empty)
  {
    mutt_file_unlink_empty(mailbox_path(m));
  }
 
#ifdef USE_SIDEBAR
  if ((purge == MUTT_YES) && (m->msg_deleted != 0))
  {
    for (i = 0; i < m->msg_count; i++)
    {
      struct Email *e = m->emails[i];
      if (!e)
        break;
      if (e->deleted && !e->read)
      {
        m->msg_unread--;
        if (!e->old)
          m->msg_new--;
      }
      if (e->deleted && e->flagged)
        m->msg_flagged--;
    }
  }
#endif
 
  mx_fastclose_mailbox(m, false);
 
  rc = MX_STATUS_OK;
 
cleanup:
  mutt_buffer_pool_release(&mbox);
  mutt_buffer_pool_release(&buf);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_open()

bool mx_mbox_open	(	struct Mailbox *	m,
		OpenMailboxFlags	flags
	)

Open a mailbox and parse it.

Parameters

m	Mailbox to open
flags	Flags, see OpenMailboxFlags

Return values

true	Success
false	Error

Definition at line 305 of file mx.c.

{
  if (!m)
    return false;
 
  if ((m->type == MUTT_UNKNOWN) && (flags & (MUTT_NEWFOLDER | MUTT_APPEND)))
  {
    m->type = cs_subset_enum(NeoMutt->sub, "mbox_type");
    m->mx_ops = mx_get_ops(m->type);
  }
 
  const bool newly_linked_account = !m->account;
  if (newly_linked_account)
  {
    if (!mx_mbox_ac_link(m))
    {
      return false;
    }
  }
 
  m->verbose = !(flags & MUTT_QUIET);
  m->readonly = (flags & MUTT_READONLY);
  m->peekonly = (flags & MUTT_PEEK);
 
  if (flags & (MUTT_APPEND | MUTT_NEWFOLDER))
  {
    if (!mx_open_mailbox_append(m, flags))
    {
      goto error;
    }
    return true;
  }
 
  if (m->opened > 0)
  {
    m->opened++;
    return true;
  }
 
  m->size = 0;
  m->msg_unread = 0;
  m->msg_flagged = 0;
  m->rights = MUTT_ACL_ALL;
 
  if (m->type == MUTT_UNKNOWN)
  {
    m->type = mx_path_probe(mailbox_path(m));
    m->mx_ops = mx_get_ops(m->type);
  }
 
  if ((m->type == MUTT_UNKNOWN) || (m->type == MUTT_MAILBOX_ERROR) || !m->mx_ops)
  {
    if (m->type == MUTT_MAILBOX_ERROR)
      mutt_perror(mailbox_path(m));
    else if ((m->type == MUTT_UNKNOWN) || !m->mx_ops)
      mutt_error(_("%s is not a mailbox"), mailbox_path(m));
    goto error;
  }
 
  mutt_make_label_hash(m);
 
  /* if the user has a 'push' command in their .neomuttrc, or in a folder-hook,
   * it will cause the progress messages not to be displayed because
   * mutt_refresh() will think we are in the middle of a macro.  so set a
   * flag to indicate that we should really refresh the screen.  */
  OptForceRefresh = true;
 
  if (m->verbose)
    mutt_message(_("Reading %s..."), mailbox_path(m));
 
  // Clear out any existing emails
  for (int i = 0; i < m->email_max; i++)
  {
    email_free(&m->emails[i]);
  }
 
  m->msg_count = 0;
  m->msg_unread = 0;
  m->msg_flagged = 0;
  m->msg_new = 0;
  m->msg_deleted = 0;
  m->msg_tagged = 0;
  m->vcount = 0;
 
  enum MxOpenReturns rc = m->mx_ops->mbox_open(m);
  m->opened++;
 
  if ((rc == MX_OPEN_OK) || (rc == MX_OPEN_ABORT))
  {
    if ((flags & MUTT_NOSORT) == 0)
    {
      /* avoid unnecessary work since the mailbox is completely unthreaded
       * to begin with */
      OptSortSubthreads = false;
      OptNeedRescore = false;
    }
    if (m->verbose)
      mutt_clear_error();
    if (rc == MX_OPEN_ABORT)
    {
      mutt_error(_("Reading from %s interrupted..."), mailbox_path(m));
    }
  }
  else
  {
    goto error;
  }
 
  if (!m->peekonly)
    m->has_new = false;
  OptForceRefresh = false;
 
  return true;
 
error:
  mx_fastclose_mailbox(m, newly_linked_account);
  if (newly_linked_account)
    account_mailbox_remove(m->account, m);
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_sync()

enum MxStatus mx_mbox_sync

(

struct Mailbox *

m

)

Save changes to mailbox.

Parameters

[in]

m

Mailbox

Return values

enum

MxStatus

Note

The flag retvals come from a call to a backend sync function

Definition at line 924 of file mx.c.

{
  if (!m)
    return MX_STATUS_ERROR;
 
  enum MxStatus rc = MX_STATUS_OK;
  int purge = 1;
  int msgcount, deleted;
 
  if (m->dontwrite)
  {
    char buf[256], tmp[256];
    if (km_expand_key(buf, sizeof(buf), km_find_func(MENU_INDEX, OP_TOGGLE_WRITE)))
      snprintf(tmp, sizeof(tmp), _(" Press '%s' to toggle write"), buf);
    else
      mutt_str_copy(tmp, _("Use 'toggle-write' to re-enable write"), sizeof(tmp));
 
    mutt_error(_("Mailbox is marked unwritable. %s"), tmp);
    return MX_STATUS_ERROR;
  }
  else if (m->readonly)
  {
    mutt_error(_("Mailbox is read-only"));
    return MX_STATUS_ERROR;
  }
 
  if (!m->changed && (m->msg_deleted == 0))
  {
    if (m->verbose)
      mutt_message(_("Mailbox is unchanged"));
    return MX_STATUS_OK;
  }
 
  if (m->msg_deleted != 0)
  {
    char buf[128] = { 0 };
 
    snprintf(buf, sizeof(buf),
             ngettext("Purge %d deleted message?", "Purge %d deleted messages?", m->msg_deleted),
             m->msg_deleted);
    const enum QuadOption c_delete = cs_subset_quad(NeoMutt->sub, "delete");
    purge = query_quadoption(c_delete, buf);
    if (purge == MUTT_ABORT)
      return MX_STATUS_ERROR;
    if (purge == MUTT_NO)
    {
      if (!m->changed)
        return MX_STATUS_OK; /* nothing to do! */
      /* let IMAP servers hold on to D flags */
      if (m->type != MUTT_IMAP)
      {
        for (int i = 0; i < m->msg_count; i++)
        {
          struct Email *e = m->emails[i];
          if (!e)
            break;
          e->deleted = false;
          e->purge = false;
        }
        m->msg_deleted = 0;
      }
    }
    mailbox_changed(m, NT_MAILBOX_UNTAG);
  }
 
  /* really only for IMAP - imap_sync_mailbox results in a call to
   * ctx_update_tables, so m->msg_deleted is 0 when it comes back */
  msgcount = m->msg_count;
  deleted = m->msg_deleted;
 
  const char *const c_trash = cs_subset_string(NeoMutt->sub, "trash");
  const struct Mailbox *m_trash = mx_mbox_find(m->account, c_trash);
  if (purge && (m->msg_deleted != 0) && (m != m_trash))
  {
    if (trash_append(m) != 0)
      return MX_STATUS_OK;
  }
 
#ifdef USE_IMAP
  if (m->type == MUTT_IMAP)
    rc = imap_sync_mailbox(m, purge, false);
  else
#endif
    rc = sync_mailbox(m);
  if (rc != MX_STATUS_ERROR)
  {
#ifdef USE_IMAP
    if ((m->type == MUTT_IMAP) && !purge)
    {
      if (m->verbose)
        mutt_message(_("Mailbox checkpointed"));
    }
    else
#endif
    {
      if (m->verbose)
        mutt_message(_("%d kept, %d deleted"), msgcount - deleted, deleted);
    }
 
    mutt_sleep(0);
 
    const bool c_save_empty = cs_subset_bool(NeoMutt->sub, "save_empty");
    if ((m->msg_count == m->msg_deleted) &&
        ((m->type == MUTT_MBOX) || (m->type == MUTT_MMDF)) &&
        !mutt_is_spool(mailbox_path(m)) && !c_save_empty)
    {
      unlink(mailbox_path(m));
      mx_fastclose_mailbox(m, false);
      return MX_STATUS_OK;
    }
 
    /* if we haven't deleted any messages, we don't need to resort
     * ... except for certain folder formats which need "unsorted"
     * sort order in order to synchronize folders.
     *
     * MH and maildir are safe.  mbox-style seems to need re-sorting,
     * at least with the new threading code.  */
    if (purge || ((m->type != MUTT_MAILDIR) && (m->type != MUTT_MH)))
    {
      /* IMAP does this automatically after handling EXPUNGE */
      if (m->type != MUTT_IMAP)
      {
        mailbox_changed(m, NT_MAILBOX_UPDATE);
        mailbox_changed(m, NT_MAILBOX_RESORT);
      }
    }
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_msg_close()

int mx_msg_close	(	struct Mailbox *	m,
		struct Message **	msg
	)

Close a message.

Parameters

[in]	m	Mailbox
[out]	msg	Message to close

Return values

0	Success
-1	Failure

Definition at line 1200 of file mx.c.

{
  if (!m || !msg || !*msg)
    return 0;
 
  int rc = 0;
 
  if (m->mx_ops && m->mx_ops->msg_close)
    rc = m->mx_ops->msg_close(m, *msg);
 
  if ((*msg)->path)
  {
    mutt_debug(LL_DEBUG1, "unlinking %s\n", (*msg)->path);
    unlink((*msg)->path);
    FREE(&(*msg)->path);
  }
 
  FREE(&(*msg)->committed_path);
  FREE(msg);
  return rc;
}

Here is the caller graph for this function:

mx_msg_commit()

int mx_msg_commit	(	struct Mailbox *	m,
		struct Message *	msg
	)

Commit a message to a folder - Wrapper for MxOps::msg_commit()

Parameters

m	Mailbox
msg	Message to commit

Return values

0	Success
-1	Failure

Definition at line 1179 of file mx.c.

{
  if (!m || !m->mx_ops || !m->mx_ops->msg_commit || !msg)
    return -1;
 
  if (!(msg->write && m->append))
  {
    mutt_debug(LL_DEBUG1, "msg->write = %d, m->append = %d\n", msg->write, m->append);
    return -1;
  }
 
  return m->mx_ops->msg_commit(m, msg);
}

Here is the caller graph for this function:

mx_msg_open_new()

struct Message * mx_msg_open_new	(	struct Mailbox *	m,
		const struct Email *	e,
		MsgOpenFlags	flags
	)

Open a new message.

Parameters

m	Destination mailbox
e	Message being copied (required for maildir support, because the filename depends on the message flags)
flags	Flags, see MsgOpenFlags

Return values

ptr	New Message

Definition at line 1062 of file mx.c.

{
  if (!m)
    return NULL;
 
  struct Address *p = NULL;
  struct Message *msg = NULL;
 
  if (!m->mx_ops || !m->mx_ops->msg_open_new)
  {
    mutt_debug(LL_DEBUG1, "function unimplemented for mailbox type %d\n", m->type);
    return NULL;
  }
 
  msg = mutt_mem_calloc(1, sizeof(struct Message));
  msg->write = true;
 
  if (e)
  {
    msg->flags.flagged = e->flagged;
    msg->flags.replied = e->replied;
    msg->flags.read = e->read;
    msg->flags.draft = (flags & MUTT_SET_DRAFT);
    msg->received = e->received;
  }
 
  if (msg->received == 0)
    msg->received = mutt_date_now();
 
  if (m->mx_ops->msg_open_new(m, msg, e))
  {
    if (m->type == MUTT_MMDF)
      fputs(MMDF_SEP, msg->fp);
 
    if (((m->type == MUTT_MBOX) || (m->type == MUTT_MMDF)) && (flags & MUTT_ADD_FROM))
    {
      if (e)
      {
        p = TAILQ_FIRST(&e->env->return_path);
        if (!p)
          p = TAILQ_FIRST(&e->env->sender);
        if (!p)
          p = TAILQ_FIRST(&e->env->from);
      }
 
      // Force a 'C' locale for the date, so that day/month names are in English
      char buf[64] = { 0 };
      struct tm tm = mutt_date_localtime(msg->received);
#ifdef LC_TIME_MASK
      locale_t loc = newlocale(LC_TIME_MASK, "C", 0);
      strftime_l(buf, sizeof(buf), "%a %b %e %H:%M:%S %Y", &tm, loc);
      freelocale(loc);
#else  /* !LC_TIME_MASK */
      strftime(buf, sizeof(buf), "%a %b %e %H:%M:%S %Y", &tm);
#endif /* LC_TIME_MASK */
      fprintf(msg->fp, "From %s %s\n", p ? p->mailbox : NONULL(Username), buf);
    }
  }
  else
  {
    FREE(&msg);
  }
 
  return msg;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_msg_open()

struct Message * mx_msg_open	(	struct Mailbox *	m,
		int	msgno
	)

Return a stream pointer for a message.

Parameters

m	Mailbox
msgno	Message number

Return values

ptr	Message
NULL	Error

Definition at line 1154 of file mx.c.

{
  if (!m || !m->emails || (msgno < 0) || (msgno >= m->msg_count))
    return NULL;
 
  if (!m->mx_ops || !m->mx_ops->msg_open)
  {
    mutt_debug(LL_DEBUG1, "function not implemented for mailbox type %d\n", m->type);
    return NULL;
  }
 
  struct Message *msg = mutt_mem_calloc(1, sizeof(struct Message));
  if (!m->mx_ops->msg_open(m, msg, msgno))
    FREE(&msg);
 
  return msg;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_msg_padding_size()

int mx_msg_padding_size

(

struct Mailbox *

m

)

Bytes of padding between messages - Wrapper for MxOps::msg_padding_size()

Parameters

m

Mailbox

Return values

num	Number of bytes of padding

mmdf and mbox add separators, which leads a small discrepancy when computing vsize for a limited view.

Definition at line 1556 of file mx.c.

{
  if (!m || !m->mx_ops || !m->mx_ops->msg_padding_size)
    return 0;
 
  return m->mx_ops->msg_padding_size(m);
}

Here is the caller graph for this function:

mx_save_hcache()

int mx_save_hcache	(	struct Mailbox *	m,
		struct Email *	e
	)

Save message to the header cache - Wrapper for MxOps::msg_save_hcache()

Parameters

m	Mailbox
e	Email

Return values

0	Success
-1	Failure

Write a single header out to the header cache.

Definition at line 1831 of file mx.c.

{
  if (!m || !m->mx_ops || !m->mx_ops->msg_save_hcache || !e)
    return 0;
 
  return m->mx_ops->msg_save_hcache(m, e);
}

Here is the caller graph for this function:

mx_path_canon()

int mx_path_canon	(	char *	buf,
		size_t	buflen,
		const char *	folder,
		enum MailboxType *	type
	)

Canonicalise a mailbox path - Wrapper for MxOps::path_canon()

Definition at line 1380 of file mx.c.

{
  if (!buf)
    return -1;
 
  for (size_t i = 0; i < 3; i++)
  {
    /* Look for !! ! - < > or ^ followed by / or NUL */
    if ((buf[0] == '!') && (buf[1] == '!'))
    {
      if (((buf[2] == '/') || (buf[2] == '\0')))
      {
        mutt_str_inline_replace(buf, buflen, 2, LastFolder);
      }
    }
    else if ((buf[0] == '+') || (buf[0] == '='))
    {
      size_t folder_len = mutt_str_len(folder);
      if ((folder_len > 0) && (folder[folder_len - 1] != '/'))
      {
        buf[0] = '/';
        mutt_str_inline_replace(buf, buflen, 0, folder);
      }
      else
      {
        mutt_str_inline_replace(buf, buflen, 1, folder);
      }
    }
    else if ((buf[1] == '/') || (buf[1] == '\0'))
    {
      if (buf[0] == '!')
      {
        const char *const c_spool_file = cs_subset_string(NeoMutt->sub, "spool_file");
        mutt_str_inline_replace(buf, buflen, 1, c_spool_file);
      }
      else if (buf[0] == '-')
      {
        mutt_str_inline_replace(buf, buflen, 1, LastFolder);
      }
      else if (buf[0] == '<')
      {
        const char *const c_record = cs_subset_string(NeoMutt->sub, "record");
        mutt_str_inline_replace(buf, buflen, 1, c_record);
      }
      else if (buf[0] == '>')
      {
        const char *const c_mbox = cs_subset_string(NeoMutt->sub, "mbox");
        mutt_str_inline_replace(buf, buflen, 1, c_mbox);
      }
      else if (buf[0] == '^')
      {
        mutt_str_inline_replace(buf, buflen, 1, CurrentFolder);
      }
      else if (buf[0] == '~')
      {
        mutt_str_inline_replace(buf, buflen, 1, HomeDir);
      }
    }
    else if (buf[0] == '@')
    {
      /* elm compatibility, @ expands alias to user name */
      struct AddressList *al = alias_lookup(buf + 1);
      if (!al || TAILQ_EMPTY(al))
        break;
 
      struct Email *e = email_new();
      e->env = mutt_env_new();
      mutt_addrlist_copy(&e->env->from, al, false);
      mutt_addrlist_copy(&e->env->to, al, false);
      mutt_default_save(buf, buflen, e);
      email_free(&e);
      break;
    }
    else
    {
      break;
    }
  }
 
  // if (!folder) //XXX - use inherited version, or pass NULL to backend?
  //   return -1;
 
  enum MailboxType type2 = mx_path_probe(buf);
  if (type)
    *type = type2;
  const struct MxOps *ops = mx_get_ops(type2);
  if (!ops || !ops->path_canon)
    return -1;
 
  if (ops->path_canon(buf, buflen) < 0)
  {
    mutt_path_canon(buf, buflen, HomeDir, true);
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_path_canon2()

int mx_path_canon2	(	struct Mailbox *	m,
		const char *	folder
	)

Canonicalise the path to realpath.

Parameters

m	Mailbox
folder	Path to canonicalise

Return values

0	Success
-1	Failure

Definition at line 1484 of file mx.c.

{
  if (!m)
    return -1;
 
  char buf[PATH_MAX] = { 0 };
 
  if (m->realpath)
    mutt_str_copy(buf, m->realpath, sizeof(buf));
  else
    mutt_str_copy(buf, mailbox_path(m), sizeof(buf));
 
  int rc = mx_path_canon(buf, sizeof(buf), folder, &m->type);
 
  mutt_str_replace(&m->realpath, buf);
 
  if (rc >= 0)
  {
    m->mx_ops = mx_get_ops(m->type);
    mutt_buffer_strcpy(&m->pathbuf, m->realpath);
  }
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_path_parent()

int mx_path_parent	(	const char *	buf,
		size_t	buflen
	)

Find the parent of a mailbox path - Wrapper for MxOps::path_parent()

Definition at line 1540 of file mx.c.

{
  if (!buf)
    return -1;
 
  return 0;
}

mx_path_pretty()

int mx_path_pretty	(	char *	buf,
		size_t	buflen,
		const char *	folder
	)

Abbreviate a mailbox path - Wrapper for MxOps::path_pretty()

Definition at line 1512 of file mx.c.

{
  if (!buf)
    return -1;
 
  enum MailboxType type = mx_path_probe(buf);
  const struct MxOps *ops = mx_get_ops(type);
  if (!ops)
    return -1;
 
  if (!ops->path_canon)
    return -1;
 
  if (ops->path_canon(buf, buflen) < 0)
    return -1;
 
  if (!ops->path_pretty)
    return -1;
 
  if (ops->path_pretty(buf, buflen, folder) < 0)
    return -1;
 
  return 0;
}

Here is the call graph for this function:

mx_path_probe()

enum MailboxType mx_path_probe

(

const char *

path

)

Find a mailbox that understands a path.

Parameters

path	Path to examine

Return values

num	Type, e.g. MUTT_IMAP

Definition at line 1334 of file mx.c.

{
  if (!path)
    return MUTT_UNKNOWN;
 
  enum MailboxType rc = MUTT_UNKNOWN;
 
  // First, search the non-local Mailbox types (is_local == false)
  for (const struct MxOps **ops = MxOps; *ops; ops++)
  {
    if ((*ops)->is_local)
      continue;
    rc = (*ops)->path_probe(path, NULL);
    if (rc != MUTT_UNKNOWN)
      return rc;
  }
 
  struct stat st = { 0 };
  if (stat(path, &st) != 0)
  {
    mutt_debug(LL_DEBUG1, "unable to stat %s: %s (errno %d)\n", path, strerror(errno), errno);
    return MUTT_UNKNOWN;
  }
 
  if (S_ISFIFO(st.st_mode))
  {
    mutt_error(_("Can't open %s: it is a pipe"), path);
    return MUTT_UNKNOWN;
  }
 
  // Next, search the local Mailbox types (is_local == true)
  for (const struct MxOps **ops = MxOps; *ops; ops++)
  {
    if (!(*ops)->is_local)
      continue;
    rc = (*ops)->path_probe(path, &st);
    if (rc != MUTT_UNKNOWN)
      return rc;
  }
 
  return rc;
}

Here is the caller graph for this function:

mx_path_resolve()

struct Mailbox * mx_path_resolve

(

const char *

path

)

Get a Mailbox for a path.

Parameters

path	Mailbox path

Return values

ptr

Mailbox

If there isn't a Mailbox for the path, one will be created.

Definition at line 1684 of file mx.c.

{
  if (!path)
    return NULL;
 
  struct Mailbox *m = mx_mbox_find2(path);
  if (m)
    return m;
 
  m = mailbox_new();
  mutt_buffer_strcpy(&m->pathbuf, path);
  const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
  mx_path_canon2(m, c_folder);
 
  return m;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_resolve()

struct Mailbox * mx_resolve

(

const char *

path_or_name

)

Get a Mailbox from either a path or name.

Parameters

path_or_name

Mailbox path or name

Return values

ptr

Mailbox

Order of resolving:

1. Name
2. Path

Definition at line 1753 of file mx.c.

{
  if (!path_or_name)
    return NULL;
 
  // Order is name first because you can create a Mailbox from
  // a path, but can't from a name. So fallback behavior creates
  // a new Mailbox for us.
  struct Mailbox *m = mx_mbox_find_by_name(path_or_name);
  if (!m)
    m = mx_path_resolve(path_or_name);
 
  return m;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_tags_commit()

int mx_tags_commit	(	struct Mailbox *	m,
		struct Email *	e,
		const char *	tags
	)

Save tags to the Mailbox - Wrapper for MxOps::tags_commit()

Parameters

m	Mailbox
e	Email
tags	Tags to save

Return values

0	Success
-1	Failure

Definition at line 1307 of file mx.c.

{
  if (!m || !e || !tags)
    return -1;
 
  if (m->mx_ops->tags_commit)
    return m->mx_ops->tags_commit(m, e, tags);
 
  mutt_message(_("Folder doesn't support tagging, aborting"));
  return -1;
}

Here is the caller graph for this function:

mx_tags_edit()

int mx_tags_edit	(	struct Mailbox *	m,
		const char *	tags,
		struct Buffer *	buf
	)

Start the tag editor of the mailbox.

Parameters

m	Mailbox
tags	Existing tags
buf	Buffer for the results

Return values

-1	Error
0	No valid user input
1	Buffer set

Definition at line 1287 of file mx.c.

{
  if (!m || !buf)
    return -1;
 
  if (m->mx_ops->tags_edit)
    return m->mx_ops->tags_edit(m, tags, buf);
 
  mutt_message(_("Folder doesn't support tagging, aborting"));
  return -1;
}

Here is the caller graph for this function:

mx_type()

enum MailboxType mx_type

(

struct Mailbox *

m

)

Return the type of the Mailbox.

Parameters

m

Mailbox

Return values

enum	MailboxType

Definition at line 1844 of file mx.c.

{
  return m ? m->type : MUTT_MAILBOX_ERROR;
}

Here is the caller graph for this function:

mx_ac_find()

struct Account * mx_ac_find

(

struct Mailbox *

m

)

Find the Account owning a Mailbox.

Parameters

m

Mailbox

Return values

ptr	Account
NULL	None found

Definition at line 1570 of file mx.c.

{
  if (!m || !m->mx_ops || !m->realpath)
    return NULL;
 
  struct Account *np = NULL;
  TAILQ_FOREACH(np, &NeoMutt->accounts, entries)
  {
    if (np->type != m->type)
      continue;
 
    if (m->mx_ops->ac_owns_path(np, m->realpath))
      return np;
  }
 
  return NULL;
}

Here is the caller graph for this function:

mx_mbox_find()

struct Mailbox * mx_mbox_find	(	struct Account *	a,
		const char *	path
	)

Find a Mailbox on an Account.

Parameters

a	Account to search
path	Path to find

Return values

ptr

Mailbox

Definition at line 1594 of file mx.c.

{
  if (!a || !path)
    return NULL;
 
  struct MailboxNode *np = NULL;
  struct Url *url_p = NULL;
  struct Url *url_a = NULL;
 
  const bool use_url = (a->type == MUTT_IMAP);
  if (use_url)
  {
    url_p = url_parse(path);
    if (!url_p)
      goto done;
  }
 
  STAILQ_FOREACH(np, &a->mailboxes, entries)
  {
    if (!use_url)
    {
      if (mutt_str_equal(np->mailbox->realpath, path))
        return np->mailbox;
      continue;
    }
 
    url_free(&url_a);
    url_a = url_parse(np->mailbox->realpath);
    if (!url_a)
      continue;
 
    if (!mutt_istr_equal(url_a->host, url_p->host))
      continue;
    if (url_p->user && !mutt_istr_equal(url_a->user, url_p->user))
      continue;
    if (a->type == MUTT_IMAP)
    {
      if (imap_mxcmp(url_a->path, url_p->path) == 0)
        break;
    }
    else
    {
      if (mutt_str_equal(url_a->path, url_p->path))
        break;
    }
  }
 
done:
  url_free(&url_p);
  url_free(&url_a);
 
  if (!np)
    return NULL;
  return np->mailbox;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_find2()

struct Mailbox * mx_mbox_find2

(

const char *

path

)

Find a Mailbox on an Account.

Parameters

path	Path to find

Return values

ptr	Mailbox
NULL	No match

Definition at line 1656 of file mx.c.

{
  if (!path)
    return NULL;
 
  char buf[PATH_MAX] = { 0 };
  mutt_str_copy(buf, path, sizeof(buf));
  const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
  mx_path_canon(buf, sizeof(buf), c_folder, NULL);
 
  struct Account *np = NULL;
  TAILQ_FOREACH(np, &NeoMutt->accounts, entries)
  {
    struct Mailbox *m = mx_mbox_find(np, buf);
    if (m)
      return m;
  }
 
  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_mbox_ac_link()

bool mx_mbox_ac_link

(

struct Mailbox *

m

)

Link a Mailbox to an existing or new Account.

Parameters

m	Mailbox to link

Return values

true	Success
false	Failure

Definition at line 268 of file mx.c.

{
  if (!m)
    return false;
 
  if (m->account)
    return true;
 
  struct Account *a = mx_ac_find(m);
  const bool new_account = !a;
  if (new_account)
  {
    a = account_new(NULL, NeoMutt->sub);
    a->type = m->type;
  }
  if (!mx_ac_add(a, m))
  {
    if (new_account)
    {
      account_free(&a);
    }
    return false;
  }
  if (new_account)
  {
    neomutt_account_add(NeoMutt, a);
  }
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_ac_add()

bool mx_ac_add	(	struct Account *	a,
		struct Mailbox *	m
	)

Add a Mailbox to an Account - Wrapper for MxOps::ac_add()

Definition at line 1771 of file mx.c.

{
  if (!a || !m || !m->mx_ops || !m->mx_ops->ac_add)
    return false;
 
  return m->mx_ops->ac_add(a, m) && account_mailbox_add(a, m);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_ac_remove()

int mx_ac_remove	(	struct Mailbox *	m,
		bool	keep_account
	)

Remove a Mailbox from an Account and delete Account if empty.

Parameters

m	Mailbox to remove
keep_account	Make sure not to remove the mailbox's account

Return values

0	Success
-1	Error

Note

The mailbox is NOT free'd

Definition at line 1788 of file mx.c.

{
  if (!m || !m->account)
    return -1;
 
  struct Account *a = m->account;
  account_mailbox_remove(m->account, m);
  if (!keep_account && STAILQ_EMPTY(&a->mailboxes))
  {
    neomutt_account_remove(NeoMutt, a);
  }
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_access()

int mx_access	(	const char *	path,
		int	flags
	)

Wrapper for access, checks permissions on a given mailbox.

Parameters

path	Path of mailbox
flags	Flags, e.g. W_OK

Return values

0	Success, allowed
<0	Failure, not allowed

We may be interested in using ACL-style flags at some point, currently we use the normal access() flags.

Definition at line 183 of file mx.c.

{
#ifdef USE_IMAP
  if (imap_path_probe(path, NULL) == MUTT_IMAP)
    return imap_access(path);
#endif
 
  return access(path, flags);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_alloc_memory()

void mx_alloc_memory

(

struct Mailbox *

m

)

Create storage for the emails.

Parameters

m

Mailbox

Definition at line 1226 of file mx.c.

{
  const int grow = 25;
  size_t s = MAX(sizeof(struct Email *), sizeof(int));
 
  if (((m->email_max + grow) * s) < (m->email_max * s))
  {
    mutt_error(_("Out of memory"));
    mutt_exit(1);
  }
 
  m->email_max += grow;
  if (m->emails)
  {
    mutt_mem_realloc(&m->emails, m->email_max * sizeof(struct Email *));
    mutt_mem_realloc(&m->v2r, m->email_max * sizeof(int));
  }
  else
  {
    m->emails = mutt_mem_calloc(m->email_max, sizeof(struct Email *));
    m->v2r = mutt_mem_calloc(m->email_max, sizeof(int));
  }
  for (int i = m->email_max - grow; i < m->email_max; i++)
  {
    if (i < m->email_max)
    {
      m->emails[i] = NULL;
      m->v2r[i] = -1;
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_path_is_empty()

int mx_path_is_empty

(

const char *

path

)

Is the mailbox empty.

Parameters

path	Mailbox to check

Return values

1	Mailbox is empty
0	Mailbox contains mail
-1	Error

Definition at line 1265 of file mx.c.

{
  if (!path || (*path == '\0'))
    return -1;
 
  enum MailboxType type = mx_path_probe(path);
  const struct MxOps *ops = mx_get_ops(type);
  if (!ops || !ops->path_is_empty)
    return -1;
 
  return ops->path_is_empty(path);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_fastclose_mailbox()

void mx_fastclose_mailbox	(	struct Mailbox *	m,
		bool	keep_account
	)

Free up memory associated with the Mailbox.

Parameters

m	Mailbox
keep_account	Make sure not to remove the mailbox's account

Definition at line 431 of file mx.c.

{
  if (!m)
    return;
 
  m->opened--;
  if (m->opened != 0)
    return;
 
  /* never announce that a mailbox we've just left has new mail.
   * TODO: really belongs in mx_mbox_close, but this is a nice hook point */
  if (!m->peekonly)
    mutt_mailbox_set_notified(m);
 
  if (m->mx_ops)
    m->mx_ops->mbox_close(m);
 
  mutt_hash_free(&m->subj_hash);
  mutt_hash_free(&m->id_hash);
  mutt_hash_free(&m->label_hash);
 
  if (m->emails)
  {
    for (int i = 0; i < m->msg_count; i++)
    {
      if (!m->emails[i])
        break;
      email_free(&m->emails[i]);
    }
  }
 
  if (!m->visible)
  {
    mx_ac_remove(m, keep_account);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mx_get_ops()

const struct MxOps * mx_get_ops

(

enum MailboxType

type

)

Get mailbox operations.

Parameters

type	Mailbox type

Return values

ptr	Mailbox function
NULL	Error

Definition at line 140 of file mx.c.

{
  for (const struct MxOps **ops = MxOps; *ops; ops++)
    if ((*ops)->type == type)
      return *ops;
 
  return NULL;
}

Here is the caller graph for this function:

mx_tags_is_supported()

bool mx_tags_is_supported

(

struct Mailbox *

m

)

Return true if mailbox support tagging.

Parameters

m

Mailbox

Return values

true	Tagging is supported

Definition at line 1324 of file mx.c.

{
  return m && m->mx_ops->tags_commit && m->mx_ops->tags_edit;
}

Here is the caller graph for this function:

mx_toggle_write()

int mx_toggle_write

(

struct Mailbox *

m

)

Toggle the mailbox's readonly flag.

Parameters

m

Mailbox

Return values

0	Success
-1	Error

Definition at line 1855 of file mx.c.

{
  if (!m)
    return -1;
 
  if (m->readonly)
  {
    mutt_error(_("Can't toggle write on a readonly mailbox"));
    return -1;
  }
 
  if (m->dontwrite)
  {
    m->dontwrite = false;
    mutt_message(_("Changes to folder will be written on folder exit"));
  }
  else
  {
    m->dontwrite = true;
    mutt_message(_("Changes to folder will not be written"));
  }
 
  struct EventMailbox ev_m = { m };
  notify_send(m->notify, NT_MAILBOX, NT_MAILBOX_CHANGE, &ev_m);
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

mx_ops

const struct MxOps* mx_ops[]

extern

MboxTypeDef

struct EnumDef MboxTypeDef

extern

Definition at line 97 of file mx.c.