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