]> git.notmuchmail.org Git - notmuch/blob - lib/index.cc
2b98b588d38d4532173a503cc652aa5e8d3c3de1
[notmuch] / lib / index.cc
1 /*
2  * Copyright © 2009 Carl Worth
3  *
4  * This program is free software: you can redistribute it and/or modify
5  * it under the terms of the GNU General Public License as published by
6  * the Free Software Foundation, either version 3 of the License, or
7  * (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program.  If not, see https://www.gnu.org/licenses/ .
16  *
17  * Author: Carl Worth <cworth@cworth.org>
18  */
19
20 #include "notmuch-private.h"
21
22 #include <gmime/gmime.h>
23 #include <gmime/gmime-filter.h>
24
25 #include <xapian.h>
26
27
28 typedef struct {
29     int state;
30     int a;
31     int b;
32     int next_if_match;
33     int next_if_not_match;
34 } scanner_state_t;
35
36 /* Simple, linear state-transition diagram for the uuencode filter.
37  *
38  * If the character being processed is within the range of [a, b]
39  * for the current state then we transition next_if_match
40  * state. If not, we transition to the next_if_not_match state.
41  *
42  * The final two states are special in that they are the states in
43  * which we discard data. */
44 static const int first_uuencode_skipping_state = 11;
45 static const scanner_state_t uuencode_states[] = {
46     {0,  'b',  'b',  1,  0},
47     {1,  'e',  'e',  2,  0},
48     {2,  'g',  'g',  3,  0},
49     {3,  'i',  'i',  4,  0},
50     {4,  'n',  'n',  5,  0},
51     {5,  ' ',  ' ',  6,  0},
52     {6,  '0',  '7',  7,  0},
53     {7,  '0',  '7',  8,  0},
54     {8,  '0',  '7',  9,  0},
55     {9,  ' ',  ' ',  10, 0},
56     {10, '\n', '\n', 11, 10},
57     {11, 'M',  'M',  12, 0},
58     {12, ' ',  '`',  12, 11}
59 };
60
61 /* The following table is intended to implement this DFA (in 'dot'
62    format). Note that 2 and 3 are "hidden" states used to step through
63    the possible out edges of state 1.
64
65 digraph html_filter {
66        0 -> 1  [label="<"];
67        0 -> 0;
68        1 -> 4 [label="'"];
69        1 -> 5 [label="\""];
70        1 -> 0 [label=">"];
71        1 -> 1;
72        4 -> 1 [label="'"];
73        4 -> 4;
74        5 -> 1 [label="\""];
75        5 -> 5;
76 }
77 */
78 static const int first_html_skipping_state = 1;
79 static const scanner_state_t html_states[] = {
80     {0,  '<',  '<',  1,  0},
81     {1,  '\'', '\'', 4,  2},  /* scanning for quote or > */
82     {1,  '"',  '"',  5,  3},
83     {1,  '>',  '>',  0,  1},
84     {4,  '\'', '\'', 1,  4},  /* inside single quotes */
85     {5,  '"', '"',   1,  5},  /* inside double quotes */
86 };
87
88 /* Oh, how I wish that gobject didn't require so much noisy boilerplate!
89  * (Though I have at least eliminated some of the stock set...) */
90 typedef struct _NotmuchFilterDiscardNonTerm NotmuchFilterDiscardNonTerm;
91 typedef struct _NotmuchFilterDiscardNonTermClass NotmuchFilterDiscardNonTermClass;
92
93 /**
94  * NotmuchFilterDiscardNonTerm:
95  *
96  * @parent_object: parent #GMimeFilter
97  * @encode: encoding vs decoding
98  * @state: State of the parser
99  *
100  * A filter to discard uuencoded portions of an email.
101  *
102  * A uuencoded portion is identified as beginning with a line
103  * matching:
104  *
105  *      begin [0-7][0-7][0-7] .*
106  *
107  * After that detection, and beginning with the following line,
108  * characters will be discarded as long as the first character of each
109  * line begins with M and subsequent characters on the line are within
110  * the range of ASCII characters from ' ' to '`'.
111  *
112  * This is not a perfect UUencode filter. It's possible to have a
113  * message that will legitimately match that pattern, (so that some
114  * legitimate content is discarded). And for most UUencoded files, the
115  * final line of encoded data (the line not starting with M) will be
116  * indexed.
117  **/
118 struct _NotmuchFilterDiscardNonTerm {
119     GMimeFilter parent_object;
120     GMimeContentType *content_type;
121     int state;
122     int first_skipping_state;
123     const scanner_state_t *states;
124 };
125
126 struct _NotmuchFilterDiscardNonTermClass {
127     GMimeFilterClass parent_class;
128 };
129
130 static GMimeFilter *notmuch_filter_discard_non_term_new (GMimeContentType *content);
131
132 static void notmuch_filter_discard_non_term_finalize (GObject *object);
133
134 static GMimeFilter *filter_copy (GMimeFilter *filter);
135 static void filter_filter (GMimeFilter *filter, char *in, size_t len, size_t prespace,
136                            char **out, size_t *outlen, size_t *outprespace);
137 static void filter_complete (GMimeFilter *filter, char *in, size_t len, size_t prespace,
138                              char **out, size_t *outlen, size_t *outprespace);
139 static void filter_reset (GMimeFilter *filter);
140
141
142 static GMimeFilterClass *parent_class = NULL;
143
144 static void
145 notmuch_filter_discard_non_term_class_init (NotmuchFilterDiscardNonTermClass *klass)
146 {
147     GObjectClass *object_class = G_OBJECT_CLASS (klass);
148     GMimeFilterClass *filter_class = GMIME_FILTER_CLASS (klass);
149
150     parent_class = (GMimeFilterClass *) g_type_class_ref (GMIME_TYPE_FILTER);
151
152     object_class->finalize = notmuch_filter_discard_non_term_finalize;
153
154     filter_class->copy = filter_copy;
155     filter_class->filter = filter_filter;
156     filter_class->complete = filter_complete;
157     filter_class->reset = filter_reset;
158 }
159
160 static void
161 notmuch_filter_discard_non_term_finalize (GObject *object)
162 {
163     G_OBJECT_CLASS (parent_class)->finalize (object);
164 }
165
166 static GMimeFilter *
167 filter_copy (GMimeFilter *gmime_filter)
168 {
169     NotmuchFilterDiscardNonTerm *filter = (NotmuchFilterDiscardNonTerm *) gmime_filter;
170     return notmuch_filter_discard_non_term_new (filter->content_type);
171 }
172
173 static void
174 filter_filter (GMimeFilter *gmime_filter, char *inbuf, size_t inlen, size_t prespace,
175                char **outbuf, size_t *outlen, size_t *outprespace)
176 {
177     NotmuchFilterDiscardNonTerm *filter = (NotmuchFilterDiscardNonTerm *) gmime_filter;
178     const scanner_state_t *states = filter->states;
179     register const char *inptr = inbuf;
180     const char *inend = inbuf + inlen;
181     char *outptr;
182
183     (void) prespace;
184
185     int next;
186
187     g_mime_filter_set_size (gmime_filter, inlen, FALSE);
188     outptr = gmime_filter->outbuf;
189
190     next = filter->state;
191     while (inptr < inend) {
192          /* Each state is defined by a contiguous set of rows of the
193          * state table marked by a common value for '.state'. The
194          * state numbers must be equal to the index of the first row
195          * in a given state; thus the loop condition here looks for a
196          * jump to a first row of a state, which is a real transition
197          * in the underlying DFA.
198          */
199         do {
200             if (*inptr >= states[next].a && *inptr <= states[next].b)  {
201                 next = states[next].next_if_match;
202             } else  {
203                 next = states[next].next_if_not_match;
204             }
205
206         } while (next != states[next].state);
207
208         if (filter->state < filter->first_skipping_state)
209             *outptr++ = *inptr;
210
211         filter->state = next;
212         inptr++;
213     }
214
215     *outlen = outptr - gmime_filter->outbuf;
216     *outprespace = gmime_filter->outpre;
217     *outbuf = gmime_filter->outbuf;
218 }
219
220 static void
221 filter_complete (GMimeFilter *filter, char *inbuf, size_t inlen, size_t prespace,
222                  char **outbuf, size_t *outlen, size_t *outprespace)
223 {
224     if (inbuf && inlen)
225         filter_filter (filter, inbuf, inlen, prespace, outbuf, outlen, outprespace);
226 }
227
228 static void
229 filter_reset (GMimeFilter *gmime_filter)
230 {
231     NotmuchFilterDiscardNonTerm *filter = (NotmuchFilterDiscardNonTerm *) gmime_filter;
232
233     filter->state = 0;
234 }
235
236 /**
237  * notmuch_filter_discard_non_term_new:
238  *
239  * Returns: a new #NotmuchFilterDiscardNonTerm filter.
240  **/
241 static GMimeFilter *
242 notmuch_filter_discard_non_term_new (GMimeContentType *content_type)
243 {
244     static GType type = 0;
245     NotmuchFilterDiscardNonTerm *filter;
246
247     if (!type) {
248         static const GTypeInfo info = {
249             sizeof (NotmuchFilterDiscardNonTermClass),
250             NULL, /* base_class_init */
251             NULL, /* base_class_finalize */
252             (GClassInitFunc) notmuch_filter_discard_non_term_class_init,
253             NULL, /* class_finalize */
254             NULL, /* class_data */
255             sizeof (NotmuchFilterDiscardNonTerm),
256             0,    /* n_preallocs */
257             NULL, /* instance_init */
258             NULL  /* value_table */
259         };
260
261         type = g_type_register_static (GMIME_TYPE_FILTER, "NotmuchFilterDiscardNonTerm", &info, (GTypeFlags) 0);
262     }
263
264     filter = (NotmuchFilterDiscardNonTerm *) g_object_new (type, NULL);
265     filter->content_type = content_type;
266     filter->state = 0;
267     if (g_mime_content_type_is_type (content_type, "text", "html")) {
268       filter->states = html_states;
269       filter->first_skipping_state = first_html_skipping_state;
270     } else {
271       filter->states = uuencode_states;
272       filter->first_skipping_state = first_uuencode_skipping_state;
273     }
274
275     return (GMimeFilter *) filter;
276 }
277
278 /* We're finally down to a single (NAME + address) email "mailbox". */
279 static void
280 _index_address_mailbox (notmuch_message_t *message,
281                         const char *prefix_name,
282                         InternetAddress *address)
283 {
284     InternetAddressMailbox *mailbox = INTERNET_ADDRESS_MAILBOX (address);
285     const char *name, *addr, *combined;
286     void *local = talloc_new (message);
287
288     name = internet_address_get_name (address);
289     addr = internet_address_mailbox_get_addr (mailbox);
290
291     /* Combine the name and address and index them as a phrase. */
292     if (name && addr)
293         combined = talloc_asprintf (local, "%s %s", name, addr);
294     else if (name)
295         combined = name;
296     else
297         combined = addr;
298
299     if (combined)
300         _notmuch_message_gen_terms (message, prefix_name, combined);
301
302     talloc_free (local);
303 }
304
305 static void
306 _index_address_list (notmuch_message_t *message,
307                      const char *prefix_name,
308                      InternetAddressList *addresses);
309
310 /* The outer loop over the InternetAddressList wasn't quite enough.
311  * There can actually be a tree here where a single member of the list
312  * is a "group" containing another list. Recurse please.
313  */
314 static void
315 _index_address_group (notmuch_message_t *message,
316                       const char *prefix_name,
317                       InternetAddress *address)
318 {
319     InternetAddressGroup *group;
320     InternetAddressList *list;
321
322     group = INTERNET_ADDRESS_GROUP (address);
323     list = internet_address_group_get_members (group);
324
325     if (! list)
326         return;
327
328     _index_address_list (message, prefix_name, list);
329 }
330
331 static void
332 _index_address_list (notmuch_message_t *message,
333                      const char *prefix_name,
334                      InternetAddressList *addresses)
335 {
336     int i;
337     InternetAddress *address;
338
339     if (addresses == NULL)
340         return;
341
342     for (i = 0; i < internet_address_list_length (addresses); i++) {
343         address = internet_address_list_get_address (addresses, i);
344         if (INTERNET_ADDRESS_IS_MAILBOX (address)) {
345             _index_address_mailbox (message, prefix_name, address);
346         } else if (INTERNET_ADDRESS_IS_GROUP (address)) {
347             _index_address_group (message, prefix_name, address);
348         } else {
349             INTERNAL_ERROR ("GMime InternetAddress is neither a mailbox nor a group.\n");
350         }
351     }
352 }
353
354 /* Callback to generate terms for each mime part of a message. */
355 static void
356 _index_mime_part (notmuch_message_t *message,
357                   GMimeObject *part)
358 {
359     GMimeStream *stream, *filter;
360     GMimeFilter *discard_non_term_filter;
361     GMimeDataWrapper *wrapper;
362     GByteArray *byte_array;
363     GMimeContentDisposition *disposition;
364     char *body;
365     const char *charset;
366
367     if (! part) {
368         _notmuch_database_log (_notmuch_message_database (message),
369                               "Warning: Not indexing empty mime part.\n");
370         return;
371     }
372
373     GMimeContentType *content_type = g_mime_object_get_content_type(part);
374     if (content_type) {
375         char *mime_string = g_mime_content_type_to_string(content_type);
376         if (mime_string)
377         {
378             _notmuch_message_gen_terms (message, "mimetype", mime_string);
379             g_free(mime_string);
380         }
381     }
382
383     if (GMIME_IS_MULTIPART (part)) {
384         GMimeMultipart *multipart = GMIME_MULTIPART (part);
385         int i;
386
387         if (GMIME_IS_MULTIPART_SIGNED (multipart))
388           _notmuch_message_add_term (message, "tag", "signed");
389
390         if (GMIME_IS_MULTIPART_ENCRYPTED (multipart))
391           _notmuch_message_add_term (message, "tag", "encrypted");
392
393         for (i = 0; i < g_mime_multipart_get_count (multipart); i++) {
394             if (GMIME_IS_MULTIPART_SIGNED (multipart)) {
395                 /* Don't index the signature. */
396                 if (i == 1)
397                     continue;
398                 if (i > 1)
399                     _notmuch_database_log (_notmuch_message_database (message),
400                                           "Warning: Unexpected extra parts of multipart/signed. Indexing anyway.\n");
401             }
402             if (GMIME_IS_MULTIPART_ENCRYPTED (multipart)) {
403                 /* Don't index encrypted parts. */
404                 continue;
405             }
406             _index_mime_part (message,
407                               g_mime_multipart_get_part (multipart, i));
408         }
409         return;
410     }
411
412     if (GMIME_IS_MESSAGE_PART (part)) {
413         GMimeMessage *mime_message;
414
415         mime_message = g_mime_message_part_get_message (GMIME_MESSAGE_PART (part));
416
417         _index_mime_part (message, g_mime_message_get_mime_part (mime_message));
418
419         return;
420     }
421
422     if (! (GMIME_IS_PART (part))) {
423         _notmuch_database_log (_notmuch_message_database (message),
424                               "Warning: Not indexing unknown mime part: %s.\n",
425                               g_type_name (G_OBJECT_TYPE (part)));
426         return;
427     }
428
429     disposition = g_mime_object_get_content_disposition (part);
430     if (disposition &&
431         strcasecmp (g_mime_content_disposition_get_disposition (disposition),
432                     GMIME_DISPOSITION_ATTACHMENT) == 0)
433     {
434         const char *filename = g_mime_part_get_filename (GMIME_PART (part));
435
436         _notmuch_message_add_term (message, "tag", "attachment");
437         _notmuch_message_gen_terms (message, "attachment", filename);
438
439         /* XXX: Would be nice to call out to something here to parse
440          * the attachment into text and then index that. */
441         return;
442     }
443
444     byte_array = g_byte_array_new ();
445
446     stream = g_mime_stream_mem_new_with_byte_array (byte_array);
447     g_mime_stream_mem_set_owner (GMIME_STREAM_MEM (stream), FALSE);
448
449     filter = g_mime_stream_filter_new (stream);
450     discard_non_term_filter = notmuch_filter_discard_non_term_new (content_type);
451
452     g_mime_stream_filter_add (GMIME_STREAM_FILTER (filter),
453                               discard_non_term_filter);
454
455     charset = g_mime_object_get_content_type_parameter (part, "charset");
456     if (charset) {
457         GMimeFilter *charset_filter;
458         charset_filter = g_mime_filter_charset_new (charset, "UTF-8");
459         /* This result can be NULL for things like "unknown-8bit".
460          * Don't set a NULL filter as that makes GMime print
461          * annoying assertion-failure messages on stderr. */
462         if (charset_filter) {
463             g_mime_stream_filter_add (GMIME_STREAM_FILTER (filter),
464                                       charset_filter);
465             g_object_unref (charset_filter);
466         }
467     }
468
469     wrapper = g_mime_part_get_content_object (GMIME_PART (part));
470     if (wrapper)
471         g_mime_data_wrapper_write_to_stream (wrapper, filter);
472
473     g_object_unref (stream);
474     g_object_unref (filter);
475     g_object_unref (discard_non_term_filter);
476
477     g_byte_array_append (byte_array, (guint8 *) "\0", 1);
478     body = (char *) g_byte_array_free (byte_array, FALSE);
479
480     if (body) {
481         _notmuch_message_gen_terms (message, NULL, body);
482
483         free (body);
484     }
485 }
486
487 notmuch_status_t
488 _notmuch_message_index_file (notmuch_message_t *message,
489                              notmuch_message_file_t *message_file)
490 {
491     GMimeMessage *mime_message;
492     InternetAddressList *addresses;
493     const char *subject;
494     notmuch_status_t status;
495
496     status = _notmuch_message_file_get_mime_message (message_file,
497                                                      &mime_message);
498     if (status)
499         return status;
500
501     addresses = g_mime_message_get_from (mime_message);
502     if (addresses) {
503         _index_address_list (message, "from", addresses);
504         g_mime_2_6_unref (addresses);
505     }
506
507     addresses = g_mime_message_get_all_recipients (mime_message);
508     if (addresses) {
509         _index_address_list (message, "to", addresses);
510         g_object_unref (addresses);
511     }
512
513     subject = g_mime_message_get_subject (mime_message);
514     _notmuch_message_gen_terms (message, "subject", subject);
515
516     _index_mime_part (message, g_mime_message_get_mime_part (mime_message));
517
518     return NOTMUCH_STATUS_SUCCESS;
519 }