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