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