NeoMutt  2024-10-02-7-gd3e66a
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
mailbox.h
Go to the documentation of this file.
1
24#ifndef MUTT_CORE_MAILBOX_H
25#define MUTT_CORE_MAILBOX_H
26
27#include "config.h"
28#include <stdbool.h>
29#include <stdint.h>
30#include <sys/types.h>
31#include <time.h>
32#include "mutt/lib.h"
33
34struct ConfigSubset;
35struct Email;
36
41{
54};
55
59typedef uint16_t AclFlags;
60#define MUTT_ACL_NO_FLAGS 0
61#define MUTT_ACL_ADMIN (1 << 0)
62#define MUTT_ACL_CREATE (1 << 1)
63#define MUTT_ACL_DELETE (1 << 2)
64#define MUTT_ACL_DELMX (1 << 3)
65#define MUTT_ACL_EXPUNGE (1 << 4)
66#define MUTT_ACL_INSERT (1 << 5)
67#define MUTT_ACL_LOOKUP (1 << 6)
68#define MUTT_ACL_POST (1 << 7)
69#define MUTT_ACL_READ (1 << 8)
70#define MUTT_ACL_SEEN (1 << 9)
71#define MUTT_ACL_WRITE (1 << 10)
72
73#define MUTT_ACL_ALL ((1 << 11) - 1)
74
78struct Mailbox
79{
80 struct Buffer pathbuf;
81 char *realpath;
82 char *name;
83 struct ConfigSubset *sub;
84 off_t size;
85 bool has_new;
86
87 // These next three are only set when $mail_check_stats is set
91
92 int msg_new;
95
96 struct Email **emails;
98 int *v2r;
99 int vcount;
100
101 bool notified;
104 struct timespec last_visited;
106
107 const struct MxOps *mx_ops;
108
109 bool append : 1;
110 bool changed : 1;
111 bool dontwrite : 1;
113 bool notify_user : 1;
114 bool peekonly : 1;
115 bool poll_new_mail : 1;
116 bool readonly : 1;
117 bool verbose : 1;
118
120
122
126
127 struct Account *account;
128 int opened;
129
130 bool visible;
131
132 void *mdata;
133
143 void (*mdata_free)(void **ptr);
144
145 struct Notify *notify;
146
147 int gen;
148};
149
156{
160};
161
166{
167 struct Mailbox *mailbox;
169};
171
181{
186
187 /* These don't really belong here as they are tied to GUI operations.
188 * Eventually, they'll be eliminated. */
193};
194
199{
200 struct Mailbox *mailbox;
201};
202
203void mailbox_changed (struct Mailbox *m, enum NotifyMailbox action);
204struct Mailbox *mailbox_find (const char *path);
205struct Mailbox *mailbox_find_name (const char *name);
206void mailbox_free (struct Mailbox **ptr);
207int mailbox_gen (void);
208struct Mailbox *mailbox_new (void);
209bool mailbox_set_subset(struct Mailbox *m, struct ConfigSubset *sub);
210void mailbox_size_add (struct Mailbox *m, const struct Email *e);
211void mailbox_size_sub (struct Mailbox *m, const struct Email *e);
212void mailbox_update (struct Mailbox *m);
213void mailbox_gc_add (struct Email *e);
214void mailbox_gc_run (void);
215
216const char *mailbox_get_type_name(enum MailboxType type);
217
223static inline const char *mailbox_path(const struct Mailbox *m) // LCOV_EXCL_LINE
224{
225 return buf_string(&m->pathbuf); // LCOV_EXCL_LINE
226}
227
228#endif /* MUTT_CORE_MAILBOX_H */
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition: buffer.h:96
NotifyMailbox
Types of Mailbox Event.
Definition: mailbox.h:181
@ NT_MAILBOX_UNTAG
Clear the 'last-tagged' pointer.
Definition: mailbox.h:192
@ NT_MAILBOX_CHANGE
Mailbox has been changed.
Definition: mailbox.h:185
@ NT_MAILBOX_RESORT
Email list needs resorting.
Definition: mailbox.h:190
@ NT_MAILBOX_DELETE
Mailbox is about to be deleted.
Definition: mailbox.h:183
@ NT_MAILBOX_INVALID
Email list was changed.
Definition: mailbox.h:189
@ NT_MAILBOX_DELETE_ALL
All Mailboxes are about to be deleted.
Definition: mailbox.h:184
@ NT_MAILBOX_UPDATE
Update internal tables.
Definition: mailbox.h:191
@ NT_MAILBOX_ADD
Mailbox has been added.
Definition: mailbox.h:182
bool mailbox_set_subset(struct Mailbox *m, struct ConfigSubset *sub)
Set a Mailbox's Config Subset.
Definition: mailbox.c:270
void mailbox_gc_run(void)
Run the garbage-collection.
Definition: mailbox.c:312
void mailbox_size_add(struct Mailbox *m, const struct Email *e)
Add an email's size to the total size of a Mailbox.
Definition: mailbox.c:249
void mailbox_size_sub(struct Mailbox *m, const struct Email *e)
Subtract an email's size from the total size of a Mailbox.
Definition: mailbox.c:259
ExpandoDataMailbox
Expando UIDs for Mailboxes.
Definition: mailbox.h:156
@ ED_MBX_MESSAGE_COUNT
Mailbox.msg_count.
Definition: mailbox.h:158
@ ED_MBX_PERCENTAGE
HdrFormatInfo.pager_progress.
Definition: mailbox.h:159
@ ED_MBX_MAILBOX_NAME
Mailbox, mailbox_path()
Definition: mailbox.h:157
int mailbox_gen(void)
Get the next generation number.
Definition: mailbox.c:58
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition: mailbox.h:223
uint16_t AclFlags
ACL Rights - These show permission to...
Definition: mailbox.h:59
struct Mailbox * mailbox_new(void)
Create a new Mailbox.
Definition: mailbox.c:68
void mailbox_gc_add(struct Email *e)
Add an Email to the garbage-collection set.
Definition: mailbox.c:298
void mailbox_update(struct Mailbox *m)
Get the mailbox's current size.
Definition: mailbox.c:215
void mailbox_free(struct Mailbox **ptr)
Free a Mailbox.
Definition: mailbox.c:89
struct Mailbox * mailbox_find_name(const char *name)
Find the mailbox with a given name.
Definition: mailbox.c:187
void mailbox_changed(struct Mailbox *m, enum NotifyMailbox action)
Notify observers of a change to a Mailbox.
Definition: mailbox.c:233
MailboxType
Supported mailbox formats.
Definition: mailbox.h:41
@ MUTT_NOTMUCH
'Notmuch' (virtual) Mailbox type
Definition: mailbox.h:51
@ MUTT_MMDF
'mmdf' Mailbox type
Definition: mailbox.h:46
@ MUTT_MAILBOX_ERROR
Error occurred examining Mailbox.
Definition: mailbox.h:43
@ MUTT_POP
'POP3' Mailbox type
Definition: mailbox.h:52
@ MUTT_MH
'MH' Mailbox type
Definition: mailbox.h:47
@ MUTT_NNTP
'NNTP' (Usenet) Mailbox type
Definition: mailbox.h:49
@ MUTT_IMAP
'IMAP' Mailbox type
Definition: mailbox.h:50
@ MUTT_MBOX
'mbox' Mailbox type
Definition: mailbox.h:45
@ MUTT_MAILBOX_ANY
Match any Mailbox type.
Definition: mailbox.h:42
@ MUTT_COMPRESSED
Compressed file Mailbox type.
Definition: mailbox.h:53
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
Definition: mailbox.h:44
@ MUTT_MAILDIR
'Maildir' Mailbox type
Definition: mailbox.h:48
const char * mailbox_get_type_name(enum MailboxType type)
Get the type of a Mailbox.
Definition: mailbox.c:326
struct Mailbox * mailbox_find(const char *path)
Find the mailbox with a given path.
Definition: mailbox.c:150
Convenience wrapper for the library headers.
#define STAILQ_HEAD(name, type)
Definition: queue.h:312
A group of associated Mailboxes.
Definition: account.h:36
String manipulation buffer.
Definition: buffer.h:36
A set of inherited config items.
Definition: subset.h:47
The envelope/body of an email.
Definition: email.h:39
An Event that happened to a Mailbox.
Definition: mailbox.h:199
struct Mailbox * mailbox
The Mailbox this Event relates to.
Definition: mailbox.h:200
A Hash Table.
Definition: hash.h:97
List of Mailboxes.
Definition: mailbox.h:166
struct Mailbox * mailbox
Mailbox in the list.
Definition: mailbox.h:167
STAILQ_ENTRY(MailboxNode) entries
Linked list.
A mailbox.
Definition: mailbox.h:79
void(* mdata_free)(void **ptr)
Definition: mailbox.h:143
int vcount
The number of virtual messages.
Definition: mailbox.h:99
bool changed
Mailbox has been modified.
Definition: mailbox.h:110
bool has_new
Mailbox has new mail.
Definition: mailbox.h:85
char * realpath
Used for duplicate detection, context comparison, and the sidebar.
Definition: mailbox.h:81
bool append
Mailbox is opened in append mode.
Definition: mailbox.h:109
int * v2r
Mapping from virtual to real msgno.
Definition: mailbox.h:98
const struct MxOps * mx_ops
MXAPI callback functions.
Definition: mailbox.h:107
int msg_new
Number of new messages.
Definition: mailbox.h:92
time_t last_checked
Last time we checked this mailbox for new mail.
Definition: mailbox.h:105
int msg_count
Total number of messages.
Definition: mailbox.h:88
bool first_check_stats_done
True when the check have been done at least one time.
Definition: mailbox.h:112
AclFlags rights
ACL bits, see AclFlags.
Definition: mailbox.h:119
int email_max
Size of emails array.
Definition: mailbox.h:97
enum MailboxType type
Mailbox type.
Definition: mailbox.h:102
bool newly_created
Mbox or mmdf just popped into existence.
Definition: mailbox.h:103
bool poll_new_mail
Check for new mail.
Definition: mailbox.h:115
void * mdata
Driver specific data.
Definition: mailbox.h:132
struct HashTable * subj_hash
Hash Table: "subject" -> Email.
Definition: mailbox.h:124
struct Email ** emails
Array of Emails.
Definition: mailbox.h:96
char * name
A short name for the Mailbox.
Definition: mailbox.h:82
struct Notify * notify
Notifications: NotifyMailbox, EventMailbox.
Definition: mailbox.h:145
bool notify_user
Notify the user of new mail.
Definition: mailbox.h:113
struct HashTable * id_hash
Hash Table: "message-id" -> Email.
Definition: mailbox.h:123
struct Buffer pathbuf
Path of the Mailbox.
Definition: mailbox.h:80
bool peekonly
Just taking a glance, revert atime.
Definition: mailbox.h:114
int msg_deleted
Number of deleted messages.
Definition: mailbox.h:93
struct Account * account
Account that owns this Mailbox.
Definition: mailbox.h:127
bool dontwrite
Don't write the mailbox on close.
Definition: mailbox.h:111
bool notified
User has been notified.
Definition: mailbox.h:101
off_t size
Size of the Mailbox.
Definition: mailbox.h:84
struct HashTable * label_hash
Hash Table: "x-labels" -> Email.
Definition: mailbox.h:125
bool visible
True if a result of "mailboxes".
Definition: mailbox.h:130
int msg_flagged
Number of flagged messages.
Definition: mailbox.h:90
int opened
Number of times mailbox is opened.
Definition: mailbox.h:128
void * compress_info
Compressed mbox module private data.
Definition: mailbox.h:121
struct timespec last_visited
Time of last exit from this mailbox.
Definition: mailbox.h:104
bool readonly
Don't allow changes to the mailbox.
Definition: mailbox.h:116
int msg_tagged
How many messages are tagged?
Definition: mailbox.h:94
bool verbose
Display status messages?
Definition: mailbox.h:117
int msg_unread
Number of unread messages.
Definition: mailbox.h:89
int gen
Generation number, for sorting.
Definition: mailbox.h:147
struct ConfigSubset * sub
Inherited config items.
Definition: mailbox.h:83
Definition: mxapi.h:91
Notification API.
Definition: notify.c:53