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