mailbox.h File Reference

Representation of a mailbox. More...

#include "config.h"
#include <stdbool.h>
#include <stdint.h>
#include <sys/types.h>
#include <time.h>
#include "mutt/mutt.h"

Go to the source code of this file.

Data Structures
struct	Mailbox
	A mailbox. More...
struct	MailboxNode
	List of Mailboxes. More...
struct	EventMailbox
	An Event that happened to a Mailbox. More...

Macros
#define	MB_NORMAL   0
#define	MB_HIDDEN   1
#define	MUTT_ACL_NO_FLAGS   0
	No flags are set. More...
#define	MUTT_ACL_ADMIN   (1 << 0)
	Administer the account (get/set permissions) More...
#define	MUTT_ACL_CREATE   (1 << 1)
	Create a mailbox. More...
#define	MUTT_ACL_DELETE   (1 << 2)
	Delete a message. More...
#define	MUTT_ACL_DELMX   (1 << 3)
	Delete a mailbox. More...
#define	MUTT_ACL_EXPUNGE   (1 << 4)
	Expunge messages. More...
#define	MUTT_ACL_INSERT   (1 << 5)
	Add/copy into the mailbox (used when editing a message) More...
#define	MUTT_ACL_LOOKUP   (1 << 6)
	Lookup mailbox (visible to 'list') More...
#define	MUTT_ACL_POST   (1 << 7)
	Post (submit messages to the server) More...
#define	MUTT_ACL_READ   (1 << 8)
	Read the mailbox. More...
#define	MUTT_ACL_SEEN   (1 << 9)
	Change the 'seen' status of a message. More...
#define	MUTT_ACL_WRITE   (1 << 10)
	Write to a message (for flagging or linking threads) More...
#define	MUTT_ACL_ALL   ((1 << 11) - 1)

Typedefs
typedef uint16_t	AclFlags
	ACL Rights - These show permission to... More...

Enumerations
enum	MailboxType {   MUTT_MAILBOX_ANY = -2, MUTT_MAILBOX_ERROR = -1, MUTT_UNKNOWN = 0, MUTT_MBOX,   MUTT_MMDF, MUTT_MH, MUTT_MAILDIR, MUTT_NNTP,   MUTT_IMAP, MUTT_NOTMUCH, MUTT_POP, MUTT_COMPRESSED }
	Supported mailbox formats. More...
enum	MailboxNotification {   MBN_CLOSED = 1, MBN_INVALID, MBN_RESORT, MBN_UPDATE,   MBN_UNTAG }
	Notifications about changes to a Mailbox. More...
enum	NotifyMailbox { NT_MAILBOX_ADD = 1, NT_MAILBOX_REMOVE }
	Types of Mailbox Event. More...

Functions
	STAILQ_HEAD (MailboxList, MailboxNode)
void	mailbox_changed (struct Mailbox *m, enum MailboxNotification action)
	Notify observers of a change to a Mailbox. More...
struct Mailbox *	mailbox_find (const char *path)
	Find the mailbox with a given path. More...
struct Mailbox *	mailbox_find_name (const char *name)
	Find the mailbox with a given name. More...
void	mailbox_free (struct Mailbox **ptr)
	Free a Mailbox. More...
struct Mailbox *	mailbox_new (void)
	Create a new Mailbox. More...
void	mailbox_size_add (struct Mailbox *m, const struct Email *e)
	Add an email's size to the total size of a Mailbox. More...
void	mailbox_size_sub (struct Mailbox *m, const struct Email *e)
	Subtract an email's size from the total size of a Mailbox. More...
void	mailbox_update (struct Mailbox *m)
	Get the mailbox's current size. More...

Detailed Description

Representation of a mailbox.

Authors

• 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 mailbox.h.

Macro Definition Documentation

#define MB_NORMAL   0

Definition at line 37 of file mailbox.h.

#define MB_HIDDEN   1

Definition at line 38 of file mailbox.h.

#define MUTT_ACL_NO_FLAGS   0

No flags are set.

Definition at line 75 of file mailbox.h.

#define MUTT_ACL_ADMIN   (1 << 0)

Administer the account (get/set permissions)

Definition at line 76 of file mailbox.h.

#define MUTT_ACL_CREATE   (1 << 1)

Create a mailbox.

Definition at line 77 of file mailbox.h.

#define MUTT_ACL_DELETE   (1 << 2)

Delete a message.

Definition at line 78 of file mailbox.h.

#define MUTT_ACL_DELMX   (1 << 3)

Delete a mailbox.

Definition at line 79 of file mailbox.h.

#define MUTT_ACL_EXPUNGE   (1 << 4)

Expunge messages.

Definition at line 80 of file mailbox.h.

#define MUTT_ACL_INSERT   (1 << 5)

Add/copy into the mailbox (used when editing a message)

Definition at line 81 of file mailbox.h.

#define MUTT_ACL_LOOKUP   (1 << 6)

Lookup mailbox (visible to 'list')

Definition at line 82 of file mailbox.h.

#define MUTT_ACL_POST   (1 << 7)

Post (submit messages to the server)

Definition at line 83 of file mailbox.h.

#define MUTT_ACL_READ   (1 << 8)

Read the mailbox.

Definition at line 84 of file mailbox.h.

#define MUTT_ACL_SEEN   (1 << 9)

Change the 'seen' status of a message.

Definition at line 85 of file mailbox.h.

#define MUTT_ACL_WRITE   (1 << 10)

Write to a message (for flagging or linking threads)

Definition at line 86 of file mailbox.h.

#define MUTT_ACL_ALL   ((1 << 11) - 1)

Definition at line 88 of file mailbox.h.

Typedef Documentation

typedef uint16_t AclFlags

ACL Rights - These show permission to...

Flags, e.g. MUTT_ACL_ADMIN

Definition at line 74 of file mailbox.h.

Enumeration Type Documentation

enum MailboxType

Supported mailbox formats.

Enumerator
MUTT_MAILBOX_ANY	Match any Mailbox type.
MUTT_MAILBOX_ERROR	Error occurred examining Mailbox.
MUTT_UNKNOWN	Mailbox wasn't recognised.
MUTT_MBOX	'mbox' Mailbox type
MUTT_MMDF	'mmdf' Mailbox type
MUTT_MH	'MH' Mailbox type
MUTT_MAILDIR	'Maildir' Mailbox type
MUTT_NNTP	'NNTP' (Usenet) Mailbox type
MUTT_IMAP	'IMAP' Mailbox type
MUTT_NOTMUCH	'Notmuch' (virtual) Mailbox type
MUTT_POP	'POP3' Mailbox type
MUTT_COMPRESSED	Compressed file Mailbox type.

Definition at line 43 of file mailbox.h.

{
  MUTT_MAILBOX_ANY = -2,   
  MUTT_MAILBOX_ERROR = -1, 
  MUTT_UNKNOWN = 0,        
  MUTT_MBOX,               
  MUTT_MMDF,               
  MUTT_MH,                 
  MUTT_MAILDIR,            
  MUTT_NNTP,               
  MUTT_IMAP,               
  MUTT_NOTMUCH,            
  MUTT_POP,                
  MUTT_COMPRESSED,         
};

enum MailboxNotification

Notifications about changes to a Mailbox.

Enumerator
MBN_CLOSED	Mailbox was closed.
MBN_INVALID	Email list was changed.
MBN_RESORT	Email list needs resorting.
MBN_UPDATE	Update internal tables.
MBN_UNTAG	Clear the 'last-tagged' pointer.

Definition at line 62 of file mailbox.h.

{
  MBN_CLOSED = 1, 
  MBN_INVALID,    
  MBN_RESORT,     
  MBN_UPDATE,     
  MBN_UNTAG,      
};

enum NotifyMailbox

Types of Mailbox Event.

Enumerator
NT_MAILBOX_ADD	A new Mailbox has been created.
NT_MAILBOX_REMOVE	A Mailbox is about to be destroyed.

Definition at line 175 of file mailbox.h.

{
  NT_MAILBOX_ADD = 1, 
  NT_MAILBOX_REMOVE,  
};

Function Documentation

STAILQ_HEAD	(	MailboxList	,
		MailboxNode
	)

void mailbox_changed	(	struct Mailbox *	m,
		enum MailboxNotification	action
	)

Notify observers of a change to a Mailbox.

Parameters

m	Mailbox
action	Change to Mailbox

Definition at line 159 of file mailbox.c.

{
  if (!m)
    return;

  notify_send(m->notify, NT_MAILBOX, action, 0);
}

struct Mailbox* mailbox_find

(

const char *

path

)

Find the mailbox with a given path.

Parameters

path	Path to match

Return values

ptr	Matching Mailbox

Definition at line 78 of file mailbox.c.

{
  if (!path)
    return NULL;

  struct stat sb;
  struct stat tmp_sb;

  if (stat(path, &sb) != 0)
    return NULL;

  struct MailboxList ml = neomutt_mailboxlist_get_all(NeoMutt, MUTT_MAILBOX_ANY);
  struct MailboxNode *np = NULL;
  struct Mailbox *m = NULL;
  STAILQ_FOREACH(np, &ml, entries)
  {
    if ((stat(mutt_b2s(np->mailbox->pathbuf), &tmp_sb) == 0) &&
        (sb.st_dev == tmp_sb.st_dev) && (sb.st_ino == tmp_sb.st_ino))
    {
      m = np->mailbox;
      break;
    }
  }
  neomutt_mailboxlist_clear(&ml);

  return m;
}

struct Mailbox* mailbox_find_name

(

const char *

name

)

Find the mailbox with a given name.

Parameters

name	Name to match

Return values

ptr	Matching Mailbox
NULL	No matching mailbox found

Note

This searches across all Accounts

Definition at line 114 of file mailbox.c.

{
  if (!name)
    return NULL;

  struct MailboxList ml = neomutt_mailboxlist_get_all(NeoMutt, MUTT_MAILBOX_ANY);
  struct MailboxNode *np = NULL;
  struct Mailbox *m = NULL;
  STAILQ_FOREACH(np, &ml, entries)
  {
    if (mutt_str_strcmp(np->mailbox->name, name) == 0)
    {
      m = np->mailbox;
      break;
    }
  }
  neomutt_mailboxlist_clear(&ml);

  return m;
}

void mailbox_free

(

struct Mailbox **

ptr

)

Free a Mailbox.

Parameters

[out]

ptr

Mailbox to free

Definition at line 56 of file mailbox.c.

{
  if (!ptr || !*ptr)
    return;

  struct Mailbox *m = *ptr;
  mailbox_changed(m, MBN_CLOSED);
  notify_free(&m->notify);

  mutt_buffer_free(&m->pathbuf);
  FREE(&m->name);
  if (m->mdata && m->free_mdata)
    m->free_mdata(&m->mdata);
  FREE(&m->realpath);
  FREE(ptr);
}

struct Mailbox* mailbox_new

(

void

)

Create a new Mailbox.

Return values

ptr	New Mailbox

Definition at line 42 of file mailbox.c.

{
  struct Mailbox *m = mutt_mem_calloc(1, sizeof(struct Mailbox));

  m->pathbuf = mutt_buffer_new();
  m->notify = notify_new(m, NT_MAILBOX);

  return m;
}

void mailbox_size_add	(	struct Mailbox *	m,
		const struct Email *	e
	)

Add an email's size to the total size of a Mailbox.

Parameters

m	Mailbox
e	Email

Definition at line 172 of file mailbox.c.

{
  m->size += mutt_email_size(e);
}

void mailbox_size_sub	(	struct Mailbox *	m,
		const struct Email *	e
	)

Subtract an email's size from the total size of a Mailbox.

Parameters

m	Mailbox
e	Email

Definition at line 182 of file mailbox.c.

{
  m->size -= mutt_email_size(e);
}

void mailbox_update

(

struct Mailbox *

m

)

Get the mailbox's current size.

Parameters

m	Mailbox to check

Note

Only applies to local Mailboxes

Definition at line 141 of file mailbox.c.

{
  struct stat sb;

  if (!m)
    return;

  if (stat(mutt_b2s(m->pathbuf), &sb) == 0)
    m->size = (off_t) sb.st_size;
  else
    m->size = 0;
}