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
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
|
/***************************************************************************
begin : Mon Mar 01 2004
copyright : (C) 2004-2010 by Martin Preuss
email : martin@libchipcard.de
***************************************************************************
* Please see toplevel file COPYING for license details *
***************************************************************************/
#ifdef HAVE_CONFIG_H
# include <config.h>
#endif
#undef BUILDING_LIBCHIPCARD2_DLL
#include <chipcard/chipcard.h>
#include <chipcard/client.h>
#include <chipcard/cards/kvkcard.h>
/*
* While tutorial1 only works with base classes we are now to understand how
* more complex card classes can be used.
* This tutorial waits for a German medical card to be inserted, reads the
* information stored on the card and prints it to the standard output
* channel.
*
* The only parts which differ a marked below by lines of equation marks,
* the rest is pretty much the same as in the other tutorials.
*
* Usage:
* tutorial2
*/
/* This function explains an error */
void showError(LC_CARD *card, LC_CLIENT_RESULT res,
const char *failedCommand)
{
const char *s;
switch (res) {
case LC_Client_ResultOk:
s="Ok.";
break;
case LC_Client_ResultWait:
s="Timeout.";
break;
case LC_Client_ResultIpcError:
s="IPC error.";
break;
case LC_Client_ResultCmdError:
s="Command error.";
break;
case LC_Client_ResultDataError:
s="Data error.";
break;
case LC_Client_ResultAborted:
s="Aborted.";
break;
case LC_Client_ResultInvalid:
s="Invalid argument to command.";
break;
case LC_Client_ResultInternal:
s="Internal error.";
break;
case LC_Client_ResultGeneric:
s="Generic error.";
break;
default:
s="Unknown error.";
break;
}
fprintf(stderr, "Error in \"%s\": %s\n", failedCommand, s);
if (card && res==LC_Client_ResultCmdError) {
int sw1;
int sw2;
sw1=LC_Card_GetLastSW1(card);
sw2=LC_Card_GetLastSW2(card);
fprintf(stderr, " Last card command result:\n");
if (sw1!=-1 && sw2!=-1)
fprintf(stderr, " SW1=%02x, SW2=%02x\n", sw1, sw2);
s=LC_Card_GetLastResult(card);
if (s)
fprintf(stderr, " Result: %s\n", s);
s=LC_Card_GetLastText(card);
if (s)
fprintf(stderr, " Text : %s\n", s);
}
}
int main(int argc, char **argv)
{
LC_CLIENT *cl;
LC_CARD *card=0;
LC_CLIENT_RESULT res;
int rv;
GWEN_DB_NODE *dbData=NULL;
cl=LC_Client_new("tutorial2", "1.0");
res=LC_Client_Init(cl);
if (res!=LC_Client_ResultOk) {
showError(card, res, "Init");
LC_Client_free(cl);
return 1;
}
fprintf(stderr, "INFO: Connecting to server.\n");
res=LC_Client_Start(cl);
if (res!=LC_Client_ResultOk) {
showError(card, res, "StartWait");
LC_Client_free(cl);
return 2;
}
fprintf(stderr, "Please insert a German medical card.\n");
res=LC_Client_GetNextCard(cl, &card, 30);
if (res!=LC_Client_ResultOk) {
showError(card, res, "GetNextCard");
LC_Client_Stop(cl);
LC_Client_free(cl);
return 2;
}
/* stop waiting */
fprintf(stderr, "INFO: Telling the server that we need no more cards.\n");
res=LC_Client_Stop(cl);
if (res!=LC_Client_ResultOk) {
showError(card, res, "Stop");
LC_Client_ReleaseCard(cl, card);
LC_Card_free(card);
LC_Client_free(cl);
return 2;
}
/* ======================================================================
* Until now we only handled basic card functions as the other tutorials
* did.
* The inserted card is supposed to be a German medical card, so we need
* to tell Libchipcard2 that we want to use it as such. This makes sure that
* the correct card commands for the reader/card combination is used
* internally.
* The following function also sets more specific functions for the complex
* card type to be called internally upon LC_Card_Open() and
* LC_Card_Close(), so we need to call the _ExtendCard() function before
* the function LC_Card_Open() !
* The specific open() function for a German medical card for example reads
* the known fields from the card.
* This function seldomly fails, however, you should always be prepared
* that it could.
*
* If you later want to use the card as a memory card you can just
* unextend the card (LC_KVKCard_UnextendCard()) and then extend it as
* a memory card, like in:
* LC_KVKCard_UnextentCard(card);
* LC_MemoryCard_ExtendCard(card);
* Please always remember to unextend an extended card before extending it
* as a different type.
*
* By the way: Since a German medical card basically is a memory card you
* would in this case not need to unextend it, since internally the function
* LC_KVKCard_ExtendCard() also extends it as such.
*
* This is a fine example of the heritage model used in Libchipcard2:
* You could also create your own card type by extending an existing one.
*/
rv=LC_KVKCard_ExtendCard(card);
if (rv) {
fprintf(stderr, "Could not extend card as German medical card\n");
return 2;
}
/* open card */
fprintf(stderr, "INFO: Opening card.\n");
res=LC_Card_Open(card);
if (res!=LC_Client_ResultOk) {
showError(card, res, "CardOpen");
LC_Client_ReleaseCard(cl, card);
LC_Card_free(card);
LC_Client_free(cl);
return 2;
}
/* Since the card has been extended as a German medical card we can now
* use the functions of that module.
* In this case we retrieve the user information stored on the card.
* Please note that there is no data if the card is corrupted (e.g. a bad
* checksum).
*/
/* dbData=LC_KVKCard_GetCardData(card); */ /* FIXME: deprecated function */
if (!dbData) {
fprintf(stderr, "ERROR: No card data available.\n");
LC_Client_ReleaseCard(cl, card);
LC_Card_free(card);
LC_Client_free(cl);
return 2;
}
/* The data returned is stored in a GWEN_DB which we now present to the
* user (see the API documentation in Gwenhywfar for a description of
* a GWEN_DB, search for GWEN_DB_NODE).
*/
fprintf(stderr, "INFO: I got this card:\n");
GWEN_DB_Dump(dbData, 2);
/* ====================================================================== */
/* close card */
fprintf(stderr, "INFO: Closing card.\n");
res=LC_Card_Close(card);
if (res!=LC_Client_ResultOk) {
showError(card, res, "CardClose");
LC_Client_ReleaseCard(cl, card);
LC_Card_free(card);
LC_Client_free(cl);
return 2;
}
fprintf(stderr, "INFO: Card closed.\n");
/* release card */
res=LC_Client_ReleaseCard(cl, card);
if (res!=LC_Client_ResultOk) {
showError(card, res, "CardRelease");
LC_Card_free(card);
LC_Client_free(cl);
return 2;
}
/* cleanup */
LC_Card_free(card);
LC_Client_free(cl);
return 0;
}
|
