NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
mbox_sync()

Save changes to the Mailbox. More...

+ Collaboration diagram for mbox_sync():

Functions

static enum MxStatus comp_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
enum MxStatus maildir_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
static enum MxStatus mbox_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
static enum MxStatus mh_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
static enum MxStatus nntp_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
static enum MxStatus nm_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 
static enum MxStatus pop_mbox_sync (struct Mailbox *m)
 Save changes to the Mailbox - Implements MxOps::mbox_sync() -.
 

Detailed Description

Save changes to the Mailbox.

Parameters
mMailbox to sync
Return values
enumMxStatus
Precondition
m is not NULL

Function Documentation

◆ comp_mbox_sync()

static enum MxStatus comp_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Changes in NeoMutt only affect the tmp file. Calling comp_mbox_sync() will commit them to the compressed file.

Definition at line 586 of file compress.c.

587{
588 if (!m->compress_info)
589 return MX_STATUS_ERROR;
590
591 struct CompressInfo *ci = m->compress_info;
592
593 if (!ci->cmd_close)
594 {
595 mutt_error(_("Can't sync a compressed file without a close-hook"));
596 return MX_STATUS_ERROR;
597 }
598
599 const struct MxOps *ops = ci->child_ops;
600 if (!ops)
601 return MX_STATUS_ERROR;
602
603 if (!lock_realpath(m, true))
604 {
605 mutt_error(_("Unable to lock mailbox"));
606 return MX_STATUS_ERROR;
607 }
608
609 enum MxStatus check = comp_mbox_check(m);
610 if (check != MX_STATUS_OK)
611 goto sync_cleanup;
612
613 check = ops->mbox_sync(m);
614 if (check != MX_STATUS_OK)
615 goto sync_cleanup;
616
617 if (!execute_command(m, ci->cmd_close, _("Compressing %s")))
618 {
619 check = MX_STATUS_ERROR;
620 goto sync_cleanup;
621 }
622
623 check = MX_STATUS_OK;
624
625sync_cleanup:
626 store_size(m);
628 return check;
629}
static void store_size(const struct Mailbox *m)
Save the size of the compressed file.
Definition compress.c:198
static bool lock_realpath(struct Mailbox *m, bool excl)
Try to lock the Mailbox.realpath.
Definition compress.c:108
static void unlock_realpath(struct Mailbox *m)
Unlock the mailbox->realpath.
Definition compress.c:149
static bool execute_command(struct Mailbox *m, const struct Expando *exp, const char *progress)
Run a system command.
Definition compress.c:291
#define mutt_error(...)
Definition logging2.h:94
static enum MxStatus comp_mbox_check(struct Mailbox *m)
Check for new mail - Implements MxOps::mbox_check() -.
Definition compress.c:550
#define _(a)
Definition message.h:28
MxStatus
Return values from mbox_check(), mbox_check_stats(), mbox_sync(), and mbox_close()
Definition mxapi.h:59
@ MX_STATUS_ERROR
An error occurred.
Definition mxapi.h:60
@ MX_STATUS_OK
No changes.
Definition mxapi.h:61
Private data for compress.
Definition lib.h:61
const struct MxOps * child_ops
callbacks of de-compressed file
Definition lib.h:66
struct Expando * cmd_close
close-hook command
Definition lib.h:63
void * compress_info
Compressed mbox module private data.
Definition mailbox.h:120
Definition mxapi.h:87
enum MxStatus(* mbox_sync)(struct Mailbox *m)
Definition mxapi.h:183
+ Here is the call graph for this function:

◆ maildir_mbox_sync()

enum MxStatus maildir_mbox_sync ( struct Mailbox * m)

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Return values
enumMxStatus
Note
The flag retvals come from a call to a backend sync function

Definition at line 846 of file mailbox.c.

847{
848 enum MxStatus check = maildir_check(m);
849 if (check == MX_STATUS_ERROR)
850 return check;
851
852 struct HeaderCache *hc = maildir_hcache_open(m);
853
854 struct Progress *progress = NULL;
855 if (m->verbose)
856 {
858 progress_set_message(progress, _("Writing %s..."), mailbox_path(m));
859 }
860
861 for (int i = 0; i < m->msg_count; i++)
862 {
863 progress_update(progress, i, -1);
864
865 struct Email *e = m->emails[i];
866 if (!maildir_sync_mailbox_message(m, e, hc))
867 {
868 progress_free(&progress);
869 goto err;
870 }
871 }
872 progress_free(&progress);
874
875 /* XXX race condition? */
876
878
879 /* adjust indices */
880
881 if (m->msg_deleted)
882 {
883 const bool c_maildir_trash = cs_subset_bool(NeoMutt->sub, "maildir_trash");
884 for (int i = 0, j = 0; i < m->msg_count; i++)
885 {
886 struct Email *e = m->emails[i];
887 if (!e)
888 break;
889
890 if (!e->deleted || c_maildir_trash)
891 e->index = j++;
892 }
893 }
894
895 return check;
896
897err:
899 return MX_STATUS_ERROR;
900}
bool cs_subset_bool(const struct ConfigSubset *sub, const char *name)
Get a boolean config item by name.
Definition helpers.c:47
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition mailbox.h:213
struct HeaderCache * maildir_hcache_open(struct Mailbox *m)
Open the Header Cache.
Definition hcache.c:104
void maildir_hcache_close(struct HeaderCache **ptr)
Close the Header Cache.
Definition hcache.c:77
static enum MxStatus maildir_check(struct Mailbox *m)
Check for new mail.
Definition mailbox.c:545
void maildir_update_mtime(struct Mailbox *m)
Update our record of the Maildir modification time.
Definition mailbox.c:722
bool maildir_sync_mailbox_message(struct Mailbox *m, struct Email *e, struct HeaderCache *hc)
Save changes to the mailbox.
Definition message.c:315
@ MUTT_PROGRESS_WRITE
Progress tracks elements, according to $write_inc
Definition lib.h:85
struct Progress * progress_new(enum ProgressType type, size_t size)
Create a new Progress Bar.
Definition progress.c:139
void progress_free(struct Progress **ptr)
Free a Progress Bar.
Definition progress.c:110
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.
Definition progress.c:80
The envelope/body of an email.
Definition email.h:39
bool deleted
Email is deleted.
Definition email.h:78
int index
The absolute (unsorted) message number.
Definition email.h:110
Header Cache.
Definition lib.h:87
int msg_count
Total number of messages.
Definition mailbox.h:87
struct Email ** emails
Array of Emails.
Definition mailbox.h:95
int msg_deleted
Number of deleted messages.
Definition mailbox.h:92
bool verbose
Display status messages?
Definition mailbox.h:116
Container for Accounts, Notifications.
Definition neomutt.h:41
struct ConfigSubset * sub
Inherited config items.
Definition neomutt.h:49
+ Here is the call graph for this function:

◆ mbox_mbox_sync()

static enum MxStatus mbox_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Definition at line 1058 of file mbox.c.

1059{
1061 if (!adata)
1062 return MX_STATUS_ERROR;
1063
1064 struct Buffer *tempfile = NULL;
1065 char buf[32] = { 0 };
1066 int j;
1067 bool unlink_tempfile = false;
1068 bool need_sort = false; /* flag to resort mailbox if new mail arrives */
1069 int first = -1; /* first message to be written */
1070 LOFF_T offset; /* location in mailbox to write changed messages */
1071 struct stat st = { 0 };
1072 struct MUpdate *new_offset = NULL;
1073 struct MUpdate *old_offset = NULL;
1074 FILE *fp = NULL;
1075 struct Progress *progress = NULL;
1076 enum MxStatus rc = MX_STATUS_ERROR;
1077
1078 /* sort message by their position in the mailbox on disk */
1079 const enum EmailSortType c_sort = cs_subset_sort(NeoMutt->sub, "sort");
1080 if (c_sort != EMAIL_SORT_UNSORTED)
1081 {
1083 need_sort = true;
1084 }
1085
1086 /* need to open the file for writing in such a way that it does not truncate
1087 * the file, so use read-write mode. */
1088 adata->fp = freopen(mailbox_path(m), "r+", adata->fp);
1089 if (!adata->fp)
1090 {
1091 mx_fastclose_mailbox(m, false);
1092 mutt_error(_("Fatal error! Could not reopen mailbox!"));
1093 goto fatal;
1094 }
1095
1097
1098 if (mbox_lock_mailbox(m, true, true) == -1)
1099 {
1101 mutt_error(_("Unable to lock mailbox"));
1102 goto bail;
1103 }
1104
1105 /* Check to make sure that the file hasn't changed on disk */
1106 enum MxStatus check = mbox_mbox_check(m);
1107 if ((check == MX_STATUS_NEW_MAIL) || (check == MX_STATUS_REOPENED))
1108 {
1109 /* new mail arrived, or mailbox reopened */
1110 rc = check;
1111 goto bail;
1112 }
1113 else if (check < 0)
1114 {
1115 goto fatal;
1116 }
1117
1118 /* Create a temporary file to write the new version of the mailbox in. */
1119 tempfile = buf_pool_get();
1120 buf_mktemp(tempfile);
1121 int fd = open(buf_string(tempfile), O_WRONLY | O_EXCL | O_CREAT, 0600);
1122 if ((fd == -1) || !(fp = fdopen(fd, "w")))
1123 {
1124 if (fd != -1)
1125 {
1126 close(fd);
1127 unlink_tempfile = true;
1128 }
1129 mutt_error(_("Could not create temporary file"));
1130 goto bail;
1131 }
1132 unlink_tempfile = true;
1133
1134 /* find the first deleted/changed message. we save a lot of time by only
1135 * rewriting the mailbox from the point where it has actually changed. */
1136 int i = 0;
1137 for (; (i < m->msg_count) && !m->emails[i]->deleted &&
1138 !m->emails[i]->changed && !m->emails[i]->attach_del;
1139 i++)
1140 {
1141 }
1142 if (i == m->msg_count)
1143 {
1144 /* this means m->changed or m->msg_deleted was set, but no
1145 * messages were found to be changed or deleted. This should
1146 * never happen, is we presume it is a bug in neomutt. */
1147 mutt_error(_("sync: mbox modified, but no modified messages (report this bug)"));
1148 mutt_debug(LL_DEBUG1, "no modified messages\n");
1149 goto bail;
1150 }
1151
1152 /* save the index of the first changed/deleted message */
1153 first = i;
1154 /* where to start overwriting */
1155 offset = m->emails[i]->offset;
1156
1157 /* the offset stored in the header does not include the MMDF_SEP, so make
1158 * sure we seek to the correct location */
1159 if (m->type == MUTT_MMDF)
1160 offset -= (sizeof(MMDF_SEP) - 1);
1161
1162 /* allocate space for the new offsets */
1163 new_offset = MUTT_MEM_CALLOC(m->msg_count - first, struct MUpdate);
1164 old_offset = MUTT_MEM_CALLOC(m->msg_count - first, struct MUpdate);
1165
1166 if (m->verbose)
1167 {
1169 progress_set_message(progress, _("Writing %s..."), mailbox_path(m));
1170 }
1171
1172 for (i = first, j = 0; i < m->msg_count; i++)
1173 {
1174 progress_update(progress, i, i / (m->msg_count / 100 + 1));
1175 /* back up some information which is needed to restore offsets when
1176 * something fails. */
1177
1178 old_offset[i - first].valid = true;
1179 old_offset[i - first].hdr = m->emails[i]->offset;
1180 old_offset[i - first].body = m->emails[i]->body->offset;
1181 old_offset[i - first].lines = m->emails[i]->lines;
1182 old_offset[i - first].length = m->emails[i]->body->length;
1183
1184 if (!m->emails[i]->deleted)
1185 {
1186 j++;
1187
1188 if (m->type == MUTT_MMDF)
1189 {
1190 if (fputs(MMDF_SEP, fp) == EOF)
1191 {
1192 mutt_perror("%s", buf_string(tempfile));
1193 goto bail;
1194 }
1195 }
1196
1197 /* save the new offset for this message. we add 'offset' because the
1198 * temporary file only contains saved message which are located after
1199 * 'offset' in the real mailbox */
1200 new_offset[i - first].hdr = ftello(fp) + offset;
1201
1202 struct Message *msg = mx_msg_open(m, m->emails[i]);
1203 const int rc2 = mutt_copy_message(fp, m->emails[i], msg, MUTT_CM_UPDATE,
1205 mx_msg_close(m, &msg);
1206 if (rc2 != 0)
1207 {
1208 mutt_perror("%s", buf_string(tempfile));
1209 goto bail;
1210 }
1211
1212 /* Since messages could have been deleted, the offsets stored in memory
1213 * will be wrong, so update what we can, which is the offset of this
1214 * message, and the offset of the body. If this is a multipart message,
1215 * we just flush the in memory cache so that the message will be reparsed
1216 * if the user accesses it later. */
1217 new_offset[i - first].body = ftello(fp) - m->emails[i]->body->length + offset;
1218 mutt_body_free(&m->emails[i]->body->parts);
1219
1220 if (m->type == MUTT_MMDF)
1221 {
1222 if (fputs(MMDF_SEP, fp) == EOF)
1223 {
1224 mutt_perror("%s", buf_string(tempfile));
1225 goto bail;
1226 }
1227 }
1228 else
1229 {
1230 if (fputs("\n", fp) == EOF)
1231 {
1232 mutt_perror("%s", buf_string(tempfile));
1233 goto bail;
1234 }
1235 }
1236 }
1237 }
1238
1239 if (mutt_file_fclose(&fp) != 0)
1240 {
1241 mutt_debug(LL_DEBUG1, "mutt_file_fclose (&) returned non-zero\n");
1242 mutt_perror("%s", buf_string(tempfile));
1243 goto bail;
1244 }
1245
1246 /* Save the state of this folder. */
1247 if (stat(mailbox_path(m), &st) == -1)
1248 {
1249 mutt_perror("%s", mailbox_path(m));
1250 goto bail;
1251 }
1252
1253 unlink_tempfile = false;
1254
1255 fp = mutt_file_fopen(buf_string(tempfile), "r");
1256 if (!fp)
1257 {
1259 mx_fastclose_mailbox(m, false);
1260 mutt_debug(LL_DEBUG1, "unable to reopen temp copy of mailbox!\n");
1261 mutt_perror("%s", buf_string(tempfile));
1262 FREE(&new_offset);
1263 FREE(&old_offset);
1264 goto fatal;
1265 }
1266
1267 if (!mutt_file_seek(adata->fp, offset, SEEK_SET) || /* seek the append location */
1268 /* do a sanity check to make sure the mailbox looks ok */
1269 !fgets(buf, sizeof(buf), adata->fp) ||
1270 ((m->type == MUTT_MBOX) && !mutt_str_startswith(buf, "From ")) ||
1271 ((m->type == MUTT_MMDF) && !mutt_str_equal(MMDF_SEP, buf)))
1272 {
1273 mutt_debug(LL_DEBUG1, "message not in expected position\n");
1274 mutt_debug(LL_DEBUG1, " LINE: %s\n", buf);
1275 i = -1;
1276 }
1277 else
1278 {
1279 if (!mutt_file_seek(adata->fp, offset, SEEK_SET)) /* return to proper offset */
1280 {
1281 i = -1;
1282 }
1283 else
1284 {
1285 /* copy the temp mailbox back into place starting at the first
1286 * change/deleted message */
1287 if (m->verbose)
1288 mutt_message(_("Committing changes..."));
1289 i = mutt_file_copy_stream(fp, adata->fp);
1290
1291 if (ferror(adata->fp))
1292 i = -1;
1293 }
1294 if (i >= 0)
1295 {
1296 m->size = ftello(adata->fp); /* update the mailbox->size of the mailbox */
1297 if ((m->size < 0) || (ftruncate(fileno(adata->fp), m->size) != 0))
1298 {
1299 i = -1;
1300 mutt_debug(LL_DEBUG1, "ftruncate() failed\n");
1301 }
1302 }
1303 }
1304
1307
1308 if ((mutt_file_fclose(&adata->fp) != 0) || (i == -1))
1309 {
1310 /* error occurred while writing the mailbox back, so keep the temp copy around */
1311
1312 struct Buffer *savefile = buf_pool_get();
1313
1314 const char *const c_tmp_dir = cs_subset_path(NeoMutt->sub, "tmp_dir");
1315 buf_printf(savefile, "%s/neomutt.%s-%s-%u", NONULL(c_tmp_dir),
1316 NONULL(NeoMutt->username), NONULL(ShortHostname), (unsigned int) getpid());
1317 rename(buf_string(tempfile), buf_string(savefile));
1319 mx_fastclose_mailbox(m, false);
1320 pretty_mailbox(savefile);
1321 mutt_error(_("Write failed! Saved partial mailbox to %s"), buf_string(savefile));
1322 buf_pool_release(&savefile);
1323 FREE(&new_offset);
1324 FREE(&old_offset);
1325 goto fatal;
1326 }
1327
1328 /* Restore the previous access/modification times */
1329 mbox_reset_atime(m, &st);
1330
1331 /* reopen the mailbox in read-only mode */
1332 adata->fp = mbox_open_readwrite(m);
1333 if (!adata->fp)
1334 {
1335 adata->fp = mbox_open_readonly(m);
1336 }
1337 if (!adata->fp)
1338 {
1339 unlink(buf_string(tempfile));
1341 mx_fastclose_mailbox(m, false);
1342 mutt_error(_("Fatal error! Could not reopen mailbox!"));
1343 FREE(&new_offset);
1344 FREE(&old_offset);
1345 goto fatal;
1346 }
1347
1348 /* update the offsets of the rewritten messages */
1349 for (i = first, j = first; i < m->msg_count; i++)
1350 {
1351 if (!m->emails[i]->deleted)
1352 {
1353 m->emails[i]->offset = new_offset[i - first].hdr;
1354 m->emails[i]->body->hdr_offset = new_offset[i - first].hdr;
1355 m->emails[i]->body->offset = new_offset[i - first].body;
1356 m->emails[i]->index = j++;
1357 }
1358 }
1359 FREE(&new_offset);
1360 FREE(&old_offset);
1361 unlink(buf_string(tempfile)); /* remove partial copy of the mailbox */
1362 buf_pool_release(&tempfile);
1364
1365 const bool c_check_mbox_size = cs_subset_bool(NeoMutt->sub, "check_mbox_size");
1366 if (c_check_mbox_size)
1367 {
1368 struct Mailbox *m_tmp = mailbox_find(mailbox_path(m));
1369 if (m_tmp && !m_tmp->has_new)
1370 mailbox_update(m_tmp);
1371 }
1372
1373 progress_free(&progress);
1374 return 0; /* signal success */
1375
1376bail: /* Come here in case of disaster */
1377
1378 mutt_file_fclose(&fp);
1379
1380 if (tempfile && unlink_tempfile)
1381 unlink(buf_string(tempfile));
1382
1383 /* restore offsets, as far as they are valid */
1384 if ((first >= 0) && old_offset)
1385 {
1386 for (i = first; (i < m->msg_count) && old_offset[i - first].valid; i++)
1387 {
1388 m->emails[i]->offset = old_offset[i - first].hdr;
1389 m->emails[i]->body->hdr_offset = old_offset[i - first].hdr;
1390 m->emails[i]->body->offset = old_offset[i - first].body;
1391 m->emails[i]->lines = old_offset[i - first].lines;
1392 m->emails[i]->body->length = old_offset[i - first].length;
1393 }
1394 }
1395
1396 /* this is ok to call even if we haven't locked anything */
1398
1400 FREE(&new_offset);
1401 FREE(&old_offset);
1402
1403 adata->fp = freopen(mailbox_path(m), "r", adata->fp);
1404 if (!adata->fp)
1405 {
1406 mutt_error(_("Could not reopen mailbox"));
1407 mx_fastclose_mailbox(m, false);
1408 goto fatal;
1409 }
1410
1412 if (need_sort)
1413 {
1414 /* if the mailbox was reopened, the thread tree will be invalid so make
1415 * sure to start threading from scratch. */
1417 }
1418
1419fatal:
1420 buf_pool_release(&tempfile);
1421 progress_free(&progress);
1422 return rc;
1423}
int buf_printf(struct Buffer *buf, const char *fmt,...)
Format a string overwriting a Buffer.
Definition buffer.c:161
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition buffer.h:96
const char * cs_subset_path(const struct ConfigSubset *sub, const char *name)
Get a path config item by name.
Definition helpers.c:168
short cs_subset_sort(const struct ConfigSubset *sub, const char *name)
Get a sort config item by name.
Definition helpers.c:266
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.
Definition copy_email.c:917
#define MUTT_CM_UPDATE
Update structs on sync.
Definition copy_email.h:42
#define CH_UPDATE
Update the status and x-status fields?
Definition copy_email.h:56
#define CH_FROM
Retain the "From " message separator?
Definition copy_email.h:60
#define CH_UPDATE_LEN
Update Lines: and Content-Length:
Definition copy_email.h:66
void mailbox_update(struct Mailbox *m)
Get the mailbox's current size.
Definition mailbox.c:214
void mailbox_changed(struct Mailbox *m, enum NotifyMailbox action)
Notify observers of a change to a Mailbox.
Definition mailbox.c:232
struct Mailbox * mailbox_find(const char *path)
Find the mailbox with a given path.
Definition mailbox.c:151
@ NT_MAILBOX_RESORT
Email list needs resorting.
Definition mailbox.h:180
@ NT_MAILBOX_UPDATE
Update internal tables.
Definition mailbox.h:181
@ MUTT_MMDF
'mmdf' Mailbox type
Definition mailbox.h:45
@ MUTT_MBOX
'mbox' Mailbox type
Definition mailbox.h:44
void mutt_body_free(struct Body **ptr)
Free a Body.
Definition body.c:58
void mutt_sort_unsorted(struct Mailbox *m)
Sort emails by their disk order.
Definition sort.c:448
EmailSortType
Methods for sorting Emails.
Definition sort.h:53
@ EMAIL_SORT_UNSORTED
Sort by the order the messages appear in the mailbox.
Definition sort.h:64
int mutt_file_copy_stream(FILE *fp_in, FILE *fp_out)
Copy the contents of one file into another.
Definition file.c:222
bool mutt_file_seek(FILE *fp, LOFF_T offset, int whence)
Wrapper for fseeko with error handling.
Definition file.c:652
#define mutt_file_fclose(FP)
Definition file.h:139
#define mutt_file_fopen(PATH, MODE)
Definition file.h:138
char * ShortHostname
Short version of the hostname.
Definition globals.c:36
#define mutt_message(...)
Definition logging2.h:93
#define mutt_debug(LEVEL,...)
Definition logging2.h:91
#define mutt_perror(...)
Definition logging2.h:95
static enum MxStatus mbox_mbox_check(struct Mailbox *m)
Check for new mail - Implements MxOps::mbox_check() -.
Definition mbox.c:924
@ LL_DEBUG1
Log at debug level 1.
Definition logging2.h:45
#define MMDF_SEP
Definition lib.h:63
static int mbox_lock_mailbox(struct Mailbox *m, bool excl, bool retry)
Lock a mailbox.
Definition mbox.c:136
static struct MboxAccountData * mbox_adata_get(struct Mailbox *m)
Get the private data associated with a Mailbox.
Definition mbox.c:121
static FILE * mbox_open_readwrite(struct Mailbox *m)
Open an mbox read-write.
Definition mbox.c:797
static FILE * mbox_open_readonly(struct Mailbox *m)
Open an mbox read-only.
Definition mbox.c:812
static void mbox_unlock_mailbox(struct Mailbox *m)
Unlock a mailbox.
Definition mbox.c:160
void mbox_reset_atime(struct Mailbox *m, struct stat *st)
Reset the access time on the mailbox file.
Definition mbox.c:742
#define FREE(x)
Free memory and set the pointer to NULL.
Definition memory.h:68
#define MUTT_MEM_CALLOC(n, type)
Definition memory.h:52
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
Definition string.c:662
size_t mutt_str_startswith(const char *str, const char *prefix)
Check whether a string starts with a prefix.
Definition string.c:234
void pretty_mailbox(struct Buffer *buf)
Shorten a mailbox path using '~' or '='.
Definition muttlib.c:427
int mx_msg_close(struct Mailbox *m, struct Message **ptr)
Close a message.
Definition mx.c:1182
void mx_fastclose_mailbox(struct Mailbox *m, bool keep_account)
Free up memory associated with the Mailbox.
Definition mx.c:411
struct Message * mx_msg_open(struct Mailbox *m, struct Email *e)
Return a stream pointer for a message.
Definition mx.c:1136
@ MX_STATUS_REOPENED
Mailbox was reopened.
Definition mxapi.h:64
@ MX_STATUS_NEW_MAIL
New mail received in Mailbox.
Definition mxapi.h:62
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition pool.c:91
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:111
void mutt_sig_block(void)
Block signals during critical operations.
Definition signal.c:227
void mutt_sig_unblock(void)
Restore previously blocked signals.
Definition signal.c:245
#define NONULL(x)
Definition string2.h:44
void * adata
Private data (for Mailbox backends)
Definition account.h:42
struct Body * parts
parts of a multipart or message/rfc822
Definition body.h:73
LOFF_T offset
offset where the actual data begins
Definition body.h:52
LOFF_T length
length (in bytes) of attachment
Definition body.h:53
long hdr_offset
Offset in stream where the headers begin.
Definition body.h:81
String manipulation buffer.
Definition buffer.h:36
int lines
How many lines in the body of this message?
Definition email.h:62
struct Body * body
List of MIME parts.
Definition email.h:69
bool changed
Email has been edited.
Definition email.h:77
LOFF_T offset
Where in the stream does this message begin?
Definition email.h:71
bool attach_del
Has an attachment marked for deletion.
Definition email.h:99
Store of new offsets, used by mutt_sync_mailbox()
Definition mbox.c:65
long lines
Number of lines.
Definition mbox.c:69
LOFF_T hdr
Header offset.
Definition mbox.c:67
LOFF_T length
Total length.
Definition mbox.c:70
LOFF_T body
Body offset.
Definition mbox.c:68
bool valid
Is this entry valid?
Definition mbox.c:66
A mailbox.
Definition mailbox.h:78
bool has_new
Mailbox has new mail.
Definition mailbox.h:84
enum MailboxType type
Mailbox type.
Definition mailbox.h:101
off_t size
Size of the Mailbox.
Definition mailbox.h:83
Mbox-specific Account data -.
Definition lib.h:50
FILE * fp
Mailbox file.
Definition lib.h:51
A local copy of an email.
Definition message.h:34
FILE * fp
pointer to the message data
Definition message.h:35
char * username
User's login name.
Definition neomutt.h:57
#define buf_mktemp(buf)
Definition tmp.h:33
+ Here is the call graph for this function:

◆ mh_mbox_sync()

static enum MxStatus mh_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Return values
MX_STATUS_REOPENEDmailbox has been externally modified
MX_STATUS_NEW_MAILnew mail has arrived
0Success
-1Error
Note
The flag retvals come from a call to a backend sync function

Definition at line 1062 of file mh.c.

1063{
1064 enum MxStatus check = mh_check(m);
1065 if (check == MX_STATUS_ERROR)
1066 return check;
1067
1068 struct HeaderCache *hc = NULL;
1069#ifdef USE_HCACHE
1070 const char *const c_header_cache = cs_subset_path(NeoMutt->sub, "header_cache");
1071 hc = hcache_open(c_header_cache, mailbox_path(m), NULL, true);
1072#endif
1073
1074 struct Progress *progress = NULL;
1075 if (m->verbose)
1076 {
1078 progress_set_message(progress, _("Writing %s..."), mailbox_path(m));
1079 }
1080
1081 for (int i = 0; i < m->msg_count; i++)
1082 {
1083 progress_update(progress, i, -1);
1084
1085 struct Email *e = m->emails[i];
1086 if (mh_sync_mailbox_message(m, e, hc) == -1)
1087 {
1088 progress_free(&progress);
1089 goto err;
1090 }
1091 }
1092 progress_free(&progress);
1093
1094#ifdef USE_HCACHE
1095 hcache_close(&hc);
1096#endif
1097
1098 mh_seq_update(m);
1099
1100 /* XXX race condition? */
1101
1102 mh_update_mtime(m);
1103
1104 /* adjust indices */
1105
1106 if (m->msg_deleted)
1107 {
1108 for (int i = 0, j = 0; i < m->msg_count; i++)
1109 {
1110 struct Email *e = m->emails[i];
1111 if (!e)
1112 break;
1113
1114 if (!e->deleted)
1115 e->index = j++;
1116 }
1117 }
1118
1119 return check;
1120
1121err:
1122#ifdef USE_HCACHE
1123 hcache_close(&hc);
1124#endif
1125 return MX_STATUS_ERROR;
1126}
struct HeaderCache * hcache_open(const char *path, const char *folder, hcache_namer_t namer, bool create)
Multiplexor for StoreOps::open.
Definition hcache.c:476
void hcache_close(struct HeaderCache **ptr)
Multiplexor for StoreOps::close.
Definition hcache.c:547
static void mh_update_mtime(struct Mailbox *m)
Update our record of the mailbox modification time.
Definition mh.c:416
static enum MxStatus mh_check(struct Mailbox *m)
Check for new mail.
Definition mh.c:906
int mh_sync_mailbox_message(struct Mailbox *m, struct Email *e, struct HeaderCache *hc)
Save changes to the mailbox.
Definition mh.c:725
void mh_seq_update(struct Mailbox *m)
Update sequence numbers.
Definition sequence.c:234
+ Here is the call graph for this function:

◆ nntp_mbox_sync()

static enum MxStatus nntp_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Note
May also return values from check_mailbox()

Definition at line 2561 of file nntp.c.

2562{
2563 struct NntpMboxData *mdata = m->mdata;
2564
2565 /* check for new articles */
2566 mdata->adata->check_time = 0;
2567 enum MxStatus check = check_mailbox(m);
2568 if (check != MX_STATUS_OK)
2569 return check;
2570
2571#ifdef USE_HCACHE
2572 mdata->last_cached = 0;
2573 struct HeaderCache *hc = nntp_hcache_open(mdata);
2574#endif
2575
2576 for (int i = 0; i < m->msg_count; i++)
2577 {
2578 struct Email *e = m->emails[i];
2579 if (!e)
2580 break;
2581
2582 char buf[16] = { 0 };
2583
2584 snprintf(buf, sizeof(buf), ANUM_FMT, nntp_edata_get(e)->article_num);
2585 if (mdata->bcache && e->deleted)
2586 {
2587 mutt_debug(LL_DEBUG2, "mutt_bcache_del %s\n", buf);
2588 mutt_bcache_del(mdata->bcache, buf);
2589 }
2590
2591#ifdef USE_HCACHE
2592 if (hc && (e->changed || e->deleted))
2593 {
2594 if (e->deleted && !e->read)
2595 mdata->unread--;
2596 mutt_debug(LL_DEBUG2, "hcache_store_email %s\n", buf);
2597 hcache_store_email(hc, buf, strlen(buf), e, 0);
2598 }
2599#endif
2600 }
2601
2602#ifdef USE_HCACHE
2603 if (hc)
2604 {
2605 hcache_close(&hc);
2606 mdata->last_cached = mdata->last_loaded;
2607 }
2608#endif
2609
2610 /* save .newsrc entries */
2612 nntp_newsrc_update(mdata->adata);
2613 nntp_newsrc_close(mdata->adata);
2614 return MX_STATUS_OK;
2615}
int mutt_bcache_del(struct BodyCache *bcache, const char *id)
Delete a file from the Body Cache.
Definition bcache.c:269
int hcache_store_email(struct HeaderCache *hc, const char *key, size_t keylen, struct Email *e, uint32_t uidvalidity)
Multiplexor for StoreOps::store.
Definition hcache.c:675
@ LL_DEBUG2
Log at debug level 2.
Definition logging2.h:46
struct HeaderCache * nntp_hcache_open(struct NntpMboxData *mdata)
Open newsgroup hcache.
Definition newsrc.c:706
void nntp_newsrc_gen_entries(struct Mailbox *m)
Generate array of .newsrc entries.
Definition newsrc.c:300
struct NntpEmailData * nntp_edata_get(struct Email *e)
Get the private data for this Email.
Definition edata.c:60
void nntp_newsrc_close(struct NntpAccountData *adata)
Unlock and close .newsrc file.
Definition newsrc.c:119
int nntp_newsrc_update(struct NntpAccountData *adata)
Update .newsrc file.
Definition newsrc.c:442
#define ANUM_FMT
Definition lib.h:64
static enum MxStatus check_mailbox(struct Mailbox *m)
Check current newsgroup for new articles.
Definition nntp.c:1488
bool read
Email is read.
Definition email.h:50
void * mdata
Driver specific data.
Definition mailbox.h:131
NNTP-specific Mailbox data -.
Definition mdata.h:34
anum_t last_cached
Last cached article.
Definition mdata.h:40
struct BodyCache * bcache
Body cache.
Definition mdata.h:50
struct NntpAccountData * adata
Account data.
Definition mdata.h:48
anum_t unread
Unread articles.
Definition mdata.h:41
anum_t last_loaded
Last loaded article.
Definition mdata.h:39
+ Here is the call graph for this function:

◆ nm_mbox_sync()

static enum MxStatus nm_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Definition at line 2278 of file notmuch.c.

2279{
2280 struct NmMboxData *mdata = nm_mdata_get(m);
2281 if (!mdata)
2282 return MX_STATUS_ERROR;
2283
2284 enum MxStatus rc = MX_STATUS_OK;
2285 struct Progress *progress = NULL;
2286 char *url = mutt_str_dup(mailbox_path(m));
2287 bool changed = false;
2288
2289 mutt_debug(LL_DEBUG1, "nm: sync start\n");
2290
2291 if (m->verbose)
2292 {
2293 /* all is in this function so we don't use data->progress here */
2295 progress_set_message(progress, _("Writing %s..."), mailbox_path(m));
2296 }
2297
2298 struct HeaderCache *hc = nm_hcache_open(m);
2299
2300 int mh_sync_errors = 0;
2301 for (int i = 0; i < m->msg_count; i++)
2302 {
2303 char old_file[PATH_MAX], new_file[PATH_MAX];
2304 struct Email *e = m->emails[i];
2305 if (!e)
2306 break;
2307
2308 struct NmEmailData *edata = nm_edata_get(e);
2309
2310 progress_update(progress, i, -1);
2311
2312 *old_file = '\0';
2313 *new_file = '\0';
2314
2315 if (edata->oldpath)
2316 {
2317 mutt_str_copy(old_file, edata->oldpath, sizeof(old_file));
2318 mutt_debug(LL_DEBUG2, "nm: fixing obsolete path '%s'\n", old_file);
2319 }
2320 else
2321 {
2322 email_get_fullpath(e, old_file, sizeof(old_file));
2323 }
2324
2325 buf_strcpy(&m->pathbuf, edata->folder);
2326 m->type = edata->type;
2327
2328 bool ok = maildir_sync_mailbox_message(m, e, hc);
2329 if (!ok)
2330 {
2331 // Syncing file failed, query notmuch for new filepath.
2332 m->type = MUTT_NOTMUCH;
2333 notmuch_database_t *db = nm_db_get(m, true);
2334 if (db)
2335 {
2336 notmuch_message_t *msg = get_nm_message(db, e);
2337
2339
2340 buf_strcpy(&m->pathbuf, edata->folder);
2341 m->type = edata->type;
2342 ok = maildir_sync_mailbox_message(m, e, hc);
2343 m->type = MUTT_NOTMUCH;
2344 }
2345 nm_db_release(m);
2346 m->type = edata->type;
2347 }
2348
2349 buf_strcpy(&m->pathbuf, url);
2350 m->type = MUTT_NOTMUCH;
2351
2352 if (!ok)
2353 {
2354 mh_sync_errors += 1;
2355 continue;
2356 }
2357
2358 if (!e->deleted)
2359 email_get_fullpath(e, new_file, sizeof(new_file));
2360
2361 if (e->deleted || !mutt_str_equal(old_file, new_file))
2362 {
2363 if (e->deleted && (remove_filename(m, old_file) == 0))
2364 changed = true;
2365 else if (*new_file && *old_file && (rename_filename(m, old_file, new_file, e) == 0))
2366 changed = true;
2367 }
2368
2369 FREE(&edata->oldpath);
2370 }
2371
2372 if (mh_sync_errors > 0)
2373 {
2374 mutt_error(ngettext("Unable to sync %d message due to external mailbox modification",
2375 "Unable to sync %d messages due to external mailbox modification",
2376 mh_sync_errors),
2377 mh_sync_errors);
2378 rc = MX_STATUS_ERROR;
2379 }
2380
2381 buf_strcpy(&m->pathbuf, url);
2382 m->type = MUTT_NOTMUCH;
2383
2384 nm_db_release(m);
2385
2386 if (changed)
2387 {
2388 mdata->mtime.tv_sec = mutt_date_now();
2389 mdata->mtime.tv_nsec = 0;
2390 }
2391
2392 nm_hcache_close(&hc);
2393
2394 progress_free(&progress);
2395 FREE(&url);
2396 mutt_debug(LL_DEBUG1, "nm: .... sync done [rc=%d]\n", rc);
2397 return rc;
2398}
size_t buf_strcpy(struct Buffer *buf, const char *s)
Copy a string into a Buffer.
Definition buffer.c:395
@ MUTT_NOTMUCH
'Notmuch' (virtual) Mailbox type
Definition mailbox.h:50
time_t mutt_date_now(void)
Return the number of seconds since the Unix epoch.
Definition date.c:457
char * mutt_str_dup(const char *str)
Copy a string, safely.
Definition string.c:257
size_t mutt_str_copy(char *dest, const char *src, size_t dsize)
Copy a string into a buffer (guaranteeing NUL-termination)
Definition string.c:583
#define PATH_MAX
Definition mutt.h:49
notmuch_database_t * nm_db_get(struct Mailbox *m, bool writable)
Get the Notmuch database.
Definition db.c:209
int nm_db_release(struct Mailbox *m)
Close the Notmuch database.
Definition db.c:233
struct NmEmailData * nm_edata_get(struct Email *e)
Get the Notmuch Email data.
Definition edata.c:72
struct NmMboxData * nm_mdata_get(struct Mailbox *m)
Get the Notmuch Mailbox data.
Definition mdata.c:96
static char * email_get_fullpath(struct Email *e, char *buf, size_t buflen)
Get the full path of an email.
Definition notmuch.c:230
static void sync_email_path_with_nm(struct Email *e, notmuch_message_t *msg)
Synchronize NeoMutt's Email path with notmuch.
Definition notmuch.c:1122
static notmuch_message_t * get_nm_message(notmuch_database_t *db, struct Email *e)
Find a Notmuch message.
Definition notmuch.c:1081
static int rename_filename(struct Mailbox *m, const char *old_file, const char *new_file, struct Email *e)
Rename the file.
Definition notmuch.c:1367
static struct HeaderCache * nm_hcache_open(struct Mailbox *m)
Open a header cache.
Definition notmuch.c:111
static int remove_filename(struct Mailbox *m, const char *path)
Delete a file.
Definition notmuch.c:1303
static void nm_hcache_close(struct HeaderCache **ptr)
Close the header cache.
Definition notmuch.c:125
void * edata
Driver-specific data.
Definition email.h:74
struct Buffer pathbuf
Path of the Mailbox.
Definition mailbox.h:79
Notmuch-specific Email data -.
Definition edata.h:34
Notmuch-specific Mailbox data -.
Definition mdata.h:35
struct timespec mtime
Time Mailbox was last changed.
Definition mdata.h:44
+ Here is the call graph for this function:

◆ pop_mbox_sync()

static enum MxStatus pop_mbox_sync ( struct Mailbox * m)
static

Save changes to the Mailbox - Implements MxOps::mbox_sync() -.

Update POP mailbox, delete messages from server

Definition at line 864 of file pop.c.

865{
866 int i, j, rc = 0;
867 char buf[1024] = { 0 };
869#ifdef USE_HCACHE
870 struct HeaderCache *hc = NULL;
871#endif
872
873 adata->check_time = 0;
874
875 int num_deleted = 0;
876 for (i = 0; i < m->msg_count; i++)
877 {
878 if (m->emails[i]->deleted)
879 num_deleted++;
880 }
881
882 while (true)
883 {
884 if (pop_reconnect(m) < 0)
885 return MX_STATUS_ERROR;
886
887#ifdef USE_HCACHE
888 hc = pop_hcache_open(adata, mailbox_path(m));
889#endif
890
891 struct Progress *progress = NULL;
892 if (m->verbose)
893 {
894 progress = progress_new(MUTT_PROGRESS_WRITE, num_deleted);
895 progress_set_message(progress, _("Marking messages deleted..."));
896 }
897
898 for (i = 0, j = 0, rc = 0; (rc == 0) && (i < m->msg_count); i++)
899 {
900 struct PopEmailData *edata = pop_edata_get(m->emails[i]);
901 if (m->emails[i]->deleted && (edata->refno != -1))
902 {
903 j++;
904 progress_update(progress, j, -1);
905 snprintf(buf, sizeof(buf), "DELE %d\r\n", edata->refno);
906 rc = pop_query(adata, buf, sizeof(buf));
907 if (rc == 0)
908 {
909 mutt_bcache_del(adata->bcache, cache_id(edata->uid));
910#ifdef USE_HCACHE
911 hcache_delete_email(hc, edata->uid, strlen(edata->uid));
912#endif
913 }
914 }
915
916#ifdef USE_HCACHE
917 if (m->emails[i]->changed)
918 {
919 hcache_store_email(hc, edata->uid, strlen(edata->uid), m->emails[i], 0);
920 }
921#endif
922 }
923 progress_free(&progress);
924
925#ifdef USE_HCACHE
926 hcache_close(&hc);
927#endif
928
929 if (rc == 0)
930 {
931 mutt_str_copy(buf, "QUIT\r\n", sizeof(buf));
932 rc = pop_query(adata, buf, sizeof(buf));
933 }
934
935 if (rc == 0)
936 {
937 adata->clear_cache = true;
938 pop_clear_cache(adata);
939 adata->status = POP_DISCONNECTED;
940 return MX_STATUS_OK;
941 }
942
943 if (rc == -2)
944 {
945 mutt_error("%s", adata->err_msg);
946 return MX_STATUS_ERROR;
947 }
948 }
949}
int hcache_delete_email(struct HeaderCache *hc, const char *key, size_t keylen)
Multiplexor for StoreOps::delete_record.
Definition hcache.c:744
struct PopAccountData * pop_adata_get(struct Mailbox *m)
Get the Account data for this mailbox.
Definition adata.c:73
struct PopEmailData * pop_edata_get(struct Email *e)
Get the private data for this Email.
Definition edata.c:68
int pop_reconnect(struct Mailbox *m)
Reconnect and verify indexes if connection was lost.
Definition lib.c:609
#define pop_query(adata, buf, buflen)
Definition private.h:109
@ POP_DISCONNECTED
Disconnected from server.
Definition private.h:49
static void pop_clear_cache(struct PopAccountData *adata)
Delete all cached messages.
Definition pop.c:497
static const char * cache_id(const char *id)
Make a message-cache-compatible id.
Definition pop.c:80
static struct HeaderCache * pop_hcache_open(struct PopAccountData *adata, const char *path)
Open the header cache.
Definition pop.c:304
POP-specific Account data -.
Definition adata.h:37
bool clear_cache
Clear the cache.
Definition adata.h:49
time_t check_time
Last check time.
Definition adata.h:51
char err_msg[POP_CMD_RESPONSE]
Last error message.
Definition adata.h:57
unsigned int status
Connection status.
Definition adata.h:39
struct BodyCache * bcache
body cache
Definition adata.h:56
POP-specific Email data -.
Definition edata.h:32
+ Here is the call graph for this function: