aboutsummaryrefslogtreecommitdiffstats
path: root/camel/camel-folder-summary.h
blob: 77d8abfb68323a091f26cd25f5718ffb47d6467b (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
/*
 *  Copyright (C) 2000 Helix Code Inc.
 *
 *  Authors: Michael Zucchi <notzed@helixcode.com>
 *
 *  This program is free software; you can redistribute it and/or 
 *  modify it under the terms of the GNU General Public License as 
 *  published by the Free Software Foundation; either version 2 of the
 *  License, or (at your option) any later version.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
 *  USA
 */

#ifndef _CAMEL_FOLDER_SUMMARY_H
#define _CAMEL_FOLDER_SUMMARY_H

#include <camel/camel-object.h>
#include <stdio.h>
#include <time.h>
#include <camel/camel-mime-parser.h>
#include <libibex/ibex.h>

#define CAMEL_FOLDER_SUMMARY(obj)         CAMEL_CHECK_CAST (obj, camel_folder_summary_get_type (), CamelFolderSummary)
#define CAMEL_FOLDER_SUMMARY_CLASS(klass) CAMEL_CHECK_CLASS_CAST (klass, camel_folder_summary_get_type (), CamelFolderSummaryClass)
#define IS_CAMEL_FOLDER_SUMMARY(obj)      CAMEL_CHECK_TYPE (obj, camel_folder_summary_get_type ())

/*typedef struct _CamelFolderSummary      CamelFolderSummary;*/
typedef struct _CamelFolderSummaryClass CamelFolderSummaryClass;

/* A tree of message content info structures
   describe the content structure of the message (if it has any) */
typedef struct _CamelMessageContentInfo {
    struct _CamelMessageContentInfo *next;

    struct _CamelMessageContentInfo *childs;
    struct _CamelMessageContentInfo *parent;

    struct _header_content_type *type;
    char *id;
    char *description;
    char *encoding;

    /* information about where this object lives in the stream.
       if pos is -1 these are all invalid */
    off_t pos;
    off_t bodypos;
    off_t endpos;
} CamelMessageContentInfo;

/* system flag bits */
enum _CamelMessageFlags {
    CAMEL_MESSAGE_ANSWERED = 1<<0,
    CAMEL_MESSAGE_DELETED = 1<<1,
    CAMEL_MESSAGE_DRAFT = 1<<2,
    CAMEL_MESSAGE_FLAGGED = 1<<3,
    CAMEL_MESSAGE_SEEN = 1<<4,
    /* following flags are for the folder, and are not really permanent flags */
    CAMEL_MESSAGE_FOLDER_FLAGGED = 1<<16, /* for use by the folder implementation */
    CAMEL_MESSAGE_USER = 1<<31 /* supports user flags */
};

typedef struct _CamelFlag {
    struct _CamelFlag *next;
    char name[1];       /* name allocated as part of the structure */
} CamelFlag;

typedef struct _CamelTag {
    struct _CamelTag *next;
    char *value;
    char name[1];       /* name allocated as part of the structure */
} CamelTag;

/* information about a given object */
typedef struct {
    /* public fields */
    gchar *subject;
    gchar *from;
    gchar *to;
    gchar *cc;

    gchar *uid;
    guint32 flags;
    guint32 size;

    time_t date_sent;
    time_t date_received;

    /* Message-ID / References structures */
    char *message_id;   /* for this message */
    struct _header_references *references; /* from parent to root */

    struct _CamelFlag *user_flags;
    struct _CamelTag *user_tags;

    /* tree of content description - NULL if it is not available */
    CamelMessageContentInfo *content;
} CamelMessageInfo;

enum _CamelFolderSummaryFlags {
    CAMEL_SUMMARY_DIRTY = 1<<0,
};

struct _CamelFolderSummary {
    CamelObject parent;

    struct _CamelFolderSummaryPrivate *priv;

    /* header info */
    guint32 version;    /* version of file required, should be set by implementors */
    guint32 flags;      /* flags */
    guint32 nextuid;    /* next uid? */
    guint32 saved_count;    /* how many were saved/loaded */
    time_t time;        /* timestamp for this summary (for implementors to use) */

    /* sizes of memory objects */
    guint32 message_info_size;
    guint32 content_info_size;

    char *summary_path;
    gboolean build_content; /* do we try and parse/index the content, or not? */

    GPtrArray *messages;    /* CamelMessageInfo's */
    GHashTable *messages_uid; /* CamelMessageInfo's by uid */
};

struct _CamelFolderSummaryClass {
    CamelObjectClass parent_class;

    /* load/save the global info */
    int (*summary_header_load)(CamelFolderSummary *, FILE *);
    int (*summary_header_save)(CamelFolderSummary *, FILE *);

    /* create/save/load an individual message info */
    CamelMessageInfo * (*message_info_new)(CamelFolderSummary *, struct _header_raw *);
    CamelMessageInfo * (*message_info_new_from_parser)(CamelFolderSummary *, CamelMimeParser *);
    CamelMessageInfo * (*message_info_load)(CamelFolderSummary *, FILE *);
    int        (*message_info_save)(CamelFolderSummary *, FILE *, CamelMessageInfo *);
    void           (*message_info_free)(CamelFolderSummary *, CamelMessageInfo *);

    /* save/load individual content info's */
    CamelMessageContentInfo * (*content_info_new)(CamelFolderSummary *, struct _header_raw *);
    CamelMessageContentInfo * (*content_info_new_from_parser)(CamelFolderSummary *, CamelMimeParser *);
    CamelMessageContentInfo * (*content_info_load)(CamelFolderSummary *, FILE *);
    int               (*content_info_save)(CamelFolderSummary *, FILE *, CamelMessageContentInfo *);
    void                  (*content_info_free)(CamelFolderSummary *, CamelMessageContentInfo *);
};

guint            camel_folder_summary_get_type  (void);
CamelFolderSummary      *camel_folder_summary_new   (void);

void camel_folder_summary_set_filename(CamelFolderSummary *, const char *);
void camel_folder_summary_set_index(CamelFolderSummary *, ibex *);
void camel_folder_summary_set_build_content(CamelFolderSummary *, gboolean state);

guint32  camel_folder_summary_next_uid        (CamelFolderSummary *s);
char    *camel_folder_summary_next_uid_string (CamelFolderSummary *s);
void     camel_folder_summary_set_uid         (CamelFolderSummary *s, guint32 uid);

/* load/save the summary in its entirety */
int camel_folder_summary_load(CamelFolderSummary *);
int camel_folder_summary_save(CamelFolderSummary *);

/* set the dirty bit on the summary */
void camel_folder_summary_touch(CamelFolderSummary *s);

/* add a new raw summary item */
void camel_folder_summary_add(CamelFolderSummary *, CamelMessageInfo *info);

/* build/add raw summary items */
CamelMessageInfo *camel_folder_summary_add_from_header(CamelFolderSummary *, struct _header_raw *);
CamelMessageInfo *camel_folder_summary_add_from_parser(CamelFolderSummary *, CamelMimeParser *);

/* removes a summary item, doesn't fix content offsets */
void camel_folder_summary_remove(CamelFolderSummary *s, CamelMessageInfo *info);
void camel_folder_summary_remove_uid(CamelFolderSummary *s, const char *uid);
/* remove all items */
void camel_folder_summary_clear(CamelFolderSummary *s);

/* lookup functions */
int camel_folder_summary_count(CamelFolderSummary *);
CamelMessageInfo *camel_folder_summary_index(CamelFolderSummary *, int);
CamelMessageInfo *camel_folder_summary_uid(CamelFolderSummary *, const char *uid);

/* shift content ... */
void camel_folder_summary_offset_content(CamelMessageContentInfo *content, off_t offset);

/* summary formatting utils */
char *camel_folder_summary_format_address (struct _header_raw *h, const char *name);
char *camel_folder_summary_format_string (struct _header_raw *h, const char *name);

/* summary file loading/saving helper functions */
int camel_folder_summary_encode_fixed_int32(FILE *, gint32);
int camel_folder_summary_decode_fixed_int32(FILE *, gint32 *);

int camel_folder_summary_encode_uint32(FILE *, guint32);
int camel_folder_summary_decode_uint32(FILE *, guint32 *);

int camel_folder_summary_encode_time_t(FILE *out, time_t value);
int camel_folder_summary_decode_time_t(FILE *in, time_t *dest);

int camel_folder_summary_encode_string(FILE *, char *);
int camel_folder_summary_decode_string(FILE *, char **);

/* basically like strings, but certain keywords can be compressed and de-cased */
int camel_folder_summary_encode_token(FILE *, char *);
int camel_folder_summary_decode_token(FILE *, char **);

/* message flag operations */
gboolean    camel_flag_get(CamelFlag **list, const char *name);
void        camel_flag_set(CamelFlag **list, const char *name, gboolean state);
int     camel_flag_list_size(CamelFlag **list);
void        camel_flag_list_free(CamelFlag **list);

/* message tag operations */
const char  *camel_tag_get(CamelTag **list, const char *name);
void        camel_tag_set(CamelTag **list, const char *name, const char *value);
int     camel_tag_list_size(CamelTag **list);
void        camel_tag_list_free(CamelTag **list);

/* message info utils */
void camel_message_info_dup_to(const CamelMessageInfo *from, CamelMessageInfo *to);
void camel_message_info_free(CamelMessageInfo *mi);

#endif /* ! _CAMEL_FOLDER_SUMMARY_H */