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
|
/***************************************************************************
$RCSfile$
-------------------
cvs : $Id: tutorial1b.c 167 2006-03-06 23:26:16Z aquamaniac $
begin : Mon Mar 01 2004
copyright : (C) 2004 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 <chipcard2/chipcard2.h>
#include <chipcard2-client/client/client.h>
/*
* This is a small tutorial on how to use the basic functions of
* libchipcard2. It just waits for a card to be inserted and prints some
* card's information.
* This is the most basic type of application using a chipcard, no error
* checking is performed.
*
* This tutorial is intended to show the basics only.
* After studying this tutorial you should advance to the next one, which
* will add some error checking.
*
* Usage:
* tutorial1b
*/
int main(int argc, char **argv) {
/* The basic object of Libchipcard2 itself is LC_CLIENT.
* You must create and initialize such an object before doing anything
* with Libchipcard2.
*/
LC_CLIENT *cl;
/* The other central object is LC_CARD. This is the object most card
* commands operate on.
*/
LC_CARD *card;
/* Create an instance of Libchipcard2.
* Libchipcard2 wants to know what application is requesting its service to
* improve server-side logging. It also makes it easier to debug
* Libchipcard2.
* The last parameter is the path to the data folder of Libchipcard2.
* We don't want any special handling here so we provide a NULL to make
* Libchipcard2 use its default path.
*/
cl=LC_Client_new("tutorial1b", "1.0", 0);
/* Initialize Libchipcard2 by reading its configuration file.
* Again, we don't want special treatment so we provide a NULL for the
* filename thus making Libchipcard2 use its default configuration file.
*/
LC_Client_ReadConfigFile(cl, 0);
/* We now need to tell Libchipcard2 that we are interested in chipcards.
* After sending this command the chipcard server will notify us about
* available cards.
* Only now the server will be connected, and if we are the only client
* then the server now starts acquiring card readers.
* The two latter arguments are reserved (please specify 0 for each).
*/
LC_Client_StartWait(cl, 0, 0);
/* It's always nice to tell the user what we expect of him. */
fprintf(stderr, "Please insert a chip card.\n");
/* Now that the server is informed about us being interested in chipcards
* we can just wait for the server to notify us about inserted cards.
* We will wait for about 30 seconds.
*/
card=LC_Client_WaitForNextCard(cl, 30);
/* Now that we have found a card we can tell the server that we don't want
* to be informed about other cards.
*/
LC_Client_StopWait(cl);
/* We don't own the card yet! The server just informed us that a card has
* been inserted. To work with the card we need to grab it. This is all
* done internally by this call. If this call succeeds we are the only
* client to access the card. All other clients are blocked out until we
* release the card via LC_Card_Close() or LC_Client_free().
*/
LC_Card_Open(card);
/* NOW we own the card and are free to do whatever we like with it ;-)
* Well, we could call the following function without grabbing the card
* since it only prints information from the notification received via
* LC_Client_WaitForNextCard().
* However, this is a tutorial, so we go all the way ;-)
*/
LC_Card_Dump(card, stderr, 0);
/* After working with the card we should always release it so that other
* clients may access it. If no other client is interested in this card
* the reader is shutdown after a grace period, so releasing a card after
* using it is always a good idea.
* However, if we disconnect from the chipcard server the card is released
* anyway but is is much nicer to release the card explicitly.
*/
LC_Card_Close(card);
/* Release all ressources associated with Libchipcard2.
* You should always do this at the end of your program to prevent
* memory leaks.
*/
LC_Card_free(card);
LC_Client_free(cl);
/* Aaaand that's it ;-)
*/
return 0;
}
|
