w32: Remove all support for WindowsCE
[gpgme.git] / src / ops.h
1 /* ops.h - Internal operation support.
2    Copyright (C) 2000 Werner Koch (dd9jn)
3    Copyright (C) 2001, 2002, 2003, 2004, 2005 g10 Code GmbH
4
5    This file is part of GPGME.
6
7    GPGME is free software; you can redistribute it and/or modify it
8    under the terms of the GNU Lesser General Public License as
9    published by the Free Software Foundation; either version 2.1 of
10    the License, or (at your option) any later version.
11
12    GPGME is distributed in the hope that it will be useful, but
13    WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
15    Lesser General Public License for more details.
16
17    You should have received a copy of the GNU Lesser General Public
18    License along with this program; if not, write to the Free Software
19    Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
20    02111-1307, USA.  */
21
22 #ifndef OPS_H
23 #define OPS_H
24
25 #include "gpgme.h"
26 #include "context.h"
27
28 \f
29 /* From gpgme.c.  */
30 gpgme_error_t _gpgme_cancel_with_err (gpgme_ctx_t ctx, gpg_error_t ctx_err,
31                                       gpg_error_t op_err);
32 /* Clear all notation data from the context.  */
33 void _gpgme_sig_notation_clear (gpgme_ctx_t ctx);
34
35 void _gpgme_release_result (gpgme_ctx_t ctx);
36
37 \f
38 /* From wait.c.  */
39 gpgme_error_t _gpgme_wait_one (gpgme_ctx_t ctx);
40 gpgme_error_t _gpgme_wait_one_ext (gpgme_ctx_t ctx, gpgme_error_t *op_err);
41 gpgme_error_t _gpgme_wait_on_condition (gpgme_ctx_t ctx, volatile int *cond,
42                                         gpgme_error_t *op_err);
43
44 \f
45 /* From data.c.  */
46 gpgme_error_t _gpgme_data_inbound_handler (void *opaque, int fd);
47 gpgme_error_t _gpgme_data_outbound_handler (void *opaque, int fd);
48
49 \f
50 /* From op-support.c.  */
51
52 /* Find or create the op data object of type TYPE.  */
53 gpgme_error_t _gpgme_op_data_lookup (gpgme_ctx_t ctx, ctx_op_data_id_t type,
54                                      void **hook, int size,
55                                      void (*cleanup) (void *));
56
57 /* Prepare a new operation on CTX.  */
58 gpgme_error_t _gpgme_op_reset (gpgme_ctx_t ctx, int synchronous);
59
60 /* Parse the KEY_CONSIDERED status line.  */
61 gpgme_error_t _gpgme_parse_key_considered (const char *args,
62                                            char **r_fpr, unsigned int *r_flags);
63
64 /* Parse the INV_RECP status line in ARGS and return the result in
65    KEY.  */
66 gpgme_error_t _gpgme_parse_inv_recp (char *args, int for_signing,
67                                      const char *kc_fpr, unsigned int kc_flags,
68                                      gpgme_invalid_key_t *key);
69
70 /* Parse the PLAINTEXT status line in ARGS and return the result in
71    FILENAMEP and R_MIME.  */
72 gpgme_error_t _gpgme_parse_plaintext (char *args, char **filenamep,int *r_mime);
73
74 /* Parse a FAILURE status line and return the error code.  ARGS is
75    modified to contain the location part.  */
76 gpgme_error_t _gpgme_parse_failure (char *args);
77
78
79 \f
80 /* From verify.c.  */
81 gpgme_error_t _gpgme_op_verify_init_result (gpgme_ctx_t ctx);
82 gpgme_error_t _gpgme_verify_status_handler (void *priv,
83                                             gpgme_status_code_t code,
84                                             char *args);
85
86 \f
87 /* From decrypt.c.  */
88 gpgme_error_t _gpgme_op_decrypt_init_result (gpgme_ctx_t ctx,
89                                              gpgme_data_t plaintext);
90 gpgme_error_t _gpgme_decrypt_status_handler (void *priv,
91                                              gpgme_status_code_t code,
92                                              char *args);
93 gpgme_error_t _gpgme_decrypt_start (gpgme_ctx_t ctx, int synchronous,
94                                     gpgme_decrypt_flags_t flags,
95                                     gpgme_data_t cipher, gpgme_data_t plain);
96
97 \f
98 /* From signers.c.  */
99 void _gpgme_signers_clear (gpgme_ctx_t ctx);
100
101 /* From sign.c.  */
102
103 /* Create an initial op data object for signing.  Needs to be called
104    once before calling _gpgme_sign_status_handler.  */
105 gpgme_error_t _gpgme_op_sign_init_result (gpgme_ctx_t ctx);
106
107 /* Process a status line for signing operations.  */
108 gpgme_error_t _gpgme_sign_status_handler (void *priv,
109                                           gpgme_status_code_t code,
110                                           char *args);
111
112 \f
113 /* From encrypt.c.  */
114
115 /* Create an initial op data object for encrypt.  Needs to be called
116    once before calling _gpgme_encrypt_status_handler.  */
117 gpgme_error_t _gpgme_op_encrypt_init_result (gpgme_ctx_t ctx);
118
119 /* Process a status line for encryption operations.  */
120 gpgme_error_t _gpgme_encrypt_status_handler (void *priv,
121                                              gpgme_status_code_t code,
122                                              char *args);
123
124 \f
125 /* From passphrase.c.  */
126 gpgme_error_t _gpgme_passphrase_status_handler (void *priv,
127                                                 gpgme_status_code_t code,
128                                                 char *args);
129 gpgme_error_t _gpgme_passphrase_command_handler (void *opaque,
130                                                  gpgme_status_code_t code,
131                                                  const char *key, int fd,
132                                                  int *processed);
133
134 \f
135 /* From progress.c.  */
136 gpgme_error_t _gpgme_progress_status_handler (void *priv,
137                                               gpgme_status_code_t code,
138                                               char *args);
139
140 \f
141 /* From key.c.  */
142 gpgme_error_t _gpgme_key_new (gpgme_key_t *r_key);
143 gpgme_error_t _gpgme_key_add_subkey (gpgme_key_t key,
144                                      gpgme_subkey_t *r_subkey);
145 gpgme_error_t _gpgme_key_append_name (gpgme_key_t key,
146                                       const char *src, int convert);
147 gpgme_key_sig_t _gpgme_key_add_sig (gpgme_key_t key, char *src);
148
149
150 \f
151 /* From keylist.c.  */
152 void _gpgme_op_keylist_event_cb (void *data, gpgme_event_io_t type,
153                                  void *type_data);
154
155 \f
156 /* From trust-item.c.  */
157
158 /* Create a new trust item.  */
159 gpgme_error_t _gpgme_trust_item_new (gpgme_trust_item_t *r_item);
160
161 \f
162 /* From trustlist.c.  */
163 void _gpgme_op_trustlist_event_cb (void *data, gpgme_event_io_t type,
164                                    void *type_data);
165
166 \f
167 /* From version.c.  */
168
169 /* Return true if MY_VERSION is at least REQ_VERSION, and false
170    otherwise.  */
171 int _gpgme_compare_versions (const char *my_version,
172                              const char *req_version);
173 char *_gpgme_get_program_version (const char *const path);
174
175 \f
176 /* From sig-notation.c.  */
177
178 /* Create a new, empty signature notation data object.  */
179 gpgme_error_t _gpgme_sig_notation_create (gpgme_sig_notation_t *notationp,
180                                           const char *name, int name_len,
181                                           const char *value, int value_len,
182                                           gpgme_sig_notation_flags_t flags);
183
184 /* Free the signature notation object and all associated resources.
185    The object must already be removed from any linked list as the next
186    pointer is ignored.  */
187 void _gpgme_sig_notation_free (gpgme_sig_notation_t notation);
188
189 /* Parse a notation or policy URL subpacket.  If the packet type is
190    not known, return no error but NULL in NOTATION.  */
191 gpgme_error_t _gpgme_parse_notation (gpgme_sig_notation_t *notationp,
192                                      int type, int pkflags, int len,
193                                      char *data);
194
195 #endif /* OPS_H */