view src/lib-imap-storage/imap-msgpart.h @ 23017:c1d36f2575c7 default tip

lib-imap: Fix "Don't accept strings with NULs" cherry-pick
author Timo Sirainen <>
date Thu, 29 Aug 2019 09:55:25 +0300
parents 4cd9e46e0c78
line wrap: on
line source


struct imap_msgpart;

struct imap_msgpart_open_result {
	/* message contents with CRLF linefeeds */
	struct istream *input;
	/* size of input */
	uoff_t size;
	/* if size was looked up using cache and it ends up being wrong,
	   this field can be used to log about cache corruption */
	enum mail_fetch_field size_field;
	/* TRUE if BINARY decoded content contains NUL characters */
	bool binary_decoded_input_has_nuls;

struct imap_msgpart *imap_msgpart_full(void);
struct imap_msgpart *imap_msgpart_header(void);
struct imap_msgpart *imap_msgpart_body(void);
/* Parse section into imap_msgpart. Returns 0 and msgpart_r on success,
   -1 if the section isn't valid. The same imap_msgpart can be used to open
   multiple messages. */
int imap_msgpart_parse(const char *section, struct imap_msgpart **msgpart_r);
void imap_msgpart_free(struct imap_msgpart **msgpart);

/* Returns TRUE if the msgpart might return at least part of the message body.
   Or alternatively: If FALSE is returned, the msgpart will never return
   anything except (part of) the message header. MIME headers are counted
   as part of the message body. */
bool imap_msgpart_contains_body(const struct imap_msgpart *msgpart);
/* Decode MIME parts with Content-Transfer-Encoding: base64/quoted-printable
   to binary data (IMAP BINARY extension). If something can't be decoded, fails
   with storage error set to MAIL_ERROR_CONVERSION. */
void imap_msgpart_set_decode_to_binary(struct imap_msgpart *msgpart);

/* Set the fetch to be partial. For unlimited size use (uoff_t)-1. */
void imap_msgpart_set_partial(struct imap_msgpart *msgpart,
			      uoff_t offset, uoff_t size);
uoff_t imap_msgpart_get_partial_offset(struct imap_msgpart *msgpart);
uoff_t imap_msgpart_get_partial_size(struct imap_msgpart *msgpart);
/* Return wanted_fields mask. */
enum mail_fetch_field imap_msgpart_get_fetch_data(struct imap_msgpart *msgpart);
/* Append all the specifically requested headers to the headers array
   (no deduplication is done) */
void imap_msgpart_get_wanted_headers(struct imap_msgpart *msgpart,
				     ARRAY_TYPE(const_string) *headers);

/* Open message part refenced by IMAP section as istream. Returns 0 if
   successful, -1 if storage error. Returned istream is initially referenced,
   so i_stream_unref() must be called for it. */
int imap_msgpart_open(struct mail *mail, struct imap_msgpart *msgpart,
		      struct imap_msgpart_open_result *result_r);
/* Return msgpart's size without actually opening the stream (if possible). */
int imap_msgpart_size(struct mail *mail, struct imap_msgpart *msgpart,
		      uoff_t *size_r);

/* Return msgpart's IMAP BODYPARTSTRUCTURE */
int imap_msgpart_bodypartstructure(struct mail *mail,
				   struct imap_msgpart *msgpart,
				   const char **bpstruct_r);

/* Header context is automatically created by imap_msgpart_open() and destroyed
   by imap_msgpart_free(), but if you want to use the same imap_msgpart across
   multiple mailboxes, you need to close the part before closing the mailbox. */
void imap_msgpart_close_mailbox(struct imap_msgpart *msgpart);