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