2008-08-28 [colin] 3.5.0cvs78
[claws.git] / src / privacy.h
1 /*
2  * Sylpheed -- a GTK+ based, lightweight, and fast e-mail client
3  * Copyright (C) 1999-2007 Hiroyuki Yamamoto & the Claws Mail team
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 3 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful,
11  * but WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13  * GNU General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program. If not, see <http://www.gnu.org/licenses/>.
17  * 
18  */
19
20 #ifndef PRIVACY_H
21 #define PRIVACY_H
22
23 typedef struct _PrivacySystem PrivacySystem;
24 typedef struct _PrivacyData PrivacyData;
25
26 typedef enum {
27         SIGNATURE_UNCHECKED,
28         SIGNATURE_OK,
29         SIGNATURE_WARN,
30         SIGNATURE_KEY_EXPIRED,
31         SIGNATURE_INVALID,
32         SIGNATURE_CHECK_FAILED,
33         SIGNATURE_CHECK_TIMEOUT
34 } SignatureStatus;
35
36 #include <glib.h>
37
38 #include "procmime.h"
39 #include "prefs_account.h"
40
41 void privacy_register_system                    (PrivacySystem *system);
42 void privacy_unregister_system                  (PrivacySystem *system);
43
44 void privacy_free_privacydata                   (PrivacyData *);
45
46 void privacy_msginfo_get_signed_state           (MsgInfo *);
47 gboolean privacy_mimeinfo_is_signed             (MimeInfo *);
48 gint privacy_mimeinfo_check_signature           (MimeInfo *);
49 SignatureStatus privacy_mimeinfo_get_sig_status (MimeInfo *);
50 gchar *privacy_mimeinfo_sig_info_short          (MimeInfo *);
51 gchar *privacy_mimeinfo_sig_info_full           (MimeInfo *);
52
53 gboolean privacy_mimeinfo_is_encrypted          (MimeInfo *);
54 gint privacy_mimeinfo_decrypt                   (MimeInfo *);
55
56 GSList *privacy_get_system_ids                  ();
57 const gchar *privacy_system_get_name            (const gchar *);
58 gboolean privacy_system_can_sign                (const gchar *);
59 gboolean privacy_system_can_encrypt             (const gchar *);
60
61 gboolean privacy_sign                           (const gchar  *system,
62                                                  MimeInfo     *mimeinfo,
63                                                  PrefsAccount *account);
64 gchar *privacy_get_encrypt_data                 (const gchar  *system,
65                                                  GSList       *recp_names);
66 const gchar *privacy_get_encrypt_warning        (const gchar  *system);
67 gboolean privacy_encrypt                        (const gchar  *system,
68                                                  MimeInfo     *mimeinfo,
69                                                  const gchar  *encdata);
70
71 void privacy_set_error                          (const gchar *format, ...) G_GNUC_PRINTF(1, 2);
72 void privacy_reset_error                                (void);
73 gboolean privacy_peek_error                             (void);
74 const gchar *privacy_get_error                  (void);
75
76 struct _PrivacySystem {
77         /** Identifier for the PrivacySystem that can use in config files */
78         gchar            *id;
79         /** Human readable name for the PrivacySystem for the user interface */
80         gchar            *name;
81
82         void             (*free_privacydata)    (PrivacyData *data);
83
84         gboolean         (*is_signed)           (MimeInfo *mimeinfo);
85         gint             (*check_signature)     (MimeInfo *mimeinfo);
86         SignatureStatus  (*get_sig_status)      (MimeInfo *mimeinfo);
87         gchar           *(*get_sig_info_short)  (MimeInfo *mimeinfo);
88         gchar           *(*get_sig_info_full)   (MimeInfo *mimeinfo);
89
90         gboolean         (*is_encrypted)        (MimeInfo *mimeinfo);
91         MimeInfo        *(*decrypt)             (MimeInfo *mimeinfo);
92
93         gboolean           can_sign;
94         gboolean         (*sign)                (MimeInfo *mimeinfo,
95                                                  PrefsAccount *account);
96
97         gboolean           can_encrypt;
98         gchar           *(*get_encrypt_data)    (GSList *recp_names);
99         gboolean         (*encrypt)             (MimeInfo *mimeinfo,
100                                                  const gchar *encrypt_data);
101         const gchar     *(*get_encrypt_warning) (void);
102         void             (*inhibit_encrypt_warning)     (gboolean inhibit);
103 };
104
105 struct _PrivacyData {
106         PrivacySystem   *system;
107 };
108
109 void privacy_inhibit_encrypt_warning            (const gchar *id,
110                                                  gboolean inhibit);
111
112 #endif /* PRIVACY_H */