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