/*
* Abstract types for MIME parsing/building
*/
-typedef struct cefile *CE;
-typedef struct CTinfo *CI;
-typedef struct Content *CT;
+typedef struct cefile *CE;
+typedef struct CTinfo *CI;
+typedef struct Content *CT;
+typedef struct Parameter *PM;
/*
* type for Init function (both type and transfer encoding)
HF next; /* link to next header field */
};
+/*
+ * Structure for holding MIME parameter elements.
+ */
+struct Parameter {
+ char *pm_name; /* Parameter name */
+ char *pm_value; /* Parameter value */
+ char *pm_charset; /* Parameter character set (optional) */
+ char *pm_lang; /* Parameter language tag (optional) */
+ PM pm_next; /* Pointer to next element */
+};
+
/*
* Structure for storing parsed elements
* of the Content-Type component.
struct CTinfo {
char *ci_type; /* content type */
char *ci_subtype; /* content subtype */
- char *ci_attrs[NPARMS + 2]; /* attribute names */
- char *ci_values[NPARMS]; /* attribute values */
+ PM ci_first_pm; /* Pointer to first MIME parameter */
+ PM ci_last_pm; /* Pointer to last MIME parameter */
char *ci_comment; /* RFC-822 comments */
char *ci_magic;
};
char *c_id; /* Content-ID: */
char *c_descr; /* Content-Description: */
char *c_dispo; /* Content-Disposition: */
+ char *c_dispo_type; /* Type of Content-Disposition */
+ PM c_dispo_first; /* Pointer to first disposition parm */
+ PM c_dispo_last; /* Pointer to last disposition parm */
char *c_partno; /* within multipart content */
/* Content-Type info */
/* Content-Transfer-Encoding info (decoded contents) */
struct cefile c_cefile; /* structure holding decoded content */
int c_encoding; /* internal flag for encoding type */
+ int c_reqencoding; /* Requested encoding (by mhbuild) */
/* Content-MD5 info */
int c_digested; /* have we seen this header before? */
* Translate a composition file into a MIME data structure. Arguments are:
*
* infile - Name of input filename
+ * autobuild - A flag to indicate if the composition file parser is
+ * being run in automatic mode or not. In auto mode,
+ * if a MIME-Version header is encountered it is assumed
+ * that the composition file is already in MIME format
+ * and will not be processed further. Otherwise, an
+ * error is generated.
+ * dist - A flag to indicate if we are being run by "dist". In
+ * that case, add no MIME headers to the message. Existing
+ * headers will still be encoded by RFC 2047.
* directives - A flag to control whether or not build directives are
* processed by default.
* encoding - The default encoding to use when doing RFC 2047 header
* encoding. Must be one of CE_UNKNOWN, CE_BASE64, or
- * CE_QUOTED;
+ * CE_QUOTED.
+ * maxunencoded - The maximum line length before the default encoding for
+ * text parts is quoted-printable.
*
- * Returns a CT structure describing the resulting MIME message.
+ * Returns a CT structure describing the resulting MIME message. If the
+ * -auto flag is set and a MIME-Version header is encountered, the return
+ * value is NULL.
*/
-CT build_mime (char *infile, int directives, int encoding);
+CT build_mime (char *infile, int autobuild, int dist, int directives,
+ int encoding, size_t maxunencoded);
int add_header (CT, char *, char *);
int get_ctinfo (char *, CT, int);
const struct str2init *get_ct_init (int);
const char *ce_str (int);
const struct str2init *get_ce_method (const char *);
-int parse_header_attrs (const char *, int, char **, CI, int *);
+
+/*
+ * Parse a series of MIME attributes (or parameters) given a header as
+ * input.
+ *
+ * Arguments include:
+ *
+ * filename - Name of input file (for error messages)
+ * fieldname - Name of field being processed
+ * headerp - Pointer to pointer of the beginning of the MIME attributes.
+ * Updated to point to end of attributes when finished.
+ * param_head - Pointer to head of parameter list
+ * param_tail - Pointer to tail of parameter list
+ * commentp - Pointer to header comment pointer (may be NULL)
+ *
+ * Returns OK if parsing was successful, NOTOK if parsing failed, and
+ * DONE to indicate a benign error (minor parsing error, but the program
+ * should continue).
+ */
+int parse_header_attrs (const char *filename, const char *fieldname,
+ char **headerp, PM *param_head, PM *param_tail,
+ char **commentp);
+
+/*
+ * Given a linked list of parameters, build an output string for them. This
+ * string is designed to be concatenated on an already-built header.
+ *
+ * Arguments are:
+ *
+ * initialwidth - Current width of the header. Used to compute when to wrap
+ * parameters on the first line. The following lines will
+ * be prefixed by a tab (\t) character.
+ * params - Pointer to head of linked list of parameters.
+ * offsetout - The final line offset after all the parameters have been
+ * output. May be NULL.
+ * external - If set, outputting an external-body type and will not
+ * output a "body" parameter.
+
+ * Returns a pointer to the resulting parameter string. This string must
+ * be free()'d by the caller. Returns NULL on error.
+ */
+char *output_params(size_t initialwidth, PM params, int *offsetout,
+ int external);
+
+/*
+ * Add a parameter to the parameter linked list.
+ *
+ * Arguments are:
+ *
+ * first - Pointer to head of linked list
+ * last - Pointer to tail of linked list
+ * name - Name of parameter
+ * value - Value of parameter
+ *
+ * Returned allocated parameter element
+ */
+PM add_param(PM *first, PM *last, const char *name, const char *value);
+
+/*
+ * Retrieve a parameter value from a parameter linked list. Convert to the
+ * local character set if required.
+ *
+ * Arguments are:
+ *
+ * first - Pointer to head of parameter linked list.
+ * name - Name of parameter.
+ * replace - If characters in the parameter list cannot be converted to
+ * the local character set, replace with this character.
+ * fetchonly - If true, return pointer to original value, no conversion
+ * performed.
+ *
+ * Returns parameter value if found, NULL otherwise. Memory must be free()'d
+ * unless fetchonly is set.
+ */
+
+char *get_param(PM first, const char *name, char replace, int fetchonly);
+
+/*
+ * Fetch a parameter value from a parameter structure, converting it to
+ * the local character set.
+ *
+ * Arguments are:
+ *
+ * pm - Pointer to parameter structure
+ * replace - If characters in the parameter list cannot be converted to
+ * the local character set, replace with this character.
+ *
+ * Returns a pointer to the parameter value. Memory is stored in an
+ * internal buffer, so the returned value is only valid until the next
+ * call to get_param_value() or get_param() (get_param() uses get_param_value()
+ * internally).
+ */
+char *get_param_value(PM pm, char replace);
extern int checksw; /* Add Content-MD5 field */
projects / nmh / blobdiff