NEWS 19 KB
Newer Older
Simon Josefsson's avatar
Simon Josefsson committed
1 2 3 4 5 6 7
NEWS for the 2.6 release

	New features:

	* Support for PKCS #5 PBKDF2.  Contributed by Simon Josefsson.
          Specification in RFC 2898 and test vectors in RFC 6070.

8 9
NEWS for the 2.5 release

10 11
	This release includes important portability fixes for Windows
	and MacOS. There are also a few new features.
12 13 14 15 16 17

	First a *warning*: Some internal functions have been removed
	from the library. Since the functions in question are internal
	and not documented, this is not considered a change of ABI or
	API. Programs explicitly using any of these functions will
	break.
18
	
19
	* The function pkcs1_signature_prefix has been renamed to
20
	  _pkcs1_signature_prefix, and with slightly different
21 22 23 24 25 26
	  behavior.

	* The file nettle-internal.c is no longer included in the
          library (the features defined there are used by the
          benchmark and test programs, and were never intended for
          public use).
27 28 29 30 31 32 33 34 35 36 37 38 39 40

	New features:

	* Support for the salsa20 block cipher, including x86_64
          assembler. Originally contributed by Simon Josefsson, based
          on the reference implementation, then further optimized.

	* Tentative interface for timing-resistant RSA functions,
          contributed by Nikos Mavrogiannopoulos.

	* A more general interface for PKCS#1 signatures, taking the
          input in the form of a "DigestInfo". Suggested by Nikos
          Mavrogiannopoulos.

41
	Configuration:
42
	
43 44 45
	* Building of shared libraries (./configure --enable-shared)
          is now enabled by default.

46
	* Various portability fixes for MacOS and M$ Windows. A lot of
Niels Möller's avatar
Niels Möller committed
47
	  this work done by Martin Storsjö.
48 49

	* In particular, Nettle now hopefully works on 64-bit Windows
50
	  builds, "W64", including the x86_64 assembly code.
51

52 53
	Miscellaneous:
	
54 55 56
	* Documentation and example programs for the base16 and base64
	  functions. Was contributed by Jeronimo Pellegrini back in
	  2006, but unfortunately forgotten until now.
57

58 59 60 61
	* Use an additional table to avoid GF2^8 multiplications in
	  aes_invert_key (mainly used by aes_set_decrypt_key). Also
	  tabulate round constants in aes_set_encrypt_key.

62 63 64 65 66 67 68 69 70 71 72 73
	* The nettle repository has been migrated from cvs to git,
	  with a public repository at
	  http://git.lysator.liu.se/nettle. To make it independent of
	  the LSH repository, a few files have been moved around.
	  While at it, files have also been converted from latin-1 to
	  utf-8.

	The libraries are intended to be binary compatible with
	nettle-2.2 and later. The shared library names are
	libnettle.so.4.4 and libhogweed.so.2.2, with sonames still
	libnettle.so.4 and libhogweed.so.2

Niels Möller's avatar
Niels Möller committed
74 75 76 77 78 79 80 81 82 83 84
NEWS for the 2.4 release

	This is a bugfix release only. It turned out ripemd160 in the
	2.3 release was broken on all big-endian systems, due to a
	missing include of config.h. nettle-2.4 fixes this.

	The library is intended to be binary compatible with
	nettle-2.2 and nettle-2.3. The shared library names are
	libnettle.so.4.3 and libhogweed.so.2.1, with sonames still
	libnettle.so.4 and libhogweed.so.2.
	
Niels Möller's avatar
Niels Möller committed
85 86
NEWS for the 2.3 release

Niels Möller's avatar
Niels Möller committed
87
	* Support for the ripemd-160 hash function.
Niels Möller's avatar
Niels Möller committed
88

Niels Möller's avatar
Niels Möller committed
89 90 91 92 93 94 95 96 97 98
	* Generates and installs nettle.pc and hogweed.pc files, for
          use with pkg-config. Feedback appreciated. For projects
          using autoconf, the traditional non-pkg-config ways of
          detecting libraries, and setting LIBS and LDFLAGS, is still
          recommended.

	* Fixed a bug which made the testsuite fail in the GCM test on
	  certain platforms. Should not affect any documented features
	  of the library.

Niels Möller's avatar
Niels Möller committed
99
	* Reorganization of the code for the various Merkle-Damgård
Niels Möller's avatar
Niels Möller committed
100 101 102 103 104 105 106 107 108 109 110 111
	  hash functions. Some fields in the context structs for md4,
	  md5 and sha1 have been renamed, for consistency.
	  Applications should not peek inside these structs, and the
	  ABI is unchanged.
	  
	* In the manual, fixed mis-placed const in certain function
          prototypes.

	The library is intended to be binary compatible with
	nettle-2.2. The shared library names are libnettle.so.4.2 and
	libhogweed.so.2.1, with sonames still libnettle.so.4 and
	libhogweed.so.2.
Niels Möller's avatar
Niels Möller committed
112

Niels Möller's avatar
Niels Möller committed
113 114
NEWS for the 2.2 release

115 116
	Licensing change:
     	
Niels Möller's avatar
Niels Möller committed
117
	* Relicensed as LGPL v2.1 or later (user's option).
Niels Möller's avatar
Niels Möller committed
118

119 120 121 122 123
	* Replaced blowfish and serpent implementation. New code is
          based on the LGPLed code in libgcrypt.

	New features:

Niels Möller's avatar
Niels Möller committed
124
	* Support for Galois/Counter Mode (GCM).
125 126 127 128 129

	* New interface for enumerating (most) available algorithms,
	  contributed by Daniel Kahn Gillmor.

	* New tool nettle-hash. Can generate hash digests using any
Niels Möller's avatar
Niels Möller committed
130 131 132
	  supported hash function, with output compatible with md5sum
	  and friends from GNU coreutils. Checking (like md5sum -c)
	  not yet implemented.
133 134 135 136 137 138 139

	Bug fixes:

	* The old serpent code had a byte order bug (introduced by
	  yours truly about ten years ago). New serpent implementation
	  does not interoperate with earlier versions of nettle.

Niels Möller's avatar
Niels Möller committed
140 141 142
	* Fixed ABI-dependent libdir default for Linux-based systems
	  which do not follow the Linux File Hierarchy Standard, e.g.,
	  Debian GNU/Linux.
143 144

	Optimizations:
Niels Möller's avatar
Niels Möller committed
145
	
Niels Möller's avatar
Niels Möller committed
146
	* x86_64 implemention of serpent.
147 148 149

	* x86_64 implemention of camellia.

Niels Möller's avatar
Niels Möller committed
150 151
	* Optimized memxor using word rather than byte operations.
          Both generic C and x86_64 assembler.
Niels Möller's avatar
Niels Möller committed
152

Niels Möller's avatar
Niels Möller committed
153 154
	* Eliminated a memcpy for in-place CBC decrypt.
	
155 156
	Miscellaneous:

Niels Möller's avatar
Niels Möller committed
157 158 159
	* In command line tools, no longer support -? for requesting
          help, since using it without shell quoting is a dangerous
          habit. Use long option --help instead.
Niels Möller's avatar
Niels Möller committed
160

161 162 163 164
	The shared library names are libnettle.so.4.1 and
	libhogweed.so.2.1, with sonames libnettle.so.4 and
	libhogweed.so.2.

Niels Möller's avatar
Niels Möller committed
165
NEWS for the 2.1 release
Niels Möller's avatar
Niels Möller committed
166 167

	*Important*: this release breaks source and binary
Niels Möller's avatar
Niels Möller committed
168 169 170
	compatibility for the digital signature functions, and for the
	DES and BLOWFISH ciphers which have weak keys.

Niels Möller's avatar
Niels Möller committed
171 172 173
	Incompatible changes:

	* The functions rsa_md5_sign, rsa_sha1_sign and
Niels Möller's avatar
Niels Möller committed
174
          rsa_sha256_sign, and the corresponding _digest variants, now
Niels Möller's avatar
Niels Möller committed
175 176 177 178 179 180 181
          have a return value which callers should check. The functions
          return failure if the key is too small for the type of
          signature.

	* The functions dsa_sign and dsa_verify are renamed to
          dsa_sha1_sign and dsa_sha1_verify. The _-digest variants are
          renamed similarly. These functions now have a return value
Niels Möller's avatar
Niels Möller committed
182
          which callers should check, and they return failure if the
Niels Möller's avatar
Niels Möller committed
183 184
          number q is not of the appropriate size.

185 186 187 188 189 190 191 192 193 194 195
	* The return value from des_set_key, des3_set_key and
	  blowfish_set_key now indicates whether or not the given key
	  is weak. But in either case, the key setup is done, and
	  applications that don't care about weak keys can ignore the
	  return value.

	  The incompatible part of this change is that enum des_error
	  and enum blowfish_error has been deleted, and so has the
	  status attribute in struct des_ctx, struct des3_ctx, and
	  struct blowfish_ctx.

196 197 198 199
	The shared library names are libnettle.so.4.0 and
	libhogweed.so.2.0, with sonames libnettle.so.4 and
	libhogweed.so.2.

Niels Möller's avatar
Niels Möller committed
200 201
	Other changes:

202 203
	* Support for the Camellia block cipher, including an
          assembler implementation for x86_32.
Niels Möller's avatar
Niels Möller committed
204 205 206 207

	* New function aes_invert_key, useful for applications that
	  need both encryption and decryption using the same AES key.
	  
208 209 210 211 212
	* des_set_key and des3_set_key no longer check the key parity
	  bits. Parity bits are silently ignored. A new function
	  des_check_parity is provided, for applications that care
	  about the DES parity bits.

Niels Möller's avatar
Niels Möller committed
213 214 215 216 217 218 219
	* Support for sha224, sha384 and sha512.

	* Support for digital signatures using rsa-sha512 and
          dsa-sha256. Due to lack of official test vectors and interop
          testing, this support should be considered somewhat
          experimental.

Niels Möller's avatar
Niels Möller committed
220 221 222 223 224
	* Key generation for RSA and DSA changed to use Maurer's
	  algorithm to generate provably prime numbers (as usual, the
	  mathematical proof does not guaranteee that the
	  implementation is bug free).
	  
Niels Möller's avatar
Niels Möller committed
225 226 227 228
	* x86_64 assembler implementation actually included in the
	  distribution (was accidentally left out in nettle-2.0).

	* Configure script now detects if the compiler uses a 32-bit
229
          or 64-bit ABI on x86_64 (prevously did this for sparc only).
Niels Möller's avatar
Niels Möller committed
230
          Also sets the default location for installing libraries
Niels Möller's avatar
Niels Möller committed
231
          (libdir) depending on system type and the ABI used.
Niels Möller's avatar
Niels Möller committed
232 233 234 235 236 237 238 239 240 241 242 243

	* Added the nettle and gmp libraries as dependencies when
          linking shared library libhogweed.so. On systems using
          shared libraries where such dependencies work (in
          particular, ELF systems), it is sufficient to link
          applications with -lhogweed. For static linking -lhogweed
          -lnettle -lgmp is still required.

	* The program pkcs1-conv is extended to also handle dsa keys.
          Contributed by Magnus Holmgren.

	* Slightly improved sha1 performance on x86.
244

Niels Möller's avatar
Niels Möller committed
245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293
NEWS for the 2.0 release

	This release breaks binary compatibility by splitting the
	library into two. Some other smaller changes that are not
	backwards compatible are also done at the same time.

	* The nettle library is split into two libraries, libnettle
	  and libhogweed. libnettle contains the symmetric crypto
	  algorithms that don't depend on GMP, while libhogweed
	  contains the public key algorithms that depend on GMP.
	  Using a single library worked fine with static linking, but
	  not with dynamic linking. Consider an application that uses
	  nettle and which doesn't use any public key cryptography. If
	  this application is linked dynamically to nettle, it would
	  have to be linked also with GMP if and only if public key
	  support was enabled when the nettle library was installed.

	  The library names are libnettle.so.3.0 and
	  libhogweed.so.1.0, with sonames libnettle.so.3 and
	  libhogweed.so.1.

	* Function typedefs have been changed to non-pointer types.
	  E.g, the

	    typedef void (nettle_hash_init_func *)(void *ctx);

	  of previous versions is replaced by

	    typedef void (nettle_hash_init_func)(void *ctx);

	  This makes it possible to use the type when declaring
	  functions, like

	    nettle_hash_init_func foo_hash_init;

	    void foo_hash_init(void *ctx) { ... }

	* Changes to the yarrow256 interface. The automatic seed file
	  generation, and the seed_file member in struct
	  yarrow256_ctx, has been removed. To generate a new seed
	  file, use yarrow256_random. The function
	  yarrow256_force_reseed has been replaced by the two
	  functions yarrow256_fast_reseed and yarrow256_slow_reseed,
	  which were previously static. This interface change makes it
	  easier to mix in the current content of the seed file before
	  overwriting it with newly generated data.

	Other changes:

294 295 296 297
	* Nettle manual now contributed to the public domain, to
          enable remixing into documentation of programs that use
          Nettle.	  

Niels Möller's avatar
Niels Möller committed
298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313
	* The sexp-conv program preserves comments when using the
	  advanced syntax for output. Optionally locks the output
	  file.

	* The base64 decoder recognizes ASCII FF (form feed) and VT
          (vertical tab) as white space.

	* New x86_64 implementations of AES and SHA1. On a 2.2 GHz
          opteron, SHA1 was benchmarked at 250 MByte/s, and AES-128 at
          110 MByte/s.

	* Performance of AES increased by 20-30% on x86.

	* New programs in the examples directory: erathostenes and
          next-prime.
	
Niels Möller's avatar
Niels Möller committed
314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352
NEWS for the 1.15 release

	Added support for PKCS#1 style RSA signatures using SHA256,
	according to RFC 3447. Currently lacks interoperability
	testing.
	
	Header files are now C++ aware, so C++ programs using Nettle
	should now use plain

	  #include <nettle/foo.h>

	rather than

	  #extern "C" {
	  #include <nettle/foo.h>
	  }

	as was the recommendation for the previous version. This
	breaks source-level compatibility with C++, even though
	there's full binary compatibility.

	The file rfc1750.txt (which is considered non-free by debian)
	has been removed from the distribution. The file was used as input
	for the Yarrow testcase, and has been replaced by the short
	story "The Gold-bug" by Edgar Allan Poe. Anyway, RFC 1750 is
	obsoleted by RFC 4086.

	Fixes for Darwin shared library support, contributed by Grant
	Robinsson.

	Example programs now use a supplied getopt.c.

	Configure tests for assemblers with a logarithmic .align
	directive.

	The library is intended to be upwards binary compatible with
	earlier versions. The library name is libnettle.so.2.6, soname
	is still libnettle.so.2.
		
353 354
NEWS for the 1.14 release

Niels Möller's avatar
Niels Möller committed
355 356 357
	Experimental support for reading keys in PKCS#1 ASN1/DER
	format, and a new command line tool pkcs1-conv.
	
358 359
	Improved MD5 performance on x86.

Niels Möller's avatar
Niels Möller committed
360 361
	Fixed support for sparc64.

362 363 364 365 366 367 368 369 370
	Reorganized AES code. Better performance for all three
	implementations (C, x86 assembler, sparc assembler).

	New sparc assembler for arcfour. Compared to the code
	generated by gcc, the new code is about 25% faster on old
	sparcs, and 6 times faster on ultrasparc.

	Replaced the internal function nettle_mpz_from_octets with a
	call to mpz_import, if available in the installed GMP library.
Niels Möller's avatar
Niels Möller committed
371 372 373 374 375 376 377 378 379

	More Makefile fixes; it now seems to work to build with
	the the make programs on Solaris and FreeBSD (although
	--disable-dependency-tracking is required for the latter).

	The library is intended to be binary compatible with earlier
	versions. The library name is libnettle.so.2.5, soname is
	still libnettle.so.2.

Niels Möller's avatar
Niels Möller committed
380 381 382 383 384
NEWS for the 1.13 release

	Fixed problem with broken m4 on bsd, which resulted in
	corrupted x86 assembler for sha1.

Niels Möller's avatar
Niels Möller committed
385 386 387 388 389 390 391
	Nettle probably works on windows: I've been able to cross
	compile it with ./configure --host=i586-mingw32msvc (without
	public-key support), and the testsuite binaries seem to run
	fine in Wine.

	Implemented CTR mode.

Niels Möller's avatar
Niels Möller committed
392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407
	Improved sha1 performance on x86.

	Configure check to figure out if symbols in assembler files
	need a leading underscore.

	Improved benchmark program. Displays cycles per byte and block,
	and compares with openssl (if openssl is installed).
	
	Terminating newline in output from sexp-conv --hash.

	The library is intended to be binary compatible with earlier
	versions. The library name is libnettle.so.2.4. However, the
	interface for the internal function _nettle_sha1_compress has
	changed; any program that calls this function directly will
	break.

408 409 410 411 412 413 414
NEWS for the 1.12 release
	
	Fixed a bug in the configure script.

	Updated the description of aes_set_encrypt_key and
	aes_set_decrypt_key in the manual.

415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440
NEWS for the 1.11 release

	Nettle no longer uses automake. Side effects:

	  * Dependency tracking is enabled only for gcc-3 (help with
	    supporting dependency tracking with other compilers is
	    appreciated).
	  
	  * Makefile compatibility with make programs other than GNU
	    make is mostly unknown, please report any problems.

	Support for arctwo.

	Fixes to the libdes compatibility code. Declarations should
	now match openssl/libdes better. des_cbc_cksum pads
	input with NUL's, if it's not an integral number of blocks (in
	general, such unreversible padding is a bad idea).

	By default, also the static library is compiled as position
	independent code. This is needed on some systems to make it
	possible to link nettle into a dynamically loaded module. Use
	the configure flag --disable-pic if this is not desired.

	Stricter constness typing for the sexp_iterator_assoc and
	sexp_iterator_check_types arguments.

Niels Möller's avatar
Niels Möller committed
441 442
	Minor tweaks of arcfour on x86 cpu:s, to speed it up on older
	x86 variants such as PII and PPro.
443

Niels Möller's avatar
Niels Möller committed
444 445
	The shared library is intended to be binary compatible with
	nettle-1.8 - nettle-1.10. Only the minor version number of the
Niels Möller's avatar
Niels Möller committed
446 447
	shared library is increased. The soname is still
	libnettle.so.2.
Niels Möller's avatar
Niels Möller committed
448

Niels Möller's avatar
Niels Möller committed
449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466
NEWS for the 1.10 release

	Nettle should now compile also on Tru64, Darwin, FreeBSD and
	Windows. (The only tested windows build uses the rntcl rsh
	wrapper to run the command line M$ C compiler "cl". See
	http://pike.ida.liu.se for those tools, I don't know all
	details about the Pike team's windows setup).

	There are some known testsuite failures, on Windows and on one
	of the xenofarm HPUX machines, see
	http://www.lysator.liu.se/~nisse/xeno-lsh/latest.html. Help
	tracking these down is appreciated.

	There are no new features.
	
	This release is intended to be binary compatible with
	nettle-1.8 and nettle-1.9.
	
467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486
NEWS for the 1.9 release

	Optimized C implementation of arcfour. Optimized x86
	implementations of arcfour and sha1.

	Improved benchmark program.
	
	Fixed bug in the rsa-encrypt example program.

	Fixed bug in make install, some of the header files were
	forgotten.
	
	Portability fixes. Fixes to make Nettle compile on systems
	without gmp. This version has been tested on GNU/Linux,
	Solaris, HPUX and AIX.

	The shared library is intended to be binary compatible with
	nettle-1.8. Only the minor version number of the shared
	library is increased.

Niels Möller's avatar
Niels Möller committed
487 488
NEWS for the 1.8 release

Niels Möller's avatar
Niels Möller committed
489 490 491 492
	New example programs, demonstrating encrypting and decrypting
	files using RSA, and random sessions keys for bulk encryption
	and message authentication.

Niels Möller's avatar
Niels Möller committed
493 494 495 496
	Support for systems that don't have alloca. On such systems,
	some of Nettle's functions have arbitrary limits applied to
	their input.

Niels Möller's avatar
Niels Möller committed
497 498 499
	Uses AX_CREATE_STDINT_H, to support systems without
	inttypes.h.

Niels Möller's avatar
Niels Möller committed
500 501
	Support for the md2 and md4 hash functions.
	 
Niels Möller's avatar
Niels Möller committed
502
	New name mangling, to reduce the risk of link collisions. All
Niels Möller's avatar
Niels Möller committed
503
	functions (except memxor) now use a nettle_ or _nettle_ prefix
Niels Möller's avatar
Niels Möller committed
504
	when seen by the linker. For most functions, the header file
Niels Möller's avatar
Niels Möller committed
505 506
	that declares a function also uses #define to provide a
	shorter more readable name without the prefix.
Niels Möller's avatar
Niels Möller committed
507

Niels Möller's avatar
Niels Möller committed
508 509
	The shared library soname for this version is libnettle.so.2.
	
510 511
NEWS for the 1.7 release

Niels Möller's avatar
Niels Möller committed
512 513 514
	Implemented DSA.

	Renamed RSA functions for consistency. Now it's
515
	rsa_public_key_init, not rsa_init_public_key, etc.
Niels Möller's avatar
Niels Möller committed
516 517 518 519 520 521 522 523 524 525 526 527 528 529 530

	Both RSA and DSA now have sign/verify functions that take the
	hash digest as argument.

	A rewritten and much more powerful sexp-conv program.

	Other changes to the sexp code, in particular updating it to
	the latest SPKI draft.

	Building nettle as a shared library (ELF only) seems to work.
	The version number is increased, so the library "soname" for
	this release is "libnettle.so.1".

	Bugfixes. Fixes for build and portability problems.

Niels Möller's avatar
Niels Möller committed
531 532
NEWS for the 1.6 release

Niels Möller's avatar
Niels Möller committed
533 534 535 536 537 538
	Optimized assembler implementations of aes, for sparc and x86.

	The aes interface has changed slightly. The function
	aes_set_key is no more. Instead one has to use
	aes_set_encrypt_key or aes_set_decrypt_key. Sorry about that. 

Niels Möller's avatar
Niels Möller committed
539 540 541 542 543 544 545 546 547 548 549
	New example programs, rsa-keygen, rsa-sign and rsa-verify,
	located in the examples directory.

	New configure option --enable-shared, which builds a shared
	library. Not tested.

	New experimental features, including sexp parsing and
	formatting, and changes to base64 encoding and decoding. The
	interfaces to these functions are subject to change, and are
	documented only in the source code.
	
Niels Möller's avatar
Niels Möller committed
550 551
NEWS for the 1.5 release

Niels Möller's avatar
Niels Möller committed
552
	RSA support. Key generation and signatures.
Niels Möller's avatar
Niels Möller committed
553
	
Niels Möller's avatar
Niels Möller committed
554
	Support for HMAC (RFC-2104).
Niels Möller's avatar
Niels Möller committed
555

Niels Möller's avatar
Niels Möller committed
556 557 558 559
	An implementation of the Yarrow-256 PRNG.

	New sections in the manual.
	
Niels Möller's avatar
Niels Möller committed
560 561 562 563 564
	Changed the interface for hash functions. The md5_digest
	function is now equivalent to the old sequence of md5_final,
	md5_digest, md5_init, and similarly for the other hashing
	algorithms. This makes the interface simpler.

Niels Möller's avatar
Niels Möller committed
565 566 567 568
NEWS for the 1.0 release

	Fixed twofish bug spotted by Jean-Pierre Stierlin.

Niels Möller's avatar
Niels Möller committed
569 570
	Added des3 and cbc.
	
Niels Möller's avatar
Niels Möller committed
571 572 573
	New RFC-1321-like interface in nettle/md5-compat.h, suggested
	by Assar Westerlund.

Niels Möller's avatar
Niels Möller committed
574
	New libdes-style compatibility interface in nettle/des-compat.h.