Author: Pekka Riikonen <priikone@silcnet.org>
- Copyright (C) 2005 - 2007 Pekka Riikonen
+ Copyright (C) 2005 - 2008 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
*/
-/****h* silcutil/SILC MIME Interface
+/****h* silcutil/MIME Interface
*
* DESCRIPTION
*
- * Simple implementation of MIME. Supports creation and parsing of simple
+ * Simple MIME Interface. This API supports creation and parsing of simple
* 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
+ * SILC Mime API is not thread-safe. If the same SilcMime context must be
* used in multithreaded environment concurrency control must be employed.
*
***/
#ifndef SILCMIME_H
#define SILCMIME_H
-/****s* silcutil/SILCMIMEAPI/SilcMime
+/****s* silcutil/SilcMime
*
* NAME
*
***/
typedef struct SilcMimeStruct *SilcMime;
-/****s* silcutil/SILCMIMEAPI/SilcMimeAssembler
+/****s* silcutil/SilcMimeAssembler
*
* NAME
*
***/
typedef struct SilcMimeAssemblerStruct *SilcMimeAssembler;
-/****f* silcutil/SILCMIMEAPI/silc_mime_alloc
+/****f* silcutil/silc_mime_alloc
*
* SYNOPSIS
*
***/
SilcMime silc_mime_alloc(void);
-/****f* silcutil/SILCMIMEAPI/silc_mime_free
+/****f* silcutil/silc_mime_free
*
* SYNOPSIS
*
***/
void silc_mime_free(SilcMime mime);
-/****f* silcutil/SILCMIMEAPI/silc_mime_assembler_alloc
+/****f* silcutil/silc_mime_assembler_alloc
*
* SYNOPSIS
*
***/
SilcMimeAssembler silc_mime_assembler_alloc(void);
-/****f* silcutil/SILCMIMEAPI/silc_mime_assembler_free
+/****f* silcutil/silc_mime_assembler_free
*
* SYNOPSIS
*
***/
void silc_mime_assembler_free(SilcMimeAssembler assembler);
-/****f* silcutil/SILCMIMEAPI/silc_mime_assembler_purge
+/****f* silcutil/silc_mime_assembler_purge
*
* SYNOPSIS
*
void silc_mime_assembler_purge(SilcMimeAssembler assembler,
SilcUInt32 purge_minutes);
-/****f* silcutil/SILCMIMEAPI/silc_mime_decode
+/****f* silcutil/silc_mime_decode
*
* SYNOPSIS
*
SilcMime silc_mime_decode(SilcMime mime, const unsigned char *data,
SilcUInt32 data_len);
-/****f* silcutil/SILCMIMEAPI/silc_mime_encode
+/****f* silcutil/silc_mime_encode
*
* SYNOPSIS
*
***/
unsigned char *silc_mime_encode(SilcMime mime, SilcUInt32 *encoded_len);
-/****f* silcutil/SILCMIMEAPI/silc_mime_assemble
+/****f* silcutil/silc_mime_assemble
*
* SYNOPSIS
*
***/
SilcMime silc_mime_assemble(SilcMimeAssembler assembler, SilcMime partial);
-/****f* silcutil/SILCMIMEAPI/silc_mime_encode_partial
+/****f* silcutil/silc_mime_encode_partial
*
* SYNOPSIS
*
***/
SilcDList silc_mime_encode_partial(SilcMime mime, int max_size);
-/****f* silcutil/SILCMIMEAPI/silc_mime_partial_free
+/****f* silcutil/silc_mime_partial_free
*
* SYNOPSIS
*
***/
void silc_mime_partial_free(SilcDList partials);
-/****f* silcutil/SILCMIMEAPI/silc_mime_add_field
+/****f* silcutil/silc_mime_add_field
*
* SYNOPSIS
*
***/
void silc_mime_add_field(SilcMime mime, const char *field, const char *value);
-/****f* silcutil/SILCMIMEAPI/silc_mime_get_field
+/****f* silcutil/silc_mime_get_field
*
* SYNOPSIS
*
***/
const char *silc_mime_get_field(SilcMime mime, const char *field);
-/****f* silcutil/SILCMIMEAPI/silc_mime_add_data
+/****f* silcutil/silc_mime_add_data
*
* SYNOPSIS
*
void silc_mime_add_data(SilcMime mime, const unsigned char *data,
SilcUInt32 data_len);
-/****f* silcutil/SILCMIMEAPI/silc_mime_get_data
+/****f* silcutil/silc_mime_get_data
*
* SYNOPSIS
*
***/
const unsigned char *silc_mime_get_data(SilcMime mime, SilcUInt32 *data_len);
-/****f* silcutil/SILCMIMEAPI/silc_mime_steal_data
+/****f* silcutil/silc_mime_steal_data
*
* SYNOPSIS
*
***/
unsigned char *silc_mime_steal_data(SilcMime mime, SilcUInt32 *data_len);
-/****f* silcutil/SILCMIMEAPI/silc_mime_is_partial
+/****f* silcutil/silc_mime_is_partial
*
* SYNOPSIS
*
***/
SilcBool silc_mime_is_partial(SilcMime mime);
-/****f* silcutil/SILCMIMEAPI/silc_mime_set_multipart
+/****f* silcutil/silc_mime_set_multipart
*
* SYNOPSIS
*
void silc_mime_set_multipart(SilcMime mime, const char *type,
const char *boundary);
-/****f* silcutil/SILCMIMEAPI/silc_mime_add_multipart
+/****f* silcutil/silc_mime_add_multipart
*
* SYNOPSIS
*
***/
SilcBool silc_mime_add_multipart(SilcMime mime, SilcMime part);
-/****f* silcutil/SILCMIMEAPI/silc_mime_is_multipart
+/****f* silcutil/silc_mime_is_multipart
*
* SYNOPSIS
*
***/
SilcBool silc_mime_is_multipart(SilcMime mime);
-/****f* silcutil/SILCMIMEAPI/silc_mime_get_multiparts
+/****f* silcutil/silc_mime_get_multiparts
*
* SYNOPSIS
*