lib-mime/mime.h

   1 /*
   2  *  This program is free software; you can redistribute it and/or modify
   3  *  it under the terms of the GNU General Public License as published by
   4  *  the Free Software Foundation; either version 2 of the License, or (at
   5  *  your option) any later version.
   6  *
   7  *  This program is distributed in the hope that it will be useful, but
   8  *  WITHOUT ANY WARRANTY; without even the implied warranty of
   9  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  10  *  General Public License for more details.
  11  *
  12  *  You should have received a copy of the GNU General Public License
  13  *  along with this program; if not, write to the Free Software
  14  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
  15  *  MA 02110-1301, USA.
  16  *
  17  *  Copyright © 2006 Pierre Habouzit
  18  */
  19
  20 /*
  21  * Copyright notice from original mutt:
  22  * Copyright (C) 1999-2000 Thomas Roessler <roessler@does-not-exist.org>
  23  *
  24  * This file is part of mutt-ng, see http://www.muttng.org/.
  25  * It's licensed under the GNU General Public License,
  26  * please see the file GPL in the top level source directory.
  27  */
  28
  29 #ifndef MUTT_LIB_MIME_MIME_H
  30 #define MUTT_LIB_MIME_MIME_H
  31
  32 #include <stdlib.h>
  33
  34 #include <lib-lib/mem.h>
  35
  36 /* Content-Type */
  37 enum {
  38     TYPEOTHER,
  39     TYPEAUDIO,
  40     TYPEAPPLICATION,
  41     TYPEIMAGE,
  42     TYPEMESSAGE,
  43     TYPEMODEL,
  44     TYPEMULTIPART,
  45     TYPETEXT,
  46     TYPEVIDEO,
  47     TYPEANY
  48 };
  49
  50 /* Content-Transfer-Encoding */
  51 enum {
  52     ENCOTHER,
  53     ENC7BIT,
  54     ENC8BIT,
  55     ENCQUOTEDPRINTABLE,
  56     ENCBASE64,
  57     ENCBINARY,
  58     ENCUUENCODED
  59 };
  60
  61 /* Content-Disposition values */
  62 enum {
  63     DISPINLINE,
  64     DISPATTACH,
  65     DISPFORMDATA
  66 };
  67
  68 typedef struct parameter {
  69     char *attribute;
  70     char *value;
  71     struct parameter *next;
  72 } PARAMETER;
  73
  74 extern const char MimeSpecials[];
  75 extern const char *BodyTypes[];
  76 extern const char *BodyEncodings[];
  77
  78 /* MIME encoding/decoding global vars */
  79
  80 #define is_multipart(x) \
  81     ((x)->type == TYPEMULTIPART \
  82      || ((x)->type == TYPEMESSAGE && (!strcasecmp((x)->subtype, "rfc822") \
  83                                       || !strcasecmp((x)->subtype, "news"))))
  84 #define TYPE(X) ((X->type == TYPEOTHER) && (X->xtype != NULL) ? X->xtype : BodyTypes[(X->type)])
  85 #define ENCODING(X) BodyEncodings[(X)]
  86
  87 /****************************************************************************/
  88 /* RFC 822                                                                  */
  89 /*                Standard for ARPA Internet Text Messages                  */
  90 /****************************************************************************/
  91
  92 /* possible values for RFC822Error */
  93 enum {
  94     ERR_MEMORY = 1,
  95     ERR_MISMATCH_PAREN,
  96     ERR_MISMATCH_QUOTE,
  97     ERR_BAD_ROUTE,
  98     ERR_BAD_ROUTE_ADDR,
  99     ERR_BAD_ADDR_SPEC
 100 };
 101
 102 typedef struct address_t {
 103     char *personal;               /* real name of address */
 104     char *mailbox;                /* mailbox and host address */
 105     int group;                    /* group mailbox? */
 106     struct address_t *next;
 107 } address_t;
 108
 109 DO_INIT(address_t, address);
 110 void address_wipe(address_t *);
 111
 112 DO_NEW(address_t, address);
 113 DO_DELETE(address_t, address);
 114
 115 void rfc822_qualify(address_t *, const char *);
 116 address_t *rfc822_parse_adrlist(address_t *, const char *s);
 117 address_t *rfc822_cpy_adr(address_t * addr);
 118 address_t *rfc822_cpy_adr_real(address_t * addr);
 119 address_t *rfc822_append(address_t ** a, address_t * b);
 120 void rfc822_write_address(char *, size_t, address_t *, int);
 121 void rfc822_write_address_single(char *, size_t, address_t *, int);
 122 void rfc822_cat(char *, size_t, const char *, const char *);
 123
 124 extern int RFC822Error;
 125 extern const char *RFC822Errors[];
 126 extern const char RFC822Specials[];
 127
 128 #define rfc822_error(x) RFC822Errors[x]
 129
 130 /****************************************************************************/
 131 /* RFC 2231                                                                 */
 132 /*             MIME Parameter Value and Encoded Word Extensions:            */
 133 /*               Character Sets, Languages, and Continuations               */
 134 /****************************************************************************/
 135
 136 int  rfc2231_encode_string(char **);
 137 void rfc2231_decode_parameters(PARAMETER **);
 138
 139 #endif /* MUTT_LIB_MIME_MIME_H */