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