muttlib.c File Reference

Some miscellaneous functions. More...

#include "config.h"
#include <ctype.h>
#include <errno.h>
#include <limits.h>
#include <pwd.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <sys/stat.h>
#include <unistd.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 "muttlib.h"
#include "enter/lib.h"
#include "ncrypt/lib.h"
#include "parse/lib.h"
#include "question/lib.h"
#include "format_flags.h"
#include "globals.h"
#include "hook.h"
#include "mx.h"
#include "protos.h"
#include "imap/lib.h"

Include dependency graph for muttlib.c:

Go to the source code of this file.

Functions
void	mutt_adv_mktemp (struct Buffer *buf)
	Create a temporary file. More...
char *	mutt_expand_path (char *buf, size_t buflen)
	Create the canonical path. More...
void	buf_expand_path_regex (struct Buffer *buf, bool regex)
	Create the canonical path (with regex char escaping) More...
void	buf_expand_path (struct Buffer *buf)
	Create the canonical path. More...
char *	mutt_expand_path_regex (char *buf, size_t buflen, bool regex)
	Create the canonical path (with regex char escaping) More...
char *	mutt_gecos_name (char *dest, size_t destlen, struct passwd *pw)
	Lookup a user's real name in /etc/passwd. More...
bool	mutt_needs_mailcap (struct Body *m)
	Does this type need a mailcap entry do display. More...
bool	mutt_is_text_part (struct Body *b)
	Is this part of an email in plain text? More...
void	mutt_pretty_mailbox (char *buf, size_t buflen)
	Shorten a mailbox path using '~' or '='. More...
void	buf_pretty_mailbox (struct Buffer *buf)
	Shorten a mailbox path using '~' or '='. More...
int	mutt_check_overwrite (const char *attname, const char *path, struct Buffer *fname, enum SaveAttach *opt, char **directory)
	Ask the user if overwriting is necessary. More...
void	mutt_save_path (char *buf, size_t buflen, const struct Address *addr)
	Turn an email address into a filename (for saving) More...
void	buf_save_path (struct Buffer *dest, const struct Address *a)
	Make a safe filename from an email address. More...
void	mutt_safe_path (struct Buffer *dest, const struct Address *a)
	Make a safe filename from an email address. More...
void	mutt_expando_format (char *buf, size_t buflen, size_t col, int cols, const char *src, format_t callback, intptr_t data, MuttFormatFlags flags)
	Expand expandos (x) in a string -. More...
FILE *	mutt_open_read (const char *path, pid_t *thepid)
	Run a command to read from. More...
int	mutt_save_confirm (const char *s, struct stat *st)
	Ask the user to save. More...
void	mutt_sleep (short s)
	Sleep for a while. More...
const char *	mutt_make_version (void)
	Generate the NeoMutt version string. More...
void	mutt_encode_path (struct Buffer *buf, const char *src)
	Convert a path to 'us-ascii'. More...
int	mutt_set_xdg_path (enum XdgType type, struct Buffer *buf)
	Find an XDG path or its fallback. More...
void	mutt_get_parent_path (const char *path, char *buf, size_t buflen)
	Find the parent of a path (or mailbox) More...
int	mutt_inbox_cmp (const char *a, const char *b)
	Do two folders share the same path and one is an inbox. More...
void	buf_sanitize_filename (struct Buffer *buf, const char *path, short slash)
	Replace unsafe characters in a filename. More...
void	mutt_str_pretty_size (char *buf, size_t buflen, size_t num)
	Display an abbreviated size, like 3.4K. More...
void	add_to_stailq (struct ListHead *head, const char *str)
	Add a string to a list. More...
void	remove_from_stailq (struct ListHead *head, const char *str)
	Remove an item, matching a string, from a List. More...

Variables
static const char *	XdgEnvVars []
	Accepted XDG environment variables. More...
static const char *	XdgDefaults []
	XDG default locations. More...

Detailed Description

Some miscellaneous functions.

Authors

• Michael R. Elkins
• Thomas Roessler
• Pietro Cerutti

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

Function Documentation

mutt_adv_mktemp()

void mutt_adv_mktemp

(

struct Buffer *

buf

)

Create a temporary file.

Parameters

buf	Buffer for the name

Accept a "suggestion" for file name. If that file exists, then construct one with unique name but keep any extension. This might fail, I guess.

Definition at line 85 of file muttlib.c.

{
  if (!(buf->data && (buf->data[0] != '\0')))
  {
    buf_mktemp(buf);
  }
  else
  {
    struct Buffer *prefix = buf_pool_get();
    buf_strcpy(prefix, buf->data);
    mutt_file_sanitize_filename(prefix->data, true);
    const char *const c_tmp_dir = cs_subset_path(NeoMutt->sub, "tmp_dir");
    buf_printf(buf, "%s/%s", NONULL(c_tmp_dir), buf_string(prefix));
 
    struct stat st = { 0 };
    if ((lstat(buf_string(buf), &st) == -1) && (errno == ENOENT))
      goto out;
 
    char *suffix = strchr(prefix->data, '.');
    if (suffix)
    {
      *suffix = '\0';
      suffix++;
    }
    buf_mktemp_pfx_sfx(buf, prefix->data, suffix);
 
  out:
    buf_pool_release(&prefix);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_expand_path()

char * mutt_expand_path	(	char *	buf,
		size_t	buflen
	)

Create the canonical path.

Parameters

buf	Buffer with path
buflen	Length of buffer

Return values

ptr	The expanded string

Note

The path is expanded in-place

Definition at line 124 of file muttlib.c.

{
  return mutt_expand_path_regex(buf, buflen, false);
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_expand_path_regex()

void buf_expand_path_regex	(	struct Buffer *	buf,
		bool	regex
	)

Create the canonical path (with regex char escaping)

Parameters

buf	Buffer with path
regex	If true, escape any regex characters

Note

The path is expanded in-place

Definition at line 136 of file muttlib.c.

{
  const char *s = NULL;
  const char *tail = "";
 
  bool recurse = false;
 
  struct Buffer *p = buf_pool_get();
  struct Buffer *q = buf_pool_get();
  struct Buffer *tmp = buf_pool_get();
 
  do
  {
    recurse = false;
    s = buf_string(buf);
 
    switch (*s)
    {
      case '~':
      {
        if ((s[1] == '/') || (s[1] == '\0'))
        {
          buf_strcpy(p, HomeDir);
          tail = s + 1;
        }
        else
        {
          char *t = strchr(s + 1, '/');
          if (t)
            *t = '\0';
 
          struct passwd *pw = getpwnam(s + 1);
          if (pw)
          {
            buf_strcpy(p, pw->pw_dir);
            if (t)
            {
              *t = '/';
              tail = t;
            }
            else
            {
              tail = "";
            }
          }
          else
          {
            /* user not found! */
            if (t)
              *t = '/';
            buf_reset(p);
            tail = s;
          }
        }
        break;
      }
 
      case '=':
      case '+':
      {
        const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
        enum MailboxType mb_type = mx_path_probe(c_folder);
 
        /* if folder = {host} or imap[s]://host/: don't append slash */
        if ((mb_type == MUTT_IMAP) && ((c_folder[strlen(c_folder) - 1] == '}') ||
                                       (c_folder[strlen(c_folder) - 1] == '/')))
        {
          buf_strcpy(p, NONULL(c_folder));
        }
        else if (mb_type == MUTT_NOTMUCH)
        {
          buf_strcpy(p, NONULL(c_folder));
        }
        else if (c_folder && (c_folder[strlen(c_folder) - 1] == '/'))
        {
          buf_strcpy(p, NONULL(c_folder));
        }
        else
        {
          buf_printf(p, "%s/", NONULL(c_folder));
        }
 
        tail = s + 1;
        break;
      }
 
        /* elm compatibility, @ expands alias to user name */
 
      case '@':
      {
        struct AddressList *al = alias_lookup(s + 1);
        if (al && !TAILQ_EMPTY(al))
        {
          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);
 
          /* TODO: fix mutt_default_save() to use Buffer */
          buf_alloc(p, PATH_MAX);
          mutt_default_save(p->data, p->dsize, e);
          buf_fix_dptr(p);
 
          email_free(&e);
          /* Avoid infinite recursion if the resulting folder starts with '@' */
          if (*p->data != '@')
            recurse = true;
 
          tail = "";
        }
        break;
      }
 
      case '>':
      {
        const char *const c_mbox = cs_subset_string(NeoMutt->sub, "mbox");
        buf_strcpy(p, c_mbox);
        tail = s + 1;
        break;
      }
 
      case '<':
      {
        const char *const c_record = cs_subset_string(NeoMutt->sub, "record");
        buf_strcpy(p, c_record);
        tail = s + 1;
        break;
      }
 
      case '!':
      {
        if (s[1] == '!')
        {
          buf_strcpy(p, LastFolder);
          tail = s + 2;
        }
        else
        {
          const char *const c_spool_file = cs_subset_string(NeoMutt->sub, "spool_file");
          buf_strcpy(p, c_spool_file);
          tail = s + 1;
        }
        break;
      }
 
      case '-':
      {
        buf_strcpy(p, LastFolder);
        tail = s + 1;
        break;
      }
 
      case '^':
      {
        buf_strcpy(p, CurrentFolder);
        tail = s + 1;
        break;
      }
 
      default:
      {
        buf_reset(p);
        tail = s;
      }
    }
 
    if (regex && *(buf_string(p)) && !recurse)
    {
      mutt_file_sanitize_regex(q, buf_string(p));
      buf_printf(tmp, "%s%s", buf_string(q), tail);
    }
    else
    {
      buf_printf(tmp, "%s%s", buf_string(p), tail);
    }
 
    buf_copy(buf, tmp);
  } while (recurse);
 
  buf_pool_release(&p);
  buf_pool_release(&q);
  buf_pool_release(&tmp);
 
#ifdef USE_IMAP
  /* Rewrite IMAP path in canonical form - aids in string comparisons of
   * folders. May possibly fail, in which case buf should be the same. */
  if (imap_path_probe(buf_string(buf), NULL) == MUTT_IMAP)
    imap_expand_path(buf);
#endif
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_expand_path()

void buf_expand_path

(

struct Buffer *

buf

)

Create the canonical path.

Parameters

buf	Buffer with path

Note

The path is expanded in-place

Definition at line 333 of file muttlib.c.

{
  buf_expand_path_regex(buf, false);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_expand_path_regex()

char * mutt_expand_path_regex	(	char *	buf,
		size_t	buflen,
		bool	regex
	)

Create the canonical path (with regex char escaping)

Parameters

buf	Buffer with path
buflen	Length of buffer
regex	If true, escape any regex characters

Return values

ptr	The expanded string

Note

The path is expanded in-place

Definition at line 347 of file muttlib.c.

{
  struct Buffer *tmp = buf_pool_get();
 
  buf_addstr(tmp, NONULL(buf));
  buf_expand_path_regex(tmp, regex);
  mutt_str_copy(buf, buf_string(tmp), buflen);
 
  buf_pool_release(&tmp);
 
  return buf;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_gecos_name()

char * mutt_gecos_name	(	char *	dest,
		size_t	destlen,
		struct passwd *	pw
	)

Lookup a user's real name in /etc/passwd.

Parameters

dest	Buffer for the result
destlen	Length of buffer
pw	Passwd entry

Return values

ptr	Result buffer on success

Extract the real name from /etc/passwd's GECOS field. When set, honor the regular expression in $gecos_mask, otherwise assume that the GECOS field is a comma-separated list. Replace "&" by a capitalized version of the user's login name.

Definition at line 372 of file muttlib.c.

{
  regmatch_t pat_match[1];
  size_t pwnl;
  char *p = NULL;
 
  if (!pw || !pw->pw_gecos)
    return NULL;
 
  memset(dest, 0, destlen);
 
  const struct Regex *c_gecos_mask = cs_subset_regex(NeoMutt->sub, "gecos_mask");
  if (mutt_regex_capture(c_gecos_mask, pw->pw_gecos, 1, pat_match))
  {
    mutt_str_copy(dest, pw->pw_gecos + pat_match[0].rm_so,
                  MIN(pat_match[0].rm_eo - pat_match[0].rm_so + 1, destlen));
  }
  else if ((p = strchr(pw->pw_gecos, ',')))
  {
    mutt_str_copy(dest, pw->pw_gecos, MIN(destlen, p - pw->pw_gecos + 1));
  }
  else
  {
    mutt_str_copy(dest, pw->pw_gecos, destlen);
  }
 
  pwnl = strlen(pw->pw_name);
 
  for (int idx = 0; dest[idx]; idx++)
  {
    if (dest[idx] == '&')
    {
      memmove(&dest[idx + pwnl], &dest[idx + 1],
              MAX((ssize_t) (destlen - idx - pwnl - 1), 0));
      memcpy(&dest[idx], pw->pw_name, MIN(destlen - idx - 1, pwnl));
      dest[idx] = toupper((unsigned char) dest[idx]);
    }
  }
 
  return dest;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_needs_mailcap()

bool mutt_needs_mailcap

(

struct Body *

m

)

Does this type need a mailcap entry do display.

Parameters

m	Attachment body to be displayed

Return values

true	NeoMutt requires a mailcap entry to display
false	otherwise

Definition at line 420 of file muttlib.c.

{
  switch (m->type)
  {
    case TYPE_TEXT:
      if (mutt_istr_equal("plain", m->subtype))
        return false;
      break;
    case TYPE_APPLICATION:
      if (((WithCrypto & APPLICATION_PGP) != 0) && mutt_is_application_pgp(m))
        return false;
      if (((WithCrypto & APPLICATION_SMIME) != 0) && mutt_is_application_smime(m))
        return false;
      break;
 
    case TYPE_MULTIPART:
    case TYPE_MESSAGE:
      return false;
  }
 
  return true;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_is_text_part()

bool mutt_is_text_part

(

struct Body *

b

)

Is this part of an email in plain text?

Parameters

b	Part of an email

Return values

true	Part is in plain text

Definition at line 448 of file muttlib.c.

{
  int t = b->type;
  char *s = b->subtype;
 
  if (((WithCrypto & APPLICATION_PGP) != 0) && mutt_is_application_pgp(b))
    return false;
 
  if (t == TYPE_TEXT)
    return true;
 
  if (t == TYPE_MESSAGE)
  {
    if (mutt_istr_equal("delivery-status", s))
      return true;
  }
 
  if (((WithCrypto & APPLICATION_PGP) != 0) && (t == TYPE_APPLICATION))
  {
    if (mutt_istr_equal("pgp-keys", s))
      return true;
  }
 
  return false;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_pretty_mailbox()

void mutt_pretty_mailbox	(	char *	buf,
		size_t	buflen
	)

Shorten a mailbox path using '~' or '='.

Parameters

buf	Buffer containing string to shorten
buflen	Length of buffer

Collapse the pathname using ~ or = when possible

Definition at line 481 of file muttlib.c.

{
  if (!buf)
    return;
 
  char *p = buf, *q = buf;
  size_t len;
  enum UrlScheme scheme;
  char tmp[PATH_MAX] = { 0 };
 
  scheme = url_check_scheme(buf);
 
  const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
  if ((scheme == U_IMAP) || (scheme == U_IMAPS))
  {
    imap_pretty_mailbox(buf, buflen, c_folder);
    return;
  }
 
  if (scheme == U_NOTMUCH)
    return;
 
  /* if buf is an url, only collapse path component */
  if (scheme != U_UNKNOWN)
  {
    p = strchr(buf, ':') + 1;
    if (mutt_strn_equal(p, "//", 2))
      q = strchr(p + 2, '/');
    if (!q)
      q = strchr(p, '\0');
    p = q;
  }
 
  /* cleanup path */
  if (strstr(p, "//") || strstr(p, "/./"))
  {
    /* first attempt to collapse the pathname, this is more
     * lightweight than realpath() and doesn't resolve links */
    while (*p)
    {
      if ((p[0] == '/') && (p[1] == '/'))
      {
        *q++ = '/';
        p += 2;
      }
      else if ((p[0] == '/') && (p[1] == '.') && (p[2] == '/'))
      {
        *q++ = '/';
        p += 3;
      }
      else
      {
        *q++ = *p++;
      }
    }
    *q = '\0';
  }
  else if (strstr(p, "..") && ((scheme == U_UNKNOWN) || (scheme == U_FILE)) &&
           realpath(p, tmp))
  {
    mutt_str_copy(p, tmp, buflen - (p - buf));
  }
 
  if ((len = mutt_str_startswith(buf, c_folder)) && (buf[len] == '/'))
  {
    *buf++ = '=';
    memmove(buf, buf + len, mutt_str_len(buf + len) + 1);
  }
  else if ((len = mutt_str_startswith(buf, HomeDir)) && (buf[len] == '/'))
  {
    *buf++ = '~';
    memmove(buf, buf + len - 1, mutt_str_len(buf + len - 1) + 1);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_pretty_mailbox()

void buf_pretty_mailbox

(

struct Buffer *

buf

)

Shorten a mailbox path using '~' or '='.

Parameters

buf	Buffer containing Mailbox name

Definition at line 560 of file muttlib.c.

{
  if (!buf || !buf->data)
    return;
  /* This reduces the size of the Buffer, so we can pass it through.
   * We adjust the size just to make sure buf->data is not NULL though */
  buf_alloc(buf, PATH_MAX);
  mutt_pretty_mailbox(buf->data, buf->dsize);
  buf_fix_dptr(buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_check_overwrite()

int mutt_check_overwrite	(	const char *	attname,
		const char *	path,
		struct Buffer *	fname,
		enum SaveAttach *	opt,
		char **	directory
	)

Ask the user if overwriting is necessary.

Parameters

[in]	attname	Attachment name
[in]	path	Path to save the file
[out]	fname	Buffer for filename
[out]	opt	Save option, see SaveAttach
[out]	directory	Directory to save under (OPTIONAL)

Return values

0	Success
-1	Abort
1	Error

Definition at line 582 of file muttlib.c.

{
  struct stat st = { 0 };
 
  buf_strcpy(fname, path);
  if (access(buf_string(fname), F_OK) != 0)
    return 0;
  if (stat(buf_string(fname), &st) != 0)
    return -1;
  if (S_ISDIR(st.st_mode))
  {
    enum QuadOption ans = MUTT_NO;
    if (directory)
    {
      switch (mutt_multi_choice
              /* L10N: Means "The path you specified as the destination file is a directory."
                 See the msgid "Save to file: " (alias.c, recvattach.c)
                 These three letters correspond to the choices in the string.  */
              (_("File is a directory, save under it: (y)es, (n)o, (a)ll?"), _("yna")))
      {
        case 3: /* all */
          mutt_str_replace(directory, buf_string(fname));
          break;
        case 1: /* yes */
          FREE(directory);
          break;
        case -1: /* abort */
          FREE(directory);
          return -1;
        case 2: /* no */
          FREE(directory);
          return 1;
      }
    }
    /* L10N: Means "The path you specified as the destination file is a directory."
       See the msgid "Save to file: " (alias.c, recvattach.c) */
    else if ((ans = mutt_yesorno(_("File is a directory, save under it?"), MUTT_YES)) != MUTT_YES)
      return (ans == MUTT_NO) ? 1 : -1;
 
    struct Buffer *tmp = buf_pool_get();
    buf_strcpy(tmp, mutt_path_basename(NONULL(attname)));
    if ((buf_get_field(_("File under directory: "), tmp, MUTT_COMP_FILE | MUTT_COMP_CLEAR,
                       false, NULL, NULL, NULL) != 0) ||
        buf_is_empty(tmp))
    {
      buf_pool_release(&tmp);
      return (-1);
    }
    buf_concat_path(fname, path, buf_string(tmp));
    buf_pool_release(&tmp);
  }
 
  if ((*opt == MUTT_SAVE_NO_FLAGS) && (access(buf_string(fname), F_OK) == 0))
  {
    char buf[4096] = { 0 };
    snprintf(buf, sizeof(buf), "%s - %s", buf_string(fname),
             // L10N: Options for: File %s exists, (o)verwrite, (a)ppend, or (c)ancel?
             _("File exists, (o)verwrite, (a)ppend, or (c)ancel?"));
    switch (mutt_multi_choice(buf, _("oac")))
    {
      case -1: /* abort */
        return -1;
      case 3: /* cancel */
        return 1;
 
      case 2: /* append */
        *opt = MUTT_SAVE_APPEND;
        break;
      case 1: /* overwrite */
        *opt = MUTT_SAVE_OVERWRITE;
        break;
    }
  }
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_save_path()

void mutt_save_path	(	char *	buf,
		size_t	buflen,
		const struct Address *	addr
	)

Turn an email address into a filename (for saving)

Parameters

buf	Buffer for the result
buflen	Length of buffer
addr	Email address to use

If the user hasn't set $save_address the name will be truncated to the '@' character.

Definition at line 668 of file muttlib.c.

{
  if (addr && addr->mailbox)
  {
    mutt_str_copy(buf, buf_string(addr->mailbox), buflen);
    const bool c_save_address = cs_subset_bool(NeoMutt->sub, "save_address");
    if (!c_save_address)
    {
      char *p = strpbrk(buf, "%@");
      if (p)
        *p = '\0';
    }
    mutt_str_lower(buf);
  }
  else
  {
    *buf = '\0';
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_save_path()

void buf_save_path	(	struct Buffer *	dest,
		const struct Address *	a
	)

Make a safe filename from an email address.

Parameters

dest	Buffer for the result
a	Address to use

Definition at line 693 of file muttlib.c.

{
  if (a && a->mailbox)
  {
    buf_copy(dest, a->mailbox);
    const bool c_save_address = cs_subset_bool(NeoMutt->sub, "save_address");
    if (!c_save_address)
    {
      char *p = strpbrk(dest->data, "%@");
      if (p)
      {
        *p = '\0';
        buf_fix_dptr(dest);
      }
    }
    mutt_str_lower(dest->data);
  }
  else
  {
    buf_reset(dest);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_safe_path()

void mutt_safe_path	(	struct Buffer *	dest,
		const struct Address *	a
	)

Make a safe filename from an email address.

Parameters

dest	Buffer for the result
a	Address to use

The filename will be stripped of '/', space, etc to make it safe.

Definition at line 723 of file muttlib.c.

{
  buf_save_path(dest, a);
  for (char *p = dest->data; *p; p++)
    if ((*p == '/') || isspace(*p) || !IsPrint((unsigned char) *p))
      *p = '_';
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_open_read()

FILE * mutt_open_read	(	const char *	path,
		pid_t *	thepid
	)

Run a command to read from.

Parameters

[in]	path	Path to command
[out]	thepid	PID of the command

Return values

ptr	File containing output of command

This function allows the user to specify a command to read stdout from in place of a normal file. If the last character in the string is a pipe (|), then we assume it is a command to run instead of a normal file.

Definition at line 1280 of file muttlib.c.

{
  FILE *fp = NULL;
  struct stat st = { 0 };
 
  size_t len = mutt_str_len(path);
  if (len == 0)
  {
    return NULL;
  }
 
  if (path[len - 1] == '|')
  {
    /* read from a pipe */
 
    char *p = mutt_str_dup(path);
 
    p[len - 1] = 0;
    mutt_endwin();
    *thepid = filter_create(p, NULL, &fp, NULL);
    FREE(&p);
  }
  else
  {
    if (stat(path, &st) < 0)
      return NULL;
    if (S_ISDIR(st.st_mode))
    {
      errno = EINVAL;
      return NULL;
    }
    fp = fopen(path, "r");
    *thepid = -1;
  }
  return fp;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_save_confirm()

int mutt_save_confirm	(	const char *	s,
		struct stat *	st
	)

Ask the user to save.

Parameters

s	Save location
st	Timestamp

Return values

0	OK to proceed
-1	to abort
1	to retry

Definition at line 1325 of file muttlib.c.

{
  int rc = 0;
 
  enum MailboxType type = mx_path_probe(s);
 
#ifdef USE_POP
  if (type == MUTT_POP)
  {
    mutt_error(_("Can't save message to POP mailbox"));
    return 1;
  }
#endif
 
  if ((type != MUTT_MAILBOX_ERROR) && (type != MUTT_UNKNOWN) && (mx_access(s, W_OK) == 0))
  {
    const bool c_confirm_append = cs_subset_bool(NeoMutt->sub, "confirm_append");
    if (c_confirm_append)
    {
      struct Buffer *tmp = buf_pool_get();
      buf_printf(tmp, _("Append messages to %s?"), s);
      enum QuadOption ans = mutt_yesorno(buf_string(tmp), MUTT_YES);
      if (ans == MUTT_NO)
        rc = 1;
      else if (ans == MUTT_ABORT)
        rc = -1;
      buf_pool_release(&tmp);
    }
  }
 
#ifdef USE_NNTP
  if (type == MUTT_NNTP)
  {
    mutt_error(_("Can't save message to news server"));
    return 0;
  }
#endif
 
  if (stat(s, st) != -1)
  {
    if (type == MUTT_MAILBOX_ERROR)
    {
      mutt_error(_("%s is not a mailbox"), s);
      return 1;
    }
  }
  else if (type != MUTT_IMAP)
  {
    st->st_mtime = 0;
    st->st_atime = 0;
 
    /* pathname does not exist */
    if (errno == ENOENT)
    {
      const bool c_confirm_create = cs_subset_bool(NeoMutt->sub, "confirm_create");
      if (c_confirm_create)
      {
        struct Buffer *tmp = buf_pool_get();
        buf_printf(tmp, _("Create %s?"), s);
        enum QuadOption ans = mutt_yesorno(buf_string(tmp), MUTT_YES);
        if (ans == MUTT_NO)
          rc = 1;
        else if (ans == MUTT_ABORT)
          rc = -1;
        buf_pool_release(&tmp);
      }
 
      /* user confirmed with MUTT_YES or set `$confirm_create` */
      if (rc == 0)
      {
        /* create dir recursively */
        char *tmp_path = mutt_path_dirname(s);
        if (mutt_file_mkdir(tmp_path, S_IRWXU) == -1)
        {
          /* report failure & abort */
          mutt_perror(s);
          FREE(&tmp_path);
          return 1;
        }
        FREE(&tmp_path);
      }
    }
    else
    {
      mutt_perror(s);
      return 1;
    }
  }
 
  msgwin_clear_text();
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_sleep()

void mutt_sleep

(

short

s

)

Sleep for a while.

Parameters

s	Number of seconds to sleep

If the user config '$sleep_time' is larger, sleep that long instead.

Definition at line 1424 of file muttlib.c.

{
  const short c_sleep_time = cs_subset_number(NeoMutt->sub, "sleep_time");
  if (c_sleep_time > s)
    sleep(c_sleep_time);
  else if (s)
    sleep(s);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_make_version()

const char * mutt_make_version

(

void

)

Generate the NeoMutt version string.

Return values

ptr	Version string

Note

This returns a pointer to a static buffer

Definition at line 1439 of file muttlib.c.

{
  static char vstring[256];
  snprintf(vstring, sizeof(vstring), "NeoMutt %s%s", PACKAGE_VERSION, GitVer);
  return vstring;
}

Here is the caller graph for this function:

mutt_encode_path()

void mutt_encode_path	(	struct Buffer *	buf,
		const char *	src
	)

Convert a path to 'us-ascii'.

Parameters

buf	Buffer for the result
src	Path to convert (OPTIONAL)

If src is NULL, the path in buf will be converted in-place.

Definition at line 1453 of file muttlib.c.

{
  char *p = mutt_str_dup(src);
  int rc = mutt_ch_convert_string(&p, cc_charset(), "us-ascii", MUTT_ICONV_NO_FLAGS);
  size_t len = buf_strcpy(buf, (rc == 0) ? NONULL(p) : NONULL(src));
 
  /* convert the path to POSIX "Portable Filename Character Set" */
  for (size_t i = 0; i < len; i++)
  {
    if (!isalnum(buf->data[i]) && !strchr("/.-_", buf->data[i]))
    {
      buf->data[i] = '_';
    }
  }
  FREE(&p);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_set_xdg_path()

int mutt_set_xdg_path	(	enum XdgType	type,
		struct Buffer *	buf
	)

Find an XDG path or its fallback.

Parameters

type	Type of XDG variable, e.g. XDG_CONFIG_HOME
buf	Buffer to save path

Return values

1	An entry was found that actually exists on disk and 0 otherwise

Process an XDG environment variable or its fallback.

Definition at line 1478 of file muttlib.c.

{
  const char *xdg_env = mutt_str_getenv(XdgEnvVars[type]);
  char *xdg = xdg_env ? mutt_str_dup(xdg_env) : mutt_str_dup(XdgDefaults[type]);
  char *x = xdg; /* mutt_str_sep() changes xdg, so free x instead later */
  char *token = NULL;
  int rc = 0;
 
  while ((token = mutt_str_sep(&xdg, ":")))
  {
    if (buf_printf(buf, "%s/%s/neomuttrc", token, PACKAGE) < 0)
      continue;
    buf_expand_path(buf);
    if (access(buf_string(buf), F_OK) == 0)
    {
      rc = 1;
      break;
    }
 
    if (buf_printf(buf, "%s/%s/Muttrc", token, PACKAGE) < 0)
      continue;
    buf_expand_path(buf);
    if (access(buf_string(buf), F_OK) == 0)
    {
      rc = 1;
      break;
    }
  }
 
  FREE(&x);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_get_parent_path()

void mutt_get_parent_path	(	const char *	path,
		char *	buf,
		size_t	buflen
	)

Find the parent of a path (or mailbox)

Parameters

path	Path to use
buf	Buffer for the result
buflen	Length of buffer

Definition at line 1517 of file muttlib.c.

{
  enum MailboxType mb_type = mx_path_probe(path);
 
  const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
  if (mb_type == MUTT_IMAP)
  {
    imap_get_parent_path(path, buf, buflen);
  }
  else if (mb_type == MUTT_NOTMUCH)
  {
    mutt_str_copy(buf, c_folder, buflen);
  }
  else
  {
    mutt_str_copy(buf, path, buflen);
    int n = mutt_str_len(buf);
    if (n == 0)
      return;
 
    /* remove any final trailing '/' */
    if (buf[n - 1] == '/')
      buf[n - 1] = '\0';
 
    /* Remove everything until the next slash */
    for (n--; ((n >= 0) && (buf[n] != '/')); n--)
      ; // do nothing
 
    if (n > 0)
    {
      buf[n] = '\0';
    }
    else
    {
      buf[0] = '/';
      buf[1] = '\0';
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_inbox_cmp()

int mutt_inbox_cmp	(	const char *	a,
		const char *	b
	)

Do two folders share the same path and one is an inbox.

Parameters

a	First path
b	Second path

Return values

-1	a is INBOX of b
0	None is INBOX
1	b is INBOX for a

This function compares two folder paths. It first looks for the position of the last common '/' character. If a valid position is found and it's not the last character in any of the two paths, the remaining parts of the paths are compared (case insensitively) with the string "INBOX". If one of the two paths matches, it's reported as being less than the other and the function returns -1 (a < b) or 1 (a > b). If no paths match the requirements, the two paths are considered equivalent and this function returns 0.

Examples:

• mutt_inbox_cmp("/foo/bar", "/foo/baz") --> 0
• mutt_inbox_cmp("/foo/bar/", "/foo/bar/inbox") --> 0
• mutt_inbox_cmp("/foo/bar/sent", "/foo/bar/inbox") --> 1
• mutt_inbox_cmp("=INBOX", "=Drafts") --> -1

Definition at line 1579 of file muttlib.c.

{
  /* fast-track in case the paths have been mutt_pretty_mailbox'ified */
  if ((a[0] == '+') && (b[0] == '+'))
  {
    return mutt_istr_equal(a + 1, "inbox") ? -1 :
           mutt_istr_equal(b + 1, "inbox") ? 1 :
                                             0;
  }
 
  const char *a_end = strrchr(a, '/');
  const char *b_end = strrchr(b, '/');
 
  /* If one path contains a '/', but not the other */
  if ((!a_end) ^ (!b_end))
    return 0;
 
  /* If neither path contains a '/' */
  if (!a_end)
    return 0;
 
  /* Compare the subpaths */
  size_t a_len = a_end - a;
  size_t b_len = b_end - b;
  size_t min = MIN(a_len, b_len);
  int same = (a[min] == '/') && (b[min] == '/') && (a[min + 1] != '\0') &&
             (b[min + 1] != '\0') && mutt_istrn_equal(a, b, min);
 
  if (!same)
    return 0;
 
  if (mutt_istr_equal(&a[min + 1], "inbox"))
    return -1;
 
  if (mutt_istr_equal(&b[min + 1], "inbox"))
    return 1;
 
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

buf_sanitize_filename()

void buf_sanitize_filename	(	struct Buffer *	buf,
		const char *	path,
		short	slash
	)

Replace unsafe characters in a filename.

Parameters

buf	Buffer for the result
path	Filename to make safe
slash	Replace '/' characters too

Definition at line 1625 of file muttlib.c.

{
  if (!buf || !path)
    return;
 
  buf_reset(buf);
 
  for (; *path; path++)
  {
    if ((slash && (*path == '/')) || !strchr(FilenameSafeChars, *path))
      buf_addch(buf, '_');
    else
      buf_addch(buf, *path);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_str_pretty_size()

void mutt_str_pretty_size	(	char *	buf,
		size_t	buflen,
		size_t	num
	)

Display an abbreviated size, like 3.4K.

Parameters

buf	Buffer for the result
buflen	Length of the buffer
num	Number to abbreviate

Definition at line 1647 of file muttlib.c.

{
  if (!buf || (buflen == 0))
    return;
 
  const bool c_size_show_bytes = cs_subset_bool(NeoMutt->sub, "size_show_bytes");
  const bool c_size_show_fractions = cs_subset_bool(NeoMutt->sub, "size_show_fractions");
  const bool c_size_show_mb = cs_subset_bool(NeoMutt->sub, "size_show_mb");
  const bool c_size_units_on_left = cs_subset_bool(NeoMutt->sub, "size_units_on_left");
 
  if (c_size_show_bytes && (num < 1024))
  {
    snprintf(buf, buflen, "%d", (int) num);
  }
  else if (num == 0)
  {
    mutt_str_copy(buf, c_size_units_on_left ? "K0" : "0K", buflen);
  }
  else if (c_size_show_fractions && (num < 10189)) /* 0.1K - 9.9K */
  {
    snprintf(buf, buflen, c_size_units_on_left ? "K%3.1f" : "%3.1fK",
             (num < 103) ? 0.1 : (num / 1024.0));
  }
  else if (!c_size_show_mb || (num < 1023949)) /* 10K - 999K */
  {
    /* 51 is magic which causes 10189/10240 to be rounded up to 10 */
    snprintf(buf, buflen, c_size_units_on_left ? ("K%zu") : ("%zuK"), (num + 51) / 1024);
  }
  else if (c_size_show_fractions && (num < 10433332)) /* 1.0M - 9.9M */
  {
    snprintf(buf, buflen, c_size_units_on_left ? "M%3.1f" : "%3.1fM", num / 1048576.0);
  }
  else /* 10M+ */
  {
    /* (10433332 + 52428) / 1048576 = 10 */
    snprintf(buf, buflen, c_size_units_on_left ? ("M%zu") : ("%zuM"), (num + 52428) / 1048576);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

add_to_stailq()

void add_to_stailq	(	struct ListHead *	head,
		const char *	str
	)

Add a string to a list.

Parameters

head	String list
str	String to add

Note

Duplicate or empty strings will not be added

Definition at line 1693 of file muttlib.c.

{
  /* don't add a NULL or empty string to the list */
  if (!str || (*str == '\0'))
    return;
 
  /* check to make sure the item is not already on this list */
  struct ListNode *np = NULL;
  STAILQ_FOREACH(np, head, entries)
  {
    if (mutt_istr_equal(str, np->data))
    {
      return;
    }
  }
  mutt_list_insert_tail(head, mutt_str_dup(str));
}

Here is the call graph for this function:

Here is the caller graph for this function:

remove_from_stailq()

void remove_from_stailq	(	struct ListHead *	head,
		const char *	str
	)

Remove an item, matching a string, from a List.

Parameters

head	Head of the List
str	String to match

Note

The string comparison is case-insensitive

Definition at line 1718 of file muttlib.c.

{
  if (mutt_str_equal("*", str))
  {
    mutt_list_free(head); /* "unCMD *" means delete all current entries */
  }
  else
  {
    struct ListNode *np = NULL, *tmp = NULL;
    STAILQ_FOREACH_SAFE(np, head, entries, tmp)
    {
      if (mutt_istr_equal(str, np->data))
      {
        STAILQ_REMOVE(head, np, ListNode, entries);
        FREE(&np->data);
        FREE(&np);
        break;
      }
    }
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

XdgEnvVars

const char* XdgEnvVars[]

static

Initial value:

= {
  [XDG_CONFIG_HOME] = "XDG_CONFIG_HOME",
  [XDG_CONFIG_DIRS] = "XDG_CONFIG_DIRS",
}

Accepted XDG environment variables.

Definition at line 66 of file muttlib.c.

XdgDefaults

const char* XdgDefaults[]

static

Initial value:

= {
  [XDG_CONFIG_HOME] = "~/.config",
  [XDG_CONFIG_DIRS] = "/etc/xdg",
}

XDG default locations.

Definition at line 72 of file muttlib.c.