/* * e-mail-part-utils.h * * This program is free software; you can redistribute it and/or modify it * under the terms of the GNU Lesser General Public License as published by * the Free Software Foundation. * * 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 Lesser General Public License * along with this program; if not, see . * */ #ifdef HAVE_CONFIG_H #include #endif #include #include "e-mail-part-utils.h" #include "e-mail-parser-extension.h" #include #include #include #include #define d(x) /** * e_mail_part_is_secured: * @part: a #CamelMimePart * * Whether @part is signed or encrypted or not. * * Return Value: TRUE/FALSE */ gboolean e_mail_part_is_secured (CamelMimePart *part) { CamelContentType *ct = camel_mime_part_get_content_type (part); return (camel_content_type_is (ct, "multipart", "signed") || camel_content_type_is (ct, "multipart", "encrypted") || camel_content_type_is (ct, "application", "x-inlinepgp-signed") || camel_content_type_is (ct, "application", "x-inlinepgp-encrypted") || camel_content_type_is (ct, "application", "x-pkcs7-mime") || camel_content_type_is (ct, "application", "pkcs7-mime")); } /** * e_mail_part_snoop_type: * @part: a #CamelMimePart * * Tries to snoop the mime type of a part. * * Return value: %NULL if unknown (more likely application/octet-stream). **/ const gchar * e_mail_part_snoop_type (CamelMimePart *part) { /* cache is here only to be able still return const gchar * */ static GHashTable *types_cache = NULL; const gchar *filename; gchar *name_type = NULL, *magic_type = NULL, *res, *tmp; CamelDataWrapper *dw; filename = camel_mime_part_get_filename (part); if (filename != NULL) name_type = e_util_guess_mime_type (filename, FALSE); dw = camel_medium_get_content ((CamelMedium *) part); if (!camel_data_wrapper_is_offline (dw)) { GByteArray *byte_array; CamelStream *stream; byte_array = g_byte_array_new (); stream = camel_stream_mem_new_with_byte_array (byte_array); if (camel_data_wrapper_decode_to_stream_sync (dw, stream, NULL, NULL) > 0) { gchar *content_type; content_type = g_content_type_guess ( filename, byte_array->data, byte_array->len, NULL); if (content_type != NULL) magic_type = g_content_type_get_mime_type (content_type); g_free (content_type); } g_object_unref (stream); } /* If gvfs doesn't recognize the data by magic, but it * contains English words, it will call it text/plain. If the * filename-based check came up with something different, use * that instead and if it returns "application/octet-stream" * try to do better with the filename check. */ if (magic_type) { if (name_type && (!strcmp (magic_type, "text/plain") || !strcmp (magic_type, "application/octet-stream"))) res = name_type; else res = magic_type; } else res = name_type; if (res != name_type) g_free (name_type); if (res != magic_type) g_free (magic_type); if (!types_cache) types_cache = g_hash_table_new_full ( g_str_hash, g_str_equal, (GDestroyNotify) g_free, (GDestroyNotify) NULL); if (res) { tmp = g_hash_table_lookup (types_cache, res); if (tmp) { g_free (res); res = tmp; } else { g_hash_table_insert (types_cache, res, res); } } d (printf ("Snooped mime type %s\n", res)); return res; /* We used to load parts to check their type, we don't anymore, * see bug #211778 for some discussion */ } /** * e_mail_part_is_attachment * @part: Part to check. * * Returns true if the part is an attachment. * * A part is not considered an attachment if it is a * multipart, or a text part with no filename. It is used * to determine if an attachment header should be displayed for * the part. * * Content-Disposition is not checked. * * Return value: TRUE/FALSE **/ gboolean e_mail_part_is_attachment (CamelMimePart *part) { /*CamelContentType *ct = camel_mime_part_get_content_type(part);*/ CamelDataWrapper *dw = camel_medium_get_content ((CamelMedium *) part); if (!dw) return 0; d (printf ("checking is attachment %s/%s\n", dw->mime_type->type, dw->mime_type->subtype)); return !(camel_content_type_is (dw->mime_type, "multipart", "*") || camel_content_type_is ( dw->mime_type, "application", "x-pkcs7-mime") || camel_content_type_is ( dw->mime_type, "application", "pkcs7-mime") || camel_content_type_is ( dw->mime_type, "application", "x-inlinepgp-signed") || camel_content_type_is ( dw->mime_type, "application", "x-inlinepgp-encrypted") || camel_content_type_is ( dw->mime_type, "x-evolution", "evolution-rss-feed") || camel_content_type_is (dw->mime_type, "text", "calendar") || camel_content_type_is (dw->mime_type, "text", "x-calendar") || (camel_content_type_is (dw->mime_type, "text", "*") && camel_mime_part_get_filename (part) == NULL)); } /** * e_mail_part_preserve_charset_in_content_type: * @ipart: Source #CamelMimePart * @opart: Target #CamelMimePart * * Copies 'charset' part of content-type header from @ipart to @opart. */ void e_mail_part_preserve_charset_in_content_type (CamelMimePart *ipart, CamelMimePart *opart) { CamelDataWrapper *data_wrapper; CamelContentType *content_type; const gchar *charset; g_return_if_fail (ipart != NULL); g_return_if_fail (opart != NULL); data_wrapper = camel_medium_get_content (CAMEL_MEDIUM (ipart)); content_type = camel_data_wrapper_get_mime_type_field (data_wrapper); if (content_type == NULL) return; charset = camel_content_type_param (content_type, "charset"); if (charset == NULL || *charset == '\0') return; data_wrapper = camel_medium_get_content (CAMEL_MEDIUM (opart)); content_type = camel_data_wrapper_get_mime_type_field (data_wrapper); if (content_type) camel_content_type_set_param (content_type, "charset", charset); /* update charset also on the part itself */ data_wrapper = CAMEL_DATA_WRAPPER (opart); content_type = camel_data_wrapper_get_mime_type_field (data_wrapper); if (content_type) camel_content_type_set_param (content_type, "charset", charset); } /** * e_mail_part_get_related_display_part: * @part: a multipart/related or multipart/alternative #CamelMimePart * @out_displayid: (out) returns index of the returned part * * Goes through all subparts of given @part and tries to determine which * part should be displayed and which parts are just attachments to the * part. * * Return Value: A #CamelMimePart that should be displayed */ CamelMimePart * e_mail_part_get_related_display_part (CamelMimePart *part, gint *out_displayid) { CamelMultipart *mp; CamelMimePart *body_part, *display_part = NULL; CamelContentType *content_type; const gchar *start; gint i, nparts, displayid = 0; mp = (CamelMultipart *) camel_medium_get_content ((CamelMedium *) part); if (!CAMEL_IS_MULTIPART (mp)) return NULL; nparts = camel_multipart_get_number (mp); content_type = camel_mime_part_get_content_type (part); start = camel_content_type_param (content_type, "start"); if (start && strlen (start) > 2) { gint len; const gchar *cid; /* strip <>'s from CID */ len = strlen (start) - 2; start++; for (i = 0; i < nparts; i++) { body_part = camel_multipart_get_part (mp, i); cid = camel_mime_part_get_content_id (body_part); if (cid && !strncmp (cid, start, len) && strlen (cid) == len) { display_part = body_part; displayid = i; break; } } } else { display_part = camel_multipart_get_part (mp, 0); } if (out_displayid) *out_displayid = displayid; return display_part; } void e_mail_part_animation_extract_frame (const GByteArray *anim, gchar **frame, gsize *len) { GdkPixbufLoader *loader; GdkPixbufAnimation *animation; GdkPixbuf *frame_buf; /* GIF89a (GIF image signature) */ const gchar GIF_HEADER[] = { 0x47, 0x49, 0x46, 0x38, 0x39, 0x61 }; const gint GIF_HEADER_LEN = sizeof (GIF_HEADER); /* NETSCAPE2.0 (extension describing animated GIF, starts on 0x310) */ const gchar GIF_APPEXT[] = { 0x4E, 0x45, 0x54, 0x53, 0x43, 0x41, 0x50, 0x45, 0x32, 0x2E, 0x30 }; const gint GIF_APPEXT_LEN = sizeof (GIF_APPEXT); if ((anim == NULL) || (anim->data == NULL)) { *frame = NULL; *len = 0; return; } /* Check if the image is an animated GIF. We don't care about any * other animated formats (APNG or MNG) as WebKit does not support them * and displays only the first frame. */ if ((anim->len < 0x331) || (memcmp (anim->data, GIF_HEADER, GIF_HEADER_LEN) != 0) || (memcmp (&anim->data[0x310], GIF_APPEXT, GIF_APPEXT_LEN) != 0)) { *frame = g_memdup (anim->data, anim->len); *len = anim->len; return; } loader = gdk_pixbuf_loader_new (); gdk_pixbuf_loader_write (loader, (guchar *) anim->data, anim->len, NULL); gdk_pixbuf_loader_close (loader, NULL); animation = gdk_pixbuf_loader_get_animation (loader); if (!animation) { *frame = g_memdup (anim->data, anim->len); *len = anim->len; g_object_unref (loader); return; } /* Extract first frame */ frame_buf = gdk_pixbuf_animation_get_static_image (animation); if (!frame_buf) { *frame = g_memdup (anim->data, anim->len); *len = anim->len; g_object_unref (loader); g_object_unref (animation); return; } /* Unforunatelly, GdkPixbuf cannot save to GIF, but WebKit does not * have any trouble displaying PNG image despite the part having * image/gif mime-type */ gdk_pixbuf_save_to_buffer (frame_buf, frame, len, "png", NULL, NULL); g_object_unref (loader); } /** * e_mail_part_build_url: * @folder: (allow-none) a #CamelFolder with the message or %NULL * @message_uid: uid of the message within the @folder * @first_param_name: Name of first query parameter followed by GType of it's value and value * terminated by %NULL. * * Construct a URI for message. * * The URI can contain multiple query parameters. The list of parameters must be * NULL-terminated. Each query must contain name, GType of value and value. * * Return Value: a URL of a message or part */ gchar * e_mail_part_build_uri (CamelFolder *folder, const gchar *message_uid, const gchar *first_param_name, ...) { CamelStore *store; gchar *uri, *tmp; va_list ap; const gchar *name; const gchar *service_uid, *folder_name; gchar *encoded_message_uid; gchar separator; g_return_val_if_fail (message_uid && *message_uid, NULL); if (!folder) { folder_name = "generic"; service_uid = "generic"; } else { tmp = (gchar *) camel_folder_get_full_name (folder); folder_name = (const gchar *) soup_uri_encode (tmp, NULL); store = camel_folder_get_parent_store (folder); if (store) service_uid = camel_service_get_uid (CAMEL_SERVICE (store)); else service_uid = "generic"; } encoded_message_uid = soup_uri_encode (message_uid, NULL); tmp = g_strdup_printf ( "mail://%s/%s/%s", service_uid, folder_name, encoded_message_uid); g_free (encoded_message_uid); if (folder) { g_free ((gchar *) folder_name); } va_start (ap, first_param_name); name = first_param_name; separator = '?'; while (name) { gchar *tmp2; gint type = va_arg (ap, gint); switch (type) { case G_TYPE_INT: case G_TYPE_BOOLEAN: { gint val = va_arg (ap, gint); tmp2 = g_strdup_printf ( "%s%c%s=%d", tmp, separator, name, val); break; } case G_TYPE_FLOAT: case G_TYPE_DOUBLE: { gdouble val = va_arg (ap, double); tmp2 = g_strdup_printf ( "%s%c%s=%f", tmp, separator, name, val); break; } case G_TYPE_STRING: { gchar *val = va_arg (ap, gchar *); gchar *escaped = soup_uri_encode (val, NULL); tmp2 = g_strdup_printf ( "%s%c%s=%s", tmp, separator, name, escaped); g_free (escaped); break; } default: g_warning ("Invalid param type %s", g_type_name (type)); va_end (ap); return NULL; } g_free (tmp); tmp = tmp2; if (separator == '?') separator = '&'; name = va_arg (ap, gchar *); } va_end (ap); uri = tmp; if (uri == NULL) return NULL; /* For some reason, webkit won't accept URL with username, but * without password (mail://store@host/folder/mail), so we * will replace the '@' symbol by '/' to get URL like * mail://store/host/folder/mail which is OK */ while ((tmp = strchr (uri, '@')) != NULL) { tmp[0] = '/'; } return uri; } /** * e_mail_part_describe: * @part: a #CamelMimePart * @mime_type: MIME type of the content * * Generate a simple textual description of a part, @mime_type represents * the content. * * Return value: **/ gchar * e_mail_part_describe (CamelMimePart *part, const gchar *mime_type) { GString *stext; const gchar *filename, *description; gchar *content_type, *desc; stext = g_string_new (""); content_type = g_content_type_from_mime_type (mime_type); desc = g_content_type_get_description ( content_type != NULL ? content_type : mime_type); g_free (content_type); g_string_append_printf ( stext, _("%s attachment"), desc ? desc : mime_type); g_free (desc); filename = camel_mime_part_get_filename (part); description = camel_mime_part_get_description (part); if (!filename || !*filename) { CamelDataWrapper *content; content = camel_medium_get_content (CAMEL_MEDIUM (part)); if (CAMEL_IS_MIME_MESSAGE (content)) filename = camel_mime_message_get_subject ( CAMEL_MIME_MESSAGE (content)); } if (filename != NULL && *filename != '\0') { gchar *basename = g_path_get_basename (filename); g_string_append_printf (stext, " (%s)", basename); g_free (basename); } if (description != NULL && *description != '\0' && g_strcmp0 (filename, description) != 0) g_string_append_printf (stext, ", \"%s\"", description); return g_string_free (stext, FALSE); } gboolean e_mail_part_is_inline (CamelMimePart *mime_part, GQueue *extensions) { const gchar *disposition; EMailParserExtension *extension; EMailParserExtensionClass *class; disposition = camel_mime_part_get_disposition (mime_part); if ((extensions == NULL) || g_queue_is_empty (extensions)) return disposition && g_ascii_strcasecmp (disposition, "inline") == 0; extension = g_queue_peek_head (extensions); class = E_MAIL_PARSER_EXTENSION_GET_CLASS (extension); /* Some types need to override the disposition. * e.g. application/x-pkcs7-mime */ if (class->flags & E_MAIL_PARSER_EXTENSION_INLINE_DISPOSITION) return TRUE; if (disposition != NULL) return g_ascii_strcasecmp (disposition, "inline") == 0; /* Otherwise, use the default for this handler type. */ return (class->flags & E_MAIL_PARSER_EXTENSION_INLINE) != 0; } /** * e_mail_part_utils_body_refers: * @body: text body to search for references in; can be %NULL, then returns %FALSE * @cid: a Content-ID to search for; if found in body, it should be of form "cid:xxxxx"; can be %NULL * * Returns whether @body contains a reference to @cid enclosed in quotes; * returns %FALSE if any of the arguments is %NULL. **/ gboolean e_mail_part_utils_body_refers (const gchar *body, const gchar *cid) { const gchar *ptr; if (!body || !cid || !*cid) return FALSE; ptr = body; while (ptr = strstr (ptr, cid), ptr != NULL) { if (ptr - body > 1 && ptr[-1] == '\"' && ptr[strlen (cid)] == '\"') return TRUE; ptr++; } return FALSE; }