Add.
[gsasl.git] / NEWS
blob90eb8f384099192ae4646b7e014ac3398ac65e22
1 GNU SASL NEWS -- History of user-visible changes.
2 Copyright (C) 2002, 2003, 2004, 2005, 2006 Simon Josefsson
3 See the end for copying conditions.
5 Note that changes to the GNU SASL Library is documented in lib/NEWS.
6 This file track changes to the remaining, non-library, parts of GNU
7 SASL.  That include the manual, the command line tool, and self tests.
9 * Version 0.3.0 (unreleased)
11 ** Support for the GS2 mechanism.
12 See lib/NEWS for the details.  It is disabled by default.
14 * Version 0.2.15 (released 2006-08-22)
16 ** Changed libgsasl shared library version.
17 The shared library version was not incremented correctly in the last
18 release, even though new APIs were added.
20 * Version 0.2.14 (released 2006-08-19)
22 ** New section "Requirements" in the manual, lists the external components.
23 Suggested by James Mansion.
25 ** Update of gnulib files.
27 * Version 0.2.13 (released 2006-06-14)
29 ** Update of gnulib files.
30 Further improves portability to MinGW.
32 ** Various improvements in the manuals.
34 ** The tests are run under valgrind, if it is installed.
35 Use --disable-valgrind-tests to unconditionally disable this.  It is
36 disabled by default for cross compiles.
38 ** Various minor fixes.
40 * Version 0.2.12 (released 2006-03-08)
42 ** Update of gnulib files.
43 Improves portability to Mingw32.
45 * Version 0.2.11 (released 2006-02-07)
47 ** Ported to Windows by cross-compiling using Mingw32.
48 Using Debian's mingw32 compiler, you can build it for Windows by invoking
49 `./configure --host=i586-mingw32msvc --disable-gssapi'.
51 ** Update of gnulib files.
53 * Version 0.2.10 (released 2005-10-23)
55 ** Work around bug in GnuTLS that made the command line tool exit after
56 ** failing to write a zero length message to the peer.
58 ** Don't use GnuTLS if gnutls_certificate_verify_peers2 isn't present.
60 ** Update of gnulib files.
62 * Version 0.2.9 (released 2005-10-07)
64 ** Update of gnulib files.
66 * Version 0.2.8 (released 2005-09-08)
68 ** The gsasl tool now support STARTTLS for IMAP and SMTP using GnuTLS.
70 ** The --client and --server parameters for the gsasl tool now work properly.
72 ** The --client and --server stdin/stdout modes now use the readline library.
74 ** Fixed build problems in getpass on uClibc and Mingw32 platforms.
76 ** Kinyarwanda translation added.
78 * Version 0.2.7 (released 2005-08-25)
80 ** Fix build problems when cross-compiling to uClibc and Mingw32 platforms.
82 ** Detecting and using the readline library has been improved.
84 * Version 0.2.6 (released 2005-08-08)
86 ** The gsasl tool now try to connect to all addresses for a server name.
88 ** The help-gsasl@gnu.org mailing list is now mentioned in documentation.
90 ** The license template in files were updated with the new FSF address.
92 ** Update of gnulib files.
94 * Version 0.2.5 (released 2005-02-08)
96 ** Added self test of EXTERNAL mechanism.
98 ** Vietnamese translation added, thanks to Clytie Siddall.
100 * Version 0.2.4 (released 2005-01-01)
102 ** The CRAM-MD5 mechanism is now preferred over DIGEST-MD5.
103 This decision was based on recent public research that suggest MD5 is
104 broken, while HMAC-MD5 not immediately compromised, and the lack of
105 public analysis on what consequences the MD5 break have for
106 DIGEST-MD5.  Support for CRAM-SHA1 is under investigation, to enable
107 users to avoid MD5 completely
109 ** Fixed a bug that prevented SMTP client from working.
111 ** New configure option --disable-obsolete to remove backwards compatibility.
112 This is mostly intended to be used when compiling for platforms with
113 constrained memory/space resources.
115 ** DIGEST-MD5 rewritten and enabled by default (see lib/NEWS for details).
117 ** Command line tool now query for realm, hostname and service name properly.
119 ** Documentation updates and improvements.
121 ** Self test improvements.
123 ** Update of gnulib files.
125 * Version 0.2.3 (released 2004-12-15)
127 ** Fix example code to handle base64 encoded data properly.
129 ** DIGEST-MD5 is disabled by default, pending a rewrite for the new API.
131 ** Command line tool uses new callback interface to the library.
133 ** Command line tool uses "iconvme" from gnulib for UTF-8 string conversion.
135 ** Server mode in the command line tool does not work currently.
136 It is unclear if this feature was ever that useful.  If there are no
137 objections, it will be removed completely in future versions.
139 ** Documentation fixes.
141 ** Fix self test bugs.
143 * Version 0.2.2 (released 2004-11-29)
145 ** Update of gnulib files.
147 * Version 0.2.1 (released 2004-11-19)
149 ** Documentation fixes; the old callback API functions are marked as obsolete.
151 * Version 0.2.0 (released 2004-11-07)
153 ** Added new directory examples/ with complete examples for new API.
155 ** Documentation improvements.
156 For example, you can now browse the GNU SASL API manual using DevHelp.
158 ** Update of gnulib files.
160 ** More self tests.
162 ** Translation fixes.
164 * Version 0.1.4 (released 2004-08-08)
166 ** Revamp of gnulib compatibility files.
168 ** More translations.
169 German (by Roland Illig), Basque (by Mikel Olasagasti), French (by
170 Michel Robitaille), Irish (by Kevin Patrick Scannell), Dutch (by Elros
171 Cyriatan), Polish (by Jakub Bogusz), Romanian (by Laurentiu Buzdugan),
172 and Serbian (by Aleksandar Jelenak).
174 * Version 0.1.3 (released 2004-08-04)
176 ** Command line tool support IPv6 (and other protocol families).
177 Requires that your system has `getaddrinfo'.
179 ** Command line behaviour for gsasl tool improved.
180 The --client and --imap parameters are now the default.  The --connect
181 host and port can now be specified directly.  If --authentication-id
182 is not specified, the username of the user invoking gsasl is used
183 (i.e., getpwuid(getuid)->pw_name).  Alltogether, this allows simple
184 usage, as in `gsasl mail.example.com' to connect, via IMAP, to
185 mail.example.com.
187 * Version 0.1.2 (released 2004-07-16)
189 ** The SMTP mode in `gsasl' should now work.
191 ** Cross compile builds should work.
192 It should work for any sane cross compile target, but the only tested
193 platform is uClibc/uClinux on Motorola Coldfire.
195 ** The GNU Readline library is used to read data, if available.
197 ** Passwords read from stdin are not echoed to the terminal.
199 * Version 0.1.1 (released 2004-06-26)
201 ** In the command line client, the default quality of protection is now none.
203 * Version 0.1.0 (released 2004-04-16)
205 ** The library re-licensed to LGPL and distributed as a separate package.
206 This means a fork of this NEWS file, all the entries below relate to
207 the combined work of earlier versions.  New entries above does not
208 document user visible changes for the library ("libgsasl"), for that
209 see NEWS in the lib/ sub-directory, which is also distributed as a
210 stand-alone package.
212 * Version 0.0.14 (released 2004-01-22)
214 ** Moved all mechanism specific code into sub-directories of lib/.
215 Each backend is built into its own library (e.g., libgsasl-plain.so),
216 to facilitate future possible use of dlopen to dynamically load
217 backends.
219 ** Moved compatibility files (getopt*) to gl/, and added more (strdup*).
221 * Version 0.0.13 (released 2004-01-17)
223 ** Nettle (the crypto functionality, crypto/) has been updated.
224 This fixes two portability issues, the new code should work on
225 platforms that doesn't have inttypes.h and alloca.
227 * Version 0.0.12 (released 2004-01-15)
229 ** Protocol line parser in 'gsasl' tool more reliable.
230 Earlier it assumed two lines were sent in one packet in one place, and
231 sent as two packets in another place.
233 ** Various bugfixes.
235 * Version 0.0.11 (released 2004-01-06)
237 ** The client part of CRAM-MD5 now uses SASLprep instead of NFKC.
238 This aligns with draft-ietf-sasl-crammd5-01.
240 ** The CRAM-MD5 challenge string now conform to the proper syntax.
242 ** The string preparation (SASLprep and trace) functions now work correctly.
244 ** DocBook manuals no longer included.
245 The reason is that recent DocBook tools from the distribution I use
246 (Debian) fails with an error.  DocBook manuals may be included in the
247 future, if I can get the tools to work.
249 ** API and ABI modifications.
250 GSASL_SASLPREP_ERROR: ADD.
252 * Version 0.0.10 (released 2003-11-22)
254 ** The CRAM-MD5 server now reject invalid passwords.
255 The logic flaw was introduced in 0.0.9, after blindly making code
256 changes to shut up valgrind just before the release.
258 ** Various build improvements.
259 Pkg-config is no longer needed.  GTK-DOC is only used if present.
261 * Version 0.0.9 (released 2003-11-21)
263 ** Command line client can talk to SMTP servers with --smtp.
265 ** DocBook manuals in XML, PDF, PostScript, ASCII and HTML formats included.
267 ** Token parser in DIGEST-MD5 fixed, improve interoperability of DIGEST-MD5.
269 ** Libgcrypt >= 1.1.42 is used if available (for CRAM-MD5 and DIGEST-MD5).
270 The previous libgcrypt API is no longer supported.
272 ** CRAM-MD5 and DIGEST-MD5 no longer require libgcrypt (but can still use it).
273 If libgcrypt 1.1.42 or later is not found, it uses a minimalistic
274 cryptographic library based on Nettle, from crypto/.  Currently only
275 MD5 and HMAC-MD5 is needed, making a dependence on libgcrypt overkill.
277 ** Listing supported server mechanisms with gsasl_server_mechlist work.
279 ** Autoconf 2.59, Automake 1.8 beta, Libtool CVS used.
281 ** Source code for each SASL mechanism moved to its own sub-directory in lib/.
283 ** The command line interface now uses getopt instead of argp.
284 The reason is portability, this also means we no longer use gnulib.
286 ** API and ABI modifications.
287 gsasl_randomize: ADD.
288 gsasl_md5: ADD.
289 gsasl_hmac_md5: ADD.
291 gsasl_hexdump: REMOVED.  Never intended to be exported.
293 gsasl_step: ADD.
294 gsasl_step64: ADD.
295 gsasl_client_step: DEPRECATED: use gsasl_step instead.
296 gsasl_server_step: DEPRECATED: use gsasl_step instead.
297 gsasl_client_step_base64: DEPRECATED: use gsasl_step64 instead.
298 gsasl_server_step_base64: DEPRECATED: use gsasl_step64 instead.
300 gsasl_finish: ADD.
301 gsasl_client_finish: DEPRECATED: use gsasl_finish instead.
302 gsasl_server_finish: DEPRECATED: use gsasl_finish instead.
304 gsasl_ctx_get: ADD.
305 gsasl_client_ctx_get: DEPRECATED: use gsasl_ctx_get instead.
306 gsasl_server_ctx_get: DEPRECATED: use gsasl_ctx_get instead.
308 gsasl_appinfo_get: ADD.
309 gsasl_appinfo_set: ADD.
310 gsasl_client_application_data_get: DEPRECATED: use gsasl_appinfo_get instead.
311 gsasl_client_application_data_set: DEPRECATED: use gsasl_appinfo_set instead.
312 gsasl_server_application_data_get: DEPRECATED: use gsasl_appinfo_get instead.
313 gsasl_server_application_data_set: DEPRECATED: use gsasl_appinfo_set instead.
315 Gsasl: ADD.
316 Gsasl_ctx: DEPRECATED: use Gsasl instead.
317 Gsasl_session: ADD.
318 Gsasl_session_ctx: DEPRECATED: use Gsasl_session instead.
320 GSASL_CRYPTO_ERROR: ADD, replaces deprecated GSASL_LIBGCRYPT_ERROR.
321 GSASL_LIBGCRYPT_ERROR: DEPRECATED: use GSASL_CRYPTO_ERROR instead.
323 GSASL_KERBEROS_V5_INTERNAL_ERROR: ADD, replaces deprecated GSASL_SHISHI_ERROR.
324 GSASL_SHISHI_ERROR: DEPRECATED: use GSASL_KERBEROS_V5_INTERNAL_ERROR instead.
326 GSASL_INVALID_HANDLE: ADD.
328 * Version 0.0.8 (released 2003-10-11)
330 ** Improved GSSAPI implementation detection.
331 Auto detection should work, unless you have both MIT and Heimdal, or
332 wish to override the default that prefer GSS over Heimdal over MIT.
333 In that case, use --enable-gssapi=mit or --enable-gssapi=heimdal.
335 ** GNU SASL contain APIs for internationalized string processing via SASLprep.
336 You no longer have to use Libidn directly.
338 ** Man pages for all public functions are included.
340 ** GNULib is used for compatibility functions.
341 The directory gl/ is dedicated for GNULib functions, and replace the
342 earlier ad-hoc usage of argp, memset, etc.
344 ** GNU SASL will be C89 compatible.
345 The library itself (lib/*) only use C89.  The remaining parts (src/
346 and tests/) can use C89 and any functionality from GNULib.  This
347 decision may be revised in the future, if it turns out there are
348 problems with this.
350 ** Improvements for embedded or otherwise limited systems.
351 The math library (-lm) is no longer required.  All client code can be
352 disabled by --disable-client, and all server code can be disabled by
353 --disable-server.  The internationalized string processing library can
354 be disabled by --without-stringprep.
356 ** Gettext 0.12.1 and Libtool 1.5 is used.
358 ** Libgcrypt from CVS (1.1.42) is not supported.
359 Recent libgcrypt is API incompatible with earlier released versions.
360 If a too recent version is installed, it will not be used.
362 ** Fix command line tool '--connect --imap' on Solaris.
364 ** Bug fixes.
366 ** API and ABI modifications.
367 Gsasl_client_callback_maxbuf: CHANGED: 'int' was replaced with 'size_t'.
368 Gsasl_server_callback_maxbuf: CHANGED: 'int' was replaced with 'size_t'.
369 gsasl_client_mechlist: NEW.
370 gsasl_server_mechlist: NEW.
371 gsasl_client_listmech: DEPRECATED: use gsasl_client_mechlist instead.
372 gsasl_server_listmech: DEPRECATED: use gsasl_server_mechlist instead.
373 gsasl_stringprep_nfkc: NEW.
374 gsasl_stringprep_saslprep: NEW.
375 gsasl_stringprep_trace: NEW.
377 * Version 0.0.7 (released 2003-06-02)
379 ** Two new GSS libraries supported for the GSS-API mechanism.
380 See http://josefsson.org/gss/ for GSS, which uses Shishi for Kerberos 5.
381 See http://www.pdc.kth.se/heimdal/ for Heimdal (Kerberos 5).
383 ** Bug fixes.
385 * Version 0.0.6 (released 2003-03-17)
387 ** Gettext not included.
388 Due to some conflicts between libtool and gettext, if you want i18n on
389 platforms that does not already have a useful gettext implementation,
390 you must install GNU gettext before building this package.  If you
391 don't care about i18n, this package should work fine (except for i18n,
392 of course).
394 ** Rudimentary support for KERBEROS_V5.
395 Only enable if you want to write code.  This adds two new API errors;
396 GSASL_KERBEROS_V5_INIT_ERROR, GSASL_SHISHI_ERROR.
398 ** Added API function: gsasl_client_callback_realm_set.
399 Specifies which realm the client belongs to.
401 ** Bugfixes.
402 User visible aspects includes not building the API Reference Manual
403 with GTK-DOC by default, if you want it use configure parameter
404 --enable-gtk-doc.
406 * Version 0.0.5 (released 2003-01-27)
408 ** Command line application "gsasl" now supports --imap and --connect.
409 The --imap parameter makes it use a IMAP-like negotiation on
410 stdin/stdout.  The --connect parameter makes it connect to a host over
411 TCP, and talk to it instead of stdin/stdout.  This allows it to be
412 used as a simple test tool to connect to IMAP servers.  Currently
413 integrity and confidentiality is not working properly, so if you use
414 DIGEST-MD5 you currently have to specify --quality-of-protection=auth.
416 ** Texinfo documentation added for command line tool.
418 ** Libgcrypt initialization no longer causes a warning to be printed.
420 ** Added API reference manual in HTML format, generated using GTK-DOC.
421 See doc/reference/, in particular doc/reference/html/index.html.
423 ** GNU Libidn replaces Libstringprep.
424 Although it is still stored in the libstringprep/ directory for CVS
425 reasons.
427 ** Bug fixes for DIGEST-MD5 and GSSAPI.
429 * Version 0.0.4 (released 2002-12-13)
431 ** License changed to GPL.
433 ** Official GNU project.
435 * Version 0.0.3 (released 2002-12-05)
437 ** New gsasl arguments --application-data and --no-client-first.
439 ** Bug fixes (client sends first, memory leaks, compiler warnings, more).
441 * Version 0.0.2 (released 2002-11-07)
443 ** Includes a copy of libstringprep 0.0.2 for Unicode NFKC
444 normalization and locale charset to UTF-8 string conversion, and
445 preparation for the future if a SASL Stringprep profile is created.
446 If libstringprep is already installed, it is used by default.  You can
447 force the use of the internal version with
448 --without-system-libstringprep.
450 ** Uses pkg-config instead of libgsasl.m4 + libgsasl-config.in, and
451 for finding libntlm (requires libntlm 0.3.1 or later).
453 ** Self tests for several mechanisms.
455 ** The API now allows mechanisms to return data even when returning
456 GSASL_OK (earlier only on GSASL_NEEDS_MORE).
458 ** Bug fixes.
460 * Version 0.0.1 (released 2002-10-12)
462 ** APIs for integrity and confidentiality protection of application
463 payload data.
465 ** DIGEST-MD5 support for integrity protection.
467 * Version 0.0.0 (released 2002-10-07)
469 ** Initial release.
471 ----------------------------------------------------------------------
472 Copying and distribution of this file, with or without modification,
473 are permitted in any medium without royalty provided the copyright
474 notice and this notice are preserved.
476 ;;; Local Variables: ***
477 ;;; mode:outline ***
478 ;;; mode:flyspell ***
479 ;;; End: ***