notmuch/util/repair.h

#ifndef _REPAIR_H
#define _REPAIR_H

#include "gmime-extra.h"

#ifdef __cplusplus
extern "C" {
#endif

/* This is a collection of message structure and message format repair
 * techniques that are designed to improve the user experience of
 * notmuch */

/* If payload is a cryptographic payload within an encrypted message, and
 * it has a "legacy display" part, then we can skip over it and jump
 * to the actual content, because notmuch already handles protected
 * headers appropriately.
 *
 * This function either returns payload directly (if it does not have
 * a "legacy display" part), or it returns a pointer to its
 * content-bearing subpart, with the "legacy display" part and the
 * surrounding multipart/mixed object bypassed.
 *
 * No new objects are created by calling this function, and the
 * returned object will only be released when the original part is
 * disposed of.
 */

GMimeObject *
_notmuch_repair_crypto_payload_skip_legacy_display (GMimeObject *payload);

/* Detecting and repairing "Mixed-Up MIME mangling". see
 * https://tools.ietf.org/html/draft-dkg-openpgp-pgpmime-message-mangling-00#section-4.1
 * If this returns NULL, the message was probably not "Mixed up".  If
 * it returns non-NULL, then there is a newly-allocated MIME part that
 * represents the repaired version.  The caller is responsible for
 * ensuring that any returned object is freed with g_object_unref. */
GMimeObject *
_notmuch_repair_mixed_up_mangled (GMimeObject *part);

#ifdef __cplusplus
}
#endif
#endif