mh.c File Reference

MH local mailbox type. More...

#include "config.h"
#include <ctype.h>
#include <dirent.h>
#include <errno.h>
#include <fcntl.h>
#include <inttypes.h>
#include <limits.h>
#include <stdbool.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>
#include <unistd.h>
#include "private.h"
#include "mutt/lib.h"
#include "config/lib.h"
#include "email/lib.h"
#include "core/lib.h"
#include "lib.h"
#include "progress/lib.h"
#include "copy.h"
#include "edata.h"
#include "globals.h"
#include "mdata.h"
#include "mdemail.h"
#include "mx.h"
#include "sequence.h"
#include "monitor.h"
#include "hcache/lib.h"

Include dependency graph for mh.c:

Go to the source code of this file.

Functions
bool	mh_mkstemp (struct Mailbox *m, FILE **fp, char **tgt)
	Create a temporary file.
static int	mh_already_notified (struct Mailbox *m, int msgno)
	Has the message changed.
static bool	mh_valid_message (const char *s)
	Is this a valid MH message filename.
int	mh_check_empty (struct Buffer *path)
	Is mailbox empty.
static enum MxStatus	mh_mbox_check_stats (struct Mailbox *m, uint8_t flags)
	Check the Mailbox statistics - Implements MxOps::mbox_check_stats() -.
static void	mh_update_maildir (struct MdEmailArray *mda, struct MhSequences *mhs)
	Update our record of flags.
static int	mh_commit_msg (struct Mailbox *m, struct Message *msg, struct Email *e, bool updseq)
	Commit a message to an MH folder.
static int	mh_rewrite_message (struct Mailbox *m, struct Email *e)
	Sync a message in an MH folder.
static int	mh_sync_message (struct Mailbox *m, struct Email *e)
	Sync an email to an MH folder.
static void	mh_update_mtime (struct Mailbox *m)
	Update our record of the Maildir modification time.
static int	mh_parse_dir (struct Mailbox *m, struct MdEmailArray *mda, struct Progress *progress)
	Read a Maildir mailbox.
static int	mh_sort_path (const void *a, const void *b, void *sdata)
	Compare two Maildirs by path - Implements sort_t -.
static struct Email *	mh_parse_message (const char *fname, struct Email *e)
	Actually parse an MH message.
static void	mh_delayed_parsing (struct Mailbox *m, struct MdEmailArray *mda, struct Progress *progress)
	This function does the second parsing pass.
static bool	mh_read_dir (struct Mailbox *m)
	Read an MH mailbox.
int	mh_sync_mailbox_message (struct Mailbox *m, struct Email *e, struct HeaderCache *hc)
	Save changes to the mailbox.
static int	mh_msg_save_hcache (struct Mailbox *m, struct Email *e)
	Save message to the header cache - Implements MxOps::msg_save_hcache() -.
static bool	mh_ac_owns_path (struct Account *a, const char *path)
	Check whether an Account own a Mailbox path - Implements MxOps::ac_owns_path() -.
static bool	mh_ac_add (struct Account *a, struct Mailbox *m)
	Add a Mailbox to an Account - Implements MxOps::ac_add() -.
static enum MxOpenReturns	mh_mbox_open (struct Mailbox *m)
	Open a Mailbox - Implements MxOps::mbox_open() -.
static bool	mh_mbox_open_append (struct Mailbox *m, OpenMailboxFlags flags)
	Open a Mailbox for appending - Implements MxOps::mbox_open_append() -.
static enum MxStatus	mh_check (struct Mailbox *m)
	Check for new mail.
static enum MxStatus	mh_mbox_check (struct Mailbox *m)
	Check for new mail - Implements MxOps::mbox_check() -.
static enum MxStatus	mh_mbox_sync (struct Mailbox *m)
	Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
static enum MxStatus	mh_mbox_close (struct Mailbox *m)
	Close a Mailbox - Implements MxOps::mbox_close() -.
static bool	mh_msg_open (struct Mailbox *m, struct Message *msg, struct Email *e)
	Open an email message in a Mailbox - Implements MxOps::msg_open() -.
static bool	mh_msg_open_new (struct Mailbox *m, struct Message *msg, const struct Email *e)
	Open a new message in a Mailbox - Implements MxOps::msg_open_new() -.
static int	mh_msg_commit (struct Mailbox *m, struct Message *msg)
	Save changes to an email - Implements MxOps::msg_commit() -.
static int	mh_msg_close (struct Mailbox *m, struct Message *msg)
	Close an email - Implements MxOps::msg_close() -.
static int	mh_path_canon (struct Buffer *path)
	Canonicalise a Mailbox path - Implements MxOps::path_canon() -.
static int	mh_path_parent (struct Buffer *path)
	Find the parent of a Mailbox path - Implements MxOps::path_parent() -.
static int	mh_path_pretty (struct Buffer *path, const char *folder)
	Abbreviate a Mailbox path - Implements MxOps::path_pretty() -.
static enum MailboxType	mh_path_probe (const char *path, const struct stat *st)
	Is this an mh Mailbox? - Implements MxOps::path_probe() -.

Variables
const struct MxOps	MxMhOps
	MH Mailbox - Implements MxOps -.

Detailed Description

MH local mailbox type.

Authors

• Michael R. Elkins
• Thomas Roessler
• Michael R. Elkins
• 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 mh.c.

Function Documentation

mh_mkstemp()

bool mh_mkstemp	(	struct Mailbox *	m,
		FILE **	fp,
		char **	tgt
	)

Create a temporary file.

Parameters

[in]	m	Mailbox to create the file in
[out]	fp	File handle
[out]	tgt	File name

Return values

true	Success
false	Failure

Definition at line 78 of file mh.c.

{
  int fd;
  char path[PATH_MAX] = { 0 };
 
  mode_t omask = umask(mh_umask(m));
  while (true)
  {
    snprintf(path, sizeof(path), "%s/.neomutt-%s-%d-%" PRIu64, mailbox_path(m),
             NONULL(ShortHostname), (int) getpid(), mutt_rand64());
    fd = open(path, O_WRONLY | O_EXCL | O_CREAT, 0666);
    if (fd == -1)
    {
      if (errno != EEXIST)
      {
        mutt_perror("%s", path);
        umask(omask);
        return false;
      }
    }
    else
    {
      *tgt = mutt_str_dup(path);
      break;
    }
  }
  umask(omask);
 
  *fp = fdopen(fd, "w");
  if (!*fp)
  {
    FREE(tgt);
    close(fd);
    unlink(path);
    return false;
  }
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_already_notified()

static int mh_already_notified ( struct Mailbox *  m, int  msgno  )

static

Has the message changed.

Parameters

m	Mailbox
msgno	Message number

Return values

1	Modification time on the message file is older than the last visit to this mailbox
0	Modification time on the message file is newer
-1	Error

Definition at line 126 of file mh.c.

{
  char path[PATH_MAX] = { 0 };
  struct stat st = { 0 };
 
  if ((snprintf(path, sizeof(path), "%s/%d", mailbox_path(m), msgno) < sizeof(path)) &&
      (stat(path, &st) == 0))
  {
    return (mutt_file_stat_timespec_compare(&st, MUTT_STAT_MTIME, &m->last_visited) <= 0);
  }
  return -1;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_valid_message()

static bool mh_valid_message ( const char *  s )

static

Is this a valid MH message filename.

Parameters

s	Pathname to examine

Return values

true	name is valid
false	name is invalid

Ignore the garbage files. A valid MH message consists of only digits. Deleted message get moved to a filename with a comma before it.

Definition at line 149 of file mh.c.

{
  for (; *s; s++)
  {
    if (!isdigit((unsigned char) *s))
      return false;
  }
  return true;
}

Here is the caller graph for this function:

mh_check_empty()

int mh_check_empty

(

struct Buffer *

path

)

Is mailbox empty.

Parameters

path	Mailbox to check

Return values

1	Mailbox is empty
0	Mailbox contains mail
-1	Error

Definition at line 166 of file mh.c.

{
  struct dirent *de = NULL;
  int rc = 1; /* assume empty until we find a message */
 
  DIR *dir = mutt_file_opendir(buf_string(path), MUTT_OPENDIR_NONE);
  if (!dir)
    return -1;
  while ((de = readdir(dir)))
  {
    if (mh_valid_message(de->d_name))
    {
      rc = 0;
      break;
    }
  }
  closedir(dir);
 
  return rc;
}

Here is the call graph for this function:

mh_update_maildir()

static void mh_update_maildir ( struct MdEmailArray *  mda, struct MhSequences *  mhs  )

static

Update our record of flags.

Parameters

mda	Maildir array to update
mhs	Sequences

Definition at line 260 of file mh.c.

{
  struct MdEmail *md = NULL;
  struct MdEmail **mdp = NULL;
  ARRAY_FOREACH(mdp, mda)
  {
    md = *mdp;
    char *p = strrchr(md->email->path, '/');
    if (p)
      p++;
    else
      p = md->email->path;
 
    int i = 0;
    if (!mutt_str_atoi_full(p, &i))
      continue;
    MhSeqFlags flags = mh_seq_check(mhs, i);
 
    md->email->read = !(flags & MH_SEQ_UNSEEN);
    md->email->flagged = (flags & MH_SEQ_FLAGGED);
    md->email->replied = (flags & MH_SEQ_REPLIED);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_commit_msg()

static int mh_commit_msg ( struct Mailbox *  m, struct Message *  msg, struct Email *  e, bool  updseq  )

static

Commit a message to an MH folder.

Parameters

m	Mailbox
msg	Message to commit
e	Email
updseq	If true, update the sequence number

Return values

0	Success
-1	Failure

Definition at line 293 of file mh.c.

{
  struct dirent *de = NULL;
  char *cp = NULL, *dep = NULL;
  unsigned int n, hi = 0;
  char path[PATH_MAX] = { 0 };
  char tmp[16] = { 0 };
 
  if (mutt_file_fsync_close(&msg->fp))
  {
    mutt_perror(_("Could not flush message to disk"));
    return -1;
  }
 
  DIR *dir = mutt_file_opendir(mailbox_path(m), MUTT_OPENDIR_NONE);
  if (!dir)
  {
    mutt_perror("%s", mailbox_path(m));
    return -1;
  }
 
  /* figure out what the next message number is */
  while ((de = readdir(dir)))
  {
    dep = de->d_name;
    if (*dep == ',')
      dep++;
    cp = dep;
    while (*cp)
    {
      if (!isdigit((unsigned char) *cp))
        break;
      cp++;
    }
    if (*cp == '\0')
    {
      if (!mutt_str_atoui(dep, &n))
        mutt_debug(LL_DEBUG2, "Invalid MH message number '%s'\n", dep);
      if (n > hi)
        hi = n;
    }
  }
  closedir(dir);
 
  /* Now try to rename the file to the proper name.
   * Note: We may have to try multiple times, until we find a free slot.  */
 
  while (true)
  {
    hi++;
    snprintf(tmp, sizeof(tmp), "%u", hi);
    snprintf(path, sizeof(path), "%s/%s", mailbox_path(m), tmp);
    if (mutt_file_safe_rename(msg->path, path) == 0)
    {
      if (e)
        mutt_str_replace(&e->path, tmp);
      mutt_str_replace(&msg->committed_path, path);
      FREE(&msg->path);
      break;
    }
    else if (errno != EEXIST)
    {
      mutt_perror("%s", mailbox_path(m));
      return -1;
    }
  }
  if (updseq)
  {
    mh_seq_add_one(m, hi, !msg->flags.read, msg->flags.flagged, msg->flags.replied);
  }
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_rewrite_message()

static int mh_rewrite_message ( struct Mailbox *  m, struct Email *  e  )

static

Sync a message in an MH folder.

Parameters

m	Mailbox
e	Email

Return values

0	Success
-1	Error

Definition at line 373 of file mh.c.

{
  if (!m || !e)
    return -1;
 
  bool restore = true;
 
  long old_body_offset = e->body->offset;
  long old_body_length = e->body->length;
  long old_hdr_lines = e->lines;
 
  struct Message *src = mx_msg_open(m, e);
  struct Message *dest = mx_msg_open_new(m, e, MUTT_MSG_NO_FLAGS);
  if (!src || !dest)
    return -1;
 
  int rc = mutt_copy_message(dest->fp, e, src, MUTT_CM_UPDATE, CH_UPDATE | CH_UPDATE_LEN, 0);
  if (rc == 0)
  {
    char oldpath[PATH_MAX] = { 0 };
    char partpath[PATH_MAX] = { 0 };
    snprintf(oldpath, sizeof(oldpath), "%s/%s", mailbox_path(m), e->path);
    mutt_str_copy(partpath, e->path, sizeof(partpath));
 
    rc = mh_commit_msg(m, dest, e, false);
 
    if (rc == 0)
    {
      unlink(oldpath);
      restore = false;
    }
 
    /* Try to move the new message to the old place.
     * (MH only.)
     *
     * This is important when we are just updating flags.
     *
     * Note that there is a race condition against programs which
     * use the first free slot instead of the maximum message
     * number.  NeoMutt does _not_ behave like this.
     *
     * Anyway, if this fails, the message is in the folder, so
     * all what happens is that a concurrently running neomutt will
     * lose flag modifications.  */
    if (rc == 0)
    {
      char newpath[PATH_MAX] = { 0 };
      snprintf(newpath, sizeof(newpath), "%s/%s", mailbox_path(m), e->path);
      rc = mutt_file_safe_rename(newpath, oldpath);
      if (rc == 0)
        mutt_str_replace(&e->path, partpath);
    }
  }
  mx_msg_close(m, &src);
  mx_msg_close(m, &dest);
 
  if ((rc == -1) && restore)
  {
    e->body->offset = old_body_offset;
    e->body->length = old_body_length;
    e->lines = old_hdr_lines;
  }
 
  mutt_body_free(&e->body->parts);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_sync_message()

static int mh_sync_message ( struct Mailbox *  m, struct Email *  e  )

static

Sync an email to an MH folder.

Parameters

m	Mailbox
e	Email

Return values

0	Success
-1	Error

Definition at line 447 of file mh.c.

{
  if (!m || !e)
    return -1;
 
  if (e->attach_del || e->env->changed)
  {
    if (mh_rewrite_message(m, e) != 0)
      return -1;
    e->env->changed = false;
  }
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_update_mtime()

static void mh_update_mtime ( struct Mailbox *  m )

static

Update our record of the Maildir modification time.

Parameters

m

Mailbox

Definition at line 466 of file mh.c.

{
  char buf[PATH_MAX] = { 0 };
  struct stat st = { 0 };
  struct MaildirMboxData *mdata = maildir_mdata_get(m);
 
  snprintf(buf, sizeof(buf), "%s/.mh_sequences", mailbox_path(m));
  if (stat(buf, &st) == 0)
    mutt_file_get_stat_timespec(&mdata->mtime_cur, &st, MUTT_STAT_MTIME);
 
  mutt_str_copy(buf, mailbox_path(m), sizeof(buf));
 
  if (stat(buf, &st) == 0)
    mutt_file_get_stat_timespec(&mdata->mtime, &st, MUTT_STAT_MTIME);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_parse_dir()

static int mh_parse_dir ( struct Mailbox *  m, struct MdEmailArray *  mda, struct Progress *  progress  )

static

Read a Maildir mailbox.

Parameters

[in]	m	Mailbox
[out]	mda	Array for results
[in]	progress	Progress bar

Return values

0	Success
-1	Error
-2	Aborted

Definition at line 491 of file mh.c.

{
  struct dirent *de = NULL;
  int rc = 0;
  struct MdEmail *entry = NULL;
  struct Email *e = NULL;
 
  struct Buffer *buf = buf_pool_get();
  buf_strcpy(buf, mailbox_path(m));
 
  DIR *dir = mutt_file_opendir(buf_string(buf), MUTT_OPENDIR_NONE);
  if (!dir)
  {
    rc = -1;
    goto cleanup;
  }
 
  while (((de = readdir(dir))) && !SigInt)
  {
    if (!mh_valid_message(de->d_name))
      continue;
 
    mutt_debug(LL_DEBUG2, "queueing %s\n", de->d_name);
 
    e = email_new();
    e->edata = maildir_edata_new();
    e->edata_free = maildir_edata_free;
 
    progress_update(progress, ARRAY_SIZE(mda) + 1, -1);
 
    e->path = mutt_str_dup(de->d_name);
 
    entry = maildir_entry_new();
    entry->email = e;
    ARRAY_ADD(mda, entry);
  }
 
  closedir(dir);
 
  if (SigInt)
  {
    SigInt = false;
    return -2; /* action aborted */
  }
 
cleanup:
  buf_pool_release(&buf);
 
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_parse_message()

static struct Email * mh_parse_message ( const char *  fname, struct Email *  e  )

static

Actually parse an MH message.

Parameters

fname	Message filename
e	Email to populate (OPTIONAL)

Return values

ptr	Populated Email

This may also be used to fill out a fake header structure generated by lazy maildir parsing.

Definition at line 561 of file mh.c.

{
  FILE *fp = fopen(fname, "r");
  if (!fp)
  {
    return NULL;
  }
 
  const long size = mutt_file_get_size_fp(fp);
  if (size == 0)
  {
    mutt_file_fclose(&fp);
    return NULL;
  }
 
  if (!e)
  {
    e = email_new();
    e->edata = maildir_edata_new();
    e->edata_free = maildir_edata_free;
  }
  e->env = mutt_rfc822_read_header(fp, e, false, false);
 
  if (e->received != 0)
    e->received = e->date_sent;
 
  /* always update the length since we have fresh information available. */
  e->body->length = size - e->body->offset;
  e->index = -1;
 
  mutt_file_fclose(&fp);
  return e;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_delayed_parsing()

static void mh_delayed_parsing ( struct Mailbox *  m, struct MdEmailArray *  mda, struct Progress *  progress  )

static

This function does the second parsing pass.

Parameters

[in]	m	Mailbox
[out]	mda	Maildir array to parse
[in]	progress	Progress bar

Definition at line 601 of file mh.c.

{
  char fn[PATH_MAX] = { 0 };
 
#ifdef USE_HCACHE
  const char *const c_header_cache = cs_subset_path(NeoMutt->sub, "header_cache");
  struct HeaderCache *hc = hcache_open(c_header_cache, mailbox_path(m), NULL);
#endif
 
  struct MdEmail *md = NULL;
  struct MdEmail **mdp = NULL;
  ARRAY_FOREACH(mdp, mda)
  {
    md = *mdp;
    if (!md || !md->email || md->header_parsed)
      continue;
 
    progress_update(progress, ARRAY_FOREACH_IDX, -1);
 
    snprintf(fn, sizeof(fn), "%s/%s", mailbox_path(m), md->email->path);
 
#ifdef USE_HCACHE
    struct stat st_lastchanged = { 0 };
    int rc = 0;
    const bool c_maildir_header_cache_verify = cs_subset_bool(NeoMutt->sub, "maildir_header_cache_verify");
    if (c_maildir_header_cache_verify)
    {
      rc = stat(fn, &st_lastchanged);
    }
 
    const char *key = md->email->path;
    size_t keylen = strlen(key);
    struct HCacheEntry hce = hcache_fetch(hc, key, keylen, 0);
 
    if (hce.email && (rc == 0) && (st_lastchanged.st_mtime <= hce.uidvalidity))
    {
      hce.email->edata = maildir_edata_new();
      hce.email->edata_free = maildir_edata_free;
      hce.email->old = md->email->old;
      hce.email->path = mutt_str_dup(md->email->path);
      email_free(&md->email);
      md->email = hce.email;
    }
    else
#endif
    {
      if (mh_parse_message(fn, md->email))
      {
        md->header_parsed = true;
#ifdef USE_HCACHE
        key = md->email->path;
        keylen = strlen(key);
        hcache_store(hc, key, keylen, md->email, 0);
#endif
      }
      else
      {
        email_free(&md->email);
      }
    }
  }
#ifdef USE_HCACHE
  hcache_close(&hc);
#endif
 
  const enum SortType c_sort = cs_subset_sort(NeoMutt->sub, "sort");
  if (m && mda && (ARRAY_SIZE(mda) > 0) && (c_sort == SORT_ORDER))
  {
    mutt_debug(LL_DEBUG3, "maildir: sorting %s into natural order\n", mailbox_path(m));
    ARRAY_SORT(mda, mh_sort_path, NULL);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_read_dir()

static bool mh_read_dir ( struct Mailbox *  m )

static

Read an MH mailbox.

Parameters

m

Mailbox

Return values

true	Success
false	Error

Definition at line 681 of file mh.c.

{
  if (!m)
    return false;
 
  struct MhSequences mhs = { 0 };
  struct Progress *progress = NULL;
 
  if (m->verbose)
  {
    char msg[PATH_MAX] = { 0 };
    snprintf(msg, sizeof(msg), _("Scanning %s..."), mailbox_path(m));
    progress = progress_new(msg, MUTT_PROGRESS_READ, 0);
  }
 
  struct MaildirMboxData *mdata = maildir_mdata_get(m);
  if (!mdata)
  {
    mdata = maildir_mdata_new();
    m->mdata = mdata;
    m->mdata_free = maildir_mdata_free;
  }
 
  mh_update_mtime(m);
 
  struct MdEmailArray mda = ARRAY_HEAD_INITIALIZER;
  int rc = mh_parse_dir(m, &mda, progress);
  progress_free(&progress);
  if (rc < 0)
    return false;
 
  if (m->verbose)
  {
    char msg[PATH_MAX] = { 0 };
    snprintf(msg, sizeof(msg), _("Reading %s..."), mailbox_path(m));
    progress = progress_new(msg, MUTT_PROGRESS_READ, ARRAY_SIZE(&mda));
  }
  mh_delayed_parsing(m, &mda, progress);
  progress_free(&progress);
 
  if (mh_seq_read(&mhs, mailbox_path(m)) < 0)
  {
    maildirarray_clear(&mda);
    return false;
  }
  mh_update_maildir(&mda, &mhs);
  mh_seq_free(&mhs);
 
  maildir_move_to_mailbox(m, &mda);
  maildirarray_clear(&mda);
 
  if (!mdata->mh_umask)
    mdata->mh_umask = mh_umask(m);
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_sync_mailbox_message()

int mh_sync_mailbox_message	(	struct Mailbox *	m,
		struct Email *	e,
		struct HeaderCache *	hc
	)

Save changes to the mailbox.

Parameters

m	Mailbox
e	Email
hc	Header cache handle

Return values

0	Success
-1	Error

Definition at line 746 of file mh.c.

{
  if (!m || !e)
    return -1;
 
  if (e->deleted)
  {
    char path[PATH_MAX] = { 0 };
    snprintf(path, sizeof(path), "%s/%s", mailbox_path(m), e->path);
    const bool c_mh_purge = cs_subset_bool(NeoMutt->sub, "mh_purge");
    if (c_mh_purge)
    {
#ifdef USE_HCACHE
      if (hc)
      {
        const char *key = e->path;
        size_t keylen = strlen(key);
        hcache_delete_record(hc, key, keylen);
      }
#endif
      unlink(path);
    }
    else
    {
      /* MH just moves files out of the way when you delete them */
      if (*e->path != ',')
      {
        char tmp[PATH_MAX] = { 0 };
        snprintf(tmp, sizeof(tmp), "%s/,%s", mailbox_path(m), e->path);
        unlink(tmp);
        if (rename(path, tmp) != 0)
        {
          return -1;
        }
      }
    }
  }
  else if (e->changed || e->attach_del)
  {
    if (mh_sync_message(m, e) == -1)
      return -1;
  }
 
#ifdef USE_HCACHE
  if (hc && e->changed)
  {
    const char *key = e->path;
    size_t keylen = strlen(key);
    hcache_store(hc, key, keylen, e, 0);
  }
#endif
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mh_check()

static enum MxStatus mh_check ( struct Mailbox *  m )

static

Check for new mail.

Parameters

m

Mailbox

Return values

enum

MxStatus

This function handles arrival of new mail and reopening of mh/maildir folders. Things are getting rather complex because we don't have a well-defined "mailbox order", so the tricks from mbox.c and mx.c won't work here.

Don't change this code unless you really understand what happens.

Definition at line 880 of file mh.c.

{
  char buf[PATH_MAX] = { 0 };
  struct stat st = { 0 };
  struct stat st_cur = { 0 };
  bool modified = false, occult = false, flags_changed = false;
  int num_new = 0;
  struct MhSequences mhs = { 0 };
  struct HashTable *fnames = NULL;
  struct MaildirMboxData *mdata = maildir_mdata_get(m);
 
  const bool c_check_new = cs_subset_bool(NeoMutt->sub, "check_new");
  if (!c_check_new)
    return MX_STATUS_OK;
 
  mutt_str_copy(buf, mailbox_path(m), sizeof(buf));
  if (stat(buf, &st) == -1)
    return MX_STATUS_ERROR;
 
  /* create .mh_sequences when there isn't one. */
  snprintf(buf, sizeof(buf), "%s/.mh_sequences", mailbox_path(m));
  int rc = stat(buf, &st_cur);
  if ((rc == -1) && (errno == ENOENT))
  {
    char *tmp = NULL;
    FILE *fp = NULL;
 
    if (mh_mkstemp(m, &fp, &tmp))
    {
      mutt_file_fclose(&fp);
      if (mutt_file_safe_rename(tmp, buf) == -1)
        unlink(tmp);
      FREE(&tmp);
    }
  }
 
  if ((rc == -1) && (stat(buf, &st_cur) == -1))
    modified = true;
 
  if ((mutt_file_stat_timespec_compare(&st, MUTT_STAT_MTIME, &mdata->mtime) > 0) ||
      (mutt_file_stat_timespec_compare(&st_cur, MUTT_STAT_MTIME, &mdata->mtime_cur) > 0))
  {
    modified = true;
  }
 
  if (!modified)
    return MX_STATUS_OK;
 
    /* Update the modification times on the mailbox.
     *
     * The monitor code notices changes in the open mailbox too quickly.
     * In practice, this sometimes leads to all the new messages not being
     * noticed during the SAME group of mtime stat updates.  To work around
     * the problem, don't update the stat times for a monitor caused check. */
#ifdef USE_INOTIFY
  if (MonitorContextChanged)
  {
    MonitorContextChanged = false;
  }
  else
#endif
  {
    mutt_file_get_stat_timespec(&mdata->mtime_cur, &st_cur, MUTT_STAT_MTIME);
    mutt_file_get_stat_timespec(&mdata->mtime, &st, MUTT_STAT_MTIME);
  }
 
  struct MdEmailArray mda = ARRAY_HEAD_INITIALIZER;
 
  mh_parse_dir(m, &mda, NULL);
  mh_delayed_parsing(m, &mda, NULL);
 
  if (mh_seq_read(&mhs, mailbox_path(m)) < 0)
    return MX_STATUS_ERROR;
  mh_update_maildir(&mda, &mhs);
  mh_seq_free(&mhs);
 
  /* check for modifications and adjust flags */
  fnames = mutt_hash_new(ARRAY_SIZE(&mda), MUTT_HASH_NO_FLAGS);
 
  struct MdEmail *md = NULL;
  struct MdEmail **mdp = NULL;
  ARRAY_FOREACH(mdp, &mda)
  {
    md = *mdp;
    /* the hash key must survive past the header, which is freed below. */
    md->canon_fname = mutt_str_dup(md->email->path);
    mutt_hash_insert(fnames, md->canon_fname, md);
  }
 
  for (int i = 0; i < m->msg_count; i++)
  {
    struct Email *e = m->emails[i];
    if (!e)
      break;
 
    md = mutt_hash_find(fnames, e->path);
    if (md && md->email && email_cmp_strict(e, md->email))
    {
      /* found the right message */
      if (!e->changed)
        if (maildir_update_flags(m, e, md->email))
          flags_changed = true;
 
      email_free(&md->email);
    }
    else /* message has disappeared */
    {
      occult = true;
    }
  }
 
  /* destroy the file name hash */
 
  mutt_hash_free(&fnames);
 
  /* If we didn't just get new mail, update the tables. */
  if (occult)
    mailbox_changed(m, NT_MAILBOX_RESORT);
 
  /* Incorporate new messages */
  num_new = maildir_move_to_mailbox(m, &mda);
  maildirarray_clear(&mda);
 
  if (num_new > 0)
  {
    mailbox_changed(m, NT_MAILBOX_INVALID);
    m->changed = true;
  }
 
  ARRAY_FREE(&mda);
  if (occult)
    return MX_STATUS_REOPENED;
  if (num_new > 0)
    return MX_STATUS_NEW_MAIL;
  if (flags_changed)
    return MX_STATUS_FLAGS;
  return MX_STATUS_OK;
}

Here is the call graph for this function:

Here is the caller graph for this function: