Hex Artifact Content

Artifact 3ecf224bab2e9c786e2dac9ea5ec47187c7d6e96:


0000: 44 65 73 63 72 69 70 74 69 6f 6e 3a 0a 09 43 41  Description:..CA
0010: 43 4b 65 79 20 70 72 6f 76 69 64 65 73 20 61 20  CKey provides a 
0020: 73 74 61 6e 64 61 72 64 20 69 6e 74 65 72 66 61  standard interfa
0030: 63 65 20 28 50 4b 43 53 23 31 31 29 20 66 6f 72  ce (PKCS#11) for
0040: 20 73 6d 61 72 74 63 61 72 64 73 20 63 6f 6e 6e   smartcards conn
0050: 65 63 74 65 64 0a 09 74 6f 20 61 20 50 43 2f 53  ected..to a PC/S
0060: 43 20 63 6f 6d 70 6c 69 61 6e 74 20 72 65 61 64  C compliant read
0070: 65 72 2e 20 20 49 74 20 70 65 72 66 6f 72 6d 73  er.  It performs
0080: 20 61 20 73 69 6d 69 6c 61 72 20 66 75 6e 63 74   a similar funct
0090: 69 6f 6e 20 74 6f 0a 09 22 43 6f 6f 6c 4b 65 79  ion to.."CoolKey
00a0: 22 2c 20 62 75 74 20 6f 6e 6c 79 20 73 75 70 70  ", but only supp
00b0: 6f 72 74 73 20 47 6f 76 65 72 6e 6d 65 6e 74 20  orts Government 
00c0: 53 6d 61 72 74 63 61 72 64 73 2e 20 20 49 74 20  Smartcards.  It 
00d0: 73 75 70 70 6f 72 74 73 20 61 6c 6c 0a 09 47 6f  supports all..Go
00e0: 76 65 72 6e 6d 65 6e 74 20 53 6d 61 72 74 63 61  vernment Smartca
00f0: 72 64 73 20 74 68 61 74 20 69 6d 70 6c 65 6d 65  rds that impleme
0100: 6e 74 20 74 68 65 20 47 6f 76 65 72 6e 6d 65 6e  nt the Governmen
0110: 74 20 53 6d 61 72 74 63 61 72 64 0a 09 49 6e 74  t Smartcard..Int
0120: 65 72 6f 70 65 72 61 62 69 6c 69 74 79 20 53 70  eroperability Sp
0130: 65 63 69 66 69 63 61 74 69 6f 6e 20 28 47 53 43  ecification (GSC
0140: 2d 49 53 29 20 76 32 2e 31 20 6f 72 20 6e 65 77  -IS) v2.1 or new
0150: 65 72 2e 20 20 0a 0a 43 6f 6d 70 69 6c 69 6e 67  er.  ..Compiling
0160: 3a 0a 09 24 20 2e 2f 63 6f 6e 66 69 67 75 72 65  :..$ ./configure
0170: 0a 09 24 20 6d 61 6b 65 0a 09 23 20 6d 61 6b 65  ..$ make..# make
0180: 20 69 6e 73 74 61 6c 6c 0a 0a 09 54 68 69 73 20   install...This 
0190: 77 69 6c 6c 20 69 6e 73 74 61 6c 6c 20 74 77 6f  will install two
01a0: 20 6c 69 62 72 61 72 69 65 73 20 28 6c 69 62 63   libraries (libc
01b0: 61 63 6b 65 79 2e 73 6f 2c 20 61 6e 64 20 6c 69  ackey.so, and li
01c0: 62 63 61 63 6b 65 79 5f 67 2e 73 6f 29 20 69 6e  bcackey_g.so) in
01d0: 74 6f 0a 09 22 2f 75 73 72 2f 6c 6f 63 61 6c 2f  to.."/usr/local/
01e0: 6c 69 62 22 2e 0a 0a 55 73 61 67 65 3a 0a 09 54  lib"...Usage:..T
01f0: 68 65 20 6c 69 62 72 61 72 69 65 73 20 22 6c 69  he libraries "li
0200: 62 63 61 63 6b 65 79 2e 73 6f 22 20 61 6e 64 20  bcackey.so" and 
0210: 22 6c 69 62 63 61 63 6b 65 79 5f 67 2e 73 6f 22  "libcackey_g.so"
0220: 20 61 72 65 20 52 53 41 20 50 4b 43 53 23 31 31   are RSA PKCS#11
0230: 0a 09 50 72 6f 76 69 64 65 72 73 2e 20 20 54 68  ..Providers.  Th
0240: 65 79 20 61 72 65 20 6d 65 61 6e 74 20 74 6f 20  ey are meant to 
0250: 62 65 20 6c 69 6e 6b 65 64 20 69 6e 74 6f 20 61  be linked into a
0260: 6e 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 74  ny application t
0270: 68 61 74 0a 09 72 65 71 75 69 72 65 73 20 61 20  hat..requires a 
0280: 50 4b 43 53 23 31 31 20 70 72 6f 76 69 64 65 72  PKCS#11 provider
0290: 2e 0a 0a 09 54 68 65 20 6c 69 62 72 61 72 79 20  ....The library 
02a0: 22 6c 69 62 63 61 63 6b 65 79 2e 73 6f 22 20 69  "libcackey.so" i
02b0: 73 20 6d 65 61 6e 74 20 66 6f 72 20 67 65 6e 65  s meant for gene
02c0: 72 61 6c 20 70 75 72 70 6f 73 65 20 75 73 65 2e  ral purpose use.
02d0: 0a 0a 09 54 68 65 20 6c 69 62 72 61 72 79 20 22  ...The library "
02e0: 6c 69 62 63 61 63 6b 65 79 5f 67 2e 73 6f 22 20  libcackey_g.so" 
02f0: 69 73 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67  is for debugging
0300: 20 70 75 72 70 6f 73 65 73 2e 20 20 49 74 20 68   purposes.  It h
0310: 61 73 0a 09 64 65 62 75 67 67 69 6e 67 20 73 79  as..debugging sy
0320: 6d 62 6f 6c 73 20 63 6f 6d 70 69 6c 65 64 20 69  mbols compiled i
0330: 6e 20 61 6e 64 20 67 65 6e 65 72 61 74 65 73 20  n and generates 
0340: 64 65 62 75 67 67 69 6e 67 20 69 6e 66 6f 72 6d  debugging inform
0350: 61 74 69 6f 6e 20 6f 6e 0a 09 73 74 64 65 72 72  ation on..stderr
0360: 2e 0a 0a 54 65 73 74 69 6e 67 3a 0a 09 24 20 6d  ...Testing:..$ m
0370: 61 6b 65 20 74 65 73 74 0a 09 24 20 2e 2f 74 65  ake test..$ ./te
0380: 73 74 0a 09 20 2d 20 6f 72 20 2d 0a 09 24 20 2e  st.. - or -..$ .
0390: 2f 74 65 73 74 20 32 3e 63 61 63 6b 65 79 5f 64  /test 2>cackey_d
03a0: 65 62 75 67 2e 6c 6f 67 0a                       ebug.log.