summaryrefslogtreecommitdiff
path: root/include/mailutils/message.h
blob: 1c04bdfde8ba396afa8463909efbdd95d44a8fec (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
/* GNU Mailutils -- a suite of utilities for electronic mail
   Copyright (C) 1999, 2000, 2001, 2005  Free Software Foundation, Inc.

   This library is free software; you can redistribute it and/or
   modify it under the terms of the GNU Lesser General Public
   License as published by the Free Software Foundation; either
   version 2 of the License, or (at your option) any later version.

   This library is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
   Lesser General Public License for more details.

   You should have received a copy of the GNU Lesser General
   Public License along with this library; if not, write to the
   Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
   Boston, MA 02110-1301 USA */

#ifndef _MAILUTILS_MESSAGE_H
#define _MAILUTILS_MESSAGE_H

#include <mailutils/types.h>

#ifdef __cplusplus
extern "C" {
#endif

/* A message is considered to be a container for:
  header_t, body_t, and its attribute_t.  */

extern int message_create           (message_t *, void *owner);
extern void message_destroy         (message_t *, void *owner);

extern int message_create_copy      (message_t *to, message_t from);

extern void * message_get_owner     (message_t);
extern int message_is_modified      (message_t);
extern int message_clear_modified   (message_t);
extern int message_get_mailbox      (message_t, mailbox_t *);
extern int message_set_mailbox      (message_t, mailbox_t, void *);

extern int message_ref              (message_t);
#define message_unref(msg)          message_destroy (&msg, NULL)

extern int message_get_envelope     (message_t, envelope_t *);
extern int message_set_envelope     (message_t, envelope_t, void *);

extern int message_get_header       (message_t, header_t *);
extern int message_set_header       (message_t, header_t, void *);

extern int message_get_body         (message_t, body_t *);
extern int message_set_body         (message_t, body_t, void *);

extern int message_get_stream       (message_t, stream_t *);
extern int message_set_stream       (message_t, stream_t, void *);

extern int message_get_attribute    (message_t, attribute_t *);
extern int message_set_attribute    (message_t, attribute_t, void *);

extern int message_get_observable   (message_t, observable_t *);

extern int message_is_multipart     (message_t, int *);
extern int message_set_is_multipart (message_t, 
                                     int (*_is_multipart) (message_t, int *), 
                                     void *);

extern int message_size             (message_t, size_t *);
extern int message_set_size         (message_t, 
                                     int (*_size) (message_t, size_t *), 
                                     void *owner);

extern int message_lines            (message_t, size_t *);
extern int message_set_lines        (message_t, 
                                     int (*_lines) (message_t, size_t *),
				     void *owner);

extern int message_get_num_parts    (message_t, size_t *nparts);
extern int message_set_get_num_parts (message_t, 
                                      int (*_get_num_parts) (message_t, 
                                                             size_t *),
				      void *owner);

extern int message_get_part         (message_t, size_t, message_t *);
extern int message_set_get_part     (message_t, 
                                     int (*_get_part) (message_t, size_t,
						       message_t *), 
                                     void *owner);

extern int message_get_uidl         (message_t, char *, size_t, size_t *);
extern int message_set_uidl         (message_t, 
                                     int (*_get_uidl) (message_t, char *, 
                                                       size_t, size_t *), 
                                     void *owner);
extern int message_get_uid          (message_t, size_t *);
extern int message_set_uid          (message_t, 
                                     int (*_get_uid) (message_t, size_t *),
				     void *owner);

/* misc functions */
extern int message_create_attachment (const char *content_type,
				      const char *encoding,
				      const char *filename,
				      message_t *newmsg);
extern int message_save_attachment (message_t msg,
				    const char *filename, void **data);
extern int message_encapsulate (message_t msg, message_t *newmsg, void **data);
extern int message_unencapsulate (message_t msg, message_t *newmsg, void **data);

extern int message_get_attachment_name (message_t, char *name, size_t bufsz, size_t* sz);
extern int message_aget_attachment_name (message_t, char **name);

extern int message_save_to_mailbox (message_t msg, ticket_t ticket,
                                    mu_debug_t debug, const char *toname);


#ifdef __cplusplus
}
#endif

#endif /* _MAILUTILS_MESSAGE_H */

Return to:

Send suggestions and report system problems to the System administrator.