ecc: Fix initialization of EC context.
[libgcrypt.git] / NEWS
1 Noteworthy changes in version 1.7.0 (unreleased)
2 ------------------------------------------------
3
4  * Added emulation for broken Whirlpool code prior to 1.6.0.
5
6  * Added support for curve sec256k1.
7
8  * Added support for curves GOST R 34.10-2001 and GOST R 34.10-2012.
9
10  * Improved performance of KDF functions.
11
12  * Improved ECDSA compliance.
13
14  * Moved locking out to libgpg-error.
15
16  * Fixed message digest lookup by OID (regression in 1.6.0).
17
18  * Fixed a build problem on NetBSD.
19
20  * Fixed memory leaks in ECC code.
21
22  * Fixed some asm build problems and feature detection bugs.
23
24  * Added OCB mode.
25
26  * Added support for the SHA3-224, SHA3-256, SHA3-384 and SHA3-512
27    hash algorithms.
28
29  * Added support for the SHAKE128 and SHAKE256 extendable-output
30    function algorithms.
31
32  * Added support for the ChaCha20 stream cipher.
33
34  * Added support for the Poly1305 message authentication algorithm and
35    ChaCha20-Poly1305 Authenticated Encryption with Associated Data
36    mode.
37
38  * New flag "no-keytest" for ECC key generation.  Due to a bug in the
39    parser that flag will also be accepted but ignored by older version
40    of Libgcrypt.
41
42  * Interface changes relative to the 1.6.0 release:
43  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
44  gcry_mac_get_algo               NEW.
45  gcry_md_extract                 NEW.
46  GCRY_MAC_HMAC_MD2               NEW.
47  GCRY_MD_FLAG_BUGEMU1            NEW.
48  GCRYCTL_SET_SBOX                NEW.
49  gcry_cipher_set_sbox            NEW macro.
50  GCRY_MD_GOSTR3411_CP            NEW.
51  GCRY_MD_SHA3_224                NEW.
52  GCRY_MD_SHA3_256                NEW.
53  GCRY_MD_SHA3_384                NEW.
54  GCRY_MD_SHA3_512                NEW.
55  GCRY_MD_SHAKE128                NEW.
56  GCRY_MD_SHAKE256                NEW.
57  GCRY_MAC_HMAC_SHA3_224          NEW.
58  GCRY_MAC_HMAC_SHA3_256          NEW.
59  GCRY_MAC_HMAC_SHA3_384          NEW.
60  GCRY_MAC_HMAC_SHA3_512          NEW.
61  GCRY_MAC_POLY1305               NEW.
62  GCRY_MAC_POLY1305_AES           NEW.
63  GCRY_MAC_POLY1305_CAMELLIA      NEW.
64  GCRY_MAC_POLY1305_TWOFISH       NEW.
65  GCRY_MAC_POLY1305_SERPENT       NEW.
66  GCRY_MAC_POLY1305_SEED          NEW.
67  gcry_mpi_ec_sub                 NEW.
68  gcry_mpi_ec_decode_point        NEW.
69  GCRY_CIPHER_MODE_POLY1305       NEW.
70  GCRY_CIPHER_MODE_OCB            NEW.
71  GCRYCTL_SET_TAGLEN              NEW.
72  GCRYCTL_GET_TAGLEN              NEW.
73  gcry_cipher_final               NEW macro.
74  GCRY_PK_EDDSA                   NEW constant.
75
76
77 Noteworthy changes in version 1.6.0 (2013-12-16)
78 ------------------------------------------------
79
80  * Removed the long deprecated gcry_ac interface.  Thus Libgcrypt is
81    not anymore ABI compatible to previous versions if they used the ac
82    interface.
83
84  * Removed the module register subsystem.
85
86  * The deprecated message digest debug macros have been removed.  Use
87    gcry_md_debug instead.
88
89  * Removed deprecated control codes.
90
91  * Improved performance of most cipher algorithms as well as for the
92    SHA family of hash functions.
93
94  * Added support for the IDEA cipher algorithm.
95
96  * Added support for the Salsa20 and reduced Salsa20/12 stream ciphers.
97
98  * Added limited support for the GOST 28147-89 cipher algorithm.
99
100  * Added support for the GOST R 34.11-94 and R 34.11-2012 (Stribog)
101    hash algorithms.
102
103  * Added a random number generator to directly use the system's RNG.
104    Also added an interface to prefer the use of a specified RNG.
105
106  * Added support for the SCRYPT algorithm.
107
108  * Mitigated the Yarom/Falkner flush+reload side-channel attack on RSA
109    secret keys.  See <http://eprint.iacr.org/2013/448> [CVE-2013-4242].
110
111  * Added support for Deterministic DSA as per RFC-6979.
112
113  * Added support for curve Ed25519.
114
115  * Added a scatter gather hash convenience function.
116
117  * Added several MPI amd SEXP helper functions.
118
119  * Added support for negative numbers to gcry_mpi_print,
120    gcry_mpi_aprint and gcry_mpi_scan.
121
122  * The algorithm ids GCRY_PK_ECDSA and GCRY_PK_ECDH are now
123    deprecated.  Use GCRY_PK_ECC if you need an algorithm id.
124
125  * Changed gcry_pk_genkey for "ecc" to only include the curve name and
126    not the parameters.  The flag "param" may be used to revert this.
127
128  * Added a feature to globally disable selected hardware features.
129
130  * Added debug helper functions.
131
132  * Interface changes relative to the 1.5.0 release:
133  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
134  gcry_ac_*                       REMOVED.
135  GCRY_AC_*                       REMOVED.
136  gcry_module_t                   REMOVED.
137  gcry_cipher_register            REMOVED.
138  gcry_cipher_unregister          REMOVED.
139  gcry_cipher_list                REMOVED.
140  gcry_pk_register                REMOVED.
141  gcry_pk_unregister              REMOVED.
142  gcry_pk_list                    REMOVED.
143  gcry_md_register                REMOVED.
144  gcry_md_unregister              REMOVED.
145  gcry_md_list                    REMOVED.
146  gcry_md_start_debug             REMOVED (macro).
147  gcry_md_stop_debug              REMOVED (macro).
148  GCRYCTL_SET_KEY                 REMOVED.
149  GCRYCTL_SET_IV                  REMOVED.
150  GCRYCTL_SET_CTR                 REMOVED.
151  GCRYCTL_DISABLE_ALGO            CHANGED: Not anymore thread-safe.
152  gcry_pk_genkey                  CHANGED: ECC curve params not returned.
153  gcry_md_hash_buffers            NEW.
154  gcry_buffer_t                   NEW.
155  GCRYCTL_SET_ENFORCED_FIPS_FLAG  NEW.
156  GCRYCTL_SET_PREFERRED_RNG_TYPE  NEW.
157  GCRYCTL_GET_CURRENT_RNG_TYPE    NEW.
158  GCRYCTL_CLOSE_RANDOM_DEVICE     NEW.
159  GCRY_RNG_TYPE_STANDARD          NEW.
160  GCRY_RNG_TYPE_FIPS              NEW.
161  GCRY_RNG_TYPE_SYSTEM            NEW.
162  gcry_mpi_is_neg                 NEW.
163  gcry_mpi_neg                    NEW.
164  gcry_mpi_abs                    NEW.
165  gcry_mpi_snatch                 NEW.
166  gcry_mpi_set_opaque_copy        NEW.
167  gcry_mpi_point_t                NEW.
168  gcry_mpi_point_new              NEW.
169  gcry_mpi_point_release          NEW.
170  gcry_mpi_point_get              NEW.
171  gcry_mpi_point_snatch_get       NEW.
172  gcry_mpi_point_set              NEW.
173  gcry_mpi_point_snatch_set       NEW.
174  gcry_ctx_t                      NEW.
175  gcry_ctx_release                NEW.
176  gcry_mpi_ec_new                 NEW.
177  gcry_mpi_ec_get_mpi             NEW.
178  gcry_mpi_ec_get_point           NEW.
179  gcry_mpi_ec_set_mpi             NEW.
180  gcry_mpi_ec_set_point           NEW.
181  gcry_mpi_ec_get_affine          NEW.
182  gcry_mpi_ec_dup                 NEW.
183  gcry_mpi_ec_add                 NEW.
184  gcry_mpi_ec_mul                 NEW.
185  gcry_mpi_ec_curve_point         NEW.
186  GCRYMPI_FLAG_IMMUTABLE          NEW.
187  GCRYMPI_FLAG_CONST              NEW.
188  GCRYMPI_FLAG_USER1              NEW.
189  GCRYMPI_FLAG_USER2              NEW.
190  GCRYMPI_FLAG_USER3              NEW.
191  GCRYMPI_FLAG_USER4              NEW.
192  GCRYMPI_CONST_ONE               NEW.
193  GCRYMPI_CONST_TWO               NEW.
194  GCRYMPI_CONST_THREE             NEW.
195  GCRYMPI_CONST_FOUR              NEW.
196  GCRYMPI_CONST_EIGHT             NEW.
197  GCRYMPI_FMT_OPAQUE              NEW.
198  GCRYPT_VERSION_NUMBER           NEW.
199  GCRY_KDF_SCRYPT                 NEW.
200  gcry_pubkey_get_sexp            NEW.
201  GCRYCTL_DISABLE_LOCKED_SECMEM   NEW.
202  GCRYCTL_DISABLE_PRIV_DROP       NEW.
203  GCRY_CIPHER_SALSA20             NEW.
204  gcry_sexp_nth_buffer            NEW.
205  gcry_sexp_extract_param         NEW.
206  GCRY_CIPHER_SALSA20R12          NEW.
207  GCRY_CIPHER_GOST28147           NEW.
208  GCRY_MD_GOSTR3411_94            NEW.
209  GCRY_MD_STRIBOG256              NEW.
210  GCRY_MD_STRIBOG512              NEW.
211  GCRY_PK_ECC                     NEW.
212  gcry_log_debug                  NEW.
213  gcry_log_debughex               NEW.
214  gcry_log_debugmpi               NEW.
215  gcry_log_debugpnt               NEW.
216
217
218 Noteworthy changes in version 1.5.0 (2011-06-29)
219 ------------------------------------------------
220
221  * New function gcry_kdf_derive implementing OpenPGP S2K algorithms
222    and PBKDF2.
223
224  * Support for WindowsCE.
225
226  * Support for ECDH.
227
228  * Support for OAEP and PSS methods as described by RFC-3447.
229
230  * Fixed PKCS v1.5 code to always return the leading zero.
231
232  * New format specifiers "%M" and "%u" for gcry_sexp_build.
233
234  * Support opaque MPIs with "%m" and "%M" in gcry_sexp_build.
235
236  * New functions gcry_pk_get_curve and gcry_pk_get_param to map ECC
237    parameters to a curve name and to retrieve parameter values.
238
239  * gcry_mpi_cmp applied to opaque values has a defined semantic now.
240
241  * Uses the Intel AES-NI instructions if available.
242
243  * The use of the deprecated Alternative Public Key Interface
244    (gcry_ac_*) will now print compile time warnings.
245
246  * The module register subsystem has been deprecated.  This subsystem
247    is not flexible enough and would always require ABI changes to
248    extend the internal interfaces.  It will eventually be removed.
249    Please contact us on the gcrypt-devel mailing list to discuss
250    whether you really need this feature or how it can be replaced by
251    an internal plugin mechanism.
252
253  * CTR mode may now be used with data chunks of arbitrary length.
254
255  * Changes also done in 1.4.6 (2010-07-13):
256  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
257
258  * New variants of the TIGER algorithm.
259
260  * New cipher algorithm mode for AES-WRAP.
261
262  * Changes also done in 1.4.5 (2009-12-11):
263  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
264
265  * Fixed minor memory leak in DSA key generation.
266
267  * No more switching to FIPS mode if /proc/version is not readable.
268
269  * Fixed sigill during Padlock detection on old CPUs.
270
271  * Fixed a hang on some W2000 machines.
272
273  * Boosted SHA-512 performance by 30% on ia32 boxes and gcc 4.3;
274    SHA-256 went up by 25%.
275
276  * Interface changes relative to the 1.4.6 release:
277  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
278  GCRY_PK_ECDH               NEW.
279  gcry_pk_get_curve          NEW.
280  gcry_pk_get_param          NEW.
281  GCRYCTL_DISABLE_HWF        NEW.
282  gcry_kdf_derive            NEW.
283  gcry_pk_encrypt            EXTENDED: Support OAEP.
284  gcry_pk_decrypt            EXTENDED: Support OAEP.
285  gcry_pk_sign               EXTENDED: Support PSS.
286  gcry_pk_verify             EXTENDED: Support PSS.
287  gcry_sexp_build            EXTENDED: Add format specifiers M and u.
288
289  * Interface changes relative to the 1.4.2 release:
290  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
291  GCRY_CIPHER_MODE_AESWRAP   NEW.
292  GCRY_MD_TIGER1             NEW.
293  GCRY_MD_TIGER2             NEW.
294
295
296 Noteworthy changes in version 1.4.4 (2009-01-22)
297 ------------------------------------------------
298
299  * Publish GCRY_MODULE_ID_USER and GCRY_MODULE_ID_USER_LAST constants.
300    This functionality has been in Libgcrypt since 1.3.0.
301
302  * MD5 may now be used in non-enforced fips mode.
303
304  * Fixed HMAC for SHA-384 and SHA-512 with keys longer than 64 bytes.
305
306  * In fips mode, RSA keys are now generated using the X9.31 algorithm
307    and DSA keys using the FIPS 186-2 algorithm.
308
309  * The transient-key flag is now also supported for DSA key
310    generation.  DSA domain parameters may be given as well.
311
312
313 Noteworthy changes in version 1.4.3 (2008-09-18)
314 ------------------------------------------------
315
316  * Try to auto-initialize Libgcrypt to minimize the effect of
317    applications not doing that correctly.  This is not a perfect
318    solution but given that many applicationion would totally fail
319    without such a hack, we try to help at least with the most common
320    cases.  Folks, please read the manual to learn how to properly
321    initialize Libgcrypt!
322
323  * Auto-initialize the secure memory to 32k instead of aborting the
324    process.
325
326  * Log fatal errors via syslog.
327
328  * Changed the name and the semantics of the fips mode config file.
329
330  * Add convenience macro gcry_fips_mode_active.
331
332  * More self-tests.
333
334  * Documentation cleanups.
335
336
337 Noteworthy changes in version 1.4.2 (2008-09-08)
338 ------------------------------------------------
339
340  * The long missing gcry_mpi_lshift function has been added.
341
342  * RSA key generation now supports a "transient-key" flag.
343
344  * The keygrip computation for ECDSA has been implemented thus ECDSA
345    is now fully supported.
346
347  * A few macros have been replaced by functions for better type
348    checking.
349
350  * The thread initialization structure now carries version
351    information.
352
353  * The manual describes more clearly how to initialize Libgcrypt.
354
355  * The library may now be switched into a FIPS mode.
356
357  * Interface changes relative to the 1.3.0 release:
358  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
359  GCRYCTL_OPERATIONAL_P   NEW.
360  GCRYCTL_FIPS_MODE_P     NEW.
361  GCRYCTL_FORCE_FIPS_MODE NEW.
362  gcry_cipher_setkey      NEW: Replaces macro.
363  gcry_cipher_setiv       NEW: Replaces macro.
364  gcry_cipher_setctr      NEW: Replaces macro.
365  gcry_mpi_lshift         NEW.
366  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
367
368
369 Noteworthy changes in version 1.4.1 (2008-04-25)
370 ------------------------------------------------
371
372  * Fixed a bug introduced by 1.3.1 which led to the comsumption of far
373    too much entropy for the intial seeding.
374
375  * Improved AES performance for CFB and CBC modes.
376
377  * Removed build problems for the Padlock support.
378
379
380 Noteworthy changes in version 1.4.0 (2007-12-10)
381 ------------------------------------------------
382
383  * New configure option --disable-padlock-support which is mostly
384    useful in case of build problems.
385
386
387 Noteworthy changes in version 1.3.2 (2007-12-03)
388 ------------------------------------------------
389
390  * The visibility attribute is now used if supported by the toolchain.
391
392  * The ACE engine of VIA processors is now used for AES-128.
393
394  * The ASN.1 DER template for SHA-224 has been fixed.
395
396
397 Noteworthy changes in version 1.3.1 (2007-10-26)
398 ------------------------------------------------
399
400  * The entire library is now under the LGPL. The helper programs and
401    the manual are under the GPL.  Kudos to Peter Gutmann for giving
402    permissions to relicense the rndw32 and rndunix modules.
403
404  * The Camellia cipher is now under the LGPL and included by default.
405
406  * Fixed a bug in the detection of symbol prefixes which inhibited the
407    build of optimzied assembler code on certain systems.
408
409  * Updated the entropy gatherer for W32.
410
411
412 Noteworthy changes in version 1.3.0 (2007-05-04)
413 ------------------------------------------------
414
415  * Changed the way the RNG gets initialized. This allows to keep it
416    uninitialized as long as no random numbers are used.  To override
417    this, the new macro gcry_fast_random_poll may be used.  It is in
418    general a good idea to spread this macro into the application code
419    to make sure that these polls happen often enough.
420
421  * Made the RNG immune against fork without exec.
422
423  * Reading and writing the random seed file is now protected by a
424    fcntl style file lock on systems that provide this function.
425
426  * Support for SHA-224 and HMAC using SHA-384 and SHA-512.
427
428  * Support for the SEED cipher.
429
430  * Support for the Camellia cipher.  Note that Camellia is disabled by
431    default, and that enabling it changes the license of libgcrypt from
432    LGPL to GPL.
433
434  * Support for OFB encryption mode.
435
436  * gcry_mpi_rshift does not anymore truncate the shift count.
437
438  * Reserved algorithm ranges for use by applications.
439
440  * Support for DSA2.
441
442  * The new function gcry_md_debug should be used instead of the
443    gcry_md_start_debug and gcry_md_stop_debug macros.
444
445  * New configure option --enable-random-daemon to support a system
446    wide random daemon.  The daemon code is experimental and not yet
447    very well working.  It will eventually allow to keep a global
448    random pool for the sake of short living processes.
449
450  * Non executable stack support is now used by default on systems
451    supporting it.
452
453  * Support for Microsoft Windows.
454
455  * Assembler support for the AMD64 architecture.
456
457  * New configure option --enable-mpi-path for optimized builds.
458
459  * Experimental support for ECDSA; should only be used for testing.
460
461  * New control code GCRYCTL_PRINT_CONFIG to print the build
462    configuration.
463
464  * Minor changes to some function declarations.  Buffer arguments are
465    now typed as void pointer.  This should not affect any compilation.
466    Fixed two bugs in return values and clarified documentation.
467
468  * Interface changes relative to the 1.2.0 release:
469  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
470  gcry_fast_random_poll   NEW
471  gcry_md_debug           NEW
472  gcry_sexp_nth_string    NEW
473  GCRY_MD_SHA224          NEW
474  GCRY_PK_USAGE_CERT      NEW
475  GCRY_PK_USAGE_AUTH      NEW
476  GCRY_PK_USAGE_UNKN      NEW
477  GCRY_PK_ECDSA           NEW
478  GCRY_CIPHER_SEED        NEW
479  GCRY_CIPHER_CAMELLIA128 NEW
480  GCRY_CIPHER_CAMELLIA192 NEW
481  GCRY_CIPHER_CAMELLIA256 NEW
482  GCRYCTL_FAKED_RANDOM_P  NEW
483  GCRYCTL_PRINT_CONFIG    NEW
484  GCRYCTL_SET_RNDEGD_SOCKET  NEW.
485  gcry_mpi_scan           CHANGED: Argument BUFFER is now void*.
486  gcry_pk_algo_name       CHANGED: Returns "?" instead of NULL.
487  gcry_cipher_algo_name   CHANGED: Returns "?" instead of "".
488  gcry_pk_spec_t          CHANGED: Element ALIASES is now const ptr.
489  gcry_md_write_t         CHANGED: Argument BUF is now a const void*.
490  gcry_md_ctl             CHANGED: Argument BUFFER is now void*.
491  gcry_cipher_encrypt     CHANGED: Arguments IN and OUT are now void*.
492  gcry_cipher_decrypt     CHANGED: Arguments IN and OUT are now void*.
493  gcry_sexp_sprint        CHANGED: Argument BUFFER is now void*.
494  gcry_create_nonce       CHANGED: Argument BUFFER is now void*.
495  gcry_randomize          CHANGED: Argument BUFFER is now void*.
496  gcry_cipher_register    CHANGED: Argument ALGORITHM_ID is now int*.
497  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
498
499
500 Noteworthy changes in version 1.2.0 (2004-04-15)
501 ------------------------------------------------
502
503  * First stable release.
504
505
506 Noteworthy changes in version 1.1.94 (2004-03-29)
507 -------------------------------------------------
508
509  * The support for multi-threaded users goes into its third
510    incarnation.  We removed compile time support for thread libraries.
511    To support the thread library of your choice, you have to set up
512    callback handlers at initialization time.  New data structures, a
513    new control command, and default initializers are provided for this
514    purpose.
515
516  * Interface changes relative to the 1.1.93 release:
517 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
518 libgcrypt-config --thread       OBSOLETE
519 libgcrypt-pth.la                REMOVED
520 libgcrypt-pthread.la            REMOVED
521 GCRYCTL_SET_THREAD_CBS          NEW
522 struct gcrypt_thread_cbs        NEW
523 enum gcry_thread_option         NEW
524 GCRY_THREAD_OPTION_PTH_IMPL     NEW
525 GCRY_THREAD_OPTION_PTHREAD_IMPL NEW
526 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
527
528 Noteworthy changes in version 1.1.93 (2004-03-06)
529 -------------------------------------------------
530
531  * The automatic thread library detection has finally been removed.
532    From now on, only linking explicitely to libgcrypt, libgcrypt-pth
533    or libgcrypt-pthread is supported.
534
535 Noteworthy changes in version 1.1.92 (2004-02-20)
536 -------------------------------------------------
537
538  * Minor bug fixes.
539
540  * Included a limited implementation of RFC2268.
541
542  * Changed API of the gcry_ac_ functions.  Only a very few programs
543    should be affected by this.
544
545  * Interface changes relative to the 1.1.91 release:
546 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
547 GCRY_CIPHER_RFC2268_40          NEW.
548 gcry_ac_data_set                CHANGED: New argument FLAGS.
549 gcry_ac_data_get_name           CHANGED: New argument FLAGS.
550 gcry_ac_data_get_index          CHANGED: New argument FLAGS.
551 gcry_ac_key_pair_generate       CHANGED: New and reordered arguments.
552 gcry_ac_key_test                CHANGED: New argument HANDLE.
553 gcry_ac_key_get_nbits           CHANGED: New argument HANDLE.
554 gcry_ac_key_get_grip            CHANGED: New argument HANDLE.
555 gcry_ac_data_search             REMOVED.
556 gcry_ac_data_add                REMOVED.
557 GCRY_AC_DATA_FLAG_NO_BLINDING   REMOVED.
558 GCRY_AC_FLAG_NO_BLINDING        NEW: Replaces above.
559
560
561 Noteworthy changes in version 1.1.91 (2003-12-19)
562 -------------------------------------------------
563
564  * Code cleanups and minor bug fixes.
565
566
567 Noteworthy changes in version 1.1.90 (2003-11-14)
568 -------------------------------------------------
569
570  * The use of the GCRY_WEAK_RANDOM level is now deprecated in favor of
571    the new gcry_create_nonce function.
572
573  * gcry_sexp_build now supports a "%b" format to include a memory buffer.
574
575  * Minor configuration fixes.
576
577  * Interface changes relative to the 1.1.44 release:
578 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
579 gcry_create_nonce               NEW
580 gcry_sexp_build                 ENHANCED
581
582
583 Noteworthy changes in version 1.1.44 (2003-10-31)
584 -------------------------------------------------
585
586  * Bug fixes and more code cleanups.
587
588  * Enhanced the prime API.
589
590  * Interface changes relative to the 1.1.43 release:
591 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
592 gcry_prime_group_generator      NEW
593 gcry_prime_release_factors      NEW
594
595
596 Noteworthy changes in version 1.1.43 (2003-09-04)
597 -------------------------------------------------
598
599  * Bug fixes and internal code cleanups.
600
601  * Support for the Serpent cipher algorithm.
602
603  * Interface changes relative to the 1.1.42 release:
604 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
605 gcry_prime_generate             NEW
606 gcry_prime_check                NEW
607
608
609 Noteworthy changes in version 1.1.42 (2003-07-31)
610 -------------------------------------------------
611
612  * Major API cleanup.  Applications need to be converted to the new
613    API.  See README.apichanges for hints on how to do that.  Backward
614    compatibility is provided where it was possible without too much
615    effort and did not collide with the overall sanitization effort.
616    However, this is only for ease of transition.  NO DEPRECATED
617    FUNCTION OR DATA TYPE IS CONSIDERED A PART OF THE API OR ABI AND
618    WILL BE DROPPED IN THE FUTURE WITHOUT CHANGING THE SONAME OF THE
619    LIBRARY.
620
621  * If gcrypt.h is included in sources compiled by GCC 3.1 or later,
622    deprecated attributes will warn about use of obsolete functions and
623    type definitions.  You can suppress these warnings by passing
624    -Wno-deprecated-declarations to the gcc command.
625
626  * gcry_check_version must be called from now on to initialize the
627    library, it is not longer optional.
628
629  * Removed `libgcrypt errno' concept.
630
631  * Libgcrypt depends on libgpg-error, a library that provides error
632    codes and according functions for all GnuPG components.  Functions
633    that used to return error codes asa `int' have been changed to
634    return a code of type `gcry_error_t'.  All GCRYERR_* error symbols
635    have been removed, since they are now contained in libgpg-error
636    (GPG_ERR_*). All functions and types in libgpg-error have also been
637    wrapped in Libgcrypt. The new types are gcry_err_code_t and
638    gcry_err_source_t.  The new functions are gcry_err_code,
639    gcry_err_source, gcry_error, gcry_err_make, gcry_error_from_errno,
640    gcry_err_make_from_errno, gcry_err_code_from_errno,
641    gcry_err_code_to_errno, gcry_strsource.
642
643  * New function gcry_mpi_dump to help in debugging.
644
645  * Added alternative interface for asymmetric cryptography.
646
647  * CRC-32, CRC-32 a'la RFC 1510, CRC-24 a'la RFC 2440 are now
648    supported.
649
650  * SHA-256, SHA-384 and SHA-512 are now supported.
651
652  * 128 bit Twofish is now supported.
653
654  * The random module won't print the "not enough random bytes
655    available" anymore.  A new progress status is issued instead.
656
657  * CBC-MAC for block ciphers is now supported, by using a
658    GCRY_CIPHER_CBC_MAC cipher flag.
659
660  * CTR mode for block ciphers is now supported.
661
662  * The public RSA exponent can now be specified in key generation.
663
664  * RSA blinding is now supported and is used automatically for RSA
665    decryption.  It can be explicitely disabled by using the
666    `no-blinding' symbol in the `flags' S-Expression or by using the
667    GCRY_AC_FLAG_DATA_NO_BLINDING flag when using the ac interface.
668
669  * gcry_sexp_canon_len does not use a `historically encoded' error
670    code anymore.
671
672
673  * Interface changes relative to the 1.1.12 release:
674 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
675 GCRY_MPI                        DEPRECATED; Use: gcry_mpi_t
676 GcryMPI                         DEPRECATED; Use: gcry_mpi_t
677 GCRY_SEXP                       DEPRECATED; Use: gcry_sexp_t
678 GcrySexp                        DEPRECATED; Use: gcry_sexp_t
679 GCRY_CIPHER_HD                  DEPRECATED; Use: gcry_cipher_hd_t
680 GcryCipherHd                    DEPRECATED; Use: gcry_cipher_hd_t
681 GCRY_MD_HD                      DEPRECATED; Use: gcry_md_hd_t
682 GcryMDHd                        DEPRECATED; Use: gcry_md_hd_t
683 gcry_error_t                    NEW
684 gcry_err_code_t                 NEW
685 gcry_err_source_t               NEW
686 gcry_err_make                   NEW
687 gcry_error                      NEW
688 gcry_err_code                   NEW
689 gcry_err_source                 NEW
690 gcry_err_code_from_errno        NEW
691 gcry_err_code_to_errno          NEW
692 gcry_err_make_from_errno        NEW
693 gcry_error_from_errno           NEW
694 gcry_strsource                  NEW
695 GCRYERR_{some error code}       REMOVED; Use GPG_ERR_*
696                                          from libgpg-error instead.
697 gcry_errno                      REMOVED
698 gcry_sexp_canon_len             CHANGED
699 gcry_sexp_build_array           NEW
700 gcry_mpi_scan                   CHANGED: New argument to separate in/out args.
701 gcry_mpi_print                  CHANGED: Ditto.
702 gcry_mpi_dump                   NEW
703 gcry_cipher_open                CHANGED
704 gcry_cipher_reset               NEW
705 gcry_cipher_register            NEW
706 gcry_cipher_unregister          NEW
707 gcry_cipher_list                NEW
708 gcry_cipher_algo_keylen         REPLACED macro with function.
709 gcry_cipher_algo_blklen         REPLACED macro with function.
710 gcry_pk_register                NEW
711 gcry_pk_unregister              NEW
712 gcry_pk_list                    NEW
713 gcry_pk_decrypt                 ENHANCED: Allows flag to return
714                                           complete S-expression.
715 gcry_md_open                    CHANGED
716 gcry_md_copy                    CHANGED
717 gcry_md_is_enabled              NEW
718 gcry_md_is_secure               NEW
719 gcry_md_register                NEW
720 gcry_md_unregister              NEW
721 gcry_md_list                    NEW
722 gcry_ac_data_t                  NEW
723 gcry_ac_key_t                   NEW
724 gcry_ac_key_pair_t              NEW
725 gcry_ac_handle_t                NEW
726 gcry_ac_key_spec_rsa_t          NEW
727 gcry_ac_data_new                NEW
728 gcry_ac_data_destroy            NEW
729 gcry_ac_data_set                NEW
730 gcry_ac_data_copy               NEW
731 gcry_ac_data_length             NEW
732 gcry_ac_data_get_name           NEW
733 gcry_ac_data_get_index          NEW
734 gcry_ac_data_clear              NEW
735 gcry_ac_open                    NEW
736 gcry_ac_close                   NEW
737 gcry_ac_key_init                NEW
738 gcry_ac_key_pair_generate       NEW
739 gcry_ac_key_pair_extract        NEW
740 gcry_ac_key_data_get            NEW
741 gcry_ac_key_test                NEW
742 gcry_ac_key_get_nbits           NEW
743 gcry_ac_key_get_grip            NEW
744 gcry_ac_key_destroy             NEW
745 gcry_ac_key_pair_destroy        NEW
746 gcry_ac_data_encrypt            NEW
747 gcry_ac_data_decrypt            NEW
748 gcry_ac_data_sign               NEW
749 gcry_ac_data_verify             NEW
750 gcry_ac_id_to_name              NEW
751 gcry_ac_name_to_id              NEW
752 gcry_handler_progress_t         NEW
753 gcry_handler_alloc_t            NEW
754 gcry_handler_secure_check_t     NEW
755 gcry_handle_realloc_t           NEW
756 gcry_handler_free_t             NEW
757 gcry_handler_no_mem_t           NEW
758 gcry_handler_error_t            NEW
759 gcry_handler_log_t              NEW
760 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
761
762 Noteworthy changes in version 1.1.12 (2003-01-20)
763 -------------------------------------------------
764
765  * gcry_pk_sign, gcry_pk_verify and gcry_pk_encrypt can now handle an
766    optional pkcs1 flags parameter in the S-expression.  A similar flag
767    may be passed to gcry_pk_decrypt but it is only syntactically
768    implemented.
769
770  * New convenience macro gcry_md_get_asnoid.
771
772  * There is now some real stuff in the manual.
773
774
775 Noteworthy changes in version 1.1.11 (2002-12-21)
776 -------------------------------------------------
777
778  * Don't export internal symbols anymore (currently only for GNU systems)
779
780  * New algorithm: MD4
781
782  * Implemented ciphertext stealing.
783
784  * Smaller bugs fixes and a few new OIDs.
785
786  * Interface changes relative to the 1.1.8 release:
787 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
788 gcry_cipher_cts                   NEW
789 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
790
791
792 Noteworthy changes in version 1.1.10 (2002-09-20)
793 -------------------------------------------------
794
795  * Fixed shared library builds for i386, PPC and Sparc.
796
797  * Added simple benchmark tool.
798
799  * Replaced the internal mutexes by code which automatically adapts to
800    the used threading library.  Currently Pth and Pthread are
801    supported.  For non-ELF systems the GNU toolchain is now required..
802
803  * Added untested support to build Windows DLLs.
804
805 Noteworthy changes in version 1.1.9 (2002-08-23)
806 ------------------------------------------------
807
808  * Support for plain old DES.
809
810
811 Noteworthy changes in version 1.1.8 (2002-06-25)
812 ------------------------------------------------
813
814  * Minor cleanups and exported a few new functions.
815
816  * Interface changes relative to the 1.1.7 release:
817 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
818 gcry_mpi_div                      NEW
819 gcry_mpi_mod                      NEW
820 gcry_mpi_invm                     NEW
821 gcry_mpi_swap                     NEW
822 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
823
824 Noteworthy changes in version 1.1.7 (2002-05-21)
825 ------------------------------------------------
826
827 * Libgcrypt is now distributed under the terms of the GNU Lesser
828   General Public License; see the README file for details.
829
830 * It is possible to use libgcrypt w/o intialized secure memory.
831
832 * Libgcrypt should now be thread safe after the initialization.
833   gcry_control (GCRYCRL_INITIALIZATION_FINISHED,NULL,0) should have
834   been called before creating additional threads.
835
836  * Interface changes relative to the 1.1.6 release:
837 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
838 GCRYCTL_DISABLE_INTERNAL_LOCKING  NEW
839 GCRYCTL_DISABLE_SECMEM            NEW
840 GCRYCTL_INITIALIZATION_FINISHED   NEW
841 GCRYCTL_INITIALIZATION_FINISHED_P NEW
842 GCRYCTL_ANY_INITIALIZATION_P      NEW
843 gcry_strdup                       NEW
844 gcry_sexp_create                  NEW
845 gcry_sexp_new                     NEW
846 gcry_set_progress_handler         NEW
847 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
848
849 Noteworthy changes in version 1.1.6 (2002-02-07)
850 ------------------------------------------------
851
852   * Enhanced the S-expression conversion functions.
853
854 Noteworthy changes in version 1.1.5 (2001-12-18)
855 ------------------------------------------------
856
857   * gcry_{cipher,md}_map_name are now able to map stringified object IDs.
858
859   * New functions gcry_sexp_canon_len and gcry_cipher_mode_from_oid.
860
861   * Closed some memory leaks.
862
863
864 Noteworthy changes in version 1.1.4 (2001-08-03)
865 ------------------------------------------------
866
867   * Arcfour does now work.
868
869   * Some minor fixes.
870
871   * Added a first test program
872
873   * Migrated to autoconf 2.52.
874
875
876 Noteworthy changes in version 1.1.3 (2001-05-31)
877 ------------------------------------------------
878
879   * First release of Libgcrypt which is a result of splitting GnuPG
880     into into libgcrypt and GnuPG.
881
882
883 Copyright 2001, 2002, 2003, 2004, 2007, 2008,
884           2009, 2011 Free Software Foundation, Inc.
885 Copyright 2013 g10 Code GmbH
886
887 This file is free software; as a special exception the author gives
888 unlimited permission to copy and/or distribute it, with or without
889 modifications, as long as this notice is preserved.
890
891 This file is distributed in the hope that it will be useful, but
892 WITHOUT ANY WARRANTY, to the extent permitted by law; without even the
893 implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.