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