(parse_ccid_descriptor): SCR335 FW version 5.14 is
[gnupg.git] / scd / ChangeLog
1 2005-05-23  Werner Koch  <wk@g10code.com>
2
3         * ccid-driver.c (parse_ccid_descriptor): SCR335 FW version 5.14 is
4         good.
5         (do_close_reader): Never do a reset. The caller should instead
6         make sure that the reader has been closed properly.  The new retry
7         code in ccid_slot_status will make sure that the readersatrts up
8         fine even if the last process didn't closed the USB connection
9         properly.
10         (ccid_get_atr): For certain readers try switching to ISO mode.
11         Thanks to Ludovic Rousseau for this hint and the magic numbers.
12         (print_command_failed): New.
13         (bulk_in): Use it here. Add new arg NO_DEBUG.
14
15 2005-05-21  Werner Koch  <wk@g10code.com>
16
17         * scdaemon.c (handle_signal): Print thread info on SIGUSR1.
18
19 2005-05-20  Werner Koch  <wk@g10code.com>
20
21         * ccid-driver.c: Replaced macro DEBUG_T1 by a new debug level.
22         (parse_ccid_descriptor): Mark SCR335 firmware version 5.18 good.
23         (ccid_transceive): Arghhh.  The seqno is another bit in the
24         R-block than in the I block, this was wrong at one place.
25
26         * scdaemon.c: New options --debug-ccid-driver and
27         --debug-disable-ticker.
28
29         * app-openpgp.c (do_genkey, do_writekey): Factored code to check
30         for existing key out into ..
31         (does_key_exist): .. New function.
32
33 2005-05-19  Werner Koch  <wk@g10code.com>
34
35         * tlv.c (parse_sexp): New.
36
37         * command.c (cmd_writekey): New.
38         * app.c (app_writekey): New.
39         * app-common.c (app_t): Add function ptr WRITEKEY.
40         * app-openpgp.c (do_writekey): New.
41
42         * app-openpgp.c (do_readkey) [GNUPG_MAJOR_VERSION==1]: Return error.
43         * app-common.h (app_t) [GNUPG_MAJOR_VERSION==1]: Add a field to
44         store the Assuan context.
45
46 2005-05-17  Werner Koch  <wk@g10code.com>
47
48         * scdaemon.c: Removed non-pth code paths.
49         (create_socket_name, create_server_socket): New.  Taken from
50         ../agent/gpg-agent.
51         (cleanup): Changed to adjust for SOCKET_NAME now being malloced.
52         (ticker_thread): Always use pth_event_occurred; it is again
53         defined for all decent PTH versions.
54         (handle_connections): New. Based on the gpg-agent code.
55         (start_connection_thread): Ditto.
56         (ticker_thread): Removed.
57         (cleanup_sh): Removed.
58         (main): Run the handler for the pipe server in a separate
59         thread.  This replaces the old ticker thread.
60         (scd_get_socket_name): New.
61         * command.c (cmd_getinfo): New command GETINFO.
62         (scd_command_handler): Renamed argument and changed code to use an
63         already connected FD.
64
65 2005-05-15  Werner Koch  <wk@g10code.com>
66
67         * app.c, app-common.h, app-nks.c, app-p15.c, app-dinsig.c
68         * app-openpgp.c: Change most function return types from int to
69         gpg_error_t.
70         * command.c (pin_cb): Ditto.
71         * sc-copykeys.c (pincb): Ditto.
72
73         * app.c (lock_reader, unlock_reader): New.  Changed call handler
74         wrappers to make use of these functions.
75
76 2005-05-07  Werner Koch  <wk@g10code.com>
77
78         * ccid-driver.c (do_close_reader): Don't do a reset before close.
79         Some folks reported that it makes the SCR335 hang less often.
80         Look at the source on how to re-enable it.
81
82 2005-04-27  Werner Koch  <wk@g10code.com>
83
84         * app-p15.c (micardo_mse): New.
85         (do_sign): Call it.
86         * iso7816.c (iso7816_manage_security_env): Allow passing DATA as
87         NULL to indicate an empty Lc.
88         * tlv.c (find_tlv): Check that a found object fits into the
89         buffer.
90         (find_tlv_unchecked): New as replacement for the old non-checking
91         variant.
92         * app.c (select_application): Keep on using the non-checking
93         variant.
94         * app-openpgp.c (get_one_do, dump_all_do): Ditto.
95
96         
97         Removal of the old OpenSC based code.
98         
99         * app-p15.c: New.  Basic support for pkcs15 cards without OpenSC.
100         There are quite a couple of things missing but at least I can use
101         my old TCOS cards from the Aegypten-1 development for signing.
102         * app.c (select_application): Detect pkcs15 applications.
103         * Makefile.am (scdaemon_SOURCES): Removed card.c, card-common.h
104         and card-p15.c because they are now obsolete. Added app-p15.c.
105         Removed all OpenSC stuff.
106         * command.c (do_reset, open_card, cmd_serialno, cmd_learn) 
107         (cmd_readcert, cmd_readkey, cmd_pksign, cmd_pkdecrypt): Removed
108         all special cases for the old card.c based mechanisms.
109         * scdaemon.c, apdu.c: Removed all special cases for OpenSC.
110
111 2005-04-20  Werner Koch  <wk@g10code.com>
112
113         * command.c: Use GPG_ERR_LOCKED instead of EBUSY.
114
115 2005-04-14  Werner Koch  <wk@g10code.com>
116
117         * app-openpgp.c (retrieve_key_material): Rewritten.  Return a
118         proper error code.
119         (retrieve_next_token): Removed.
120         (retrieve_fpr_from_card): Rewritten to make use of DO caching and
121         to take the KEYNO as arg.
122         (get_public_key): Renamed variable for clarity.
123
124 2005-04-12  Werner Koch  <wk@g10code.com>
125
126         Basic support for several sessions.
127         
128         * command.c (scd_command_handler): Replace the primary_connection
129         stuff by a real connection list.  Release the local context on
130         exit.
131         (scd_update_reader_status_file): Update accordingly.  Send signal
132         to all connections who registered an event signal.
133         (cmd_lock, cmd_unlock, register_commands): New commands LOCK and
134         UNLOCK.
135         (cmd_setdata, cmd_pksign, cmd_pkauth, cmd_pkdecrypt, cmd_setattr) 
136         (cmd_genkey, cmd_passwd, cmd_checkpin): Return an error if reader
137         is locked.
138         (do_reset): Handle locking.
139         (open_card): Ditto.  Share the reader slot with other sessions.
140         (get_reader_slot): New.
141         (update_card_removed): New.  Use it in the TEST_CARD_REMOVAL macro.
142
143 2005-04-07  Werner Koch  <wk@g10code.com>
144
145         * app-openpgp.c (do_check_pin): Add hack to allow verification of
146         CHV3.
147         (get_public_key): Don't use gcry functions to create S-expressions.
148         (do_deinit, do_readkey, do_genkey, send_keypair_info): Adjust for
149         above change.
150
151 2005-03-29  Moritz Schulte  <moritz@g10code.com>
152
153         * app-openpgp.c (retrieve_fpr_from_card): New function.
154         (retrieve_next_token): New function.
155         (retrieve_key_material): New function.
156         (get_public_key): Implement retrival of key through expernal
157         helper (gpg) in case the openpgp card is not cooperative enough.
158
159 2005-03-16  Werner Koch  <wk@g10code.com>
160
161         * ccid-driver.c (parse_ccid_descriptor): Make SCM workaround
162         reader type specific.
163         (scan_or_find_devices): Do not check the interface subclass in the
164         SPR532 kludge, as this depends on the firmware version.
165         (ccid_get_atr): Get the Slot status first.  This solves the
166         problem with readers hanging on recent Linux 2.6.x.
167         (bulk_in): Add argument TIMEOUT and changed all callers to pass an
168         appropriate one.  Change the standard timeout from 10 to 5 seconds.
169         (ccid_slot_status): Add a retry code with an initial short timeout.
170         (do_close_reader): Do an usb_reset before closing the reader.
171
172 2005-02-25  Werner Koch  <wk@g10code.com>
173
174         * app-openpgp.c (get_public_key): Make sure not to return negative
175         numbers.
176         (do_sign): Allow passing of indata with algorithm prefix.
177         (do_auth): Allow OPENPGP.3 as an alternative ID.
178
179         * app.c (app_getattr): Return just the S/N but not the timestamp.
180
181 2005-02-24  Werner Koch  <wk@g10code.com>
182
183         * app.c (app_getattr): Return APPTYPE or SERIALNO type even if the
184         application does dot support the getattr call.
185
186         * app-openpgp.c (get_one_do): Never try to get a non cacheable
187         object from the cache.
188         (get_one_do): Add new arg to return an error code.  Changed all
189         callers.
190         (do_getattr): Let it return a proper error code.
191
192         * app.c (select_application): Return an error code and the
193         application context in an new arg.
194         * command.c (open_card): Adjusted for that.  Don't use the
195         fallback if no card is present.  Return an error if the card has
196         been removed without a reset.
197         (do_reset, cmd_serialno): Clear that error flag.
198         (TEST_CARD_REMOVAL): New. Use it with all command handlers.
199         (scd_update_reader_status_file): Set the error flag on all changes.
200
201         * scdaemon.c (ticker_thread): Termintate if a shutdown is pending.
202
203         * apdu.c: Added some PCSC error codes.
204         (pcsc_error_to_sw): New.
205         (reset_pcsc_reader, pcsc_get_status, pcsc_send_apdu) 
206         (open_pcsc_reader): Do proper error code mapping.
207
208 2005-03-16  Werner Koch  <wk@g10code.com>
209
210         * ccid-driver.c (parse_ccid_descriptor): Make SCM workaround
211         reader type specific.
212         (scan_or_find_devices): Do not check the interface subclass in the
213         SPR532 kludge, as this depends on the firmware version.
214         (ccid_get_atr): Get the Slot status first.  This solves the
215         problem with readers hanging on recent Linux 2.6.x.
216
217 2005-02-22  Werner Koch  <wk@g10code.com>
218
219         * app-openpgp.c (app_local_s): New field PK.
220         (do_deinit, do_genkey, app_openpgp_storekey): Clear it.
221         (get_public_key, send_keypair_info): New.
222         (do_learn_status): Send KEYPAIR info
223
224         * app-common.h (app_ctx_t): Add function pointer READKEY.
225         * app.c (app_readkey): New.
226         * command.c (cmd_readkey): Use READKEY function if possible.
227
228 2005-01-26  Werner Koch  <wk@g10code.com>
229
230         * ccid-driver.c (parse_ccid_descriptor): Need the CSM workaround
231         also for newer firmware versions.  Need to get a list of fixed
232         firmware versions and use that.
233
234 2005-01-25  Werner Koch  <wk@g10code.com>
235
236         * apdu.c (apdu_send_le, apdu_send_direct): Fix some compiler
237         warnings.
238
239         * app-openpgp.c (get_cached_data): New arg GET_IMMEDIATE to bypass
240         the cache.  Changed all callers.
241         (get_one_do): Bypass the cache if the value would have been read
242         directly for v1.1 cards.It makes things a bit slower but obnly for
243         1.0 cards and there are not that many cards out in the wild.  This
244         is required to fix a caching bug when generating new keys; as a
245         side effect of the retrieval of the the C4 DO from the 6E DO the
246         cached fingerprint will get updated to the old value and later
247         when signing the generated key the checking of the fingerprint
248         fails because it won't match the new one.  Thanks to Moritz for
249         analyzing this problem.
250         (verify_chv3): Removed the CHV status reread logic because we
251         won't cache the C4 DO anymore.
252
253 2004-12-28  Werner Koch  <wk@g10code.com>
254
255         * ccid-driver.c (find_endpoint): New.
256         (scan_or_find_devices): Add new args to return endpoint info and
257         interface number.
258         (ccid_open_reader, ccid_shutdown_reader): Take care of these new
259         args.
260         (bulk_in, bulk_out): Use the correct endpoints.
261         (ccid_transceive_apdu_level): New.
262         (ccid_transceive): Divert to above.
263         (parse_ccid_descriptor): Allow APDU level exchange mode.
264         (do_close_reader): Pass the interface number to usb_release_interface.
265
266 2004-12-21  Werner Koch  <wk@g10code.com>
267
268         * scdaemon.c (main): Use default_homedir().
269
270 2004-12-18  Werner Koch  <wk@g10code.com>
271
272         * scdaemon.c (main) [W32]: Remove special Pth initialize..
273
274         * scdaemon.h (map_assuan_err): Define in terms of
275         map_assuan_err_with_source.
276
277 2004-12-15  Werner Koch  <wk@g10code.com>
278
279         * scdaemon.c [W32]: Various hacks to make it run under W32.
280
281         * command.c (scd_update_reader_status_file) [W32]: Don't use kill.
282
283         * apdu.c [W32]: Disable use of pcsc_wrapper.
284
285         * Makefile.am (scdaemon_LDADD): Reorder libs.
286         (sc_copykeys_LDADD): Add libassuan because it is needed for W32. 
287
288 2004-12-06  Werner Koch  <wk@g10code.com>
289
290         * Makefile.am (pkglib_PROGRAMS): Build only for W32.
291
292 2004-10-22  Werner Koch  <wk@g10code.com>
293
294         * app-openpgp.c (verify_chv3): The minium length for CHV3 is
295         8. Changed string to match the other ones.
296
297 2004-10-21  Werner Koch  <wk@g10code.com>
298
299         * app-openpgp.c (do_sign): Replace asprintf by direct allocation.
300         This avoids problems with missing vasprintf implementations in
301         gnupg 1.4.
302
303         * app-common.h (app_openpgp_storekey: Add prototype. 
304
305 2004-10-20  Werner Koch  <wk@g10code.com>
306
307         * sc-investigate: Removed.
308         * Makefile.am (sc_investigate): Removed.
309         
310         * pcsc-wrapper.c (load_pcsc_driver): Load get_status_change func.
311         (handle_open): Succeed even without a present card.
312         (handle_status, handle_reset): New.
313         
314         * apdu.c (apdu_open_reader): Load pcsc_get_status_change fucntion.
315         (pcsc_get_status): Implemented.
316         (reset_pcsc_reader): Implemented.
317         (open_pcsc_reader): Succeed even with no card inserted.
318         (open_ccid_reader): Set LAST_STATUS.
319
320         * iso7816.c (iso7816_select_application): Always use 0 for P1.
321
322 2004-10-18  Werner Koch  <wk@g10code.com>
323
324         * ccid-driver.c (ccid_get_atr): Reset T=1 state info.
325
326 2004-10-14  Werner Koch  <wk@g10code.com>
327
328         * app-openpgp.c (parse_login_data): New. 
329         (app_select_openpgp): Call it.
330         (do_setattr): Reparse it after change.
331
332 2004-10-06  Werner Koch  <wk@g10code.de>
333
334         * ccid-driver.c (ccid_open_reader): Store the vendor ID.
335         (ccid_transceive_secure): New.
336         (parse_ccid_descriptor): Workaround for an SCM reader problem.
337
338 2004-10-04  Werner Koch  <wk@g10code.de>
339
340         * ccid-driver.c (send_escape_cmd): New.
341
342 2004-09-30  Werner Koch  <wk@g10code.com>
343
344         * Makefile.am: Adjusted for gettext 0.14.
345
346         * app-openpgp.c (do_sign): Add the error string to the verify
347         failed messages.
348
349 2004-09-27  Werner Koch  <wk@g10code.com>
350
351         From gnupg 1.3
352
353         * app-openpgp.c: Made all strings translatable.
354         (verify_chv3) [GNUPG_MAJOR_VERSION]: Make opt.allow_admin
355         available for use in gnupg 2. 
356         (verify_chv3): Reimplemented countdown showing to use only
357         functions from this module.  Flush the CVH status cache on a
358         successful read.
359         (get_one_do): Hack to bypass the cache for cards versions > 1.0.
360         (store_fpr): Store the creation date for card version > 1.0.
361
362         * app-openpgp.c (app_openpgp_storekey): Call flush_cache.
363         (get_cached_data): Move local data initialization to ..
364         (app_select_openpgp): .. here. Read some flags for later use.
365         (do_getattr): New read-only attribute EXTCAP.
366         
367         * apdu.c (open_pcsc_reader): Do not print empty reader string.
368
369         * ccid-driver.c (do_close_reader): Factored some code out from ...
370         (ccid_close_reader): ..here.
371         (ccid_shutdown_reader): New.
372
373         * apdu.c (apdu_shutdown_reader): New.
374         (shutdown_ccid_reader): New.
375
376         * apdu.c (open_ccid_reader): New arg PORTSTR.  Pass it to
377         ccid_open_reader.
378         (apdu_open_reader): Pass portstr to open_ccid_reader.
379         (apdu_open_reader): No fallback if a full CCID reader id has been
380         given.
381
382         * ccid-driver.c (ccid_get_reader_list): New.
383         (ccid_open_reader): Changed API to take a string for the reader.
384         Removed al the cruft for the libusb development vesion which seems
385         not to be maintained anymore and there are no packages anyway.
386         The stable library works just fine.
387         (struct ccid_reader_id_s): Deleted and replaced everywhere by a
388         simple string.
389         (usb_get_string_simple): Removed.
390         (bulk_in): Do valgrind hack here and not just everywhere.
391
392         * ccid-driver.c (read_device_info): Removed.
393         (make_reader_id, scan_or_find_devices): New.
394         (ccid_open_reader): Simplified by make use of the new functions.
395         (ccid_set_debug_level): New.  Changed the macros to make use of
396         it.  It has turned out that it is often useful to enable debugging
397         at runtime so I added this option.
398
399         From gnupg 1.3 - David Shaw  <dshaw@jabberwocky.com>
400
401         * app-openpgp.c (verify_chv3): Show a countdown of how many wrong
402         admin PINs can be entered before the card is locked.
403
404         * app-openpgp.c (get_cached_data): Avoid mallocing zero since it
405         breaks us when using --enable-m-guard.
406
407         * ccid-driver.c (usb_get_string_simple): Replacement function to
408         work with older libusb.
409
410         * ccid-driver.c (read_device_info): Fix segfault when usb device
411         is not accessible.
412         (ccid_open_reader): Allow working with an even older version of
413         libusb (usb_busses global instead of usb_get_busses()).
414
415 2004-09-11  Werner Koch  <wk@g10code.com>
416
417         * app-openpgp.c (app_select_openpgp): Its app_munge_serialno and
418         not app_number_serialno.
419
420 2004-08-20  Werner Koch  <wk@g10code.de>
421
422         * app.c (select_application): Fixed serial number extraction and
423         added the BMI card workaround.
424         (app_munge_serialno): New.
425         * app-openpgp.c (app_select_openpgp): Try munging serialno.
426
427 2004-08-05  Werner Koch  <wk@g10code.de>
428
429         * scdaemon.c (main): New option --disable-application.
430         * app.c (is_app_allowed): New.
431         (select_application): Use it to check for disabled applications.
432
433         * ccid-driver.h (CCID_DRIVER_ERR_ABORTED): New.
434         * ccid-driver.c (ccid_open_reader): Support the stable 0.1 version
435         of libusb.
436         (ccid_get_atr): Handle short messages.
437
438         * apdu.c (my_rapdu_get_status): Implemented.
439
440 2004-07-27  Moritz Schulte  <moritz@g10code.com>
441
442         * apdu.c: Include <signal.h>.
443
444         * Makefile.am: Use @DL_LIBS@ instead of -ldl.
445
446 2004-07-22  Werner Koch  <wk@g10code.de>
447
448         * Makefile.am: Make OpenSC lib link after libgcrypt. Do not link
449         to pth.
450         * apdu.c: Don't use Pth if we use OpenSC.
451         * sc-investigate.c, scdaemon.c: Disable use of pth if OpenSC is used. 
452
453         * scdaemon.c (main): Bumbed thread stack size up to 512k.
454
455 2004-07-16  Werner Koch  <wk@gnupg.org>
456
457         * apdu.c (reader_table_s):  Add function pointers for the backends.
458         (apdu_close_reader, apdu_get_status, apdu_activate) 
459         (send_apdu): Make use of them.
460         (new_reader_slot): Intialize them to NULL.
461         (dump_ccid_reader_status, ct_dump_reader_status): New.
462         (dump_pcsc_reader_status): New.
463         (open_ct_reader, open_pcsc_reader, open_ccid_reader) 
464         (open_osc_reader, open_rapdu_reader): Intialize function pointers.
465         (ct_activate_card, ct_send_apdu, pcsc_send_apdu, osc_send_apdu) 
466         (error_string): Removed.  Replaced by apdu_strerror.
467         (get_ccid_error_string): Removed.
468         (ct_activate_card): Remove the unused loop.
469         (reset_ct_reader): Implemented.
470         (ct_send_apdu): Activate the card if not yet done.
471         (pcsc_send_apdu): Ditto.
472
473 2004-07-15  Werner Koch  <wk@gnupg.org>
474
475         * ccid-driver.h: Add error codes.
476         * ccid-driver.c: Implement more or less proper error codes all
477         over the place.
478
479         * apdu.c (apdu_send_direct): New.
480         (get_ccid_error_string): Add some error code mappings.
481         (send_apdu): Pass error codes along for drivers already supporting
482         them.
483         (host_sw_string): New.
484         (get_ccid_error_string): Use above.
485         (send_apdu_ccid): Reset the reader if it has not yet been done.
486         (open_ccid_reader): Don't care if the ATR can't be read.
487         (apdu_activate_card): New.
488         (apdu_strerror): New.
489         (dump_reader_status): Only enable it with opt.VERBOSE.
490         * iso7816.c (map_sw): Add mappings for the new error codes.
491
492 2004-07-02  Werner Koch  <wk@gnupg.org>
493
494         * apdu.c (open_ct_reader, open_pcsc_reader, open_ccid_reader)
495         (reset_ccid_reader, open_osc_reader): Call dump_reader_status only
496         in verbose mode.
497
498 2004-07-01  Werner Koch  <wk@gnupg.org>
499
500         * sc-investigate.c: Initialize Pth which is now required.
501         (interactive_shell): New command "readpk".
502
503         * app-openpgp.c (do_getattr): Fix for sending CA-FPR.
504
505 2004-06-30  Werner Koch  <wk@gnupg.org>
506
507         * app-openpgp.c (app_openpgp_readkey): Fixed check for valid
508         exponent.
509
510 2004-06-18  Werner Koch  <wk@g10code.com>
511
512         * sc-investigate.c (my_read_line): Renamed from read_line.
513
514 2004-06-16  Werner Koch  <wk@gnupg.org>
515
516         * apdu.c (osc_get_status): Fixed type in function name. Noted by
517         Axel Thimm.  Yes, I didn't tested it with OpenSC :-(.
518
519 2004-04-28  Werner Koch  <wk@gnupg.org>
520
521         * app-openpgp.c (do_setattr): Sync FORCE_CHV1.
522
523 2004-04-27  Werner Koch  <wk@gnupg.org>
524
525         * app-common.h: Do not include ksba.h for gnupg 1.
526
527 2004-04-26  Werner Koch  <wk@gnupg.org>
528
529         * app-common.h: New members FNC.DEINIT and APP_LOCAL.
530         * app.c (release_application): Call new deconstructor.
531         * app-openpgp.c (do_deinit): New.
532         (get_cached_data, flush_cache_item, flush_cache_after_error)
533         (flush_cache): New.
534         (get_one_do): Replaced arg SLOT by APP.  Make used of cached data.
535         (verify_chv2, verify_chv3): Flush some cache item after error.
536         (do_change_pin): Ditto.
537         (do_sign): Ditto.
538         (do_setattr): Flush cache item.
539         (do_genkey): Flush the entire cache.
540         (compare_fingerprint): Use cached data.
541
542         * scdaemon.c (main): Do the last change the usual way. This is so
543         that we can easily test for versioned config files above.
544
545 2004-04-26  Marcus Brinkmann  <marcus@g10code.de>
546
547         * scdaemon.c (main): For now, always print default filename for
548         --gpgconf-list, and never /dev/null.
549
550 2004-04-21  Werner Koch  <wk@gnupg.org>
551
552         * command.c (scd_update_reader_status_file): Send a signal back to
553         the client.
554         (option_handler): Parse the new event-signal option.
555
556         * scdaemon.c (handle_signal): Do not use SIGUSR{1,2} anymore for
557         changing the verbosity.
558
559 2004-04-20  Werner Koch  <wk@gnupg.org>
560
561         * command.c (scd_update_reader_status_file): Write status files.
562
563         * app-help.c (app_help_read_length_of_cert): Fixed calculation of
564         R_CERTOFF.
565
566         * pcsc-wrapper.c: New.
567         * Makefile.am (pkglib_PROGRAMS): Install it here.
568         * apdu.c (writen, readn): New.
569         (open_pcsc_reader, pcsc_send_apdu, close_pcsc_reader): Use the
570         pcsc-wrapper if we are using Pth.
571         (apdu_send_le): Reinitialize RESULTLEN.  Handle SW_EOF_REACHED
572         like SW_SUCCESS.
573
574 2004-04-19  Werner Koch  <wk@gnupg.org>
575
576         * ccid-driver.c (parse_ccid_descriptor): Store some of the reader
577         features away.  New arg HANDLE
578         (read_device_info): New arg HANDLE. Changed caller.
579         (bulk_in): Handle time extension requests.
580         (ccid_get_atr): Setup parameters and the IFSD.
581         (compute_edc): New. Factored out code.
582         (ccid_transceive): Use default NADs when required.
583
584 2004-04-14  Werner Koch  <wk@gnupg.org>
585
586         * scdaemon.h (server_control_s): Add member READER_SLOT.
587         * scdaemon.c (scd_init_default_ctrl): Initialize READER_SLOT to -1.
588         * command.c (open_card): Reuse an open slot.
589         (reset_notify): Just reset the slot if supported by the reader.
590         (do_reset): Factored code from above out.
591         (scd_command_handler): Use it for cleanup.
592
593         * apdu.h: New pseudo stati SW_HOST_NOT_SUPPORTED,
594         SW_HOST_LOCKING_FAILED and SW_HOST_BUSY.
595         * iso7816.c (map_sw): Map it.
596         
597         * ccid-driver.c (ccid_slot_status): Add arg STATUSBITS.
598         * apdu.c (apdu_get_status): New.
599         (ct_get_status, pcsc_get_status, ocsc_get_status): New stubs.
600         (get_status_ccid): New.
601         (apdu_reset): New.
602         (reset_ct_reader, reset_pcsc_reader, reset_osc_reader): New stubs.
603         (reset_ccid_reader): New.
604         (apdu_enum_reader): New.
605         
606         * apdu.c (lock_slot, trylock_slot, unlock_slot): New helpers.
607         (new_reader_slot) [USE_GNU_PTH]: Init mutex.
608         (apdu_reset, apdu_get_status, apdu_send_le): Run functions
609         in locked mode.
610
611         * command.c (scd_update_reader_status_file): New.
612         * scdaemon.c (handle_tick): Call it.
613
614 2004-04-13  Werner Koch  <wk@gnupg.org>
615
616         * scdaemon.c: Convert to a Pth application.
617         (handle_signal, ticker_thread, handle_tick): New.
618         (main): Fire up the ticker thread in server mode.
619
620 2004-03-23  Werner Koch  <wk@gnupg.org>
621
622         * scdaemon.c (main) <gpgconf_list>: Fixed output for pcsc_driver.
623
624 2004-03-17  Werner Koch  <wk@gnupg.org>
625
626         * tlv.c (parse_ber_header): Do not check for tag overflow - it
627         does not make sense.  Simplified the check for length overflow.
628
629         * scdaemon.c (main) <gpgconf>: Fixed default value quoting.
630
631 2004-03-16  Werner Koch  <wk@gnupg.org>
632
633         * app-dinsig.c: Implemented. Based on app-nks.c and card-dinsig.c
634         * app-nks.c (get_length_of_cert): Removed.
635         * app-help.c: New.
636         (app_help_read_length_of_cert): New.  Code taken from above.  New
637         optional arg R_CERTOFF.
638
639         * card-dinsig.c: Removed.
640         * card.c (card_get_serial_and_stamp): Do not bind to the old and
641         never finsiged card-dinsig.c.
642
643         * iso7816.c (iso7816_read_binary): Allow for an NMAX > 254.
644
645 2004-03-11  Werner Koch  <wk@gnupg.org>
646
647         * scdaemon.h (out_of_core): Removed.  Replaced callers by standard
648         gpg_error function.
649
650         * apdu.c, iso7816.c, ccid-driver.c [GNUPG_SCD_MAIN_HEADER]: Allow
651         to include a header defined by the compiler.  This helps us to
652         reuse the source in other software.
653
654 2004-03-10  Werner Koch  <wk@gnupg.org>
655
656         * iso7816.c (iso7816_read_record): New arg SHORT_EF.  Changed all
657         callers.
658
659 2004-02-18  Werner Koch  <wk@gnupg.org>
660
661         * sc-investigate.c (main): Setup the used character set.
662         * scdaemon.c (main): Ditto.
663
664         * scdaemon.c (set_debug): New.  Add option --debug-level.
665         (main): Add option --gpgconf-list.
666
667 2004-02-12  Werner Koch  <wk@gnupg.org>
668
669         * Makefile.am: Include cmacros.am for common flags.
670
671 2004-01-29  Werner Koch  <wk@gnupg.org>
672
673         * command.c (reset_notify): Release the application context and
674         close the reader.
675
676 2004-01-28  Werner Koch  <wk@gnupg.org>
677
678         * iso7816.c (iso7816_manage_security_env): New.
679         (iso7816_decipher): Add PADIND argument.
680
681 2004-01-27  Werner Koch  <wk@gnupg.org>
682
683         * command.c (cmd_readcert, cmd_readkey): Work on a copy of LINE.
684
685         * app-common.h (app_ctx_s): Added readcert field.
686         * app.c (app_readcert): New.
687         * tlv.c (parse_ber_header): Added; taken from libksba.
688
689 2004-01-26  Werner Koch  <wk@gnupg.org>
690
691         * card.c (map_sc_err): Use SCD as the error source.
692
693         * command.c (open_card): ADD arg NAME to allow requesting a
694         specific application.  Changed all callers.
695         (cmd_serialno): Allow optional argument to select the desired
696         application.
697
698         * app-nks.c: New. 
699
700         * scdaemon.h (opt): Add READER_PORT.
701         * scdaemon.c (main): Set it here.
702         * app.c (app_set_default_reader_port): Removed.
703         (select_application): Add NAME arg and figure out a
704         default serial number from the GDO. Add SLOT arg and remove all
705         reader management.
706         (release_application): New.
707         (app_write_learn_status): Output an APPTYPE status line.
708         * command.c (open_card): Adapt for select_application change.
709         * app-openpgp.c (app_select_openpgp): Removed SN and SNLEN args
710         and set it directly.  Changed all callers.
711
712 2004-01-25  Werner Koch  <wk@gnupg.org>
713
714         * iso7816.c (iso7816_select_application): P1 kludge for OpenPGP
715         card.
716         * app-openpgp.c (find_tlv): Factor out this function to ..
717         * tlv.c, tlv.h: .. new.
718
719         * scdaemon.h: Introduced app_t and ctrl_t as the new types for APP
720         and CTRL.
721
722 2004-01-21  Werner Koch  <wk@gnupg.org>
723
724         * apdu.c (apdu_send_le): Treat SW_EOF_REACHED as a warning.
725
726 2004-01-20  Werner Koch  <wk@gnupg.org>
727
728         * iso7816.c (iso7816_read_binary): New.
729         (iso7816_select_file): New.
730         (iso7816_list_directory): New.
731
732         * sc-investigate.c: Add option -i.
733         (select_app, read_line, interactive_shell): New.
734
735 2004-01-16  Werner Koch  <wk@gnupg.org>
736
737         * apdu.h: Add SW_FILE_NOT_FOUND.
738         * iso7816.c (map_sw): Map it to GPG_ERR_ENOENT.
739         * iso7816.c (iso7816_select_file): New.
740
741         * app-dinsig.c: New file w/o any real code yet.
742         * Makefile.am (scdaemon_SOURCES,sc_investigate_SOURCES): Add file.
743
744         * sc-investigate.c: Add option --disable-ccid.
745
746 2003-12-19  Werner Koch  <wk@gnupg.org>
747
748         * apdu.c (apdu_send_le): Send a get_response with the indicated
749         length and not the 64 bytes we used for testing.
750
751         * app-openpgp.c (verify_chv2, verify_chv3, do_sign): Check the
752         minimum length of the passphrase, so that we don't need to
753         decrement the retry counter.
754
755 2003-12-17  Werner Koch  <wk@gnupg.org>
756
757         * card-p15.c (p15_enum_keypairs): Replaced KRC by RC.
758         * card-dinsig.c (dinsig_enum_keypairs): Ditto.
759
760 2003-12-16  Werner Koch  <wk@gnupg.org>
761
762         * scdaemon.c (main): Set the prefixes for assuan logging.
763
764 2003-11-17  Werner Koch  <wk@gnupg.org>
765
766         * scdaemon.c, scdaemon.h: New options --allow-admin and --deny-admin.
767         * app-openpgp.c (verify_chv3): Check it here.
768
769 2003-11-12  Werner Koch  <wk@gnupg.org>
770
771         Adjusted for API changes in Libksba.
772
773 2003-10-30  Werner Koch  <wk@gnupg.org>
774
775         * apdu.c (close_ct_reader, close_pcsc_reader): Implemented.
776         (get_ccid_error_string): New.  Not very useful messages, though.
777
778 2003-10-25  Werner Koch  <wk@gnupg.org>
779
780         * ccid-driver.c (ccid_open_reader): Return an error if no USB
781         devices are found.
782
783         * command.c (cmd_genkey, cmd_passwd): Fixed faulty use of
784         !spacep().
785
786         * apdu.c (apdu_open_reader): Hacks for PC/SC under Windows.
787
788 2003-10-20  Werner Koch  <wk@gnupg.org>
789
790         * command.c (cmd_checkpin): New.
791         (register_commands): Add command CHECKPIN.
792         * app.c (app_check_pin): New.
793         * app-openpgp.c (check_against_given_fingerprint): New. Factored
794         out that code elsewhere.
795         (do_check_pin): New.
796
797 2003-10-10  Werner Koch  <wk@gnupg.org>
798
799         * ccid-driver.c (ccid_close_reader): New.
800
801         * apdu.c (close_ccid_reader, close_ct_reader, close_csc_reader)
802         (close_osc_reader, apdu_close_reader): New.  Not all are properly
803         implemented yet.
804
805 2003-10-09  Werner Koch  <wk@gnupg.org>
806
807         * ccid-driver.c (ccid_transceive): Add T=1 chaining for sending.
808
809 2003-10-08  Werner Koch  <wk@gnupg.org>
810
811         * app-openpgp.c (do_getattr): Support SERIALNO and AID.
812
813 2003-10-01  Werner Koch  <wk@gnupg.org>
814
815         * ccid-driver.c: Detect GnuPG 1.3 and include appropriate files.
816         * apdu.c: Ditto.
817         * app-openpgp.c: Ditto.
818         * iso7816.c: Ditto.
819         (generate_keypair): Renamed to ..
820         (do_generate_keypair): .. this.
821         * app-common.h [GNUPG_MAJOR_VERSION]: New.
822         * iso7816.h [GNUPG_MAJOR_VERSION]: Include cardglue.h
823
824 2003-09-30  Werner Koch  <wk@gnupg.org>
825
826         * command.c (cmd_getattr): New command GETATTR.
827         * app.c (app_setattr): New.
828         (do_getattr): New.
829         (do_learn_status): Reimplemented in terms of do_getattr.
830
831         * app-openpgp.c (do_change_pin): Make sure CVH1 and CHV2 are
832         always synced.
833         (verify_chv2, verify_chv3): New. Factored out common code.
834         (do_setattr, do_sign, do_auth, do_decipher): Change the names of
835         the prompts to match that we have only 2 different PINs.
836         (app_select_openpgp): Check whether the card enforced CHV1.
837         (convert_sig_counter_value): New. Factor out code from
838         get_sig_counter.
839
840 2003-09-28  Werner Koch  <wk@gnupg.org>
841
842         * app-openpgp.c (dump_all_do): Use gpg_err_code and not gpg_error.
843
844 2003-09-19  Werner Koch  <wk@gnupg.org>
845
846         * ccid-driver.c (parse_ccid_descriptor): New.
847         (read_device_info): New.
848         (ccid_open_reader): Check that the device has all required features.
849
850 2003-09-06  Werner Koch  <wk@gnupg.org>
851
852         * scdaemon.c (main): --pcsc-driver again defaults to pcsclite.
853         David Corcoran was so kind to remove the GPL incompatible
854         advertisng clause from pcsclite.
855         * apdu.c (apdu_open_reader): Actually make pcsc-driver option work.
856
857 2003-09-05  Werner Koch  <wk@gnupg.org>
858
859         * ccid-driver.c: More work, data can now actually be retrieved.
860         * ccid-driver.c, ccid-driver.h: Alternativley allow use under BSD
861         conditions.
862
863 2003-09-02  Werner Koch  <wk@gnupg.org>
864
865         * scdaemon.c, scdaemon.h: New option --pcsc-ccid.
866         * ccid-driver.c, ccid-driver.h: New but far from being useful.
867         * Makefile.am: Add above.
868         * apdu.c: Add support for that ccid driver.
869         
870 2003-08-26  Timo Schulz  <twoaday@freakmail.de>
871
872         * apdu.c (new_reader_slot): Only set 'is_osc' when OpenSC
873         is used.
874         
875 2003-08-25  Werner Koch  <wk@gnupg.org>
876
877         * command.c (cmd_setattr): Use a copy of LINE.
878         (cmd_genkey): Use a copy of KEYNO.
879         (cmd_passwd): Use a copy of CHVNOSTR.
880         (cmd_pksign, cmd_pkauth, cmd_pkdecrypt): s/strdup/xtrystrdup/.
881
882 2003-08-19  Werner Koch  <wk@gnupg.org>
883
884         * scdaemon.c, scdaemon.h: New option --pcsc-driver.
885         * apdu.c (apdu_open_reader): Use that option here instead of a
886         hardcoded one.
887
888 2003-08-18  Werner Koch  <wk@gnupg.org>
889
890         * Makefile.am: Add OPENSC_LIBS to all programs. 
891
892         * scdaemon.c, scdaemon.h: New option --disable-opensc.
893         * card.c (card_open): Implement it.
894         * apdu.c (open_osc_reader, osc_send_apdu): New.
895         (apdu_open_reader) [HAVE_OPENSC]: Use the opensc driver if not
896         disabled.
897         (error_string) [HAVE_OPENSC]: Use sc_strerror.
898         (send_apdu) [HAVE_OPENSC]: Call osc_apdu_send.
899
900         * card-p15.c (p15_enum_keypairs, p15_prepare_key): Adjusted for
901         libgpg-error.
902
903 2003-08-14  Timo Schulz  <twoaday@freakmail.de>
904
905         * apdu.c (ct_activate_card): Change the code a little to avoid
906         problems with other readers.
907         * Always use 'dynload.h' instead of 'dlfcn.h'.
908
909 2003-08-05  Werner Koch  <wk@gnupg.org>
910
911         * app-openpgp.c (dump_all_do): Don't analyze constructed DOs after
912         an error.
913
914 2003-08-04  Werner Koch  <wk@gnupg.org>
915
916         * app.c (app_set_default_reader_port): New.
917         (select_application): Use it here.
918         * scdaemon.c (main): and here.
919         * sc-copykeys.c: --reader-port does now take a string.
920         * sc-investigate.c, scdaemon.c: Ditto.
921         * apdu.c (apdu_open_reader): Ditto.  Load pcsclite if no ctapi
922         driver is configured.  Always include code for ctapi.
923         (new_reader_slot): Don't test for already used ports and remove
924         port arg.
925         (open_pcsc_reader, pcsc_send_apdu, pcsc_error_string): New.
926         (apdu_send_le): Changed RC to long to cope with PC/SC.
927
928         * scdaemon.c, scdaemon.h: New option --ctapi-driver.
929         * sc-investigate.c, sc-copykeys.c: Ditto.
930         
931 2003-07-31  Werner Koch  <wk@gnupg.org>
932
933         * Makefile.am (scdaemon_LDADD): Added INTLLIBS.
934
935 2003-07-28  Werner Koch  <wk@gnupg.org>
936
937         * app-openpgp.c (do_setattr): Change implementation.  Allow all
938         useful DOs.
939
940 2003-07-27  Werner Koch  <wk@gnupg.org>
941
942         Adjusted for gcry_mpi_print and gcry_mpi_scan API change.
943
944 2003-07-24  Werner Koch  <wk@gnupg.org>
945
946         * app-openpgp.c (do_learn_status): Print more status information.
947         (app_select_openpgp): Store the card version.
948         (store_fpr): Add argument card_version and fix DOs for old cards.
949         (app_openpgp_storekey): Likewise.
950
951 2003-07-23  Werner Koch  <wk@gnupg.org>
952
953         * command.c (cmd_pkauth): New.
954         (cmd_setdata): Check whether data was given at all to avoid
955         passing 0 to malloc.
956
957         * app.c (app_auth): New.
958         * app-openpgp.c (do_auth): New.
959
960 2003-07-22  Werner Koch  <wk@gnupg.org>
961
962         * command.c (cmd_passwd): New.
963         * app.c (app_change_pin): New.
964         * app-openpgp.c (do_change_pin): New.
965         * iso7816.c (iso7816_reset_retry_counter): Implemented.
966
967         * sc-investigate.c (main): New option --gen-random.
968         * iso7816.c (iso7816_get_challenge): Don't create APDUs with a
969         length larger than 255.
970
971 2003-07-17  Werner Koch  <wk@gnupg.org>
972
973         * command.c (cmd_random): New command RANDOM.
974
975         * iso7816.c (map_sw): New. Use it in this file to return
976         meaningful error messages.  Changed all public fucntions to return
977         a gpg_error_t.
978         (iso7816_change_reference_data): New.
979         * apdu.c (apdu_open_reader): Use faked status words for soem
980         system errors.
981
982 2003-07-16  Werner Koch  <wk@gnupg.org>
983
984         * apdu.c (apdu_send_simple): Use apdu_send_le so that we can
985         specify not to send Le as it should be.
986
987 2003-07-15  Werner Koch  <wk@gnupg.org>
988
989         * Makefile.am: Add sc-copykeys program.
990         * sc-copykeys.c: New.
991         * app-openpgp.c (app_openpgp_storekey): New.
992         (app_openpgp_cardinfo): New.
993         (count_bits): New.
994         (store_fpr): And use it here to get the actual length in bit.
995
996 2003-07-03  Werner Koch  <wk@gnupg.org>
997
998         * app-openpgp.c (do_setattr): Add setting of the URL.
999         (app_select_openpgp): Dump card data only in very verbose mode.
1000         (do_decipher): New.
1001
1002 2003-07-02  Werner Koch  <wk@gnupg.org>
1003
1004         * app-openpgp.c (get_sig_counter): New.
1005         (do_sign): Print the signature counter and enable the PIN callback.
1006         (do_genkey): Implement the PIN callback. 
1007
1008 2003-07-01  Werner Koch  <wk@gnupg.org>
1009
1010         * app-openpgp.c (store_fpr): Fixed fingerprint calculation.
1011
1012 2003-06-26  Werner Koch  <wk@gnupg.org>
1013
1014         * app-openpgp.c (find_tlv): Fixed length header parsing.
1015
1016         * app.c (app_genkey): New.
1017         * command.c (cmd_genkey): New.
1018
1019 2003-06-25  Werner Koch  <wk@gnupg.org>
1020
1021         * command.c (percent_plus_unescape): New.
1022         (cmd_setattr): New.
1023
1024 2003-06-24  Werner Koch  <wk@gnupg.org>
1025
1026         * command.c (send_status_info): New.
1027
1028         * app-openpgp.c (app_select_openpgp): Replace SLOT arg by APP arg
1029         and setup the function pointers in APP on success. Changed callers.
1030         * app.c: New.
1031         * app-common.h: New.
1032         * scdaemon.h (APP): New type to handle applications.
1033         (server_control_s): Add an APP context field.
1034
1035         * command.c (cmd_serialno): Handle applications.
1036         (cmd_pksign): Ditto.
1037         (cmd_pkdecrypt): Ditto.
1038         (reset_notify): Ditto.
1039         (cmd_learn): For now return error for application contexts.
1040         (cmd_readcert): Ditto.
1041         (cmd_readkey): Ditto.
1042
1043 2003-06-04  Werner Koch  <wk@gnupg.org>
1044
1045         * card.c (map_sc_err): Renamed gpg_make_err to gpg_err_make.
1046
1047         Renamed error codes from INVALID to INV and removed _ERROR suffixes.
1048
1049 2003-06-03  Werner Koch  <wk@gnupg.org>
1050
1051         Changed all error codes in all files to the new libgpg-error scheme.
1052
1053         * scdaemon.h: Include gpg-error.h and errno.h
1054         * card.c (map_sc_err): Use unknown for the error source.
1055         * Makefile.am: Link with libgpg-error
1056
1057 2003-05-14  Werner Koch  <wk@gnupg.org>
1058
1059         * atr.c, atr.h: New.
1060         * sc-investigate.c: Dump the ATR in a human readable format.
1061
1062 2003-05-08  Werner Koch  <wk@gnupg.org>
1063
1064         * scdaemon.h (DBG_CARD_IO_VALUE): New.
1065
1066         * sc-investigate.c: New.
1067         * scdaemon.c (main): Removed --print-atr option.
1068
1069         * iso7816.c, iso7816.h, app-openpgp.c: New.
1070
1071 2003-04-29  Werner Koch  <wk@gnupg.org>
1072
1073         * scdaemon.c: New options --print-atr and --reader-port
1074         * apdu.c, apdu.h: New
1075
1076         * card.c, card-p15.c, card-dinsig.c: Allow build without OpenSC.
1077         
1078         * Makefile.am (LDFLAGS): Removed.
1079
1080         * command.c (register_commands): Adjusted for new Assuan semantics.
1081
1082 2002-08-21  Werner Koch  <wk@gnupg.org>
1083
1084         * scdaemon.c (main): New option --daemon so that the program is
1085         not accidently started in the background.
1086
1087 2002-08-16  Werner Koch  <wk@gnupg.org>
1088
1089         * scdaemon.c: Include i18n.h.
1090
1091         * card-common.h (struct p15_private_s): Forward declaration.  Add
1092         it to card_ctx_s.
1093         * card.c (card_close): Make sure private data is released.
1094         (card_enum_certs): New.
1095         * card-p15.c (p15_release_private_data): New.
1096         (init_private_data): New to work around an OpenSC weirdness.
1097         (p15_enum_keypairs): Do an OpenSC get_objects only once.
1098         (p15_enum_certs): New.
1099         (card_p15_bind): Bind new function.
1100         * command.c (cmd_learn): Return information about the certificates.
1101
1102 2002-08-09  Werner Koch  <wk@gnupg.org>
1103
1104         * card.c (card_get_serial_and_stamp): Use the tokeinfo serial
1105         number as a fallback. Add a special prefix for serial numbers.
1106
1107 2002-07-30  Werner Koch  <wk@gnupg.org>
1108
1109         Changes to cope with OpenSC 0.7.0:
1110         
1111         * card.c: Removed the check for the packed opensc version.
1112         Changed include file names of opensc.
1113         (map_sc_err): Adjusted error codes for new opensc version.
1114         * card-p15.c: Changed include filename of opensc.
1115         * card-dinsig.c: Ditto.
1116
1117         * card-p15.c (p15_decipher): Add flags argument to OpenSC call.
1118         
1119 2002-07-24  Werner Koch  <wk@gnupg.org>
1120
1121         * card.c (find_simple_tlv, find_iccsn): New.
1122         (card_get_serial_and_stamp): Improved serial number parser.
1123
1124 2002-06-27  Werner Koch  <wk@gnupg.org>
1125
1126         * scdaemon.c (main): Use GNUPG_DEFAULT_HOMEDIR constant.
1127
1128 2002-06-15  Werner Koch  <wk@gnupg.org>
1129
1130         * card-dinsig.c: Documented some stuff from the DIN norm.
1131
1132 2002-04-15  Werner Koch  <wk@gnupg.org>
1133
1134         * command.c (cmd_pksign, cmd_pkdecrypt): Use a copy of the key ID.
1135
1136 2002-04-12  Werner Koch  <wk@gnupg.org>
1137
1138         * scdaemon.c: New option --debug-sc N.
1139         * card.c (card_open): set it here.
1140
1141         * card-p15.c (p15_prepare_key): Factored out common code from ...
1142         (p15_sign, p15_decipher): here and made the decryption work the
1143         regular way.
1144
1145 2002-04-10  Werner Koch  <wk@gnupg.org>
1146
1147         * card.c (card_open): Return immediately when no reader is available.
1148
1149 2002-03-27  Werner Koch  <wk@gnupg.org>
1150
1151         * card.c (card_open, card_close): Adjusted for changes in OpenSC.
1152
1153 2002-03-10  Werner Koch  <wk@gnupg.org>
1154
1155         * card-p15.c, card-dinsig.c, card-common.h: New.
1156         * card.c: Factored most code out to the new modules, so that we
1157         can better support different types of card applications.
1158
1159 2002-01-26  Werner Koch  <wk@gnupg.org>
1160
1161         * scdaemon.c scdaemon.h, command.c: New. Based on the code from
1162         the gpg-agent.
1163
1164         
1165  Copyright 2002, 2003, 2004, 2005 Free Software Foundation, Inc.
1166
1167  This file is free software; as a special exception the author gives
1168  unlimited permission to copy and/or distribute it, with or without
1169  modifications, as long as this notice is preserved.
1170
1171  This file is distributed in the hope that it will be useful, but
1172  WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
1173  implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.