*** empty log message ***
[gsasl.git] / NEWS
blob80c9c0dff0bc4bd3e153fbfc0c51b5881deef12b
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.2.13 (released 2006-06-14)
11 ** Update of gnulib files.
12 Further improves portability to MinGW.
14 ** Various improvements in the manuals.
16 ** The tests are run under valgrind, if it is installed.
17 Use --disable-valgrind-tests to unconditionally disable this.  It is
18 disabled by default for cross compiles.
20 ** Various minor fixes.
22 * Version 0.2.12 (released 2006-03-08)
24 ** Update of gnulib files.
25 Improves portability to Mingw32.
27 * Version 0.2.11 (released 2006-02-07)
29 ** Ported to Windows by cross-compiling using Mingw32.
30 Using Debian's mingw32 compiler, you can build it for Windows by invoking
31 `./configure --host=i586-mingw32msvc --disable-gssapi'.
33 ** Update of gnulib files.
35 * Version 0.2.10 (released 2005-10-23)
37 ** Work around bug in GnuTLS that made the command line tool exit after
38 ** failing to write a zero length message to the peer.
40 ** Don't use GnuTLS if gnutls_certificate_verify_peers2 isn't present.
42 ** Update of gnulib files.
44 * Version 0.2.9 (released 2005-10-07)
46 ** Update of gnulib files.
48 * Version 0.2.8 (released 2005-09-08)
50 ** The gsasl tool now support STARTTLS for IMAP and SMTP using GnuTLS.
52 ** The --client and --server parameters for the gsasl tool now work properly.
54 ** The --client and --server stdin/stdout modes now use the readline library.
56 ** Fixed build problems in getpass on uClibc and Mingw32 platforms.
58 ** Kinyarwanda translation added.
60 * Version 0.2.7 (released 2005-08-25)
62 ** Fix build problems when cross-compiling to uClibc and Mingw32 platforms.
64 ** Detecting and using the readline library has been improved.
66 * Version 0.2.6 (released 2005-08-08)
68 ** The gsasl tool now try to connect to all addresses for a server name.
70 ** The help-gsasl@gnu.org mailing list is now mentioned in documentation.
72 ** The license template in files were updated with the new FSF address.
74 ** Update of gnulib files.
76 * Version 0.2.5 (released 2005-02-08)
78 ** Added self test of EXTERNAL mechanism.
80 ** Vietnamese translation added, thanks to Clytie Siddall.
82 * Version 0.2.4 (released 2005-01-01)
84 ** The CRAM-MD5 mechanism is now preferred over DIGEST-MD5.
85 This decision was based on recent public research that suggest MD5 is
86 broken, while HMAC-MD5 not immediately compromised, and the lack of
87 public analysis on what consequences the MD5 break have for
88 DIGEST-MD5.  Support for CRAM-SHA1 is under investigation, to enable
89 users to avoid MD5 completely
91 ** Fixed a bug that prevented SMTP client from working.
93 ** New configure option --disable-obsolete to remove backwards compatibility.
94 This is mostly intended to be used when compiling for platforms with
95 constrained memory/space resources.
97 ** DIGEST-MD5 rewritten and enabled by default (see lib/NEWS for details).
99 ** Command line tool now query for realm, hostname and service name properly.
101 ** Documentation updates and improvements.
103 ** Self test improvements.
105 ** Update of gnulib files.
107 * Version 0.2.3 (released 2004-12-15)
109 ** Fix example code to handle base64 encoded data properly.
111 ** DIGEST-MD5 is disabled by default, pending a rewrite for the new API.
113 ** Command line tool uses new callback interface to the library.
115 ** Command line tool uses "iconvme" from gnulib for UTF-8 string conversion.
117 ** Server mode in the command line tool does not work currently.
118 It is unclear if this feature was ever that useful.  If there are no
119 objections, it will be removed completely in future versions.
121 ** Documentation fixes.
123 ** Fix self test bugs.
125 * Version 0.2.2 (released 2004-11-29)
127 ** Update of gnulib files.
129 * Version 0.2.1 (released 2004-11-19)
131 ** Documentation fixes; the old callback API functions are marked as obsolete.
133 * Version 0.2.0 (released 2004-11-07)
135 ** Added new directory examples/ with complete examples for new API.
137 ** Documentation improvements.
138 For example, you can now browse the GNU SASL API manual using DevHelp.
140 ** Update of gnulib files.
142 ** More self tests.
144 ** Translation fixes.
146 * Version 0.1.4 (released 2004-08-08)
148 ** Revamp of gnulib compatibility files.
150 ** More translations.
151 German (by Roland Illig), Basque (by Mikel Olasagasti), French (by
152 Michel Robitaille), Irish (by Kevin Patrick Scannell), Dutch (by Elros
153 Cyriatan), Polish (by Jakub Bogusz), Romanian (by Laurentiu Buzdugan),
154 and Serbian (by Aleksandar Jelenak).
156 * Version 0.1.3 (released 2004-08-04)
158 ** Command line tool support IPv6 (and other protocol families).
159 Requires that your system has `getaddrinfo'.
161 ** Command line behaviour for gsasl tool improved.
162 The --client and --imap parameters are now the default.  The --connect
163 host and port can now be specified directly.  If --authentication-id
164 is not specified, the username of the user invoking gsasl is used
165 (i.e., getpwuid(getuid)->pw_name).  Alltogether, this allows simple
166 usage, as in `gsasl mail.example.com' to connect, via IMAP, to
167 mail.example.com.
169 * Version 0.1.2 (released 2004-07-16)
171 ** The SMTP mode in `gsasl' should now work.
173 ** Cross compile builds should work.
174 It should work for any sane cross compile target, but the only tested
175 platform is uClibc/uClinux on Motorola Coldfire.
177 ** The GNU Readline library is used to read data, if available.
179 ** Passwords read from stdin are not echoed to the terminal.
181 * Version 0.1.1 (released 2004-06-26)
183 ** In the command line client, the default quality of protection is now none.
185 * Version 0.1.0 (released 2004-04-16)
187 ** The library re-licensed to LGPL and distributed as a separate package.
188 This means a fork of this NEWS file, all the entries below relate to
189 the combined work of earlier versions.  New entries above does not
190 document user visible changes for the library ("libgsasl"), for that
191 see NEWS in the lib/ sub-directory, which is also distributed as a
192 stand-alone package.
194 * Version 0.0.14 (released 2004-01-22)
196 ** Moved all mechanism specific code into sub-directories of lib/.
197 Each backend is built into its own library (e.g., libgsasl-plain.so),
198 to facilitate future possible use of dlopen to dynamically load
199 backends.
201 ** Moved compatibility files (getopt*) to gl/, and added more (strdup*).
203 * Version 0.0.13 (released 2004-01-17)
205 ** Nettle (the crypto functionality, crypto/) has been updated.
206 This fixes two portability issues, the new code should work on
207 platforms that doesn't have inttypes.h and alloca.
209 * Version 0.0.12 (released 2004-01-15)
211 ** Protocol line parser in 'gsasl' tool more reliable.
212 Earlier it assumed two lines were sent in one packet in one place, and
213 sent as two packets in another place.
215 ** Various bugfixes.
217 * Version 0.0.11 (released 2004-01-06)
219 ** The client part of CRAM-MD5 now uses SASLprep instead of NFKC.
220 This aligns with draft-ietf-sasl-crammd5-01.
222 ** The CRAM-MD5 challenge string now conform to the proper syntax.
224 ** The string preparation (SASLprep and trace) functions now work correctly.
226 ** DocBook manuals no longer included.
227 The reason is that recent DocBook tools from the distribution I use
228 (Debian) fails with an error.  DocBook manuals may be included in the
229 future, if I can get the tools to work.
231 ** API and ABI modifications.
232 GSASL_SASLPREP_ERROR: ADD.
234 * Version 0.0.10 (released 2003-11-22)
236 ** The CRAM-MD5 server now reject invalid passwords.
237 The logic flaw was introduced in 0.0.9, after blindly making code
238 changes to shut up valgrind just before the release.
240 ** Various build improvements.
241 Pkg-config is no longer needed.  GTK-DOC is only used if present.
243 * Version 0.0.9 (released 2003-11-21)
245 ** Command line client can talk to SMTP servers with --smtp.
247 ** DocBook manuals in XML, PDF, PostScript, ASCII and HTML formats included.
249 ** Token parser in DIGEST-MD5 fixed, improve interoperability of DIGEST-MD5.
251 ** Libgcrypt >= 1.1.42 is used if available (for CRAM-MD5 and DIGEST-MD5).
252 The previous libgcrypt API is no longer supported.
254 ** CRAM-MD5 and DIGEST-MD5 no longer require libgcrypt (but can still use it).
255 If libgcrypt 1.1.42 or later is not found, it uses a minimalistic
256 cryptographic library based on Nettle, from crypto/.  Currently only
257 MD5 and HMAC-MD5 is needed, making a dependence on libgcrypt overkill.
259 ** Listing supported server mechanisms with gsasl_server_mechlist work.
261 ** Autoconf 2.59, Automake 1.8 beta, Libtool CVS used.
263 ** Source code for each SASL mechanism moved to its own sub-directory in lib/.
265 ** The command line interface now uses getopt instead of argp.
266 The reason is portability, this also means we no longer use gnulib.
268 ** API and ABI modifications.
269 gsasl_randomize: ADD.
270 gsasl_md5: ADD.
271 gsasl_hmac_md5: ADD.
273 gsasl_hexdump: REMOVED.  Never intended to be exported.
275 gsasl_step: ADD.
276 gsasl_step64: ADD.
277 gsasl_client_step: DEPRECATED: use gsasl_step instead.
278 gsasl_server_step: DEPRECATED: use gsasl_step instead.
279 gsasl_client_step_base64: DEPRECATED: use gsasl_step64 instead.
280 gsasl_server_step_base64: DEPRECATED: use gsasl_step64 instead.
282 gsasl_finish: ADD.
283 gsasl_client_finish: DEPRECATED: use gsasl_finish instead.
284 gsasl_server_finish: DEPRECATED: use gsasl_finish instead.
286 gsasl_ctx_get: ADD.
287 gsasl_client_ctx_get: DEPRECATED: use gsasl_ctx_get instead.
288 gsasl_server_ctx_get: DEPRECATED: use gsasl_ctx_get instead.
290 gsasl_appinfo_get: ADD.
291 gsasl_appinfo_set: ADD.
292 gsasl_client_application_data_get: DEPRECATED: use gsasl_appinfo_get instead.
293 gsasl_client_application_data_set: DEPRECATED: use gsasl_appinfo_set instead.
294 gsasl_server_application_data_get: DEPRECATED: use gsasl_appinfo_get instead.
295 gsasl_server_application_data_set: DEPRECATED: use gsasl_appinfo_set instead.
297 Gsasl: ADD.
298 Gsasl_ctx: DEPRECATED: use Gsasl instead.
299 Gsasl_session: ADD.
300 Gsasl_session_ctx: DEPRECATED: use Gsasl_session instead.
302 GSASL_CRYPTO_ERROR: ADD, replaces deprecated GSASL_LIBGCRYPT_ERROR.
303 GSASL_LIBGCRYPT_ERROR: DEPRECATED: use GSASL_CRYPTO_ERROR instead.
305 GSASL_KERBEROS_V5_INTERNAL_ERROR: ADD, replaces deprecated GSASL_SHISHI_ERROR.
306 GSASL_SHISHI_ERROR: DEPRECATED: use GSASL_KERBEROS_V5_INTERNAL_ERROR instead.
308 GSASL_INVALID_HANDLE: ADD.
310 * Version 0.0.8 (released 2003-10-11)
312 ** Improved GSSAPI implementation detection.
313 Auto detection should work, unless you have both MIT and Heimdal, or
314 wish to override the default that prefer GSS over Heimdal over MIT.
315 In that case, use --enable-gssapi=mit or --enable-gssapi=heimdal.
317 ** GNU SASL contain APIs for internationalized string processing via SASLprep.
318 You no longer have to use Libidn directly.
320 ** Man pages for all public functions are included.
322 ** GNULib is used for compatibility functions.
323 The directory gl/ is dedicated for GNULib functions, and replace the
324 earlier ad-hoc usage of argp, memset, etc.
326 ** GNU SASL will be C89 compatible.
327 The library itself (lib/*) only use C89.  The remaining parts (src/
328 and tests/) can use C89 and any functionality from GNULib.  This
329 decision may be revised in the future, if it turns out there are
330 problems with this.
332 ** Improvements for embedded or otherwise limited systems.
333 The math library (-lm) is no longer required.  All client code can be
334 disabled by --disable-client, and all server code can be disabled by
335 --disable-server.  The internationalized string processing library can
336 be disabled by --without-stringprep.
338 ** Gettext 0.12.1 and Libtool 1.5 is used.
340 ** Libgcrypt from CVS (1.1.42) is not supported.
341 Recent libgcrypt is API incompatible with earlier released versions.
342 If a too recent version is installed, it will not be used.
344 ** Fix command line tool '--connect --imap' on Solaris.
346 ** Bug fixes.
348 ** API and ABI modifications.
349 Gsasl_client_callback_maxbuf: CHANGED: 'int' was replaced with 'size_t'.
350 Gsasl_server_callback_maxbuf: CHANGED: 'int' was replaced with 'size_t'.
351 gsasl_client_mechlist: NEW.
352 gsasl_server_mechlist: NEW.
353 gsasl_client_listmech: DEPRECATED: use gsasl_client_mechlist instead.
354 gsasl_server_listmech: DEPRECATED: use gsasl_server_mechlist instead.
355 gsasl_stringprep_nfkc: NEW.
356 gsasl_stringprep_saslprep: NEW.
357 gsasl_stringprep_trace: NEW.
359 * Version 0.0.7 (released 2003-06-02)
361 ** Two new GSS libraries supported for the GSS-API mechanism.
362 See http://josefsson.org/gss/ for GSS, which uses Shishi for Kerberos 5.
363 See http://www.pdc.kth.se/heimdal/ for Heimdal (Kerberos 5).
365 ** Bug fixes.
367 * Version 0.0.6 (released 2003-03-17)
369 ** Gettext not included.
370 Due to some conflicts between libtool and gettext, if you want i18n on
371 platforms that does not already have a useful gettext implementation,
372 you must install GNU gettext before building this package.  If you
373 don't care about i18n, this package should work fine (except for i18n,
374 of course).
376 ** Rudimentary support for KERBEROS_V5.
377 Only enable if you want to write code.  This adds two new API errors;
378 GSASL_KERBEROS_V5_INIT_ERROR, GSASL_SHISHI_ERROR.
380 ** Added API function: gsasl_client_callback_realm_set.
381 Specifies which realm the client belongs to.
383 ** Bugfixes.
384 User visible aspects includes not building the API Reference Manual
385 with GTK-DOC by default, if you want it use configure parameter
386 --enable-gtk-doc.
388 * Version 0.0.5 (released 2003-01-27)
390 ** Command line application "gsasl" now supports --imap and --connect.
391 The --imap parameter makes it use a IMAP-like negotiation on
392 stdin/stdout.  The --connect parameter makes it connect to a host over
393 TCP, and talk to it instead of stdin/stdout.  This allows it to be
394 used as a simple test tool to connect to IMAP servers.  Currently
395 integrity and confidentiality is not working properly, so if you use
396 DIGEST-MD5 you currently have to specify --quality-of-protection=auth.
398 ** Texinfo documentation added for command line tool.
400 ** Libgcrypt initialization no longer causes a warning to be printed.
402 ** Added API reference manual in HTML format, generated using GTK-DOC.
403 See doc/reference/, in particular doc/reference/html/index.html.
405 ** GNU Libidn replaces Libstringprep.
406 Although it is still stored in the libstringprep/ directory for CVS
407 reasons.
409 ** Bug fixes for DIGEST-MD5 and GSSAPI.
411 * Version 0.0.4 (released 2002-12-13)
413 ** License changed to GPL.
415 ** Official GNU project.
417 * Version 0.0.3 (released 2002-12-05)
419 ** New gsasl arguments --application-data and --no-client-first.
421 ** Bug fixes (client sends first, memory leaks, compiler warnings, more).
423 * Version 0.0.2 (released 2002-11-07)
425 ** Includes a copy of libstringprep 0.0.2 for Unicode NFKC
426 normalization and locale charset to UTF-8 string conversion, and
427 preparation for the future if a SASL Stringprep profile is created.
428 If libstringprep is already installed, it is used by default.  You can
429 force the use of the internal version with
430 --without-system-libstringprep.
432 ** Uses pkg-config instead of libgsasl.m4 + libgsasl-config.in, and
433 for finding libntlm (requires libntlm 0.3.1 or later).
435 ** Self tests for several mechanisms.
437 ** The API now allows mechanisms to return data even when returning
438 GSASL_OK (earlier only on GSASL_NEEDS_MORE).
440 ** Bug fixes.
442 * Version 0.0.1 (released 2002-10-12)
444 ** APIs for integrity and confidentiality protection of application
445 payload data.
447 ** DIGEST-MD5 support for integrity protection.
449 * Version 0.0.0 (released 2002-10-07)
451 ** Initial release.
453 ----------------------------------------------------------------------
454 Copying and distribution of this file, with or without modification,
455 are permitted in any medium without royalty provided the copyright
456 notice and this notice are preserved.
458 ;;; Local Variables: ***
459 ;;; mode:outline ***
460 ;;; mode:flyspell ***
461 ;;; End: ***