browser.c File Reference

File/Mailbox Browser Dialog. More...

#include "config.h"
#include <dirent.h>
#include <errno.h>
#include <grp.h>
#include <limits.h>
#include <locale.h>
#include <pwd.h>
#include <stdbool.h>
#include <stdint.h>
#include <stdio.h>
#include <string.h>
#include <sys/stat.h>
#include <time.h>
#include "mutt/lib.h"
#include "config/lib.h"
#include "core/lib.h"
#include "conn/lib.h"
#include "gui/lib.h"
#include "lib.h"
#include "menu/lib.h"
#include "format_flags.h"
#include "functions.h"
#include "globals.h"
#include "keymap.h"
#include "mutt_logging.h"
#include "mutt_mailbox.h"
#include "muttlib.h"
#include "mx.h"
#include "opcodes.h"
#include "private_data.h"
#include "imap/lib.h"
#include "nntp/lib.h"
#include "nntp/adata.h"
#include "nntp/mdata.h"

Include dependency graph for browser.c:

Go to the source code of this file.

Functions
static void	init_lastdir (void)
	Initialise the browser directories. More...
void	mutt_browser_cleanup (void)
	Clean up working Buffers. More...
bool	link_is_dir (const char *folder, const char *path)
	Does this symlink point to a directory? More...
static const char *	folder_format_str (char *buf, size_t buflen, size_t col, int cols, char op, const char *src, const char *prec, const char *if_str, const char *else_str, intptr_t data, MuttFormatFlags flags)
	Format a string for the folder browser - Implements format_t -. More...
void	browser_add_folder (const struct Menu *menu, struct BrowserState *state, const char *name, const char *desc, const struct stat *st, struct Mailbox *m, void *data)
	Add a folder to the browser list. More...
void	init_state (struct BrowserState *state, struct Menu *menu)
	Initialise a browser state. More...
int	examine_directory (struct Mailbox *m, struct Menu *menu, struct BrowserState *state, const char *dirname, const char *prefix)
	Get list of all files/newsgroups with mask. More...
int	examine_mailboxes (struct Mailbox *m, struct Menu *menu, struct BrowserState *state)
	Get list of mailboxes/subscribed newsgroups. More...
static int	select_file_search (struct Menu *menu, regex_t *rx, int line)
	Menu search callback for matching files - Implements Menu::search() -. More...
static void	folder_make_entry (struct Menu *menu, char *buf, size_t buflen, int line)
	Format a menu item for the folder browser - Implements Menu::make_entry() -. More...
void	browser_highlight_default (struct BrowserState *state, struct Menu *menu)
	Decide which browser item should be highlighted. More...
void	init_menu (struct BrowserState *state, struct Menu *menu, struct Mailbox *m, struct MuttWindow *sbar)
	Set up a new menu. More...
static int	file_tag (struct Menu *menu, int sel, int act)
	Tag an entry in the menu - Implements Menu::tag() -. More...
static int	browser_config_observer (struct NotifyCallback *nc)
	Notification that a Config Variable has changed - Implements observer_t -. More...
static int	browser_window_observer (struct NotifyCallback *nc)
	Notification that a Window has changed - Implements observer_t -. More...
void	mutt_browser_select_dir (const char *f)
	Remember the last directory selected. More...
void	mutt_buffer_select_file (struct Buffer *file, SelectFileFlags flags, struct Mailbox *m, char ***files, int *numfiles)
	Let the user select a file. More...
void	mutt_select_file (char *file, size_t filelen, SelectFileFlags flags, struct Mailbox *m, char ***files, int *numfiles)
	Let the user select a file. More...

Variables
static const struct Mapping	FolderHelp []
	Help Bar for the File/Dir/Mailbox browser dialog. More...
static const struct Mapping	FolderNewsHelp []
	Help Bar for the NNTP Mailbox browser dialog. More...
struct Buffer	LastDir = { 0 }
struct Buffer	LastDirBackup = { 0 }

Detailed Description

File/Mailbox Browser Dialog.

Authors

• Michael R. Elkins
• R Primus

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

Function Documentation

init_lastdir()

static void init_lastdir ( void  )

static

Initialise the browser directories.

These keep track of where the browser used to be looking.

Definition at line 144 of file browser.c.

{
  static bool done = false;
  if (!done)
  {
    mutt_buffer_alloc(&LastDir, PATH_MAX);
    mutt_buffer_alloc(&LastDirBackup, PATH_MAX);
    done = true;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_browser_cleanup()

void mutt_browser_cleanup

(

void

)

Clean up working Buffers.

Definition at line 158 of file browser.c.

{
  mutt_buffer_dealloc(&LastDir);
  mutt_buffer_dealloc(&LastDirBackup);
}

Here is the call graph for this function:

Here is the caller graph for this function:

link_is_dir()

bool link_is_dir	(	const char *	folder,
		const char *	path
	)

Does this symlink point to a directory?

Parameters

folder	Folder
path	Link name

Return values

true	Links to a directory
false	Otherwise

Definition at line 171 of file browser.c.

{
  struct stat st = { 0 };
  bool retval = false;
 
  struct Buffer *fullpath = mutt_buffer_pool_get();
  mutt_buffer_concat_path(fullpath, folder, path);
 
  if (stat(mutt_buffer_string(fullpath), &st) == 0)
    retval = S_ISDIR(st.st_mode);
 
  mutt_buffer_pool_release(&fullpath);
 
  return retval;
}

Here is the call graph for this function:

Here is the caller graph for this function:

browser_add_folder()

void browser_add_folder	(	const struct Menu *	menu,
		struct BrowserState *	state,
		const char *	name,
		const char *	desc,
		const struct stat *	st,
		struct Mailbox *	m,
		void *	data
	)

Add a folder to the browser list.

Parameters

menu	Menu to use
state	Browser state
name	Name of folder
desc	Description of folder
st	stat info for the folder
m	Mailbox
data	Data to associate with the folder

Definition at line 542 of file browser.c.

{
  if ((!menu || state->is_mailbox_list) && m && !m->visible)
  {
    return;
  }
 
  struct FolderFile ff = { 0 };
 
  if (st)
  {
    ff.mode = st->st_mode;
    ff.mtime = st->st_mtime;
    ff.size = st->st_size;
    ff.gid = st->st_gid;
    ff.uid = st->st_uid;
    ff.nlink = st->st_nlink;
    ff.local = true;
  }
  else
  {
    ff.local = false;
  }
 
  if (m)
  {
    ff.has_mailbox = true;
    ff.gen = m->gen;
    ff.has_new_mail = m->has_new;
    ff.msg_count = m->msg_count;
    ff.msg_unread = m->msg_unread;
  }
 
  ff.name = mutt_str_dup(name);
  ff.desc = mutt_str_dup(desc ? desc : name);
#ifdef USE_IMAP
  ff.imap = false;
#endif
#ifdef USE_NNTP
  if (OptNews)
    ff.nd = data;
#endif
 
  ARRAY_ADD(&state->entry, ff);
}

Here is the call graph for this function:

Here is the caller graph for this function:

init_state()

void init_state	(	struct BrowserState *	state,
		struct Menu *	menu
	)

Initialise a browser state.

Parameters

state	BrowserState to initialise
menu	Current menu

Definition at line 595 of file browser.c.

{
  ARRAY_INIT(&state->entry);
  ARRAY_RESERVE(&state->entry, 256);
#ifdef USE_IMAP
  state->imap_browse = false;
#endif
  if (menu)
  {
    menu->mdata = &state->entry;
    menu->mdata_free = NULL; // Menu doesn't own the data
  }
}

Here is the caller graph for this function:

examine_directory()

int examine_directory	(	struct Mailbox *	m,
		struct Menu *	menu,
		struct BrowserState *	state,
		const char *	dirname,
		const char *	prefix
	)

Get list of all files/newsgroups with mask.

Parameters

m	Mailbox
menu	Current Menu
state	State of browser
dirname	Directory
prefix	Files/newsgroups must match this prefix

Return values

0	Success
-1	Error

Definition at line 619 of file browser.c.

{
  int rc = -1;
  struct Buffer *buf = mutt_buffer_pool_get();
#ifdef USE_NNTP
  if (OptNews)
  {
    struct NntpAccountData *adata = CurrentNewsSrv;
 
    init_state(state, menu);
 
    for (unsigned int i = 0; i < adata->groups_num; i++)
    {
      struct NntpMboxData *mdata = adata->groups_list[i];
      if (!mdata)
        continue;
      if (prefix && *prefix && !mutt_str_startswith(mdata->group, prefix))
        continue;
      const struct Regex *c_mask = cs_subset_regex(NeoMutt->sub, "mask");
      if (!mutt_regex_match(c_mask, mdata->group))
      {
        continue;
      }
      browser_add_folder(menu, state, mdata->group, NULL, NULL, NULL, mdata);
    }
  }
  else
#endif /* USE_NNTP */
  {
    struct stat st = { 0 };
    DIR *dir = NULL;
    struct dirent *de = NULL;
 
    while (stat(dirname, &st) == -1)
    {
      if (errno == ENOENT)
      {
        /* The last used directory is deleted, try to use the parent dir. */
        char *c = strrchr(dirname, '/');
 
        if (c && (c > dirname))
        {
          *c = '\0';
          continue;
        }
      }
      mutt_perror(dirname);
      goto ed_out;
    }
 
    if (!S_ISDIR(st.st_mode))
    {
      mutt_error(_("%s is not a directory"), dirname);
      goto ed_out;
    }
 
    if (m)
      mutt_mailbox_check(m, MUTT_MAILBOX_CHECK_NO_FLAGS);
 
    dir = mutt_file_opendir(dirname, MUTT_OPENDIR_NONE);
    if (!dir)
    {
      mutt_perror(dirname);
      goto ed_out;
    }
 
    init_state(state, menu);
 
    struct MailboxList ml = STAILQ_HEAD_INITIALIZER(ml);
    neomutt_mailboxlist_get_all(&ml, NeoMutt, MUTT_MAILBOX_ANY);
    while ((de = readdir(dir)))
    {
      if (mutt_str_equal(de->d_name, "."))
        continue; /* we don't need . */
 
      if (prefix && *prefix && !mutt_str_startswith(de->d_name, prefix))
      {
        continue;
      }
      const struct Regex *c_mask = cs_subset_regex(NeoMutt->sub, "mask");
      if (!mutt_regex_match(c_mask, de->d_name))
      {
        continue;
      }
 
      mutt_buffer_concat_path(buf, dirname, de->d_name);
      if (lstat(mutt_buffer_string(buf), &st) == -1)
        continue;
 
      /* No size for directories or symlinks */
      if (S_ISDIR(st.st_mode) || S_ISLNK(st.st_mode))
        st.st_size = 0;
      else if (!S_ISREG(st.st_mode))
        continue;
 
      struct MailboxNode *np = NULL;
      STAILQ_FOREACH(np, &ml, entries)
      {
        if (mutt_str_equal(mutt_buffer_string(buf), mailbox_path(np->mailbox)))
          break;
      }
 
      if (np && m && mutt_str_equal(np->mailbox->realpath, m->realpath))
      {
        np->mailbox->msg_count = m->msg_count;
        np->mailbox->msg_unread = m->msg_unread;
      }
      browser_add_folder(menu, state, de->d_name, NULL, &st, np ? np->mailbox : NULL, NULL);
    }
    neomutt_mailboxlist_clear(&ml);
    closedir(dir);
  }
  browser_sort(state);
  rc = 0;
ed_out:
  mutt_buffer_pool_release(&buf);
  return rc;
}

Here is the call graph for this function:

Here is the caller graph for this function:

examine_mailboxes()

int examine_mailboxes	(	struct Mailbox *	m,
		struct Menu *	menu,
		struct BrowserState *	state
	)

Get list of mailboxes/subscribed newsgroups.

Parameters

m	Mailbox
menu	Current menu
state	State of browser

Return values

0	Success
-1	Error

Definition at line 747 of file browser.c.

{
  struct stat st = { 0 };
  struct Buffer *md = NULL;
  struct Buffer *mailbox = NULL;
 
#ifdef USE_NNTP
  if (OptNews)
  {
    struct NntpAccountData *adata = CurrentNewsSrv;
 
    init_state(state, menu);
 
    for (unsigned int i = 0; i < adata->groups_num; i++)
    {
      const bool c_show_only_unread = cs_subset_bool(NeoMutt->sub, "show_only_unread");
      struct NntpMboxData *mdata = adata->groups_list[i];
      if (mdata && (mdata->has_new_mail ||
                    (mdata->subscribed && (mdata->unread || !c_show_only_unread))))
      {
        browser_add_folder(menu, state, mdata->group, NULL, NULL, NULL, mdata);
      }
    }
  }
  else
#endif
  {
    init_state(state, menu);
 
    if (TAILQ_EMPTY(&NeoMutt->accounts))
      return -1;
    mailbox = mutt_buffer_pool_get();
    md = mutt_buffer_pool_get();
 
    mutt_mailbox_check(m, MUTT_MAILBOX_CHECK_NO_FLAGS);
 
    struct MailboxList ml = STAILQ_HEAD_INITIALIZER(ml);
    neomutt_mailboxlist_get_all(&ml, NeoMutt, MUTT_MAILBOX_ANY);
    struct MailboxNode *np = NULL;
    STAILQ_FOREACH(np, &ml, entries)
    {
      if (!np->mailbox)
        continue;
 
      if (m && mutt_str_equal(np->mailbox->realpath, m->realpath))
      {
        np->mailbox->msg_count = m->msg_count;
        np->mailbox->msg_unread = m->msg_unread;
      }
 
      mutt_buffer_strcpy(mailbox, mailbox_path(np->mailbox));
      const bool c_browser_abbreviate_mailboxes = cs_subset_bool(NeoMutt->sub, "browser_abbreviate_mailboxes");
      if (c_browser_abbreviate_mailboxes)
        mutt_buffer_pretty_mailbox(mailbox);
 
      switch (np->mailbox->type)
      {
        case MUTT_IMAP:
        case MUTT_POP:
          browser_add_folder(menu, state, mutt_buffer_string(mailbox),
                             np->mailbox->name, NULL, np->mailbox, NULL);
          continue;
        case MUTT_NOTMUCH:
        case MUTT_NNTP:
          browser_add_folder(menu, state, mailbox_path(np->mailbox),
                             np->mailbox->name, NULL, np->mailbox, NULL);
          continue;
        default: /* Continue */
          break;
      }
 
      if (lstat(mailbox_path(np->mailbox), &st) == -1)
        continue;
 
      if ((!S_ISREG(st.st_mode)) && (!S_ISDIR(st.st_mode)) && (!S_ISLNK(st.st_mode)))
        continue;
 
      if (np->mailbox->type == MUTT_MAILDIR)
      {
        struct stat st2 = { 0 };
 
        mutt_buffer_printf(md, "%s/new", mailbox_path(np->mailbox));
        if (stat(mutt_buffer_string(md), &st) < 0)
          st.st_mtime = 0;
        mutt_buffer_printf(md, "%s/cur", mailbox_path(np->mailbox));
        if (stat(mutt_buffer_string(md), &st2) < 0)
          st2.st_mtime = 0;
        if (st2.st_mtime > st.st_mtime)
          st.st_mtime = st2.st_mtime;
      }
 
      browser_add_folder(menu, state, mutt_buffer_string(mailbox),
                         np->mailbox->name, &st, np->mailbox, NULL);
    }
    neomutt_mailboxlist_clear(&ml);
  }
  browser_sort(state);
 
  mutt_buffer_pool_release(&mailbox);
  mutt_buffer_pool_release(&md);
  return 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

browser_highlight_default()

void browser_highlight_default	(	struct BrowserState *	state,
		struct Menu *	menu
	)

Decide which browser item should be highlighted.

Parameters

state	Browser state
menu	Current Menu

This function takes a menu and a state and defines the current entry that should be highlighted.

Definition at line 911 of file browser.c.

{
  menu->top = 0;
  /* Reset menu position to 1.
   * We do not risk overflow as the init_menu function changes
   * current if it is bigger than state->entrylen.  */
  if (!ARRAY_EMPTY(&state->entry) &&
      (mutt_str_equal(ARRAY_FIRST(&state->entry)->desc, "..") ||
       mutt_str_equal(ARRAY_FIRST(&state->entry)->desc, "../")))
  {
    /* Skip the first entry, unless there's only one entry. */
    menu_set_index(menu, (menu->max > 1));
  }
  else
  {
    menu_set_index(menu, 0);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

init_menu()

void init_menu	(	struct BrowserState *	state,
		struct Menu *	menu,
		struct Mailbox *	m,
		struct MuttWindow *	sbar
	)

Set up a new menu.

Parameters

state	Browser state
menu	Current menu
m	Mailbox
sbar	Status bar

Definition at line 937 of file browser.c.

{
  char title[256] = { 0 };
  menu->max = ARRAY_SIZE(&state->entry);
 
  int index = menu_get_index(menu);
  if (index >= menu->max)
    menu_set_index(menu, menu->max - 1);
  if (index < 0)
    menu_set_index(menu, 0);
  if (menu->top > index)
    menu->top = 0;
 
  menu->num_tagged = 0;
 
#ifdef USE_NNTP
  if (OptNews)
  {
    if (state->is_mailbox_list)
    {
      snprintf(title, sizeof(title), _("Subscribed newsgroups"));
    }
    else
    {
      snprintf(title, sizeof(title), _("Newsgroups on server [%s]"),
               CurrentNewsSrv->conn->account.host);
    }
  }
  else
#endif
  {
    if (state->is_mailbox_list)
    {
      snprintf(title, sizeof(title), _("Mailboxes [%d]"),
               mutt_mailbox_check(m, MUTT_MAILBOX_CHECK_NO_FLAGS));
    }
    else
    {
      struct Buffer *path = mutt_buffer_pool_get();
      mutt_buffer_copy(path, &LastDir);
      mutt_buffer_pretty_mailbox(path);
      const struct Regex *c_mask = cs_subset_regex(NeoMutt->sub, "mask");
#ifdef USE_IMAP
      const bool c_imap_list_subscribed = cs_subset_bool(NeoMutt->sub, "imap_list_subscribed");
      if (state->imap_browse && c_imap_list_subscribed)
      {
        snprintf(title, sizeof(title), _("Subscribed [%s], File mask: %s"),
                 mutt_buffer_string(path), NONULL(c_mask ? c_mask->pattern : NULL));
      }
      else
#endif
      {
        snprintf(title, sizeof(title), _("Directory [%s], File mask: %s"),
                 mutt_buffer_string(path), NONULL(c_mask ? c_mask->pattern : NULL));
      }
      mutt_buffer_pool_release(&path);
    }
  }
  sbar_set_title(sbar, title);
 
  /* Browser tracking feature.
   * The goal is to highlight the good directory if LastDir is the parent dir
   * of LastDirBackup (this occurs mostly when one hit "../"). It should also work
   * properly when the user is in examine_mailboxes-mode.  */
  if (mutt_str_startswith(mutt_buffer_string(&LastDirBackup), mutt_buffer_string(&LastDir)))
  {
    char target_dir[PATH_MAX] = { 0 };
 
#ifdef USE_IMAP
    /* Check what kind of dir LastDirBackup is. */
    if (imap_path_probe(mutt_buffer_string(&LastDirBackup), NULL) == MUTT_IMAP)
    {
      mutt_str_copy(target_dir, mutt_buffer_string(&LastDirBackup), sizeof(target_dir));
      imap_clean_path(target_dir, sizeof(target_dir));
    }
    else
#endif
      mutt_str_copy(target_dir, strrchr(mutt_buffer_string(&LastDirBackup), '/') + 1,
                    sizeof(target_dir));
 
    /* If we get here, it means that LastDir is the parent directory of
     * LastDirBackup.  I.e., we're returning from a subdirectory, and we want
     * to position the cursor on the directory we're returning from. */
    bool matched = false;
    struct FolderFile *ff = NULL;
    ARRAY_FOREACH(ff, &state->entry)
    {
      if (mutt_str_equal(ff->name, target_dir))
      {
        menu_set_index(menu, ARRAY_FOREACH_IDX);
        matched = true;
        break;
      }
    }
    if (!matched)
      browser_highlight_default(state, menu);
  }
  else
  {
    browser_highlight_default(state, menu);
  }
 
  menu_queue_redraw(menu, MENU_REDRAW_FULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_browser_select_dir()

void mutt_browser_select_dir

(

const char *

f

)

Remember the last directory selected.

Parameters

f	Directory name to save

This function helps the browser to know which directory has been selected. It should be called anywhere a confirm hit is done to open a new directory/file which is a maildir/mbox.

We could check if the sort method is appropriate with this feature.

Definition at line 1132 of file browser.c.

{
  init_lastdir();
 
  mutt_buffer_strcpy(&LastDirBackup, f);
 
  /* Method that will fetch the parent path depending on the type of the path. */
  char buf[PATH_MAX] = { 0 };
  mutt_get_parent_path(mutt_buffer_string(&LastDirBackup), buf, sizeof(buf));
  mutt_buffer_strcpy(&LastDir, buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_buffer_select_file()

void mutt_buffer_select_file	(	struct Buffer *	file,
		SelectFileFlags	flags,
		struct Mailbox *	m,
		char ***	files,
		int *	numfiles
	)

Let the user select a file.

Parameters

[in]	file	Buffer for the result
[in]	flags	Flags, see SelectFileFlags
[in]	m	Mailbox
[out]	files	Array of selected files
[out]	numfiles	Number of selected files

Definition at line 1152 of file browser.c.

{
  struct BrowserPrivateData *priv = browser_private_data_new();
  priv->file = file;
  priv->mailbox = m;
  priv->files = files;
  priv->numfiles = numfiles;
  struct MuttWindow *dlg = NULL;
 
  priv->multiple = (flags & MUTT_SEL_MULTI);
  priv->folder = (flags & MUTT_SEL_FOLDER);
  priv->state.is_mailbox_list = (flags & MUTT_SEL_MAILBOX) && priv->folder;
  priv->last_selected_mailbox = -1;
 
  init_lastdir();
 
#ifdef USE_NNTP
  if (OptNews)
  {
    if (mutt_buffer_is_empty(file))
    {
      struct NntpAccountData *adata = CurrentNewsSrv;
 
      /* default state for news reader mode is browse subscribed newsgroups */
      priv->state.is_mailbox_list = false;
      for (size_t i = 0; i < adata->groups_num; i++)
      {
        struct NntpMboxData *mdata = adata->groups_list[i];
        if (mdata && mdata->subscribed)
        {
          priv->state.is_mailbox_list = true;
          break;
        }
      }
    }
    else
    {
      mutt_buffer_copy(priv->prefix, file);
    }
  }
  else
#endif
      if (!mutt_buffer_is_empty(file))
  {
    mutt_buffer_expand_path(file);
#ifdef USE_IMAP
    if (imap_path_probe(mutt_buffer_string(file), NULL) == MUTT_IMAP)
    {
      init_state(&priv->state, NULL);
      priv->state.imap_browse = true;
      if (imap_browse(mutt_buffer_string(file), &priv->state) == 0)
      {
        mutt_buffer_strcpy(&LastDir, priv->state.folder);
        browser_sort(&priv->state);
      }
    }
    else
    {
#endif
      int i;
      for (i = mutt_buffer_len(file) - 1;
           (i > 0) && ((mutt_buffer_string(file))[i] != '/'); i--)
      {
        ; // do nothing
      }
 
      if (i > 0)
      {
        if ((mutt_buffer_string(file))[0] == '/')
        {
          mutt_buffer_strcpy_n(&LastDir, mutt_buffer_string(file), i);
        }
        else
        {
          mutt_path_getcwd(&LastDir);
          mutt_buffer_addch(&LastDir, '/');
          mutt_buffer_addstr_n(&LastDir, mutt_buffer_string(file), i);
        }
      }
      else
      {
        if ((mutt_buffer_string(file))[0] == '/')
          mutt_buffer_strcpy(&LastDir, "/");
        else
          mutt_path_getcwd(&LastDir);
      }
 
      if ((i <= 0) && (mutt_buffer_string(file)[0] != '/'))
        mutt_buffer_copy(priv->prefix, file);
      else
        mutt_buffer_strcpy(priv->prefix, mutt_buffer_string(file) + i + 1);
      priv->kill_prefix = true;
#ifdef USE_IMAP
    }
#endif
  }
  else
  {
    if (!priv->folder)
    {
      mutt_path_getcwd(&LastDir);
    }
    else
    {
      /* Whether we use the tracking feature of the browser depends
       * on which sort method we chose to use. This variable is defined
       * only to help readability of the code.  */
      bool browser_track = false;
 
      const short c_sort_browser = cs_subset_sort(NeoMutt->sub, "sort_browser");
      switch (c_sort_browser & SORT_MASK)
      {
        case SORT_DESC:
        case SORT_SUBJECT:
        case SORT_ORDER:
          browser_track = true;
          break;
      }
 
      /* We use mutt_browser_select_dir to initialize the two
       * variables (LastDir, LastDirBackup) at the appropriate
       * values.
       *
       * We do it only when LastDir is not set (first pass there)
       * or when CurrentFolder and LastDirBackup are not the same.
       * This code is executed only when we list files, not when
       * we press up/down keys to navigate in a displayed list.
       *
       * We only do this when CurrentFolder has been set (ie, not
       * when listing folders on startup with "neomutt -y").
       *
       * This tracker is only used when browser_track is true,
       * meaning only with sort methods SUBJECT/DESC for now.  */
      if (CurrentFolder)
      {
        if (mutt_buffer_is_empty(&LastDir))
        {
          /* If browsing in "local"-mode, than we chose to define LastDir to
           * MailDir */
          switch (mx_path_probe(CurrentFolder))
          {
            case MUTT_IMAP:
            case MUTT_MAILDIR:
            case MUTT_MBOX:
            case MUTT_MH:
            case MUTT_MMDF:
            {
              const char *const c_folder = cs_subset_string(NeoMutt->sub, "folder");
              const char *const c_spool_file = cs_subset_string(NeoMutt->sub, "spool_file");
              if (c_folder)
                mutt_buffer_strcpy(&LastDir, c_folder);
              else if (c_spool_file)
                mutt_browser_select_dir(c_spool_file);
              break;
            }
            default:
              mutt_browser_select_dir(CurrentFolder);
              break;
          }
        }
        else if (!mutt_str_equal(CurrentFolder, mutt_buffer_string(&LastDirBackup)))
        {
          mutt_browser_select_dir(CurrentFolder);
        }
      }
 
      /* When browser tracking feature is disabled, clear LastDirBackup */
      if (!browser_track)
        mutt_buffer_reset(&LastDirBackup);
    }
 
#ifdef USE_IMAP
    if (!priv->state.is_mailbox_list &&
        (imap_path_probe(mutt_buffer_string(&LastDir), NULL) == MUTT_IMAP))
    {
      init_state(&priv->state, NULL);
      priv->state.imap_browse = true;
      imap_browse(mutt_buffer_string(&LastDir), &priv->state);
      browser_sort(&priv->state);
    }
    else
#endif
    {
      size_t i = mutt_buffer_len(&LastDir);
      while ((i > 0) && (mutt_buffer_string(&LastDir)[--i] == '/'))
        LastDir.data[i] = '\0';
      mutt_buffer_fix_dptr(&LastDir);
      if (mutt_buffer_is_empty(&LastDir))
        mutt_path_getcwd(&LastDir);
    }
  }
 
  mutt_buffer_reset(file);
 
  const struct Mapping *help_data = NULL;
#ifdef USE_NNTP
  if (OptNews)
    help_data = FolderNewsHelp;
  else
#endif
    help_data = FolderHelp;
 
  dlg = simple_dialog_new(MENU_FOLDER, WT_DLG_BROWSER, help_data);
 
  priv->menu = dlg->wdata;
  dlg->wdata = priv;
  priv->menu->make_entry = folder_make_entry;
  priv->menu->search = select_file_search;
  if (priv->multiple)
    priv->menu->tag = file_tag;
 
  priv->sbar = window_find_child(dlg, WT_STATUS_BAR);
  priv->win_browser = window_find_child(dlg, WT_MENU);
 
  struct MuttWindow *win_menu = priv->menu->win;
 
  // NT_COLOR is handled by the SimpleDialog
  notify_observer_add(NeoMutt->notify, NT_CONFIG, browser_config_observer, priv->menu);
  notify_observer_add(win_menu->notify, NT_WINDOW, browser_window_observer, win_menu);
 
  if (priv->state.is_mailbox_list)
  {
    examine_mailboxes(m, NULL, &priv->state);
  }
  else
#ifdef USE_IMAP
      if (!priv->state.imap_browse)
#endif
  {
    // examine_directory() calls browser_add_folder() which needs the menu
    if (examine_directory(m, priv->menu, &priv->state, mutt_buffer_string(&LastDir),
                          mutt_buffer_string(priv->prefix)) == -1)
    {
      goto bail;
    }
  }
 
  init_menu(&priv->state, priv->menu, m, priv->sbar);
  // only now do we have a valid priv->state to attach
  priv->menu->mdata = &priv->state;
 
  // ---------------------------------------------------------------------------
  // Event Loop
  int op = OP_NULL;
  do
  {
    menu_tagging_dispatcher(priv->menu->win, op);
    window_redraw(NULL);
 
    op = km_dokey(MENU_FOLDER);
    mutt_debug(LL_DEBUG1, "Got op %s (%d)\n", opcodes_get_name(op), op);
    if (op < 0)
      continue;
    if (op == OP_NULL)
    {
      km_error_key(MENU_FOLDER);
      continue;
    }
    mutt_clear_error();
 
    int rc = browser_function_dispatcher(priv->win_browser, op);
 
    if (rc == FR_UNKNOWN)
      rc = menu_function_dispatcher(priv->menu->win, op);
    if (rc == FR_UNKNOWN)
      rc = global_function_dispatcher(NULL, op);
  } while (!priv->done);
  // ---------------------------------------------------------------------------
 
bail:
  simple_dialog_free(&dlg);
  browser_private_data_free(&priv);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_select_file()

void mutt_select_file	(	char *	file,
		size_t	filelen,
		SelectFileFlags	flags,
		struct Mailbox *	m,
		char ***	files,
		int *	numfiles
	)

Let the user select a file.

Parameters

[in]	file	Buffer for the result
[in]	filelen	Length of buffer
[in]	flags	Flags, see SelectFileFlags
[in]	m	Mailbox
[out]	files	Array of selected files
[out]	numfiles	Number of selected files

Definition at line 1436 of file browser.c.

{
  struct Buffer *f_buf = mutt_buffer_pool_get();
 
  mutt_buffer_strcpy(f_buf, NONULL(file));
  mutt_buffer_select_file(f_buf, flags, m, files, numfiles);
  mutt_str_copy(file, mutt_buffer_string(f_buf), filelen);
 
  mutt_buffer_pool_release(&f_buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

FolderHelp

const struct Mapping FolderHelp[]

static

Initial value:

= {
  
  { N_("Exit"),  OP_EXIT },
  { N_("Chdir"), OP_CHANGE_DIRECTORY },
  { N_("Goto"),  OP_BROWSER_GOTO_FOLDER },
  { N_("Mask"),  OP_ENTER_MASK },
  { N_("Help"),  OP_HELP },
  { NULL, 0 },
  
}

Help Bar for the File/Dir/Mailbox browser dialog.

Definition at line 109 of file browser.c.

FolderNewsHelp

const struct Mapping FolderNewsHelp[]

static

Initial value:

= {
  
  { N_("Exit"),        OP_EXIT },
  { N_("List"),        OP_TOGGLE_MAILBOXES },
  { N_("Subscribe"),   OP_BROWSER_SUBSCRIBE },
  { N_("Unsubscribe"), OP_BROWSER_UNSUBSCRIBE },
  { N_("Catchup"),     OP_CATCHUP },
  { N_("Mask"),        OP_ENTER_MASK },
  { N_("Help"),        OP_HELP },
  { NULL, 0 },
  
}

Help Bar for the NNTP Mailbox browser dialog.

Definition at line 122 of file browser.c.

LastDir

struct Buffer LastDir = { 0 }

Definition at line 136 of file browser.c.

LastDirBackup

struct Buffer LastDirBackup = { 0 }

Definition at line 137 of file browser.c.