-
Notifications
You must be signed in to change notification settings - Fork 5
/
dialogs.h
196 lines (148 loc) · 8.11 KB
/
dialogs.h
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
/*
* Off-the-Record Messaging plugin for pidgin
* Copyright (C) 2004-2018 Ian Goldberg, Rob Smits,
* Chris Alexander, Willy Lew,
* Nikita Borisov
* The pidgin-otrng contributors
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of version 2 of the GNU General Public License as
* published by the Free Software Foundation.
*
* 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., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
*/
#ifndef __OTRG_DIALOGS_H__
#define __OTRG_DIALOGS_H__
/* pidgin headers */
#include <notify.h>
/* libotr headers */
#include <libotr/proto.h>
#include <libotr/message.h>
#include "fingerprint.h"
#include "plugin-all.h"
/* The various help URLs */
#define BASE_HELPURL "https://otr-help.cypherpunks.ca/" PIDGIN_OTR_VERSION "/"
#define AUTHENTICATE_HELPURL BASE_HELPURL "authenticate.php"
#define SESSIONID_HELPURL BASE_HELPURL "sessionid.php"
#define UNVERIFIED_HELPURL BASE_HELPURL "unverified.php"
#define LEVELS_HELPURL BASE_HELPURL "levels.php"
#define SESSIONS_HELPURL BASE_HELPURL "sessions.php"
typedef struct s_OtrgDialogWait *OtrgDialogWaitHandle;
typedef struct {
void (*init)(void);
void (*cleanup)(void);
void (*notify_message)(PurpleNotifyMsgType type, const char *accountname,
const char *protocol, const char *username,
const char *title, const char *primary,
const char *secondary);
int (*display_otr_message)(const char *accountname, const char *protocol,
const char *username, const char *msg,
int force_create);
OtrgDialogWaitHandle (*private_key_wait_start)(const char *account,
const char *protocol);
void (*private_key_wait_done)(OtrgDialogWaitHandle handle);
void (*unknown_fingerprint)(OtrlUserState us, const char *accountname,
const char *protocol, const char *who,
const unsigned char fingerprint[20]);
void (*verify_fingerprint)(otrng_client_id_s client_id,
otrng_plugin_fingerprint_s *fprint);
void (*socialist_millionaires)(const otrng_plugin_conversation *conv,
const char *question, gboolean responder);
void (*update_smp)(const otrng_plugin_conversation *context,
otrng_smp_event smp_event, double progress_level);
void (*connected)(const otrng_plugin_conversation *conv);
void (*disconnected)(const otrng_plugin_conversation *conv);
void (*stillconnected)(ConnContext *context);
void (*finished)(const char *accountname, const char *protocol,
const char *username);
void (*resensitize_all)(void);
void (*new_conv)(PurpleConversation *conv);
void (*remove_conv)(PurpleConversation *conv);
} OtrgDialogUiOps;
/* Set the UI ops */
void otrng_dialog_set_ui_ops(const OtrgDialogUiOps *ops);
/* Get the UI ops */
const OtrgDialogUiOps *otrng_dialog_get_ui_ops(void);
/* Initialize the OTR dialog subsystem */
void otrng_dialog_init(void);
/* Deinitialize the OTR dialog subsystem */
void otrng_dialog_cleanup(void);
/* This is just like pidgin_notify_message, except: (a) it doesn't grab
* keyboard focus, (b) the button is "OK" instead of "Close", and (c)
* the labels aren't limited to 2K. */
void otrng_dialog_notify_message(PurpleNotifyMsgType type,
const char *accountname, const char *protocol,
const char *username, const char *title,
const char *primary, const char *secondary);
/* Put up the error version of otrng_dialog_notify_message */
void otrng_dialog_notify_error(const char *accountname, const char *protocol,
const char *username, const char *title,
const char *primary, const char *secondary);
/* Put up the warning version of otrng_dialog_notify_message */
void otrng_dialog_notify_warning(const char *accountname, const char *protocol,
const char *username, const char *title,
const char *primary, const char *secondary);
/* Put up the info version of otrng_dialog_notify_message */
void otrng_dialog_notify_info(const char *accountname, const char *protocol,
const char *username, const char *title,
const char *primary, const char *secondary);
/* Display an OTR control message for the given accountname / protocol /
* username conversation. Return 0 on success, non-0 on error (in which
* case the message will be displayed inline as a received message). */
int otrng_dialog_display_otr_message(const char *accountname,
const char *protocol, const char *username,
const char *msg, int force_create);
/* Put up a Please Wait dialog. This dialog can not be cancelled.
* Return a handle that must eventually be passed to
* otrng_dialog_private_key_wait_done. */
OtrgDialogWaitHandle otrng_dialog_private_key_wait_start(const char *account,
const char *protocol);
/* End a Please Wait dialog. */
void otrng_dialog_private_key_wait_done(OtrgDialogWaitHandle handle);
/* Show a dialog informing the user that a correspondent (who) has sent
* us a Key Exchange Message (kem) that contains an unknown fingerprint. */
void otrng_dialog_unknown_fingerprint(OtrlUserState us, const char *accountname,
const char *protocol, const char *who,
const unsigned char fingerprint[20]);
/* Show a dialog asking the user to verify the given fingerprint. */
void otrng_dialog_verify_fingerprint(otrng_client_id_s client_id,
otrng_plugin_fingerprint_s *fprint);
/* Show a dialog asking the user to give an SMP secret. */
void otrng_dialog_socialist_millionaires(const otrng_plugin_conversation *conv);
/* Show a dialog asking the user to give an SMP secret, prompting with a
* question. */
void otrng_dialog_socialist_millionaires_q(
const otrng_plugin_conversation *conv, const char *question);
/* Update the status of an ongoing socialist millionaires protocol. */
void otrng_dialog_update_smp(const otrng_plugin_conversation *context,
otrng_smp_event smp_event, double progress_level);
/* Call this when a context transitions to ENCRYPTED. */
void otrng_dialog_conversation_connected(otrng_plugin_conversation *conv);
void otrng_dialog_connected(ConnContext *context);
/* Call this when a context transitions to PLAINTEXT. */
void otrng_dialog_conversation_disconnected(
const otrng_plugin_conversation *conv);
void otrng_dialog_disconnected(ConnContext *context);
/* Call this when we receive a Key Exchange message that doesn't cause
* our state to change (because it was just the keys we knew already). */
void otrng_dialog_stillconnected(ConnContext *context);
/* Call this if the remote user terminates his end of an ENCRYPTED
* connection, and lets us know. */
void otrng_dialog_finished(const char *accountname, const char *protocol,
const char *username);
/* Set all OTR buttons to "sensitive" or "insensitive" as appropriate.
* Call this when accounts are logged in or out. */
void otrng_dialog_resensitize_all(void);
/* Set up the per-conversation information display */
void otrng_dialog_new_conv(PurpleConversation *conv);
/* Remove the per-conversation information display */
void otrng_dialog_remove_conv(PurpleConversation *conv);
#endif