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