doc cleanups.
[libgcrypt.git] / NEWS
1 Noteworthy changes in version 1.4.3
2 ------------------------------------------------
3
4  * More self-tests.
5
6  * Documentation cleanups.
7
8
9 Noteworthy changes in version 1.4.2 (2008-09-08)
10 ------------------------------------------------
11
12  * The long missing gcry_mpi_lshift function has been added.
13
14  * RSA key generation now supports a "transient-key" flag.
15
16  * The keygrip computation for ECDSA has been implemented thus ECDSA
17    is now fully supported.
18
19  * A few macros have been replaced by functions for better type
20    checking.
21
22  * The thread initialization structure now carries version
23    information.
24
25  * The manual describes more clearly how to initialize Libgcrypt.
26
27  * The library may now be switched into a FIPS mode.
28
29  * Interface changes relative to the 1.3.0 release:
30  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
31  GCRYCTL_OPERATIONAL_P   NEW.
32  GCRYCTL_FIPS_MODE_P     NEW.
33  GCRYCTL_FORCE_FIPS_MODE NEW.
34  gcry_cipher_setkey      NEW: Replaces macro.
35  gcry_cipher_setiv       NEW: Replaces macro.
36  gcry_cipher_setctr      NEW: Replaces macro.
37  gcry_mpi_lshift         NEW.
38  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
39
40
41 Noteworthy changes in version 1.4.1 (2008-04-25)
42 ------------------------------------------------
43
44  * Fixed a bug introduced by 1.3.1 which led to the comsumption of far
45    too much entropy for the intial seeding.
46
47  * Improved AES performance for CFB and CBC modes.
48
49  * Removed build problems for the Padlock support.
50
51
52 Noteworthy changes in version 1.4.0 (2007-12-10)
53 ------------------------------------------------
54
55  * New configure option --disable-padlock-support which is mostly
56    useful in case of build problems.
57
58
59 Noteworthy changes in version 1.3.2 (2007-12-03)
60 ------------------------------------------------
61
62  * The visibility attribute is now used if supported by the toolchain.
63
64  * The ACE engine of VIA processors is now used for AES-128.
65
66  * The ASN.1 DER template for SHA-224 has been fixed.
67
68
69 Noteworthy changes in version 1.3.1 (2007-10-26)
70 ------------------------------------------------
71
72  * The entire library is now under the LGPL. The helper programs and
73    the manual are under the GPL.  Kudos to Peter Gutmann for giving
74    permissions to relicense the rndw32 and rndunix modules.
75
76  * The Camellia cipher is now under the LGPL and included by default.
77
78  * Fixed a bug in the detection of symbol prefixes which inhibited the
79    build of optimzied assembler code on certain systems.
80
81  * Updated the entropy gatherer for W32.
82
83
84 Noteworthy changes in version 1.3.0 (2007-05-04)
85 ------------------------------------------------
86
87  * Changed the way the RNG gets initialized. This allows to keep it
88    uninitialized as long as no random numbers are used.  To override
89    this, the new macro gcry_fast_random_poll may be used.  It is in
90    general a good idea to spread this macro into the application code
91    to make sure that these polls happen often enough.
92
93  * Made the RNG immune against fork without exec.
94
95  * Reading and writing the random seed file is now protected by a
96    fcntl style file lock on systems that provide this function.
97
98  * Support for SHA-224 and HMAC using SHA-384 and SHA-512.
99
100  * Support for the SEED cipher.
101
102  * Support for the Camellia cipher.  Note that Camellia is disabled by
103    default, and that enabling it changes the license of libgcrypt from
104    LGPL to GPL.
105
106  * Support for OFB encryption mode.
107
108  * gcry_mpi_rshift does not anymore truncate the shift count.
109
110  * Reserved algorithm ranges for use by applications.
111
112  * Support for DSA2.
113
114  * The new function gcry_md_debug should be used instead of the
115    gcry_md_start_debug and gcry_md_stop_debug macros.
116
117  * New configure option --enable-random-daemon to support a system
118    wide random daemon.  The daemon code is experimental and not yet
119    very well working.  It will eventually allow to keep a global
120    random pool for the sake of short living processes.
121
122  * Non executable stack support is now used by default on systems
123    supporting it.
124
125  * Support for Microsoft Windows.
126
127  * Assembler support for the AMD64 architecture.
128
129  * New configure option --enable-mpi-path for optimized builds.
130
131  * Experimental support for ECDSA; should only be used for testing.
132
133  * New control code GCRYCTL_PRINT_CONFIG to print the build
134    configuration.
135
136  * Minor changes to some function declarations.  Buffer arguments are
137    now typed as void pointer.  This should not affect any compilation.
138    Fixed two bugs in return values and clarified documentation.
139
140  * Interface changes relative to the 1.2.0 release:
141  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
142  gcry_fast_random_poll   NEW
143  gcry_md_debug           NEW
144  gcry_sexp_nth_string    NEW
145  GCRY_MD_SHA224          NEW
146  GCRY_PK_USAGE_CERT      NEW
147  GCRY_PK_USAGE_AUTH      NEW
148  GCRY_PK_USAGE_UNKN      NEW
149  GCRY_PK_ECDSA           NEW
150  GCRY_CIPHER_SEED        NEW
151  GCRY_CIPHER_CAMELLIA128 NEW
152  GCRY_CIPHER_CAMELLIA192 NEW
153  GCRY_CIPHER_CAMELLIA256 NEW
154  GCRYCTL_FAKED_RANDOM_P  NEW 
155  GCRYCTL_PRINT_CONFIG    NEW
156  GCRYCTL_SET_RNDEGD_SOCKET  NEW.
157  gcry_mpi_scan           CHANGED: Argument BUFFER is now void*.
158  gcry_pk_algo_name       CHANGED: Returns "?" instead of NULL.
159  gcry_cipher_algo_name   CHANGED: Returns "?" instead of "".
160  gcry_pk_spec_t          CHANGED: Element ALIASES is now const ptr.
161  gcry_md_write_t         CHANGED: Argument BUF is now a const void*.
162  gcry_md_ctl             CHANGED: Argument BUFFER is now void*.
163  gcry_cipher_encrypt     CHANGED: Arguments IN and OUT are now void*.
164  gcry_cipher_decrypt     CHANGED: Arguments IN and OUT are now void*.
165  gcry_sexp_sprint        CHANGED: Argument BUFFER is now void*.
166  gcry_create_nonce       CHANGED: Argument BUFFER is now void*.
167  gcry_randomize          CHANGED: Argument BUFFER is now void*.
168  gcry_cipher_register    CHANGED: Argument ALGORITHM_ID is now int*.
169  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
170
171
172 Noteworthy changes in version 1.2.0 (2004-04-15)
173 ------------------------------------------------
174
175  * First stable release.
176
177
178 Noteworthy changes in version 1.1.94 (2004-03-29)
179 -------------------------------------------------
180
181  * The support for multi-threaded users goes into its third
182    incarnation.  We removed compile time support for thread libraries.
183    To support the thread library of your choice, you have to set up
184    callback handlers at initialization time.  New data structures, a
185    new control command, and default initializers are provided for this
186    purpose.
187
188  * Interface changes relative to the 1.1.93 release:
189 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
190 libgcrypt-config --thread       OBSOLETE
191 libgcrypt-pth.la                REMOVED
192 libgcrypt-pthread.la            REMOVED
193 GCRYCTL_SET_THREAD_CBS          NEW
194 struct gcrypt_thread_cbs        NEW
195 enum gcry_thread_option         NEW
196 GCRY_THREAD_OPTION_PTH_IMPL     NEW
197 GCRY_THREAD_OPTION_PTHREAD_IMPL NEW
198 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
199
200 Noteworthy changes in version 1.1.93 (2004-03-06)
201 -------------------------------------------------
202
203  * The automatic thread library detection has finally been removed.
204    From now on, only linking explicitely to libgcrypt, libgcrypt-pth
205    or libgcrypt-pthread is supported.
206
207 Noteworthy changes in version 1.1.92 (2004-02-20)
208 -------------------------------------------------
209
210  * Minor bug fixes.
211
212  * Included a limited implementation of RFC2268.
213
214  * Changed API of the gcry_ac_ functions.  Only a very few programs
215    should be affected by this.
216
217  * Interface changes relative to the 1.1.91 release:
218 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
219 GCRY_CIPHER_RFC2268_40          NEW.
220 gcry_ac_data_set                CHANGED: New argument FLAGS.
221 gcry_ac_data_get_name           CHANGED: New argument FLAGS.
222 gcry_ac_data_get_index          CHANGED: New argument FLAGS.
223 gcry_ac_key_pair_generate       CHANGED: New and reordered arguments.
224 gcry_ac_key_test                CHANGED: New argument HANDLE.
225 gcry_ac_key_get_nbits           CHANGED: New argument HANDLE.
226 gcry_ac_key_get_grip            CHANGED: New argument HANDLE.
227 gcry_ac_data_search             REMOVED.
228 gcry_ac_data_add                REMOVED.
229 GCRY_AC_DATA_FLAG_NO_BLINDING   REMOVED.
230 GCRY_AC_FLAG_NO_BLINDING        NEW: Replaces above.
231
232
233 Noteworthy changes in version 1.1.91 (2003-12-19)
234 -------------------------------------------------
235
236  * Code cleanups and minor bug fixes.
237
238
239 Noteworthy changes in version 1.1.90 (2003-11-14)
240 -------------------------------------------------
241
242  * The use of the GCRY_WEAK_RANDOM level is now deprecated in favor of
243    the new gcry_create_nonce function.
244
245  * gcry_sexp_build now supports a "%b" format to include a memory buffer.
246
247  * Minor configuration fixes.
248  
249  * Interface changes relative to the 1.1.44 release:
250 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
251 gcry_create_nonce               NEW
252 gcry_sexp_build                 ENHANCED
253
254
255 Noteworthy changes in version 1.1.44 (2003-10-31)
256 -------------------------------------------------
257
258  * Bug fixes and more code cleanups.
259
260  * Enhanced the prime API.
261
262  * Interface changes relative to the 1.1.43 release:
263 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
264 gcry_prime_group_generator      NEW
265 gcry_prime_release_factors      NEW
266
267
268 Noteworthy changes in version 1.1.43 (2003-09-04)
269 -------------------------------------------------
270
271  * Bug fixes and internal code cleanups.
272
273  * Support for the Serpent cipher algorithm.
274
275  * Interface changes relative to the 1.1.42 release:
276 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
277 gcry_prime_generate             NEW
278 gcry_prime_check                NEW
279
280
281 Noteworthy changes in version 1.1.42 (2003-07-31)
282 -------------------------------------------------
283
284  * Major API cleanup.  Applications need to be converted to the new
285    API.  See README.apichanges for hints on how to do that.  Backward
286    compatibility is provided where it was possible without too much
287    effort and did not collide with the overall sanitization effort.
288    However, this is only for ease of transition.  NO DEPRECATED
289    FUNCTION OR DATA TYPE IS CONSIDERED A PART OF THE API OR ABI AND
290    WILL BE DROPPED IN THE FUTURE WITHOUT CHANGING THE SONAME OF THE
291    LIBRARY. 
292
293  * If gcrypt.h is included in sources compiled by GCC 3.1 or later,
294    deprecated attributes will warn about use of obsolete functions and
295    type definitions.  You can suppress these warnings by passing
296    -Wno-deprecated-declarations to the gcc command.
297
298  * gcry_check_version must be called from now on to initialize the
299    library, it is not longer optional.
300
301  * Removed `libgcrypt errno' concept.
302
303  * Libgcrypt depends on libgpg-error, a library that provides error
304    codes and according functions for all GnuPG components.  Functions
305    that used to return error codes asa `int' have been changed to
306    return a code of type `gcry_error_t'.  All GCRYERR_* error symbols
307    have been removed, since they are now contained in libgpg-error
308    (GPG_ERR_*). All functions and types in libgpg-error have also been
309    wrapped in Libgcrypt. The new types are gcry_err_code_t and
310    gcry_err_source_t.  The new functions are gcry_err_code,
311    gcry_err_source, gcry_error, gcry_err_make, gcry_error_from_errno,
312    gcry_err_make_from_errno, gcry_err_code_from_errno,
313    gcry_err_code_to_errno, gcry_strsource.
314
315  * New function gcry_mpi_dump to help in debugging. 
316
317  * Added alternative interface for asymmetric cryptography.
318
319  * CRC-32, CRC-32 a'la RFC 1510, CRC-24 a'la RFC 2440 are now
320    supported.
321
322  * SHA-256, SHA-384 and SHA-512 are now supported.
323
324  * 128 bit Twofish is now supported.
325
326  * The random module won't print the "not enough random bytes
327    available" anymore.  A new progress status is issued instead.
328
329  * CBC-MAC for block ciphers is now supported, by using a
330    GCRY_CIPHER_CBC_MAC cipher flag.
331
332  * CTR mode for block ciphers is now supported.
333
334  * The public RSA exponent can now be specified in key generation. 
335
336  * RSA blinding is now supported and is used automatically for RSA
337    decryption.  It can be explicitely disabled by using the
338    `no-blinding' symbol in the `flags' S-Expression or by using the
339    GCRY_AC_FLAG_DATA_NO_BLINDING flag when using the ac interface.
340
341  * gcry_sexp_canon_len does not use a `historically encoded' error
342    code anymore.
343
344
345  * Interface changes relative to the 1.1.12 release:
346 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
347 GCRY_MPI                        DEPRECATED; Use: gcry_mpi_t
348 GcryMPI                         DEPRECATED; Use: gcry_mpi_t
349 GCRY_SEXP                       DEPRECATED; Use: gcry_sexp_t
350 GcrySexp                        DEPRECATED; Use: gcry_sexp_t
351 GCRY_CIPHER_HD                  DEPRECATED; Use: gcry_cipher_hd_t
352 GcryCipherHd                    DEPRECATED; Use: gcry_cipher_hd_t
353 GCRY_MD_HD                      DEPRECATED; Use: gcry_md_hd_t
354 GcryMDHd                        DEPRECATED; Use: gcry_md_hd_t
355 gcry_error_t                    NEW
356 gcry_err_code_t                 NEW
357 gcry_err_source_t               NEW
358 gcry_err_make                   NEW
359 gcry_error                      NEW
360 gcry_err_code                   NEW
361 gcry_err_source                 NEW
362 gcry_err_code_from_errno        NEW
363 gcry_err_code_to_errno          NEW
364 gcry_err_make_from_errno        NEW
365 gcry_error_from_errno           NEW
366 gcry_strsource                  NEW
367 GCRYERR_{some error code}       REMOVED; Use GPG_ERR_*
368                                          from libgpg-error instead.
369 gcry_errno                      REMOVED
370 gcry_sexp_canon_len             CHANGED
371 gcry_sexp_build_array           NEW
372 gcry_mpi_scan                   CHANGED: New argument to separate in/out args.
373 gcry_mpi_print                  CHANGED: Ditto.
374 gcry_mpi_dump                   NEW
375 gcry_cipher_open                CHANGED
376 gcry_cipher_reset               NEW
377 gcry_cipher_register            NEW
378 gcry_cipher_unregister          NEW
379 gcry_cipher_list                NEW
380 gcry_cipher_algo_keylen         REPLACED macro with function.
381 gcry_cipher_algo_blklen         REPLACED macro with function.
382 gcry_pk_register                NEW
383 gcry_pk_unregister              NEW
384 gcry_pk_list                    NEW
385 gcry_pk_decrypt                 ENHANCED: Allows flag to return
386                                           complete S-expression.
387 gcry_md_open                    CHANGED
388 gcry_md_copy                    CHANGED
389 gcry_md_is_enabled              NEW
390 gcry_md_is_secure               NEW
391 gcry_md_register                NEW
392 gcry_md_unregister              NEW
393 gcry_md_list                    NEW
394 gcry_ac_data_t                  NEW
395 gcry_ac_key_t                   NEW
396 gcry_ac_key_pair_t              NEW
397 gcry_ac_handle_t                NEW
398 gcry_ac_key_spec_rsa_t          NEW
399 gcry_ac_data_new                NEW
400 gcry_ac_data_destroy            NEW
401 gcry_ac_data_set                NEW
402 gcry_ac_data_copy               NEW
403 gcry_ac_data_length             NEW
404 gcry_ac_data_get_name           NEW
405 gcry_ac_data_get_index          NEW
406 gcry_ac_data_clear              NEW
407 gcry_ac_open                    NEW
408 gcry_ac_close                   NEW
409 gcry_ac_key_init                NEW
410 gcry_ac_key_pair_generate       NEW
411 gcry_ac_key_pair_extract        NEW
412 gcry_ac_key_data_get            NEW
413 gcry_ac_key_test                NEW
414 gcry_ac_key_get_nbits           NEW
415 gcry_ac_key_get_grip            NEW
416 gcry_ac_key_destroy             NEW
417 gcry_ac_key_pair_destroy        NEW
418 gcry_ac_data_encrypt            NEW
419 gcry_ac_data_decrypt            NEW
420 gcry_ac_data_sign               NEW
421 gcry_ac_data_verify             NEW
422 gcry_ac_id_to_name              NEW
423 gcry_ac_name_to_id              NEW
424 gcry_handler_progress_t         NEW
425 gcry_handler_alloc_t            NEW
426 gcry_handler_secure_check_t     NEW
427 gcry_handle_realloc_t           NEW
428 gcry_handler_free_t             NEW
429 gcry_handler_no_mem_t           NEW
430 gcry_handler_error_t            NEW
431 gcry_handler_log_t              NEW
432 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
433
434 Noteworthy changes in version 1.1.12 (2003-01-20)
435 -------------------------------------------------
436
437  * gcry_pk_sign, gcry_pk_verify and gcry_pk_encrypt can now handle an
438    optional pkcs1 flags parameter in the S-expression.  A similar flag
439    may be passed to gcry_pk_decrypt but it is only syntactically
440    implemented.
441
442  * New convenience macro gcry_md_get_asnoid.
443
444  * There is now some real stuff in the manual.
445
446
447 Noteworthy changes in version 1.1.11 (2002-12-21)
448 -------------------------------------------------
449
450  * Don't export internal symbols anymore (currently only for GNU systems)
451
452  * New algorithm: MD4
453
454  * Implemented ciphertext stealing.
455
456  * Smaller bugs fixes and a few new OIDs.
457
458  * Interface changes relative to the 1.1.8 release:
459 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
460 gcry_cipher_cts                   NEW
461 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
462
463
464 Noteworthy changes in version 1.1.10 (2002-09-20)
465 -------------------------------------------------
466
467  * Fixed shared library builds for i386, PPC and Sparc.
468
469  * Added simple benchmark tool.
470
471  * Replaced the internal mutexes by code which automatically adapts to
472    the used threading library.  Currently Pth and Pthread are
473    supported.  For non-ELF systems the GNU toolchain is now required..
474
475  * Added untested support to build Windows DLLs.
476
477 Noteworthy changes in version 1.1.9 (2002-08-23)
478 ------------------------------------------------
479
480  * Support for plain old DES.
481
482
483 Noteworthy changes in version 1.1.8 (2002-06-25)
484 ------------------------------------------------
485
486  * Minor cleanups and exported a few new functions.
487
488  * Interface changes relative to the 1.1.7 release:
489 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
490 gcry_mpi_div                      NEW
491 gcry_mpi_mod                      NEW
492 gcry_mpi_invm                     NEW
493 gcry_mpi_swap                     NEW
494 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
495
496 Noteworthy changes in version 1.1.7 (2002-05-21)
497 ------------------------------------------------
498
499 * Libgcrypt is now distributed under the terms of the GNU Lesser
500   General Public License; see the README file for details.    
501   
502 * It is possible to use libgcrypt w/o intialized secure memory.
503
504 * Libgcrypt should now be thread safe after the initialization.
505   gcry_control (GCRYCRL_INITIALIZATION_FINISHED,NULL,0) should have
506   been called before creating additional threads.
507
508  * Interface changes relative to the 1.1.6 release:
509 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
510 GCRYCTL_DISABLE_INTERNAL_LOCKING  NEW
511 GCRYCTL_DISABLE_SECMEM            NEW
512 GCRYCTL_INITIALIZATION_FINISHED   NEW
513 GCRYCTL_INITIALIZATION_FINISHED_P NEW
514 GCRYCTL_ANY_INITIALIZATION_P      NEW
515 gcry_strdup                       NEW
516 gcry_sexp_create                  NEW
517 gcry_sexp_new                     NEW
518 gcry_set_progress_handler         NEW
519 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
520
521 Noteworthy changes in version 1.1.6 (2002-02-07)
522 ------------------------------------------------
523
524   * Enhanced the S-expression conversion functions.
525         
526 Noteworthy changes in version 1.1.5 (2001-12-18)
527 ------------------------------------------------
528
529   * gcry_{cipher,md}_map_name are now able to map stringified object IDs.
530
531   * New functions gcry_sexp_canon_len and gcry_cipher_mode_from_oid.
532
533   * Closed some memory leaks.
534
535
536 Noteworthy changes in version 1.1.4 (2001-08-03)
537 ------------------------------------------------
538
539   * Arcfour does now work.                   
540
541   * Some minor fixes.
542
543   * Added a first test program
544
545   * Migrated to autoconf 2.52.
546
547
548 Noteworthy changes in version 1.1.3 (2001-05-31)
549 ------------------------------------------------
550
551   * First release of Libgcrypt which is a result of splitting GnuPG
552     into into libgcrypt and GnuPG.
553
554
555 Copyright 2001, 2002, 2003, 2004, 2007, 2008 Free Software Foundation, Inc.
556
557 This file is free software; as a special exception the author gives
558 unlimited permission to copy and/or distribute it, with or without
559 modifications, as long as this notice is preserved.
560
561 This file is distributed in the hope that it will be useful, but
562 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
563 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.