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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
|
/* -*-mode:c; c-style:k&r; c-basic-offset:4; -*- */
/* Balsa E-Mail Client
*
* Copyright (C) 1997-2002 Stuart Parmenter and others,
* See the file AUTHORS for a list.
*
* 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
* the Free Software Foundation; either version 2, or (at your option)
* any later version.
*
* This program 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 General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, write to the Free Software
* Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
* 02111-1307, USA.
*/
#ifndef __LIBBALSA_H__
#define __LIBBALSA_H__
#ifndef BALSA_VERSION
# error "Include config.h before this file."
#endif
typedef struct _LibBalsaCondition LibBalsaCondition;
typedef struct _LibBalsaIdentity LibBalsaIdentity;
typedef struct _LibBalsaMailbox LibBalsaMailbox;
typedef struct _LibBalsaMailboxRemote LibBalsaMailboxRemote;
typedef struct _LibBalsaMailboxSearchIter LibBalsaMailboxSearchIter;
typedef struct _LibBalsaMessage LibBalsaMessage;
typedef struct _LibBalsaMessageHeaders LibBalsaMessageHeaders;
typedef struct _LibBalsaMessageBody LibBalsaMessageBody;
typedef struct _LibBalsaServer LibBalsaServer;
#if ENABLE_ESMTP
typedef struct _LibBalsaSmtpServer LibBalsaSmtpServer;
#endif /* ENABLE_ESMTP */
typedef struct _LibbalsaVfs LibbalsaVfs;
#include "message.h"
#include "body.h"
#include "files.h"
#include "mime.h"
#include "information.h"
#include "address-book.h"
#include "address-book-vcard.h"
#include "address-book-ldif.h"
#include "address-book-extern.h"
#if ENABLE_LDAP
#include "address-book-ldap.h"
#endif
#if HAVE_SQLITE
#include "address-book-gpe.h"
#endif
#if HAVE_RUBRICA
#include "address-book-rubrica.h"
#endif
#include "mailbox.h"
#include "mailbox_local.h"
#include "mailbox_remote.h"
#include "mailbox_pop3.h"
#include "mailbox_imap.h"
#include "mailbox_mbox.h"
#include "mailbox_mh.h"
#include "mailbox_maildir.h"
#define ELEMENTS(x) (sizeof (x) / sizeof (x[0]))
/*
* Error domains for GError:
*/
enum {
LIBBALSA_SCANNER_ERROR,
LIBBALSA_MAILBOX_ERROR
};
/*
* Error codes for GError:
*/
enum {
LIBBALSA_SCANNER_ERROR_IMAP,
LIBBALSA_MAILBOX_APPEND_ERROR,
LIBBALSA_MAILBOX_AUTH_ERROR, /* retryable */
LIBBALSA_MAILBOX_AUTH_CANCELLED, /* do not try again */
LIBBALSA_MAILBOX_COPY_ERROR,
LIBBALSA_MAILBOX_RENAME_ERROR,
LIBBALSA_MAILBOX_CREATE_ERROR,
LIBBALSA_MAILBOX_DELETE_ERROR,
LIBBALSA_MAILBOX_NETWORK_ERROR,
LIBBALSA_MAILBOX_OPEN_ERROR,
LIBBALSA_MAILBOX_TOOMANYOPEN_ERROR,
LIBBALSA_MAILBOX_ACCESS_ERROR,
LIBBALSA_MAILBOX_DUPLICATES_ERROR,
LIBBALSA_MAILBOX_TEMPDIR_ERROR
};
/*
* Initialize the library
*/
void libbalsa_init(LibBalsaInformationFunc information_callback);
void libbalsa_set_spool(const gchar * spool);
void libbalsa_show_message_source(LibBalsaMessage * msg,
const gchar * font,
gboolean *escape_specials,
gint * width, gint * height);
gchar *libbalsa_rot(const gchar * pass);
gchar *libbalsa_guess_email_address(void);
gchar *libbalsa_guess_mail_spool(void);
gboolean libbalsa_is_sending_mail(void);
void libbalsa_wait_for_sending_thread(gint max_seconds);
gchar *libbalsa_guess_pop_server(void);
gchar *libbalsa_guess_imap_server(void);
gchar *libbalsa_guess_ldap_server(void);
gchar *libbalsa_guess_imap_inbox(void);
gchar* libbalsa_date_to_utf8(const time_t *date, const gchar *date_string);
LibBalsaMessageStatus libbalsa_get_icon_from_flags(LibBalsaMessageFlag flags);
#ifdef USE_TLS
#include <openssl/ssl.h>
gboolean libbalsa_is_cert_known(X509* cert, long vfy_result);
void libbalsa_certs_destroy(void);
#endif
gboolean libbalsa_abort_on_timeout(const char *host);
#ifdef BALSA_USE_THREADS
#include <pthread.h>
pthread_t libbalsa_get_main_thread(void);
gboolean libbalsa_am_i_subthread(void);
void libbalsa_threads_init(void);
void libbalsa_threads_destroy(void);
gboolean libbalsa_threads_has_lock(void);
#else
#define libbalsa_am_i_subthread() FALSE
#define libbalsa_threads_has_lock() TRUE
#endif /* BALSA_USE_THREADS */
void libbalsa_message(const char *fmt, ...)
#ifdef __GNUC__
__attribute__ ((format (printf, 1, 2)))
#endif
;
gchar * libbalsa_rot(const gchar * pass);
typedef enum {
LIBBALSA_PROGRESS_NO = 0,
LIBBALSA_PROGRESS_YES
} LibBalsaProgress;
#define LIBBALSA_PROGRESS_INIT LIBBALSA_PROGRESS_NO
/* We will not use the progress bar if the number of increments is less
* than LIBBALSA_PROGRESS_MIN_COUNT, and we will not update the fraction
* if the time since the last update is less than
* LIBBALSA_PROGRESS_MIN_UPDATE_SECS seconds or if the fraction has
* increased by less than LIBBALSA_PROGRESS_MIN_UPDATE_STEP. */
#define LIBBALSA_PROGRESS_MIN_COUNT 400
#define LIBBALSA_PROGRESS_MIN_UPDATE_USECS 50000
#define LIBBALSA_PROGRESS_MIN_UPDATE_STEP 0.05
extern void (*libbalsa_progress_set_text) (LibBalsaProgress * progress,
const gchar * text,
guint total);
extern void (*libbalsa_progress_set_fraction) (LibBalsaProgress * progress,
gdouble fraction);
extern void (*libbalsa_progress_set_activity) (gboolean set,
const gchar * text);
/*
* Face and X-Face header support.
*/
gchar *libbalsa_get_header_from_path(const gchar * header,
const gchar * path, gsize * size,
GError ** err);
GtkWidget *libbalsa_get_image_from_face_header(const gchar * content,
GError ** err);
#if HAVE_COMPFACE
GtkWidget *libbalsa_get_image_from_x_face_header(const gchar * content,
GError ** err);
#endif /* HAVE_COMPFACE */
GQuark libbalsa_image_error_quark(void);
#define LIBBALSA_IMAGE_ERROR libbalsa_image_error_quark()
enum LibBalsaImageError {
LIBBALSA_IMAGE_ERROR_NO_DATA
#if HAVE_COMPFACE
,
LIBBALSA_IMAGE_ERROR_FORMAT,
LIBBALSA_IMAGE_ERROR_BUFFER,
LIBBALSA_IMAGE_ERROR_BAD_DATA
#endif /* HAVE_COMPFACE */
};
#if HAVE_GTKSOURCEVIEW
GtkWidget *libbalsa_source_view_new(gboolean highlight_phrases, GdkColor *q_colour);
#endif /* HAVE_GTKSOURCEVIEW */
#endif /* __LIBBALSA_H__ */
|
