Author: Pekka Riikonen <priikone@silcnet.org>
- Copyright (C) 2005 Pekka Riikonen
+ Copyright (C) 2005 - 2006 Pekka Riikonen
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
* MIME messages, multipart MIME messages, including nested multiparts, and
* MIME fragmentation and defragmentation.
*
+ * SILC Mime API is not thread-safe. If the same MIME context must be
+ * used in multithreaded environment concurrency control must be employed.
+ *
***/
#ifndef SILCMIME_H
*
* SYNOPSIS
*
- * SilcMime silc_mime_decode(const unsigned char *data,
+ * SilcMime silc_mime_decode(SilcMime mime, const unsigned char *data,
* SilcUInt32 data_len);
*
* DESCRIPTION
*
* Decodes a MIME message and returns the parsed message into newly
- * allocated SilcMime context.
+ * allocated SilcMime context and returns it. If `mime' is non-NULL
+ * then the MIME message will be encoded into the pre-allocated `mime'
+ * context and same context is returned. If it is NULL then newly
+ * allocated SilcMime context is returned. On error NULL is returned.
*
* EXAMPLE
*
* // Parse MIME message and get its content type
- * mime = silc_mime_decode(data, data_len);
+ * mime = silc_mime_decode(NULL, data, data_len);
* type = silc_mime_get_field(mime, "Content-Type");
* ...
*
* // Assemble received MIME fragment
- * mime = silc_mime_decode(data, data_len);
+ * mime = silc_mime_decode(NULL, data, data_len);
* if (silc_mime_is_partial(mime) == TRUE)
* silc_mime_assmeble(assembler, mime);
*
***/
-SilcMime silc_mime_decode(const unsigned char *data, SilcUInt32 data_len);
+SilcMime silc_mime_decode(SilcMime mime, const unsigned char *data,
+ SilcUInt32 data_len);
/****f* silcutil/SILCMIMEAPI/silc_mime_encode
*
***/
const unsigned char *silc_mime_get_data(SilcMime mime, SilcUInt32 *data_len);
+/****f* silcutil/SILCMIMEAPI/silc_mime_steal_data
+ *
+ * SYNOPSIS
+ *
+ * unsigned char *
+ * silc_mime_steal_data(SilcMime mime, SilcUInt32 *data_len);
+ *
+ * DESCRIPTION
+ *
+ * Returns the MIME data from the `mime' message. The data will be
+ * removed from the `mime' and the caller is responsible of freeing the
+ * returned pointer.
+ *
+ ***/
+unsigned char *silc_mime_steal_data(SilcMime mime, SilcUInt32 *data_len);
+
/****f* silcutil/SILCMIMEAPI/silc_mime_is_partial
*
* SYNOPSIS
*
- * bool silc_mime_is_partial(SilcMime mime);
+ * SilcBool silc_mime_is_partial(SilcMime mime);
*
* DESCRIPTION
*
* Returns TRUE if the MIME message `mime' is a partial MIME fragment.
*
***/
-bool silc_mime_is_partial(SilcMime mime);
+SilcBool silc_mime_is_partial(SilcMime mime);
/****f* silcutil/SILCMIMEAPI/silc_mime_set_multipart
*
*
* SYNOPSIS
*
- * bool silc_mime_add_multipart(SilcMime mime, SilcMime part);
+ * SilcBool silc_mime_add_multipart(SilcMime mime, SilcMime part);
*
* DESCRIPTION
*
* silc_mime_add_multipart(mime, part);
*
***/
-bool silc_mime_add_multipart(SilcMime mime, SilcMime part);
+SilcBool silc_mime_add_multipart(SilcMime mime, SilcMime part);
/****f* silcutil/SILCMIMEAPI/silc_mime_is_multipart
*
* SYNOPSIS
*
- * bool silc_mime_is_multipart(SilcMime mime);
+ * SilcBool silc_mime_is_multipart(SilcMime mime);
*
* DESCRIPTION
*
* Its parts can be get by calling silc_mime_get_multiparts.
*
***/
-bool silc_mime_is_multipart(SilcMime mime);
+SilcBool silc_mime_is_multipart(SilcMime mime);
/****f* silcutil/SILCMIMEAPI/silc_mime_get_multiparts
*
***/
SilcDList silc_mime_get_multiparts(SilcMime mime, const char **type);
+#include "silcmime_i.h"
+
#endif /* SILCMIME_H */