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