replace the pathetic mutt_parse_rfc822_line function with a really better
[apps/madmutt.git] / mx.h
diff --git a/mx.h b/mx.h
index 049434e..ccbe239 100644 (file)
--- a/mx.h
+++ b/mx.h
 #ifndef _MX_H
 #define _MX_H
 
-/* supported mailbox formats */
+#include <sys/stat.h>
+#include <utime.h>
+#include <stdio.h>
+
+#include "mutt.h"
+
+/*
+ * supported mailbox formats
+ * in mx_init() the registration order must be exactly as given here!!!1!
+ */
 enum {
-  M_MBOX = 1,
-  M_MMDF,
-  M_MH,
-  M_MAILDIR
-#ifdef USE_IMAP
-    , M_IMAP
-#endif
-#ifdef USE_POP
-    , M_POP
-#endif
+    M_MBOX = 1,
+    M_MMDF,
+    M_MH,
+    M_MAILDIR,
+    M_IMAP,
+    M_POP,
 #ifdef USE_NNTP
-    , M_NNTP
-#endif
-#ifdef USE_COMPRESSED
-    , M_COMPRESSED
+    M_NNTP,
 #endif
+    M_COMPRESSED
 };
 
-/* flags for mx_open_mailbox() */
-#define M_NOSORT       (1<<0)  /* do not sort the mailbox after opening it */
-#define M_APPEND       (1<<1)  /* open mailbox for appending messages */
-#define M_READONLY     (1<<2)  /* open in read-only mode */
-#define M_QUIET                (1<<3)  /* do not print any messages */
-#define M_NEWFOLDER    (1<<4)  /* create a new folder - same as M_APPEND, but uses
-                                 * safe_fopen() for mbox-style folders.
-                                 */
-
-/* mx_open_new_message() */
-#define M_ADD_FROM     1       /* add a From_ line */
-
-#define MAXLOCKATTEMPT 5
-
-/* return values from mx_check_mailbox() */
 enum {
-  M_NEW_MAIL = 1,               /* new mail received in mailbox */
-  M_LOCKED,                     /* couldn't lock the mailbox */
-  M_REOPENED,                   /* mailbox was reopened */
-  M_FLAGS                       /* nondestructive flags change (IMAP) */
+  ACL_LOOKUP = 0,
+  ACL_READ,
+  ACL_SEEN,
+  ACL_WRITE,
+  ACL_INSERT,
+  ACL_POST,
+  ACL_CREATE,
+  ACL_DELETE,
+  ACL_ADMIN,
+
+  RIGHTSMAX
 };
 
+/* ugly hack to define macro once (for pager+index) */
+#define CHECK_MX_ACL(c,f,s) if(!mx_acl_check(c,f)) \
+                     {\
+                        mutt_flushinp (); \
+                        mutt_error(_("%s not permitted by ACL."), s); \
+                        break; \
+                     }
+
 typedef struct {
   FILE *fp;                     /* pointer to the message data */
   char *path;                   /* path to temp file */
@@ -72,8 +75,59 @@ typedef struct {
   time_t received;              /* the time at which this message was received */
 } MESSAGE;
 
+typedef struct {
+  /* folder magic */
+  int type;
+  /* may we stat() it? */
+  unsigned int local : 1;
+  /* tests if given path is of its magic */
+  int (*mx_is_magic) (const char*, struct stat*);
+  /* tests if folder is empty */
+  int (*mx_check_empty) (const char*);
+  /* test for access */
+  int (*mx_access) (const char*, int);
+  /* read mailbox into ctx structure */
+  int (*mx_open_mailbox) (CONTEXT*);
+  /* open new message */
+  int (*mx_open_new_message) (MESSAGE*, CONTEXT*, HEADER*);
+  /* check ACL flags; if not implemented, always assume granted
+   * permissions */
+  int (*mx_acl_check) (CONTEXT*, int);
+  /* check for new mail; see mx_check_mailbox() below for return vals */
+  int (*mx_check_mailbox) (CONTEXT*, int*, int);
+  /* fast closing */
+  void (*mx_fastclose_mailbox) (CONTEXT*);
+  /* write out changes */
+  int (*mx_sync_mailbox) (CONTEXT*, int, int*);
+  /* commit a message to a folder */
+  int (*mx_commit_message) (MESSAGE*, CONTEXT*);
+} mx_t;
+
+/* called from main: init all folder types */
+void mx_init (void);
+
+/* flags for mx_open_mailbox() */
+#define M_NOSORT        (1<<0)  /* do not sort the mailbox after opening it */
+#define M_APPEND        (1<<1)  /* open mailbox for appending messages */
+#define M_READONLY      (1<<2)  /* open in read-only mode */
+#define M_QUIET         (1<<3)  /* do not print any messages */
+#define M_NEWFOLDER     (1<<4)  /* create a new folder - same as M_APPEND, but uses
+                                 * safe_fopen() for mbox-style folders. */
+#define M_COUNT         (1<<5)  /* just do counting? needed to do speed optimizations
+                                   for sidebar */
+
+/* mx_open_new_message() */
+#define M_ADD_FROM      1       /* add a From_ line */
+
+#define MAXLOCKATTEMPT 5
+
 WHERE short DefaultMagic INITVAL (M_MBOX);
 
+/*
+ * please use the following _ONLY_ when doing "something"
+ * with folders
+ */
+
 CONTEXT *mx_open_mailbox (const char *, int, CONTEXT *);
 
 MESSAGE *mx_open_message (CONTEXT *, int);
@@ -85,23 +139,28 @@ int mx_close_mailbox (CONTEXT *, int *);
 int mx_sync_mailbox (CONTEXT *, int *);
 int mx_commit_message (MESSAGE *, CONTEXT *);
 int mx_close_message (MESSAGE **);
-int mx_get_magic (const char *);
+
+/* determines magic for given folder */
+int mx_get_magic (const char*);
+/* sets/parses DefaultMagic */
 int mx_set_magic (const char *);
-int mx_check_mailbox (CONTEXT *, int *, int);
+/* tests whether given folder magic is (valid and) local */
+int mx_is_local (int);
 
-#ifdef USE_IMAP
-int mx_is_imap (const char *);
-#endif
-#ifdef USE_POP
-int mx_is_pop (const char *);
-#endif
-#ifdef USE_NNTP
-int mx_is_nntp (const char *);
-#endif
+/* return values from mx_check_mailbox() */
+enum {
+  M_NEW_MAIL = 1,               /* new mail received in mailbox */
+  M_LOCKED,                     /* couldn't lock the mailbox */
+  M_REOPENED,                   /* mailbox was reopened */
+  M_FLAGS                       /* nondestructive flags change (IMAP) */
+};
+int mx_check_mailbox (CONTEXT *, int *, int);
 
 int mx_access (const char *, int);
 int mx_check_empty (const char *);
 
+int mx_acl_check (CONTEXT*, int);
+
 void mx_alloc_memory (CONTEXT *);
 void mx_update_context (CONTEXT *, int);
 void mx_update_tables (CONTEXT *, int);
@@ -109,4 +168,6 @@ void mx_update_tables (CONTEXT *, int);
 int mx_lock_file (const char *, int, int, int, int);
 int mx_unlock_file (const char *path, int fd, int dot);
 
+int mx_rebuild_cache (void);
+
 #endif /* !_MX_H */