X-Git-Url: http://git.silcnet.org/gitweb/?a=blobdiff_plain;f=lib%2Fsilcutil%2Fsilcmime.h;h=649c3d369c3e91a450c7de8a2d7f7242b6c6ce86;hb=40f8443d8d3a6577336ee66d18e04d9ac4d956bb;hp=90684e17986e3f8fe9915d2542d4ec0b3b622bbe;hpb=0f0340b9fbce9704cc7171f8f0104ce9103d2de6;p=silc.git

diff --git a/lib/silcutil/silcmime.h b/lib/silcutil/silcmime.h
index 90684e17..649c3d36 100644
--- a/lib/silcutil/silcmime.h
+++ b/lib/silcutil/silcmime.h
@@ -116,28 +116,32 @@ void silc_mime_assembler_free(SilcMimeAssembler assembler);
  *
  * 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
  *
@@ -290,14 +294,14 @@ const unsigned char *silc_mime_get_data(SilcMime mime, SilcUInt32 *data_len);
  *
  * 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
  *
@@ -320,7 +324,7 @@ void silc_mime_set_multipart(SilcMime mime, const char *type,
  *
  * SYNOPSIS
  *
- *    bool silc_mime_add_multipart(SilcMime mime, SilcMime part);
+ *    SilcBool silc_mime_add_multipart(SilcMime mime, SilcMime part);
  *
  * DESCRIPTION
  *
@@ -344,13 +348,13 @@ void silc_mime_set_multipart(SilcMime mime, const char *type,
  *    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
  *
@@ -358,7 +362,7 @@ bool silc_mime_add_multipart(SilcMime mime, SilcMime part);
  *    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
  *
@@ -377,4 +381,6 @@ bool silc_mime_is_multipart(SilcMime mime);
  ***/
 SilcDList silc_mime_get_multiparts(SilcMime mime, const char **type);
 
+#include "silcmime_i.h"
+
 #endif /* SILCMIME_H */