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