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