| blob | db2e419a218cc3b30dc3ec47522e7403a9f26fa7 |
1 NEWS for the 2.7.1 release
3 This is a bugfix release.
5 Bug fixes:
7 * Fixed a bug in the new ECC code. The ecc_j_to_a function
8 called GMP:s mpn_mul_n (via ecc_modp_mul) with overlapping
9 input and output arguments, which is not supported.
11 * The assembly files for SHA1, SHA256 and AES depend on ARMv6
12 instructions, breaking nettle-2.7 for pre-v6 ARM processors.
13 The configure script now enables those assembly files only
14 when building for ARMv6 or later.
16 * Use a more portable C expression for rotations. The
17 previous version used the following "standard" expression
18 for 32-bit rotation:
20 (x << n) | (x >> (32 - n))
22 But this gives undefined behavior (according to the C
23 specification) for n = 0. The rotate expression is replaced
24 by the more portable:
26 (x << n) | (x >> ((-n)&31))
28 This change affects only CAST128, which uses non-constant
29 rotation counts. Unfortunately, the new expression is poorly
30 optimized by released versions of gcc, making CAST128 a bit
31 slower. This is being fixed by the gcc hackers, see
32 http://gcc.gnu.org/bugzilla/show_bug.cgi?id=57157.
34 The following problems have been reported, but are *not* fixed
35 in this release:
37 * ARM assembly files use instruction syntax which is not
38 supported by all assemblers. Workaround: Use a current
39 version of GNU as, or configure with --disable-assembler.
41 * Configuring with --disable-static doesn't work on windows.
43 The libraries are intended to be binary compatible with
44 nettle-2.2 and later. The shared library names are
45 libnettle.so.4.7 and libhogweed.so.2.5, with sonames still
46 libnettle.so.4 and libhogweed.so.2.
48 NEWS for the 2.7 release
50 This release includes an implementation of elliptic curve
51 cryptography (ECC) and optimizations for the ARM architecture.
52 This work was done at the offices of South Pole AB, and
53 generously funded by the .SE Internet Fund.
55 Bug fixes:
57 * Fixed a bug in the buffer handling for incremental SHA3
58 hashing, with a possible buffer overflow. Patch by Edgar
59 E. Iglesias.
61 New features:
63 * Support for ECDSA signatures. Elliptic curve operations over
64 the following curves: secp192r1, secp224r1, secp256r1,
65 secp384r1 and secp521r1, including x86_64 and ARM assembly
66 for the most important primitives.
68 * Support for UMAC, including x86_64 and ARM assembly.
70 * Support for 12-round salsa20, "salsa20r12", as specified by
71 eSTREAM. Contributed by Nikos Mavrogiannopoulos.
73 Optimizations:
75 * ARM assembly code for several additional algorithms,
76 including AES, Salsa20, and the SHA family of hash
77 functions.
79 * x86_64 assembly for SHA256, SHA512, and SHA3. (SHA3 assembly
80 was included in the 2.6 release, but disabled due to poor
81 performance on some AMD processors. Hopefully, that
82 performance problem is fixed now).
84 The ARM code was tested and benchmarked on Cortex-A9. Some of
85 the functions use "neon" instructions. The configure script
86 decides if neon instructions can be used, and the command line
87 options --enable-arm-neon and --disable-arm-neon can be used
88 to override its choice. Feedback appreciated.
90 The libraries are intended to be binary compatible with
91 nettle-2.2 and later. The shared library names are
92 libnettle.so.4.6 and libhogweed.so.2.4, with sonames still
93 libnettle.so.4 and libhogweed.so.2.
95 NEWS for the 2.6 release
97 Bug fixes:
99 * Fixed a bug in ctr_crypt. For zero length (which should be a
100 NOP), it sometimes incremented the counter. Reported by Tim
101 Kosse.
103 * Fixed a small memory leak in nettle_realloc and
104 nettle_xrealloc.
106 New features:
108 * Support for PKCS #5 PBKDF2, to generate a key from a
109 password or passphrase. Contributed by Simon Josefsson.
110 Specification in RFC 2898 and test vectors in RFC 6070.
112 * Support for SHA3.
114 * Support for the GOST R 34.11-94 hash algorithm. Ported from
115 librhash by Nikos Mavrogiannopoulos. Written by Aleksey
116 Kravchenko. More information in RFC4357. Test vectors taken
117 from the GOST hash wikipedia page.
119 Miscellaneous:
121 * The include file <nettle/sha.h> has been split into
122 <nettle/sha1.h> and <nettle/sha2.h>. For now, sha.h is kept
123 for backwards compatibility and it simply includes both
124 files, but applications are encouraged to use the new names.
125 The new SHA3 functions are declared in <nettle/sha3.h>.
127 * Testsuite can be run under valgrind, using
129 make check EMULATOR='$(VALGRIND)'
131 For this to work, test programs and other executables now
132 deallocate storage.
134 * New configure options --disable-documentation and
135 --disable-static. Contributed by Sam Thursfield and Alon
136 Bar-Lev, respectively.
138 * The section on hash functions in the manual is split into
139 separate nodes for recommended hash functions and legacy
140 hash functions.
142 * Various smaller improvements, most of them portability
143 fixes. Credits go to David Woodhouse, Tim Rühsen, Martin
144 Storsjö, Nikos Mavrogiannopoulos, Fredrik Thulin and Dennis
145 Clarke.
147 Finally, a note on the naming of the various "SHA" hash
148 functions. Naming is a bit inconsistent; we have, e.g.,
150 SHA1: sha1_digest
151 SHA2: sha256_digest (not sha2_256_digest)
152 SHA3: sha3_256_digest
154 Renaming the SHA2 functions to make Nettle's naming more
155 consistent has been considered, but the current naming follows
156 common usage. Most documents (including the specification for
157 SHA2) refer to 256-bit SHA2 as "SHA-256" or "SHA256" rather
158 than "SHA2-256".
160 The libraries are intended to be binary compatible with
161 nettle-2.2 and later. The shared library names are
162 libnettle.so.4.5 and libhogweed.so.2.3, with sonames still
163 libnettle.so.4 and libhogweed.so.2
165 NEWS for the 2.5 release
167 This release includes important portability fixes for Windows
168 and MacOS. There are also a few new features.
170 First a *warning*: Some internal functions have been removed
171 from the library. Since the functions in question are internal
172 and not documented, this is not considered a change of ABI or
173 API. Programs explicitly using any of these functions will
174 break.
176 * The function pkcs1_signature_prefix has been renamed to
177 _pkcs1_signature_prefix, and with slightly different
178 behavior.
180 * The file nettle-internal.c is no longer included in the
181 library (the features defined there are used by the
182 benchmark and test programs, and were never intended for
183 public use).
185 New features:
187 * Support for the salsa20 stream cipher, including x86_64
188 assembler. Originally contributed by Simon Josefsson, based
189 on the reference implementation, then further optimized.
191 * Tentative interface for timing-resistant RSA functions,
192 contributed by Nikos Mavrogiannopoulos.
194 * A more general interface for PKCS#1 signatures, taking the
195 input in the form of a "DigestInfo". Suggested by Nikos
196 Mavrogiannopoulos.
198 Configuration:
200 * Building of shared libraries (./configure --enable-shared)
201 is now enabled by default.
203 * Various portability fixes for MacOS and M$ Windows. A lot of
204 this work done by Martin Storsjö.
206 * In particular, Nettle now hopefully works on 64-bit Windows
207 builds, "W64", including the x86_64 assembly code.
209 Miscellaneous:
211 * Documentation and example programs for the base16 and base64
212 functions. Was contributed by Jeronimo Pellegrini back in
213 2006, but unfortunately forgotten until now.
215 * Use an additional table to avoid GF2^8 multiplications in
216 aes_invert_key (mainly used by aes_set_decrypt_key). Also
217 tabulate round constants in aes_set_encrypt_key.
219 * The nettle repository has been migrated from cvs to git,
220 with a public repository at
221 http://git.lysator.liu.se/nettle. To make it independent of
222 the LSH repository, a few files have been moved around.
223 While at it, files have also been converted from latin-1 to
224 utf-8.
226 The libraries are intended to be binary compatible with
227 nettle-2.2 and later. The shared library names are
228 libnettle.so.4.4 and libhogweed.so.2.2, with sonames still
229 libnettle.so.4 and libhogweed.so.2
231 NEWS for the 2.4 release
233 This is a bugfix release only. It turned out ripemd160 in the
234 2.3 release was broken on all big-endian systems, due to a
235 missing include of config.h. nettle-2.4 fixes this.
237 The library is intended to be binary compatible with
238 nettle-2.2 and nettle-2.3. The shared library names are
239 libnettle.so.4.3 and libhogweed.so.2.1, with sonames still
240 libnettle.so.4 and libhogweed.so.2.
242 NEWS for the 2.3 release
244 * Support for the ripemd-160 hash function.
246 * Generates and installs nettle.pc and hogweed.pc files, for
247 use with pkg-config. Feedback appreciated. For projects
248 using autoconf, the traditional non-pkg-config ways of
249 detecting libraries, and setting LIBS and LDFLAGS, is still
250 recommended.
252 * Fixed a bug which made the testsuite fail in the GCM test on
253 certain platforms. Should not affect any documented features
254 of the library.
256 * Reorganization of the code for the various Merkle-Damgård
257 hash functions. Some fields in the context structs for md4,
258 md5 and sha1 have been renamed, for consistency.
259 Applications should not peek inside these structs, and the
260 ABI is unchanged.
262 * In the manual, fixed mis-placed const in certain function
263 prototypes.
265 The library is intended to be binary compatible with
266 nettle-2.2. The shared library names are libnettle.so.4.2 and
267 libhogweed.so.2.1, with sonames still libnettle.so.4 and
268 libhogweed.so.2.
270 NEWS for the 2.2 release
272 Licensing change:
274 * Relicensed as LGPL v2.1 or later (user's option).
276 * Replaced blowfish and serpent implementation. New code is
277 based on the LGPLed code in libgcrypt.
279 New features:
281 * Support for Galois/Counter Mode (GCM).
283 * New interface for enumerating (most) available algorithms,
284 contributed by Daniel Kahn Gillmor.
286 * New tool nettle-hash. Can generate hash digests using any
287 supported hash function, with output compatible with md5sum
288 and friends from GNU coreutils. Checking (like md5sum -c)
289 not yet implemented.
291 Bug fixes:
293 * The old serpent code had a byte order bug (introduced by
294 yours truly about ten years ago). New serpent implementation
295 does not interoperate with earlier versions of nettle.
297 * Fixed ABI-dependent libdir default for Linux-based systems
298 which do not follow the Linux File Hierarchy Standard, e.g.,
299 Debian GNU/Linux.
301 Optimizations:
303 * x86_64 implemention of serpent.
305 * x86_64 implemention of camellia.
307 * Optimized memxor using word rather than byte operations.
308 Both generic C and x86_64 assembler.
310 * Eliminated a memcpy for in-place CBC decrypt.
312 Miscellaneous:
314 * In command line tools, no longer support -? for requesting
315 help, since using it without shell quoting is a dangerous
316 habit. Use long option --help instead.
318 The shared library names are libnettle.so.4.1 and
319 libhogweed.so.2.1, with sonames libnettle.so.4 and
320 libhogweed.so.2.
322 NEWS for the 2.1 release
324 *Important*: this release breaks source and binary
325 compatibility for the digital signature functions, and for the
326 DES and BLOWFISH ciphers which have weak keys.
328 Incompatible changes:
330 * The functions rsa_md5_sign, rsa_sha1_sign and
331 rsa_sha256_sign, and the corresponding _digest variants, now
332 have a return value which callers should check. The functions
333 return failure if the key is too small for the type of
334 signature.
336 * The functions dsa_sign and dsa_verify are renamed to
337 dsa_sha1_sign and dsa_sha1_verify. The _-digest variants are
338 renamed similarly. These functions now have a return value
339 which callers should check, and they return failure if the
340 number q is not of the appropriate size.
342 * The return value from des_set_key, des3_set_key and
343 blowfish_set_key now indicates whether or not the given key
344 is weak. But in either case, the key setup is done, and
345 applications that don't care about weak keys can ignore the
346 return value.
348 The incompatible part of this change is that enum des_error
349 and enum blowfish_error has been deleted, and so has the
350 status attribute in struct des_ctx, struct des3_ctx, and
351 struct blowfish_ctx.
353 The shared library names are libnettle.so.4.0 and
354 libhogweed.so.2.0, with sonames libnettle.so.4 and
355 libhogweed.so.2.
357 Other changes:
359 * Support for the Camellia block cipher, including an
360 assembler implementation for x86_32.
362 * New function aes_invert_key, useful for applications that
363 need both encryption and decryption using the same AES key.
365 * des_set_key and des3_set_key no longer check the key parity
366 bits. Parity bits are silently ignored. A new function
367 des_check_parity is provided, for applications that care
368 about the DES parity bits.
370 * Support for sha224, sha384 and sha512.
372 * Support for digital signatures using rsa-sha512 and
373 dsa-sha256. Due to lack of official test vectors and interop
374 testing, this support should be considered somewhat
375 experimental.
377 * Key generation for RSA and DSA changed to use Maurer's
378 algorithm to generate provably prime numbers (as usual, the
379 mathematical proof does not guaranteee that the
380 implementation is bug free).
382 * x86_64 assembler implementation actually included in the
383 distribution (was accidentally left out in nettle-2.0).
385 * Configure script now detects if the compiler uses a 32-bit
386 or 64-bit ABI on x86_64 (prevously did this for sparc only).
387 Also sets the default location for installing libraries
388 (libdir) depending on system type and the ABI used.
390 * Added the nettle and gmp libraries as dependencies when
391 linking shared library libhogweed.so. On systems using
392 shared libraries where such dependencies work (in
393 particular, ELF systems), it is sufficient to link
394 applications with -lhogweed. For static linking -lhogweed
395 -lnettle -lgmp is still required.
397 * The program pkcs1-conv is extended to also handle dsa keys.
398 Contributed by Magnus Holmgren.
400 * Slightly improved sha1 performance on x86.
402 NEWS for the 2.0 release
404 This release breaks binary compatibility by splitting the
405 library into two. Some other smaller changes that are not
406 backwards compatible are also done at the same time.
408 * The nettle library is split into two libraries, libnettle
409 and libhogweed. libnettle contains the symmetric crypto
410 algorithms that don't depend on GMP, while libhogweed
411 contains the public key algorithms that depend on GMP.
412 Using a single library worked fine with static linking, but
413 not with dynamic linking. Consider an application that uses
414 nettle and which doesn't use any public key cryptography. If
415 this application is linked dynamically to nettle, it would
416 have to be linked also with GMP if and only if public key
417 support was enabled when the nettle library was installed.
419 The library names are libnettle.so.3.0 and
420 libhogweed.so.1.0, with sonames libnettle.so.3 and
421 libhogweed.so.1.
423 * Function typedefs have been changed to non-pointer types.
424 E.g, the
426 typedef void (nettle_hash_init_func *)(void *ctx);
428 of previous versions is replaced by
430 typedef void (nettle_hash_init_func)(void *ctx);
432 This makes it possible to use the type when declaring
433 functions, like
435 nettle_hash_init_func foo_hash_init;
437 void foo_hash_init(void *ctx) { ... }
439 * Changes to the yarrow256 interface. The automatic seed file
440 generation, and the seed_file member in struct
441 yarrow256_ctx, has been removed. To generate a new seed
442 file, use yarrow256_random. The function
443 yarrow256_force_reseed has been replaced by the two
444 functions yarrow256_fast_reseed and yarrow256_slow_reseed,
445 which were previously static. This interface change makes it
446 easier to mix in the current content of the seed file before
447 overwriting it with newly generated data.
449 Other changes:
451 * Nettle manual now contributed to the public domain, to
452 enable remixing into documentation of programs that use
453 Nettle.
455 * The sexp-conv program preserves comments when using the
456 advanced syntax for output. Optionally locks the output
457 file.
459 * The base64 decoder recognizes ASCII FF (form feed) and VT
460 (vertical tab) as white space.
462 * New x86_64 implementations of AES and SHA1. On a 2.2 GHz
463 opteron, SHA1 was benchmarked at 250 MByte/s, and AES-128 at
464 110 MByte/s.
466 * Performance of AES increased by 20-30% on x86.
468 * New programs in the examples directory: erathostenes and
469 next-prime.
471 NEWS for the 1.15 release
473 Added support for PKCS#1 style RSA signatures using SHA256,
474 according to RFC 3447. Currently lacks interoperability
475 testing.
477 Header files are now C++ aware, so C++ programs using Nettle
478 should now use plain
480 #include <nettle/foo.h>
482 rather than
484 #extern "C" {
485 #include <nettle/foo.h>
486 }
488 as was the recommendation for the previous version. This
489 breaks source-level compatibility with C++, even though
490 there's full binary compatibility.
492 The file rfc1750.txt (which is considered non-free by debian)
493 has been removed from the distribution. The file was used as input
494 for the Yarrow testcase, and has been replaced by the short
495 story "The Gold-bug" by Edgar Allan Poe. Anyway, RFC 1750 is
496 obsoleted by RFC 4086.
498 Fixes for Darwin shared library support, contributed by Grant
499 Robinsson.
501 Example programs now use a supplied getopt.c.
503 Configure tests for assemblers with a logarithmic .align
504 directive.
506 The library is intended to be upwards binary compatible with
507 earlier versions. The library name is libnettle.so.2.6, soname
508 is still libnettle.so.2.
510 NEWS for the 1.14 release
512 Experimental support for reading keys in PKCS#1 ASN1/DER
513 format, and a new command line tool pkcs1-conv.
515 Improved MD5 performance on x86.
517 Fixed support for sparc64.
519 Reorganized AES code. Better performance for all three
520 implementations (C, x86 assembler, sparc assembler).
522 New sparc assembler for arcfour. Compared to the code
523 generated by gcc, the new code is about 25% faster on old
524 sparcs, and 6 times faster on ultrasparc.
526 Replaced the internal function nettle_mpz_from_octets with a
527 call to mpz_import, if available in the installed GMP library.
529 More Makefile fixes; it now seems to work to build with
530 the the make programs on Solaris and FreeBSD (although
531 --disable-dependency-tracking is required for the latter).
533 The library is intended to be binary compatible with earlier
534 versions. The library name is libnettle.so.2.5, soname is
535 still libnettle.so.2.
537 NEWS for the 1.13 release
539 Fixed problem with broken m4 on bsd, which resulted in
540 corrupted x86 assembler for sha1.
542 Nettle probably works on windows: I've been able to cross
543 compile it with ./configure --host=i586-mingw32msvc (without
544 public-key support), and the testsuite binaries seem to run
545 fine in Wine.
547 Implemented CTR mode.
549 Improved sha1 performance on x86.
551 Configure check to figure out if symbols in assembler files
552 need a leading underscore.
554 Improved benchmark program. Displays cycles per byte and block,
555 and compares with openssl (if openssl is installed).
557 Terminating newline in output from sexp-conv --hash.
559 The library is intended to be binary compatible with earlier
560 versions. The library name is libnettle.so.2.4. However, the
561 interface for the internal function _nettle_sha1_compress has
562 changed; any program that calls this function directly will
563 break.
565 NEWS for the 1.12 release
567 Fixed a bug in the configure script.
569 Updated the description of aes_set_encrypt_key and
570 aes_set_decrypt_key in the manual.
572 NEWS for the 1.11 release
574 Nettle no longer uses automake. Side effects:
576 * Dependency tracking is enabled only for gcc-3 (help with
577 supporting dependency tracking with other compilers is
578 appreciated).
580 * Makefile compatibility with make programs other than GNU
581 make is mostly unknown, please report any problems.
583 Support for arctwo.
585 Fixes to the libdes compatibility code. Declarations should
586 now match openssl/libdes better. des_cbc_cksum pads
587 input with NUL's, if it's not an integral number of blocks (in
588 general, such unreversible padding is a bad idea).
590 By default, also the static library is compiled as position
591 independent code. This is needed on some systems to make it
592 possible to link nettle into a dynamically loaded module. Use
593 the configure flag --disable-pic if this is not desired.
595 Stricter constness typing for the sexp_iterator_assoc and
596 sexp_iterator_check_types arguments.
598 Minor tweaks of arcfour on x86 cpu:s, to speed it up on older
599 x86 variants such as PII and PPro.
601 The shared library is intended to be binary compatible with
602 nettle-1.8 - nettle-1.10. Only the minor version number of the
603 shared library is increased. The soname is still
604 libnettle.so.2.
606 NEWS for the 1.10 release
608 Nettle should now compile also on Tru64, Darwin, FreeBSD and
609 Windows. (The only tested windows build uses the rntcl rsh
610 wrapper to run the command line M$ C compiler "cl". See
611 http://pike.ida.liu.se for those tools, I don't know all
612 details about the Pike team's windows setup).
614 There are some known testsuite failures, on Windows and on one
615 of the xenofarm HPUX machines, see
616 http://www.lysator.liu.se/~nisse/xeno-lsh/latest.html. Help
617 tracking these down is appreciated.
619 There are no new features.
621 This release is intended to be binary compatible with
622 nettle-1.8 and nettle-1.9.
624 NEWS for the 1.9 release
626 Optimized C implementation of arcfour. Optimized x86
627 implementations of arcfour and sha1.
629 Improved benchmark program.
631 Fixed bug in the rsa-encrypt example program.
633 Fixed bug in make install, some of the header files were
634 forgotten.
636 Portability fixes. Fixes to make Nettle compile on systems
637 without gmp. This version has been tested on GNU/Linux,
638 Solaris, HPUX and AIX.
640 The shared library is intended to be binary compatible with
641 nettle-1.8. Only the minor version number of the shared
642 library is increased.
644 NEWS for the 1.8 release
646 New example programs, demonstrating encrypting and decrypting
647 files using RSA, and random sessions keys for bulk encryption
648 and message authentication.
650 Support for systems that don't have alloca. On such systems,
651 some of Nettle's functions have arbitrary limits applied to
652 their input.
654 Uses AX_CREATE_STDINT_H, to support systems without
655 inttypes.h.
657 Support for the md2 and md4 hash functions.
659 New name mangling, to reduce the risk of link collisions. All
660 functions (except memxor) now use a nettle_ or _nettle_ prefix
661 when seen by the linker. For most functions, the header file
662 that declares a function also uses #define to provide a
663 shorter more readable name without the prefix.
665 The shared library soname for this version is libnettle.so.2.
667 NEWS for the 1.7 release
669 Implemented DSA.
671 Renamed RSA functions for consistency. Now it's
672 rsa_public_key_init, not rsa_init_public_key, etc.
674 Both RSA and DSA now have sign/verify functions that take the
675 hash digest as argument.
677 A rewritten and much more powerful sexp-conv program.
679 Other changes to the sexp code, in particular updating it to
680 the latest SPKI draft.
682 Building nettle as a shared library (ELF only) seems to work.
683 The version number is increased, so the library "soname" for
684 this release is "libnettle.so.1".
686 Bugfixes. Fixes for build and portability problems.
688 NEWS for the 1.6 release
690 Optimized assembler implementations of aes, for sparc and x86.
692 The aes interface has changed slightly. The function
693 aes_set_key is no more. Instead one has to use
694 aes_set_encrypt_key or aes_set_decrypt_key. Sorry about that.
696 New example programs, rsa-keygen, rsa-sign and rsa-verify,
697 located in the examples directory.
699 New configure option --enable-shared, which builds a shared
700 library. Not tested.
702 New experimental features, including sexp parsing and
703 formatting, and changes to base64 encoding and decoding. The
704 interfaces to these functions are subject to change, and are
705 documented only in the source code.
707 NEWS for the 1.5 release
709 RSA support. Key generation and signatures.
711 Support for HMAC (RFC-2104).
713 An implementation of the Yarrow-256 PRNG.
715 New sections in the manual.
717 Changed the interface for hash functions. The md5_digest
718 function is now equivalent to the old sequence of md5_final,
719 md5_digest, md5_init, and similarly for the other hashing
720 algorithms. This makes the interface simpler.
722 NEWS for the 1.0 release
724 Fixed twofish bug spotted by Jean-Pierre Stierlin.
726 Added des3 and cbc.
728 New RFC-1321-like interface in nettle/md5-compat.h, suggested
729 by Assar Westerlund.
731 New libdes-style compatibility interface in nettle/des-compat.h.