imap-msgpart-url.h revision d65184737a0465602db98e103f9097b1a1ea9564
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis#ifndef IMAP_MSGPART_URL_H
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis#define IMAP_MSGPART_URL_H
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis#include "imap-msgpart.h"
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstruct imap_url;
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstruct imap_msgpart;
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstruct imap_msgpart_url;
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis/* Functions returning int return 1 on success, 0 if URL doesn't point to
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis valid mail, -1 on storage error. */
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_create(struct mail_user *user, const struct imap_url *url,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis struct imap_msgpart_url **url_r,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_parse(struct mail_user *user, struct mailbox *selected_box,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char *urlstr, struct imap_msgpart_url **url_r,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_open_mailbox(struct imap_msgpart_url *mpurl,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis struct mailbox **box_r, enum mail_error *error_code_r,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstruct mailbox *imap_msgpart_url_get_mailbox(struct imap_msgpart_url *mpurl);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_open_mail(struct imap_msgpart_url *mpurl,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis struct mail **mail_r, const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisstruct imap_msgpart *
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisimap_msgpart_url_get_part(struct imap_msgpart_url *mpurl);
ddc0e0b53c661f6e439e3b7072b3ef353eadb4afRichard Lowe
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis/* Decode MIME parts with Content-Transfer-Encoding: base64/quoted-printable
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis to binary data (IMAP BINARY extension). If something can't be decoded, fails
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis with storage error set to MAIL_ERROR_CONVERSION. */
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisvoid imap_msgpart_url_set_decode_to_binary(struct imap_msgpart_url *mpurl);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis/* stream_r is set to NULL when part has zero length, e.g. when partial offset
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis is larger than the size of the referenced part */
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_read_part(struct imap_msgpart_url *mpurl,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis struct imap_msgpart_open_result *result_r,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_get_bodypartstructure(struct imap_msgpart_url *mpurl,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **bpstruct_r,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisint imap_msgpart_url_verify(struct imap_msgpart_url *mpurl,
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis const char **error_r);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtisvoid imap_msgpart_url_free(struct imap_msgpart_url **mpurl);
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis#endif
25c28e83beb90e7c80452a7c818c5e6f73a07dc8Piotr Jasiukajtis