148 adata->locked =
true;
150 else if (retry && !excl)
174 adata->locked =
false;
192 char buf[8192] = { 0 };
193 char return_path[1024] = { 0 };
198 struct Email *e = NULL;
199 struct stat st = { 0 };
200 struct Progress *progress = NULL;
210 m->
size = st.st_size;
212 buf[
sizeof(buf) - 1] =
'\0';
222 if (!fgets(buf,
sizeof(buf) - 1, adata->
fp))
230 loc = ftello(adata->
fp);
243 if (!fgets(buf,
sizeof(buf) - 1, adata->
fp))
250 return_path[0] =
'\0';
252 if (!
is_from(buf, return_path,
sizeof(return_path), &t))
267 loc = ftello(adata->
fp);
275 if ((tmploc > 0) && (tmploc < m->size))
299 loc = ftello(adata->
fp);
302 if (!fgets(buf,
sizeof(buf) - 1, adata->
fp))
360 struct stat st = { 0 };
361 char buf[8192] = { 0 };
362 char return_path[256] = { 0 };
363 struct Email *e_cur = NULL;
365 int count = 0,
lines = 0;
367 struct Progress *progress = NULL;
377 m->
size = st.st_size;
390 loc = ftello(adata->
fp);
397 while ((fgets(buf,
sizeof(buf), adata->
fp)) && !
SigInt)
399 if (
is_from(buf, return_path,
sizeof(return_path), &t))
436 loc = ftello(adata->
fp);
447 if ((tmploc > 0) && (tmploc < m->
size))
462 else if (tmploc != m->
size)
473 if (e_cur->
lines == 0)
481 if (fgetc(adata->
fp) ==
'\n')
508 loc = ftello(adata->
fp);
557 bool (*cmp_headers)(
const struct Email *,
const struct Email *) = NULL;
558 struct Email **e_old = NULL;
560 bool msg_mod =
false;
633 for (
int i = 0; i < old_msg_count; i++)
656 for (j = i; j < old_msg_count; j++)
660 if (cmp_headers(m->
emails[i], e_old[j]))
668 for (j = 0; (j < i) && (j < old_msg_count); j++)
672 if (cmp_headers(m->
emails[i], e_old[j]))
703 for (
int j = 0; j < old_msg_count; j++)
749 struct stat st2 = { 0 };
757 struct utimbuf utimebuf = { 0 };
758 utimebuf.actime = st->st_atime;
759 utimebuf.modtime = st->st_mtime;
764 if (!c_mail_check_recent && (utimebuf.actime >= utimebuf.modtime) &&
mbox_has_new(m))
766 utimebuf.actime = utimebuf.modtime - 1;
944 struct stat st = { 0 };
946 bool modified =
false;
951 (st.st_size == m->
size))
956 if (st.st_size == m->
size)
963 if (st.st_size > m->
size)
984 char buf[1024] = { 0 };
989 if (fgets(buf,
sizeof(buf), adata->
fp))
1069 struct Buffer *tempfile = NULL;
1070 char buf[32] = { 0 };
1072 bool unlink_tempfile =
false;
1073 bool need_sort =
false;
1076 struct stat st = { 0 };
1077 struct MUpdate *new_offset = NULL;
1078 struct MUpdate *old_offset = NULL;
1080 struct Progress *progress = NULL;
1097 mutt_error(
_(
"Fatal error! Could not reopen mailbox!"));
1126 int fd = open(
buf_string(tempfile), O_WRONLY | O_EXCL | O_CREAT, 0600);
1127 if ((fd == -1) || !(fp = fdopen(fd,
"w")))
1132 unlink_tempfile =
true;
1137 unlink_tempfile =
true;
1152 mutt_error(
_(
"sync: mbox modified, but no modified messages (report this bug)"));
1177 for (i = first, j = 0; i < m->
msg_count; i++)
1183 old_offset[i - first].
valid =
true;
1205 new_offset[i - first].
hdr = ftello(fp) + offset;
1235 if (fputs(
"\n",
fp) == EOF)
1258 unlink_tempfile =
false;
1274 !fgets(buf,
sizeof(buf), adata->
fp) ||
1296 if (ferror(adata->
fp))
1301 m->
size = ftello(adata->
fp);
1302 if ((m->
size < 0) || (ftruncate(fileno(adata->
fp), m->
size) != 0))
1347 mutt_error(
_(
"Fatal error! Could not reopen mailbox!"));
1354 for (i = first, j = first; i < m->
msg_count; i++)
1371 if (c_check_mbox_size)
1385 if (tempfile && unlink_tempfile)
1389 if ((first >= 0) && old_offset)
1391 for (i = first; (i < m->
msg_count) && old_offset[i - first].valid; i++)
1454#ifdef HAVE_UTIMENSAT
1455 struct timespec ts[2] = { { 0 }, { 0 } };
1456 ts[0] = adata->
atime;
1457 ts[1] = adata->
mtime;
1458 utimensat(AT_FDCWD, m->path, ts, 0);
1460 struct utimbuf ut = { 0 };
1461 ut.actime = adata->
atime.tv_sec;
1462 ut.modtime = adata->
mtime.tv_sec;
1504 if (fputc(
'\n', msg->
fp) == EOF)
1507 if ((fflush(msg->
fp) == EOF) || (fsync(fileno(msg->
fp)) == -1))
1547 if (S_ISDIR(st->st_mode))
1550 if (st->st_size == 0)
1558 while ((ch = fgetc(
fp)) != EOF)
1563 if ((ch !=
'\n') && (ch !=
'\r'))
1571 char tmp[256] = { 0 };
1572 if (fgets(tmp,
sizeof(tmp),
fp))
1582 if (!c_check_mbox_size)
1587#ifdef HAVE_UTIMENSAT
1588 struct timespec ts[2] = { { 0 }, { 0 } };
1591 utimensat(AT_FDCWD, path, ts, 0);
1593 struct utimbuf times = { 0 };
1594 times.actime = st->st_atime;
1595 times.modtime = st->st_mtime;
1596 utime(path, ×);
1628 if ((fflush(msg->
fp) == EOF) || (fsync(fileno(msg->
fp)) == -1))
1652 struct stat st = { 0 };
1656 bool new_or_changed;
1659 if (c_check_mbox_size)
1661 new_or_changed = (st.st_size > m->
size);
1675 if (!c_mail_check_recent ||
1681 else if (c_check_mbox_size)
1684 m->
size = (off_t) st.st_size;
1687 if (m->
newly_created && ((st.st_ctime != st.st_mtime) || (st.st_ctime != st.st_atime)))
1694 &
adata->stats_last_checked) > 0)
1730 .msg_save_hcache = NULL,
1732 .tags_commit = NULL,
1760 .msg_save_hcache = NULL,
1762 .tags_commit = NULL,
void mutt_addrlist_copy(struct AddressList *dst, const struct AddressList *src, bool prune)
Copy a list of addresses into another list.
int mutt_addrlist_parse(struct AddressList *al, const char *s)
Parse a list of email addresses.
int buf_printf(struct Buffer *buf, const char *fmt,...)
Format a string overwriting a Buffer.
bool buf_is_empty(const struct Buffer *buf)
Is the Buffer empty?
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
const char * cs_subset_path(const struct ConfigSubset *sub, const char *name)
Get a path config item by name.
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
short cs_subset_sort(const struct ConfigSubset *sub, const char *name)
Get a sort config item by name.
Convenience wrapper for the config headers.
char * HomeDir
User's home directory.
int mutt_copy_message(FILE *fp_out, struct Email *e, struct Message *msg, CopyMessageFlags cmflags, CopyHeaderFlags chflags, int wraplen)
Copy a message from a Mailbox.
Duplicate the structure of an entire email.
#define MUTT_CM_UPDATE
Update structs on sync.
#define CH_UPDATE
Update the status and x-status fields?
#define CH_FROM
Retain the "From " message separator?
#define CH_UPDATE_LEN
Update Lines: and Content-Length:
Convenience wrapper for the core headers.
void mailbox_update(struct Mailbox *m)
Get the mailbox's current size.
void mailbox_changed(struct Mailbox *m, enum NotifyMailbox action)
Notify observers of a change to a Mailbox.
struct Mailbox * mailbox_find(const char *path)
Find the mailbox with a given path.
@ NT_MAILBOX_RESORT
Email list needs resorting.
@ NT_MAILBOX_INVALID
Email list was changed.
@ NT_MAILBOX_UPDATE
Update internal tables.
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
MailboxType
Supported mailbox formats.
@ MUTT_MMDF
'mmdf' Mailbox type
@ MUTT_MBOX
'mbox' Mailbox type
@ MUTT_UNKNOWN
Mailbox wasn't recognised.
void mutt_body_free(struct Body **ptr)
Free a Body.
bool email_cmp_strict(const struct Email *e1, const struct Email *e2)
Strictly compare message emails.
struct Email * email_new(void)
Create a new Email.
void email_free(struct Email **ptr)
Free an Email.
Structs that make up an email.
struct Envelope * mutt_rfc822_read_header(FILE *fp, struct Email *e, bool user_hdrs, bool weed)
Parses an RFC822 header.
void mutt_sort_unsorted(struct Mailbox *m)
Sort emails by their disk order.
EmailSortType
Methods for sorting Emails.
@ EMAIL_SORT_UNSORTED
Sort by the order the messages appear in the mailbox.
void mutt_file_get_stat_timespec(struct timespec *dest, struct stat *st, enum MuttStatType type)
Read the stat() time into a time value.
int mutt_file_copy_stream(FILE *fp_in, FILE *fp_out)
Copy the contents of one file into another.
int mutt_file_stat_compare(struct stat *st1, enum MuttStatType st1_type, struct stat *st2, enum MuttStatType st2_type)
Compare two stat infos.
void mutt_file_touch_atime(int fd)
Set the access time to current time.
int mutt_file_check_empty(const char *path)
Is the mailbox empty.
int mutt_file_mkdir(const char *path, mode_t mode)
Recursively create directories.
int mutt_file_lock(int fd, bool excl, bool timeout)
(Try to) Lock a file using fcntl()
int mutt_file_timespec_compare(struct timespec *a, struct timespec *b)
Compare to time values.
int mutt_file_unlock(int fd)
Unlock a file previously locked by mutt_file_lock()
bool mutt_file_seek(FILE *fp, LOFF_T offset, int whence)
Wrapper for fseeko with error handling.
int mutt_file_stat_timespec_compare(struct stat *st, enum MuttStatType type, struct timespec *b)
Compare stat info with a time value.
#define mutt_file_fclose(FP)
#define mutt_file_fopen(PATH, MODE)
@ MUTT_STAT_CTIME
File/dir's ctime - creation time.
@ MUTT_STAT_ATIME
File/dir's atime - last accessed time.
@ MUTT_STAT_MTIME
File/dir's mtime - last modified time.
void mutt_set_flag(struct Mailbox *m, struct Email *e, enum MessageType flag, bool bf, bool upd_mbox)
Set a flag on an email.
bool is_from(const char *s, char *path, size_t pathlen, time_t *tp)
Is a string a 'From' header line?
char * ShortHostname
Short version of the hostname.
char * Username
User's login name.
static void mbox_adata_free(void **ptr)
Free the private Account data - Implements Account::adata_free() -.
#define mutt_message(...)
#define mutt_debug(LEVEL,...)
static bool mbox_ac_add(struct Account *a, struct Mailbox *m)
Add a Mailbox to an Account - Implements MxOps::ac_add() -.
static bool mbox_ac_owns_path(struct Account *a, const char *path)
Check whether an Account owns a Mailbox path - Implements MxOps::ac_owns_path() -.
const struct MxOps MxMboxOps
Mbox Mailbox - Implements MxOps -.
const struct MxOps MxMmdfOps
MMDF Mailbox - Implements MxOps -.
static enum MxStatus mbox_mbox_check_stats(struct Mailbox *m, uint8_t flags)
Check the Mailbox statistics - Implements MxOps::mbox_check_stats() -.
static enum MxStatus mbox_mbox_check(struct Mailbox *m)
Check for new mail - Implements MxOps::mbox_check() -.
static enum MxStatus mbox_mbox_close(struct Mailbox *m)
Close a Mailbox - Implements MxOps::mbox_close() -.
static bool mbox_mbox_open_append(struct Mailbox *m, OpenMailboxFlags flags)
Open a Mailbox for appending - Implements MxOps::mbox_open_append() -.
static enum MxOpenReturns mbox_mbox_open(struct Mailbox *m)
Open a Mailbox - Implements MxOps::mbox_open() -.
static enum MxStatus mbox_mbox_sync(struct Mailbox *m)
Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
static int mbox_msg_close(struct Mailbox *m, struct Message *msg)
Close an email - Implements MxOps::msg_close() -.
static int mbox_msg_commit(struct Mailbox *m, struct Message *msg)
Save changes to an email - Implements MxOps::msg_commit() -.
static int mmdf_msg_commit(struct Mailbox *m, struct Message *msg)
Save changes to an email - Implements MxOps::msg_commit() -.
static bool mbox_msg_open_new(struct Mailbox *m, struct Message *msg, const struct Email *e)
Open a new message in a Mailbox - Implements MxOps::msg_open_new() -.
static bool mbox_msg_open(struct Mailbox *m, struct Message *msg, struct Email *e)
Open an email message in a Mailbox - Implements MxOps::msg_open() -.
static int mbox_msg_padding_size(struct Mailbox *m)
Bytes of padding between messages - Implements MxOps::msg_padding_size() -.
static int mmdf_msg_padding_size(struct Mailbox *m)
Bytes of padding between messages - Implements MxOps::msg_padding_size() -.
static int mbox_path_canon(struct Buffer *path)
Canonicalise a Mailbox path - Implements MxOps::path_canon() -.
static int mbox_path_is_empty(struct Buffer *path)
Is the mailbox empty - Implements MxOps::path_is_empty() -.
enum MailboxType mbox_path_probe(const char *path, const struct stat *st)
Is this an mbox Mailbox? - Implements MxOps::path_probe() -.
void mutt_hash_free(struct HashTable **ptr)
Free a hash table.
@ LL_DEBUG1
Log at debug level 1.
static enum MxOpenReturns mbox_parse_mailbox(struct Mailbox *m)
Read a mailbox from disk.
static struct MboxAccountData * mbox_adata_new(void)
Create a new MboxAccountData struct.
static bool mbox_has_new(struct Mailbox *m)
Does the mailbox have new mail.
static int mbox_lock_mailbox(struct Mailbox *m, bool excl, bool retry)
Lock a mailbox.
static struct MboxAccountData * mbox_adata_get(struct Mailbox *m)
Get the private data associated with a Mailbox.
static int init_mailbox(struct Mailbox *m)
Add Mbox data to the Mailbox.
static FILE * mbox_open_readwrite(struct Mailbox *m)
Open an mbox read-write.
static FILE * mbox_open_readonly(struct Mailbox *m)
Open an mbox read-only.
static void mbox_unlock_mailbox(struct Mailbox *m)
Unlock a mailbox.
static enum MxOpenReturns mmdf_parse_mailbox(struct Mailbox *m)
Read a mailbox in MMDF format.
void mbox_reset_atime(struct Mailbox *m, struct stat *st)
Reset the access time on the mailbox file.
static int reopen_mailbox(struct Mailbox *m)
Close and reopen a mailbox.
#define MUTT_MEM_CALLOC(n, type)
int mutt_date_local_tz(time_t t)
Calculate the local timezone in seconds east of UTC.
void mutt_time_now(struct timespec *tp)
Set the provided time field to the current time.
Convenience wrapper for the library headers.
bool mutt_path_canon(struct Buffer *path, const char *homedir, bool is_dir)
Create the canonical version of a path.
char * mutt_path_dirname(const char *path)
Return a path up to, but not including, the final '/'.
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
size_t mutt_str_startswith(const char *str, const char *prefix)
Check whether a string starts with a prefix.
Many unsorted constants and some structs.
@ MUTT_READ
Messages that have been read.
@ MUTT_PURGE
Messages to be purged (bypass trash)
@ MUTT_TAG
Tagged messages.
@ MUTT_FLAG
Flagged messages.
@ MUTT_DELETE
Messages to be deleted.
@ MUTT_REPLIED
Messages that have been replied to.
void buf_pretty_mailbox(struct Buffer *buf)
Shorten a mailbox path using '~' or '='.
Some miscellaneous functions.
void mx_alloc_memory(struct Mailbox *m, int req_size)
Create storage for the emails.
int mx_msg_close(struct Mailbox *m, struct Message **ptr)
Close a message.
void mx_fastclose_mailbox(struct Mailbox *m, bool keep_account)
Free up memory associated with the Mailbox.
bool mx_mbox_open(struct Mailbox *m, OpenMailboxFlags flags)
Open a mailbox and parse it.
struct Message * mx_msg_open(struct Mailbox *m, struct Email *e)
Return a stream pointer for a message.
enum MxStatus mx_mbox_close(struct Mailbox *m)
Save changes and close mailbox.
uint8_t OpenMailboxFlags
Flags for mutt_open_mailbox(), e.g. MUTT_NOSORT.
#define MUTT_NEWFOLDER
Create a new folder - same as MUTT_APPEND, but uses mutt_file_fopen() with mode "w" for mbox-style fo...
#define MUTT_MAILBOX_CHECK_STATS
Ignore mail_check_stats and calculate statistics (used by <check-stats>)
#define MUTT_QUIET
Do not print any messages.
MxOpenReturns
Return values for mbox_open()
@ MX_OPEN_ERROR
Open failed with an error.
@ MX_OPEN_ABORT
Open was aborted.
@ MX_OPEN_OK
Open succeeded.
#define MUTT_PEEK
Revert atime back after taking a look (if applicable)
#define MUTT_NOSORT
Do not sort the mailbox after opening it.
MxStatus
Return values from mbox_check(), mbox_check_stats(), mbox_sync(), and mbox_close()
@ MX_STATUS_LOCKED
Couldn't lock the Mailbox.
@ MX_STATUS_ERROR
An error occurred.
@ MX_STATUS_OK
No changes.
@ MX_STATUS_REOPENED
Mailbox was reopened.
@ MX_STATUS_NEW_MAIL
New mail received in Mailbox.
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
@ MUTT_PROGRESS_READ
Progress tracks elements, according to $read_inc
@ MUTT_PROGRESS_WRITE
Progress tracks elements, according to $write_inc
struct Progress * progress_new(enum ProgressType type, size_t size)
Create a new Progress Bar.
void progress_free(struct Progress **ptr)
Free a Progress Bar.
void progress_set_message(struct Progress *progress, const char *fmt,...) __attribute__((__format__(__printf__
bool progress_update(struct Progress *progress, size_t pos, int percent)
Update the state of the progress bar.
Prototypes for many functions.
#define STAILQ_FIRST(head)
#define TAILQ_EMPTY(head)
volatile sig_atomic_t SigInt
true after SIGINT is received
void mutt_sig_block(void)
Block signals during critical operations.
void mutt_sig_unblock(void)
Restore previously blocked signals.
A group of associated Mailboxes.
enum MailboxType type
Type of Mailboxes this Account contains.
void(* adata_free)(void **ptr)
void * adata
Private data (for Mailbox backends)
struct MailboxList mailboxes
List of Mailboxes.
struct Body * parts
parts of a multipart or message/rfc822
LOFF_T offset
offset where the actual data begins
LOFF_T length
length (in bytes) of attachment
long hdr_offset
Offset in stream where the headers begin.
String manipulation buffer.
The envelope/body of an email.
bool purge
Skip trash folder when deleting.
struct Envelope * env
Envelope information.
int lines
How many lines in the body of this message?
struct Body * body
List of MIME parts.
bool old
Email is seen, but unread.
bool changed
Email has been edited.
LOFF_T offset
Where in the stream does this message begin?
bool attach_del
Has an attachment marked for deletion.
bool flagged
Marked important?
bool replied
Email has been replied to.
bool deleted
Email is deleted.
int index
The absolute (unsorted) message number.
bool tagged
Email is tagged.
time_t received
Time when the message was placed in the mailbox.
struct AddressList return_path
Return path for the Email.
struct AddressList from
Email's 'From' list.
Store of new offsets, used by mutt_sync_mailbox()
struct Mailbox * mailbox
Mailbox in the list.
int vcount
The number of virtual messages.
bool changed
Mailbox has been modified.
bool has_new
Mailbox has new mail.
int * v2r
Mapping from virtual to real msgno.
int msg_new
Number of new messages.
int msg_count
Total number of messages.
int email_max
Size of emails array.
enum MailboxType type
Mailbox type.
bool newly_created
Mbox or mmdf just popped into existence.
struct HashTable * subj_hash
Hash Table: "subject" -> Email.
struct Email ** emails
Array of Emails.
struct HashTable * id_hash
Hash Table: "message-id" -> Email.
struct Buffer pathbuf
Path of the Mailbox.
bool peekonly
Just taking a glance, revert atime.
int msg_deleted
Number of deleted messages.
struct Account * account
Account that owns this Mailbox.
off_t size
Size of the Mailbox.
struct HashTable * label_hash
Hash Table: "x-labels" -> Email.
int msg_flagged
Number of flagged messages.
struct timespec last_visited
Time of last exit from this mailbox.
bool readonly
Don't allow changes to the mailbox.
int msg_tagged
How many messages are tagged?
bool verbose
Display status messages?
int msg_unread
Number of unread messages.
Mbox-specific Account data -.
bool locked
is the mailbox locked?
struct timespec atime
File's last-access time.
struct timespec mtime
Time Mailbox was last changed.
A local copy of an email.
FILE * fp
pointer to the message data
bool write
nonzero if message is open for writing
enum MailboxType type
Mailbox type, e.g. MUTT_IMAP.
Container for Accounts, Notifications.
struct ConfigSubset * sub
Inherited config items.
int cs_subset_str_native_set(const struct ConfigSubset *sub, const char *name, intptr_t value, struct Buffer *err)
Natively set the value of a string config item.