Add a few key flags - needs the lates CVS gpg
[gpgme.git] / gpgme / context.h
1 /* context.h 
2  *      Copyright (C) 2000 Werner Koch (dd9jn)
3  *
4  * This file is part of GPGME.
5  *
6  * GPGME is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GPGME is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #ifndef CONTEXT_H
22 #define CONTEXT_H
23
24 #include "gpgme.h"
25 #include "types.h"
26 #include "rungpg.h"  /* for GpgObject */
27
28 typedef enum {
29     RESULT_TYPE_NONE = 0,
30     RESULT_TYPE_VERIFY,
31     RESULT_TYPE_DECRYPT,
32     RESULT_TYPE_SIGN,
33 } ResultType;
34
35
36 struct key_queue_item_s {
37     struct key_queue_item_s *next;
38     GpgmeKey key;
39 };
40 struct trust_queue_item_s {
41     struct trust_queue_item_s *next;
42     GpgmeTrustItem item;
43 };
44
45
46 /* Currently we need it at several places, so we put the definition 
47  * into this header file */
48 struct gpgme_context_s {
49     int initialized;
50     int pending;   /* a gpg request is still pending */
51
52     /* at some points we need to allocate memory but we are not
53      * able to handle a malloc problem at that point, so we set this
54      * flag to indicate this condition */
55     int out_of_core;   
56     int cancel;    /* cancel operation request */
57
58
59     GpgObject gpg; /* the running gpg process */
60
61     int verbosity;  /* level of verbosity to use */
62     int use_armor;  
63     int use_textmode;
64     int keylist_mode;
65
66     int signers_size;  /* size of the following array */
67     GpgmeKey *signers;
68
69     ResultType result_type;
70     union {
71         VerifyResult verify;
72         DecryptResult decrypt;
73         SignResult sign;
74     } result;
75
76     GpgmeData notation;    /* last signature notation */
77
78     GpgmeKey tmp_key;       /* used by keylist.c */
79     volatile int key_cond;  /* something new is available */
80     struct key_queue_item_s *key_queue;
81     struct trust_queue_item_s *trust_queue;
82
83     GpgmePassphraseCb passphrase_cb;
84     void *passphrase_cb_value;
85
86     GpgmeProgressCb progress_cb;
87     void *progress_cb_value;
88
89     GpgmeData help_data_1;
90 };
91
92
93 struct gpgme_data_s {
94     size_t len;
95     const char *data;
96     GpgmeDataType type;
97     GpgmeDataMode mode;
98
99     int (*read_cb)( void *, char *, size_t, size_t *);
100     void *read_cb_value;
101     int read_cb_eof;
102
103     size_t readpos;
104     size_t writepos;
105     size_t private_len;
106     char *private_buffer;
107 };
108
109 struct user_id_s {
110     struct user_id_s *next;
111     unsigned int revoked:1;
112     unsigned int invalid:1;
113     GpgmeValidity validity; 
114     const char *name_part;    /* all 3 point into strings behind name */
115     const char *email_part;   /* or to read-only strings */
116     const char *comment_part;
117     char name[1];
118 };
119
120 struct gpgme_recipients_s {
121     struct user_id_s *list;
122     int checked;   /* wether the recipients are all valid */
123 };
124
125
126 #define fail_on_pending_request(c)                            \
127           do {                                                \
128                 if (!(c))         return GPGME_Invalid_Value; \
129                 if ((c)->pending) return GPGME_Busy;          \
130              } while (0)
131
132 #define wait_on_request_or_fail(c)                            \
133           do {                                                \
134                 if (!(c))          return GPGME_Invalid_Value;\
135                 if (!(c)->pending) return GPGME_No_Request;   \
136                 gpgme_wait ((c), 1);                          \
137              } while (0)
138
139
140
141 #endif /* CONTEXT_H */
142
143
144