PIN caching of cards does now work.
[gnupg.git] / scd / app-common.h
1 /* app-common.h - Common declarations for all card applications
2  *      Copyright (C) 2003, 2005 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG 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  * GnuPG 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  * $Id$
21  */
22
23 #ifndef GNUPG_SCD_APP_COMMON_H
24 #define GNUPG_SCD_APP_COMMON_H
25
26 #if GNUPG_MAJOR_VERSION == 1
27 # ifdef ENABLE_AGENT_SUPPORT
28 # include "assuan.h"
29 # endif 
30 #else
31 # include <ksba.h>
32 #endif
33
34
35 struct app_local_s;  /* Defined by all app-*.c.  */
36
37 struct app_ctx_s {
38   int initialized;  /* The application has been initialied and the
39                        function pointers may be used.  Note that for
40                        unsupported operations the particular
41                        function pointer is set to NULL */
42
43   int ref_count;    /* Number of connections currently using this
44                        application context.  fixme: We might want to
45                        merg this witghn INITIALIZED above. */
46
47   int slot;         /* Used reader. */
48
49   /* If this is used by GnuPG 1.4 we need to know the assuan context
50      in case we need to divert the operation to an already running
51      agent.  This if ASSUAN_CTX is not NULL we take this as indication
52      that all operations are diverted to gpg-agent. */
53 #if GNUPG_MAJOR_VERSION == 1
54   assuan_context_t assuan_ctx;
55 #endif /*GNUPG_MAJOR_VERSION == 1*/
56
57   unsigned char *serialno; /* Serialnumber in raw form, allocated. */
58   size_t serialnolen;      /* Length in octets of serialnumber. */
59   const char *apptype;
60   unsigned int card_version;
61   int did_chv1;
62   int force_chv1;   /* True if the card does not cache CHV1. */
63   int did_chv2;
64   int did_chv3;
65   struct app_local_s *app_local;  /* Local to the application. */
66   struct {
67     void (*deinit) (app_t app);
68     gpg_error_t (*learn_status) (app_t app, ctrl_t ctrl);
69     gpg_error_t (*readcert) (app_t app, const char *certid,
70                      unsigned char **cert, size_t *certlen);
71     gpg_error_t (*readkey) (app_t app, const char *certid,
72                     unsigned char **pk, size_t *pklen);
73     gpg_error_t (*getattr) (app_t app, ctrl_t ctrl, const char *name);
74     gpg_error_t (*setattr) (app_t app, const char *name,
75                     gpg_error_t (*pincb)(void*, const char *, char **),
76                     void *pincb_arg,
77                     const unsigned char *value, size_t valuelen);
78     gpg_error_t (*sign) (app_t app,
79                  const char *keyidstr, int hashalgo,
80                  gpg_error_t (*pincb)(void*, const char *, char **),
81                  void *pincb_arg,
82                  const void *indata, size_t indatalen,
83                  unsigned char **outdata, size_t *outdatalen );
84     gpg_error_t (*auth) (app_t app, const char *keyidstr,
85                  gpg_error_t (*pincb)(void*, const char *, char **),
86                  void *pincb_arg,
87                  const void *indata, size_t indatalen,
88                  unsigned char **outdata, size_t *outdatalen);
89     gpg_error_t (*decipher) (app_t app, const char *keyidstr,
90                      gpg_error_t (*pincb)(void*, const char *, char **),
91                      void *pincb_arg,
92                      const void *indata, size_t indatalen,
93                      unsigned char **outdata, size_t *outdatalen);
94     gpg_error_t (*writekey) (app_t app, ctrl_t ctrl,
95                              const char *certid, unsigned int flags,
96                              gpg_error_t (*pincb)(void*,const char *,char **),
97                              void *pincb_arg,
98                              const unsigned char *pk, size_t pklen);
99     gpg_error_t (*genkey) (app_t app, ctrl_t ctrl,
100                    const char *keynostr, unsigned int flags,
101                    gpg_error_t (*pincb)(void*, const char *, char **),
102                    void *pincb_arg);
103     gpg_error_t (*change_pin) (app_t app, ctrl_t ctrl,
104                        const char *chvnostr, int reset_mode,
105                        gpg_error_t (*pincb)(void*, const char *, char **),
106                        void *pincb_arg);
107     gpg_error_t (*check_pin) (app_t app, const char *keyidstr,
108                       gpg_error_t (*pincb)(void*, const char *, char **),
109                       void *pincb_arg);
110   } fnc;
111
112 };
113
114 #if GNUPG_MAJOR_VERSION == 1
115 gpg_error_t app_select_openpgp (app_t app);
116 gpg_error_t app_get_serial_and_stamp (app_t app, char **serial, time_t *stamp);
117 gpg_error_t app_openpgp_storekey (app_t app, int keyno,
118                           unsigned char *template, size_t template_len,
119                           time_t created_at,
120                           const unsigned char *m, size_t mlen,
121                           const unsigned char *e, size_t elen,
122                           gpg_error_t (*pincb)(void*, const char *, char **),
123                           void *pincb_arg);
124 #else
125 /*-- app-help.c --*/
126 gpg_error_t app_help_get_keygrip_string (ksba_cert_t cert, char *hexkeygrip);
127 size_t app_help_read_length_of_cert (int slot, int fid, size_t *r_certoff);
128
129
130 /*-- app.c --*/
131 void app_dump_state (void);
132 void application_notify_card_removed (int slot);
133 gpg_error_t check_application_conflict (ctrl_t ctrl, const char *name);
134 gpg_error_t select_application (ctrl_t ctrl, int slot, const char *name,
135                                 app_t *r_app);
136 void release_application (app_t app);
137 gpg_error_t app_munge_serialno (app_t app);
138 gpg_error_t app_get_serial_and_stamp (app_t app, char **serial, time_t *stamp);
139 gpg_error_t app_write_learn_status (app_t app, ctrl_t ctrl);
140 gpg_error_t app_readcert (app_t app, const char *certid,
141                   unsigned char **cert, size_t *certlen);
142 gpg_error_t app_readkey (app_t app, const char *keyid,
143                  unsigned char **pk, size_t *pklen);
144 gpg_error_t app_getattr (app_t app, ctrl_t ctrl, const char *name);
145 gpg_error_t app_setattr (app_t app, const char *name,
146                  gpg_error_t (*pincb)(void*, const char *, char **),
147                  void *pincb_arg,
148                  const unsigned char *value, size_t valuelen);
149 gpg_error_t app_sign (app_t app, const char *keyidstr, int hashalgo,
150               gpg_error_t (*pincb)(void*, const char *, char **),
151               void *pincb_arg,
152               const void *indata, size_t indatalen,
153               unsigned char **outdata, size_t *outdatalen );
154 gpg_error_t app_auth (app_t app, const char *keyidstr,
155               gpg_error_t (*pincb)(void*, const char *, char **),
156               void *pincb_arg,
157               const void *indata, size_t indatalen,
158               unsigned char **outdata, size_t *outdatalen);
159 gpg_error_t app_decipher (app_t app, const char *keyidstr,
160                   gpg_error_t (*pincb)(void*, const char *, char **),
161                   void *pincb_arg,
162                   const void *indata, size_t indatalen,
163                   unsigned char **outdata, size_t *outdatalen );
164 gpg_error_t app_writekey (app_t app, ctrl_t ctrl,
165                           const char *keyidstr, unsigned int flags,
166                           gpg_error_t (*pincb)(void*, const char *, char **),
167                           void *pincb_arg,
168                           const unsigned char *keydata, size_t keydatalen);
169 gpg_error_t app_genkey (app_t app, ctrl_t ctrl,
170                 const char *keynostr, unsigned int flags,
171                 gpg_error_t (*pincb)(void*, const char *, char **),
172                 void *pincb_arg);
173 gpg_error_t app_get_challenge (app_t app, size_t nbytes,
174                                unsigned char *buffer);
175 gpg_error_t app_change_pin (app_t app, ctrl_t ctrl,
176                     const char *chvnostr, int reset_mode,
177                     gpg_error_t (*pincb)(void*, const char *, char **),
178                     void *pincb_arg);
179 gpg_error_t app_check_pin (app_t app, const char *keyidstr,
180                    gpg_error_t (*pincb)(void*, const char *, char **),
181                    void *pincb_arg);
182
183
184 /*-- app-openpgp.c --*/
185 gpg_error_t app_select_openpgp (app_t app);
186
187 /*-- app-nks.c --*/
188 gpg_error_t app_select_nks (app_t app);
189
190 /*-- app-dinsig.c --*/
191 gpg_error_t app_select_dinsig (app_t app);
192
193 /*-- app-p15.c --*/
194 gpg_error_t app_select_p15 (app_t app);
195
196
197 #endif
198
199
200
201 #endif /*GNUPG_SCD_APP_COMMON_H*/
202
203
204