mailbox.h

Go to the documentation of this file.

 
#ifndef MUTT_CORE_MAILBOX_H
#define MUTT_CORE_MAILBOX_H
 
#include <stdbool.h>
#include <stdint.h>
#include <sys/types.h>
#include <time.h>
#include "mutt/lib.h"
 
struct ConfigSubset;
struct Email;

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

enum AclFlag
{
  MUTT_ACL_NONE    =        0,  
  MUTT_ACL_ADMIN   = 1U <<  0,  
  MUTT_ACL_CREATE  = 1U <<  1,  
  MUTT_ACL_DELETE  = 1U <<  2,  
  MUTT_ACL_DELMX   = 1U <<  3,  
  MUTT_ACL_EXPUNGE = 1U <<  4,  
  MUTT_ACL_INSERT  = 1U <<  5,  
  MUTT_ACL_LOOKUP  = 1U <<  6,  
  MUTT_ACL_POST    = 1U <<  7,  
  MUTT_ACL_READ    = 1U <<  8,  
  MUTT_ACL_SEEN    = 1U <<  9,  
  MUTT_ACL_WRITE   = 1U << 10,  
};
typedef uint16_t AclFlags;
 
#define MUTT_ACL_ALL    ((1 << 11) - 1) 

struct Mailbox
{
  struct Buffer pathbuf;              
  char *realpath;                     
  char *name;                         
  struct ConfigSubset *sub;           
  off_t size;                         
  bool has_new;                       
 
  // These next three are only set when $mail_check_stats is set
  int msg_count;                      
  int msg_unread;                     
  int msg_flagged;                    
 
  int msg_new;                        
  int msg_deleted;                    
  int msg_tagged;                     
 
  struct Email **emails;              
  int email_max;                      
  int *v2r;                           
  int vcount;                         
 
  bool notified;                      
  enum MailboxType type;              
  bool newly_created;                 
  struct timespec last_visited;       
  time_t last_checked;                
 
  const struct MxOps *mx_ops;         
 
  bool append                 : 1;    
  bool changed                : 1;    
  bool dontwrite              : 1;    
  bool first_check_stats_done : 1;    
  bool notify_user            : 1;    
  bool peekonly               : 1;    
  bool poll_new_mail          : 1;    
  bool readonly               : 1;    
  bool verbose                : 1;    
 
  AclFlags rights;                    
 
  void *compress_info;                
 
  struct HashTable *id_hash;          
  struct HashTable *subj_hash;        
  struct HashTable *label_hash;       
 
  struct Account *account;            
  int opened;                         
 
  bool visible;                       
 
  void *mdata;                        

  void (*mdata_free)(void **ptr);
 
  struct Notify *notify;              
 
  int gen;                            
};
ARRAY_HEAD(MailboxArray, struct Mailbox *);

enum ExpandoDataMailbox
{
  ED_MBX_MAILBOX_NAME = 1,     
  ED_MBX_MESSAGE_COUNT,        
  ED_MBX_PERCENTAGE,           
};

enum NotifyMailbox
{
  NT_MAILBOX_ADD = 1,    
  NT_MAILBOX_DELETE,     
  NT_MAILBOX_DELETE_ALL, 
  NT_MAILBOX_CHANGE,     
 
  /* These don't really belong here as they are tied to GUI operations.
   * Eventually, they'll be eliminated. */
  NT_MAILBOX_INVALID,    
  NT_MAILBOX_RESORT,     
  NT_MAILBOX_UPDATE,     
  NT_MAILBOX_UNTAG,      
};

struct EventMailbox
{
  struct Mailbox *mailbox; 
};
 
void            mailbox_changed   (struct Mailbox *m, enum NotifyMailbox action);
struct Mailbox *mailbox_find      (const char *path);
struct Mailbox *mailbox_find_name (const char *name);
void            mailbox_free      (struct Mailbox **ptr);
int             mailbox_gen       (void);
struct Mailbox *mailbox_new       (void);
bool            mailbox_set_subset(struct Mailbox *m, struct ConfigSubset *sub);
void            mailbox_size_add  (struct Mailbox *m, const struct Email *e);
void            mailbox_size_sub  (struct Mailbox *m, const struct Email *e);
void            mailbox_update    (struct Mailbox *m);
void            mailbox_gc_add    (struct Email *e);
void            mailbox_gc_run    (void);
 
const char *mailbox_get_type_name(enum MailboxType type);

static inline const char *mailbox_path(const struct Mailbox *m) // LCOV_EXCL_LINE
{
  return buf_string(&m->pathbuf); // LCOV_EXCL_LINE
}
 
#endif /* MUTT_CORE_MAILBOX_H */