1 Changes in release 0.30.0:
3 - none, API and ABI backwards-compatible with 0.27.x and later
4 * New interfaces and features:
5 - ne_ssl.h: added ne_ssl_clicert_import, ne_ssl_context_get_flag
6 - ne_session.h: added ne_set_addrlist2
7 - ne_socket.h: added ne_addr_canonical
8 - ne_auth.h: added NE_AUTH_GSSAPI_ONLY, NE_AUTH_SSPI (Nathanael Rensen)
9 - ne_basic.h: added NE_CAP_EXT_MKCOL options test
10 - ne_request.h: support chunked bodies with negative length passed to
11 ne_set_request_body_provider (Julien Reichel)
13 - ne_path_escape: fix excessive memory allocation (Pierre Crokaert)
14 - SSPI auth: use canonical server hostname, clear SSPI context after
15 successful auth (Nathanael Rensen)
16 - build fixes for Open Watcom compiler (NormW)
17 - fix Win32 error code handling for local ne_sock_prebind bind failure
18 - Win32: support LFS, thread-safe OpenSSL (Diego Santa Cruz)
19 - GnuTLS: fix GnuTLS 3.x support (Matthias Petschick, Bartosz Brachaczek)
21 Changes in release 0.29.6:
22 * Don't abort SSL handshake with GnuTLS if a client cert is requested
23 but none is configured/available (thanks to Patrick Ohly)
24 * Fix the method string passed to create_request hooks to have the same
25 lifetime as the request object (Patrick Ohly)
28 Changes in release 0.29.5:
29 * Fix GnuTLS handshakes failures with 'TLS warning alert' (Bryan Cain)
30 * Further fix for SSPI support on Win32 (Danil Shopyrin)
32 Changes in release 0.29.4:
33 * Fix SNI support (Tobias Gruetzmacher)
34 * Fix possible Solaris linker errors if building static library
35 * Win32: Fix Kerberos authentication support with SSPI (Danil Shopyrin)
36 * Fix error handling when pulling a request body from an file
37 (thanks to Lou Montulli)
38 * Fix ne_request_dispatch() return value for SOCKS proxy failure cases
39 * Tighten SSL cert ID checks to deny a wildcard match against an IP address
41 Changes in release 0.29.3:
42 * Change ne_sock_close() to no longer wait for SSL closure alert:
43 - fixes possible hang with IIS servers when closing SSL connection
44 - this reverts the behaviour with OpenSSL to match 0.28.x, and
45 changes the behaviour with GnuTLS to match that with OpenSSL
46 * Fix memory leak with GnuTLS
47 * API clarification in ne_sock_close():
48 - SSL closure handling now documented
49 - return value semantics fixed to describe the implementation
51 Changes in release 0.29.2:
52 * Fix spurious 'certificate verify failed' errors with OpenSSL (Tom C)
53 * Fix unnecessary re-authentication with SSPI (Danil Shopyrin)
55 Changes in release 0.29.1:
56 * Fixes for (Unix) NTLM implementation:
57 - fix handling of session timeout (Kai Sommerfeld)
58 - fix possible crash (basic@mozdev.org)
59 * Fix unnecessary re-authentication with SSPI (Danil Shopyrin)
60 * Build fixes for Win32:
61 - fix use of socklen_t with recent SDKs (Stefan Kung)
62 - fix USE_GETADDRINFO on Win2K (Kai Sommerfeld)
63 * Fix build with versions of GnuTLS older than 2.8.0.
65 Changes in release 0.29.0:
67 - none, API and ABI backwards-compatible with 0.28.x and 0.27.x
68 * New interfaces and features:
69 - added NTLM auth support for Unix builds (Kai Sommerfeld, Daniel Stenberg)
70 - ne_auth.h: added NE_AUTH_GSSAPI and NE_AUTH_NTLM auth protocol codes
71 - added ne_acl3744.h, updated WebDAV ACL support (Henrik Holst)
72 - added built-in SOCKS v4/v4a/v5 support: ne_socket.h:ne_sock_proxy(),
73 and ne_session.h:ne_session_socks_proxy()
74 - added support for system-default proxies: ne_session_system_proxy(),
75 implemented using libproxy where available
76 - ne_session.h: added NE_SESSFLAG_EXPECT100 session flag, SSL verification
77 failure bits extended by NE_SSL_BADCHAIN and NE_SSL_REVOKED, better
78 handling of failures within the cert chain (thanks to Ludwig Nussel)
79 - ne_utils.h: added feature code NE_FEATURE_SYSPROXY
80 - ne_socket.h: ne_sock_writev() (Julien Reichel), ne_sock_set_error(),
81 ne_iaddr_raw(), ne_iaddr_parse()
82 - ne_string.h: ne_buffer_qappend(), ne_strnqdup()
83 * Deprecated interfaces:
84 - ne_acl.h is obsoleted by ne_acl3744.h (but is still present)
85 - obsolete feature "NE_FEATURE_SOCKS" now never marked present
87 - fix handling of "stale" flag in RFC2069-style Digest auth challenge
88 - ne_free() implemented as a function on Win32 (thanks to Helge Hess)
89 - symbol versioning used for new symbols, where supported
90 - ensure SSL connections are closed cleanly with OpenSSL
91 - fix build with OpenSSL 1.0 beta
92 - updated Polish (pl) translation (Arfrever Frehtes Taifersar Arahesis)
94 Changes in release 0.28.6:
95 * SECURITY (CVE-2009-2473): Fix "billion laughs" attack against expat;
96 could allow a Denial of Service attack by a malicious server.
97 * SECURITY (CVE-2009-2474): Fix handling of an embedded NUL byte in
98 a certificate subject name with OpenSSL; could allow an undetected
99 MITM attack against an SSL server if a trusted CA issues such a cert.
101 Changes in release 0.28.5:
102 * Enable support for X.509v1 CA certificates in GnuTLS.
103 * Fix handling of EINTR in connect() calls.
104 * Fix use of builds with SOCK_CLOEXEC support on older Linux kernels.
106 Changes in release 0.28.4:
107 * Fix ne_forget_auth (Kai Sommerfeld)
108 * GnuTLS support fixes:
109 - fix handling of PKCS#12 client certs with multiple certs or keys
110 - fix crash with OpenPGP certificate
111 - use pkg-config data in configure, in preference to libgnutls-config
112 * Add PKCS#11 support for OpenSSL builds (where pakchois is available)
113 * Fix small memory leak in PKCS#11 code.
114 * Fix build on Haiku (scott mc)
116 Changes in release 0.28.3:
117 * SECURITY (CVE-2008-3746): Fix potential NULL pointer dereference in
118 Digest domain parameter support; could allow a DoS by a malicious server
119 * Fix parsing of *-Authenticate response header with LWS after quoted value
120 * Fix ne_set_progress(, NULL, ) to match pre-0.27 behaviour (and not crash)
121 * Fix to disable Nagle on Win32 with newer toolchain (thanks to Stefan Küng)
122 * Fix build on Netware (Guenter Knauf)
123 * Document existing ne_uri_parse() API postcondition and ne_uri_resolve()
124 pre/postconditions regarding the ->path field in ne_uri structures
125 * Mark ne_{,buffer_}concat with sentinel attribute for GCC >= 4.
126 * Distinguish the error message for an SSL handshake which fails after a
127 client cert was requested.
128 * Compile with PIC flags by default even for static library builds
130 Changes in release 0.28.2:
131 * Support "Proxy-Connection: Keep-Alive" for compatibility with HTTP/1.0
132 proxies which require persistent connections for NTLM authentication
133 * Fix an fd leak in ne_ssl_{,cli}cert_read (GnuTLS only)
134 * Enable fast initialization in GnuTLS.
136 Changes in release 0.28.1:
138 * Fix build on SCO OpenServer 5.0.x (thanks to Nico Kadel-Garcia)
139 * Fix handling of Digest domain parameter values without a trailing slash
140 * Fix build against apr-util's bundled libexpat.la in Subversion
141 * Add --without-pakchois to configure (Arfrever Frehtes Taifersar Arahesis)
142 * zh message catalog renamed to zh_CN, translation updated (Dongsheng Song)
144 Changes in release 0.28.0:
146 - none, API and ABI backwards-compatible with 0.27.x
148 - ne_pkcs11.h: added basic PKCS#11 support (requires GnuTLS and pakchois)
149 - ne_auth.h: added NE_AUTH_ALL and NE_AUTH_DEFAULT constants
150 - ne_socket.h: added ne_sock_peer(), ne_sock_prebind(), ne_sock_cipher()
151 - ne_session.h: NE_SESSFLAG_TLSSNI flag added; TLS SNI support is enabled
152 by default, where supported; ne_set_localaddr() added
153 - ne_request.h: added close_conn hooks (Robert J. van der Boon)
154 - ne_basic.h: added ne_options2()
156 - add Polish (pl) translation (Arfrever Frehtes Taifersar Arahesis)
157 - add support for the 'domain' parameter in Digest authentication
158 - fix fd leak in ne_sock_connect() error path (Andrew Teirney)
159 - the FD_CLOEXEC flag is set on socket fds
160 - fix timezone handling in ne_dates for more platforms (Alessandro Vesely)
161 - fix ne_simple_propfind() to print XML namespaces in flat property values
162 - fix ne_get_range() for unspecified end-range case (Henrik Holst)
163 - fix ne_strclean() to be locale-independent and avoid possible Win32 crash
164 - fix ne_get_error() to not "clean" localized error strings
165 - fix ne_ssl_clicert_read() to fail for client certs missing cert or key
166 - Win32: fix build with VS 2008 (Stefan Kueng)
167 - Win32: fix neon.mak to not double-quote $(MAKE) (Henrik Holst)
168 - improve strength of Digest cnonces in GnuTLS builds
170 Changes in release 0.27.2:
171 * Fix crash in GSSAPI Negotiate response header verification (regression
174 Changes in release 0.27.1:
175 * Fix regression in response progress counter for notifier/progress callbacks
176 * Fix interface description for ne_set_notifier() callback; sr.total
177 is set to -1 not 0 for an indeterminate response length
179 Changes in release 0.27.0:
181 - ne_session.h: ne_fill_proxy_uri() retrieves configured proxy,
182 ne_hook_post_headers() adds a hook after response headers are read,
183 ne_set_connect_timeout() sets session connection timeout,
184 NE_SESSFLAG_RFC4918, NE_SESSFLAG_CONNAUTH flags added
185 - ne_socket.h: ne_sock_connect_timeout() sets connection timeout,
186 ne_iaddr_reverse() performs reverse DNS lookup
187 - ne_string.h: ne_buffer_snprintf() prints to a buffer object
188 - ne_xml.h: ne_xml_resolve_nspace() resolves namespace prefixes
190 - ne_set_notifier() replaces ne_set_status(); finer-grained and type-safe
191 connection status information now provided; obsoletes ne_set_progress()
192 - ne_xml_dispatch_request() now only invokes the XML parser for
193 response entities with an XML content-type, following RFC 3023 rules
194 - ne_acl_set() now takes a "const" entries array
195 - LFS compatibility functions *64 removed: all functions taking an
196 off_t now take an ne_off_t which is off64_t for LFS builds
197 * GnuTLS support now mostly feature-complete with OpenSSL support:
198 - greatly improved SSL distinguished name handling with GnuTLS >= 1.7.8
200 - descriptive error messages for authentication failures
201 - SSPI support uses canonical DNS server name (Yves Martin)
202 - fixes for handling of "stale" parameter in Digest authentication
203 - added support for URIs in SSL server certificate subjectAltName field
204 - fix compiler warnings with expat 2.x
205 - fix handling of "Transfer-Encoding: identity" responses from privoxy
207 Changes in release 0.26.4:
208 * Fix Negotiate Authentication-Info response header verification with GSSAPI
209 * Fix multiple handlers with ne_add_{server,proxy}_auth (Werner Baumann)
210 * Fix SSPI build with some versions of MinGW (Gisle Vanem)
211 * Fix for SSPI segfault in response header verification (Mike DiCuccio)
212 * Fix error strings for CONNECT SSL proxy tunnel request failure
213 * Fix install-nls for VPATH builds (Hans Meine)
214 * Fix use of unencrypted client certs with GnuTLS
215 * Fix ne_lock* If: header insertion to use CRLF-terminated headers
216 * Fix test suite failures on QNX by working around send() length limit
217 * Fix handling of POSIX strerror_r failure case in ne_strerror
218 * Fix alignment issues in test suite MD5 code
220 Changes in release 0.26.3:
221 * Fix buffer under-read in URI parser (Laszlo Boszormenyi, CVE-2007-0157)
222 * Fix regression in handling of "attempt" argument passed to auth callbacks;
223 ensure the value only increments for each invocation of the callback
224 * Fix handling of "nextnonce" parameter in Digest authentication
226 Changes in release 0.26.2:
227 * Fix error reported for LOCK responses lacking a Lock-Token header.
228 * Use Libs.private in neon.pc for newer versions of pkg-config.
229 * Build fix for platforms without libintl.h.
230 * Build fixes for MinGW. (Matthias Miller)
231 * Build fix for h_errno detection on HP-UX 10. (Albert Chin)
232 * Win32: enable debugging; build fixes with some SDKs. (Kiyo Kelvin Lee)
234 Changes in release 0.26.1:
235 * Build fixes for Win32 (D.J. Heap) and OS X.
236 * Add Simplified Chinese translation (Dongsheng Song).
238 Changes in release 0.26.0:
239 * Added internationalization support:
240 - ne_i18n.h exposes ne_i18n_init(), a process-global initializer
241 which may be required for some applications
242 - (partial) message catalogs for cs, de, fr, ja, nn, ru and tr
243 - NE_FEATURE_I18N feature code added to indicate support
244 * Added support for GnuTLS (thanks to Aleix Conchillo Flaque):
245 - pass --with-ssl=gnutls to configure; GnuTLS >= 1.0.22 required
246 - use --with-ca-bundle to specify a default SSL CA root bundle
247 - some remaining issues with PKCS#12 certs in current GnuTLS releases,
248 distinguished name handling is sub-standard relative to OpenSSL
249 * Changes and additions to URI support:
250 - ne_uri structure: add query, fragment fields; authinfo renamed
252 - ne_uri_parse() now takes a URI-reference as input rather than
253 the previous pseudo-URI syntax; the query and fragment components
254 are now parsed out. Many malformed URIs are now rejected
255 - ne_uri_unparse() changed to respect the new fields
256 - ne_uri_resolve(): new function; resolves relative URI references
257 - ne_uri_copy(): new function, copies a URI structure
258 * Changed results callbacks for ne_lock_discover, PROPFIND interfaces:
259 - take URI as parsed ne_uri * structure rather than char *
260 * Added functions which give control over authentication protocol use:
261 - ne_add_server_auth(), ne_add_proxy_auth()
262 * Added ne_unhook_* functions to remove hooks
263 * Added ne_set_session_flags()/ne_get_session_flags() functions:
264 - flags to disable persistent connection support, enable "ICY"
265 protocol support, and to disable SSLv2 protocol support.
266 - replaces ne_set_persist()
267 * Added ne_set_request_flags()/ne_get_request_flags() functions:
268 - flags to enable 100-continue support, mark requests as non-idempotent
269 - replaces ne_set_request_expect100()
270 * Change ne_md5.h interface to make struct ne_md5_ctx opaque:
271 - added ne_md5_create_ctx(), ne_md5_destroy_ctx(), ne_md5_reset_ctx(),
272 ne_md5_finish_ascii(); removed ne_md5_init_ctx()
273 - fix alignment issues which could cause crashes in Digest code
274 * Fixed ne_get_range(), added ne_get_range64() (thanks to Lennart Poettering)
275 * Removed NE_FREE() macro from ne_alloc.h
276 * Added ne_strcasecmp(), ne_strncasecmp(), ne_tolower() functions
277 to ne_string.h - locale-independent string comparison
278 * Changed ne_sock_init()/ne_sock_exit() such that ne_sock_exit()
279 only has effect once called an equal number of times to _init().
280 * Added "--enable-threadsafe-ssl=posix" configure flag, to enable
281 thread-safe SSL support using POSIX threads in OpenSSL/GnuTLS
282 - NE_FEATURE_TS_SSL feature code added to indicate support
283 * The manual is now licensed under the GPL rather than the GFDL
285 Changes in release 0.25.5:
286 * ne_ssl_clicert_decrypt(): catch and fail to load a client cert
287 with mismatched key/cert pair.
288 * Fix build issue on AIX 5.1.
289 * Fix warnings if built against OpenSSL >= 0.9.8.
290 * Win32: fix issues in SSPI implementation (Stefan Küng).
292 Changes in release 0.25.4:
293 * GSSAPI fixes for non-MIT implementations (Mikhail Teterin).
294 * Fix ne_print_request_header() et al to use 8K buffer size on all
295 platforms (fixes issue with long Destination: URLs on Win32).
296 * Win32 build fix for !USE_GETADDRINFO configuration.
297 * Documentation updates.
299 Changes in release 0.25.3:
300 * ne_lock() and ne_unlock(): fix cases where NE_ERROR would be returned
301 instead of e.g. NE_AUTH on auth failure.
302 * Prevent use of poll() on Darwin.
303 * Fix gethostbyname-based resolver on LP64 platforms (Matthew Sanderson).
305 Changes in release 0.25.2:
306 * Really fix the Win32 build.
308 Changes in release 0.25.1:
309 * ne_get_content_type(): fix cases where the charset field was not set
310 to NULL after successful return (Johannes Schneider)
311 * Compressed response handling fixes:
312 - fix double invocation of reader callback with len=0
313 - fix cases where the reader callback return value was ignored
314 * Cache the new SSL session if the old one was expired (Robert Eiglmaier)
315 * Win32: fix build issues.
317 Changes in release 0.25.0:
319 - ne_get_response_header() replaces ne_add_response_header_handler
320 - ne_read_response_to_fd() and ne_discard_response() for use with
321 ne_begin_request/ne_end_request style response handling
322 - ne_xmlreq.h: ne_xml_parse_response() and ne_xml_dispatch_request()
323 - ne_has_support() for feature detection, replaces ne_support_ssl()
324 - ne_set_addrlist() can be used to bypass normal DNS hostname resolver
325 - ne_buffer_czappend(), convenience wrapper for ne_buffer_append.
326 - ne_iaddr_typeof() returns type of a socket object
327 - ne_get_content_type() replaces ne_content_type_handler()
328 - ne_set_request_expect100() replaces ne_set_expect100()
329 * New interfaces on LFS systems for large file support:
330 - ne_set_request_body_fd64() call for using an fd opened using O_LARGEFILE
331 - ne_set_request_body_provider64(), takes an off64_t length argument
333 - ne_set_request_body_fd takes offset and length arguments and returns void
334 - ne_set_request_body_provider takes length as off_t rather than size_t;
335 provider callbacks now MUST set session error string if returning an error
336 - response body reader callback returns an integer and can abort the response
337 - ne_decompress_destroy() returns void; errors are caught earlier
338 - ne_xml_failed() replaces ne_xml_valid(), with different return value logic
339 - ne_xml_parse() can return an error; ne_xml_parse_v() aborts the response if
340 the parse either fails or is aborted by a handler returning NE_XML_ABORT
341 - ne_path_escape() now escapes all but unreserved characters
342 - ne_ssl_clicert_name() and ne_ssl_cert_identity() clarified to return UTF-8
343 - ne_ssl_clicert_name() clicert object argument is now const
344 - ne_uri_parse()/ne_uri_free() memory handling clarified
345 - removed the buffer length requirement for ne_read_response_block()
347 - properly handle multiple Authentication challenges per request
348 - fixes and improvements to the Negotiate auth implementation
349 - handle proxies which send a 401 auth challenge to a CONNECT request
350 - XML: handle the UTF-8 BOM even if the underlying parser does not
351 - Win32: Fix timezone handling (Jiang Lei)
352 - ne_lock_refresh() works and will update timeout of passed-in lock
353 - persistent connection timeout handling fixes for CygWin et al
354 - impose hard limit of 1024 props per resource in ne_props.h response parsing
355 * New platform-specific features:
356 - Win32: Negotiate/NTLM support using SSPI (Vladimir Berezniker)
357 - Win32: Add IPv6 support using ENABLE_IPV6 neon.mak flag (Kai Sommerfeld)
359 - the cookies interface has been removed
360 - removed functions: ne_service_lookup(), ne_put_if_unmodified()
361 - "qop=auth-int" support removed from Digest auth implementation
362 * Default XML parser search changed to check for expat before libxml2.
364 Changes in release 0.24.7:
365 * Compression interface fixes:
366 - fix issues handling content decoding and request retries from
367 authentication challenges (Justin Erenkrantz)
368 - fix places where reader callback would receive spurious size=0 calls
369 - fix to pass user-supplied userdata to user-supplied acceptance callback
370 * Fix for RFC2617-style digest authentication (Hideaki Takahashi).
371 * Fix to pick up gethostbyname() on QNX 6.2.
373 Changes in release 0.24.6:
374 * SECURITY (CVE CAN-2004-0398): Fix sscanf overflow in ne_rfc1036_parse,
375 thanks to Stefan Esser.
376 * Link libneon against libexpat during Subversion build using bundled neon.
377 * Win32 build script update (Jon Foster).
379 Changes in release 0.24.5:
380 * SECURITY (CVE CAN-2004-0179): Fix format string vulnerabilities in
381 XML/207 response handling, reported by greuff@void.at.
382 * Performance fix: avoid seeding the SSL PRNG if not creating an SSL socket.
383 * ne_ssl_readable_dname() is now defined to return UTF-8 strings.
384 * Fix case where gssapi/gssapi_generic.h was included but not present.
385 * Fix ne_utils.c build on platforms where zlib does "#define const".
386 * Fix use of ne_proppatch_operation with some C++ compilers.
387 * Update libtool for fix to --enable-shared on Darwin.
388 * BeOS: check for gethostbyname in -lbind (David Reid).
390 Changes in release 0.24.4:
391 * Ignore unclean SSL closure when response body is delimited by EOF
392 ("Could not read response body: Secure connection truncated" errors
393 with some buggy SSL servers).
394 * Fix test/ssl.c syntax errors with C89 compilers (Radu Greab).
396 Changes in release 0.24.3:
397 * Respect configure's --datadir argument (Max Bowsher).
398 * Fix build on Windows when OpenSSL is not used.
399 * Fix use of SSLv2 (spurious "Server did not present certificate" error).
400 * When using SSL via a proxy, prevent leaking server auth credentials
401 to the proxy, or proxy auth credentials to the server.
403 Changes in release 0.24.2:
404 * Fix name resolver with some old versions of glibc.
405 * Fix problems with configure's "time_t format string" detection.
406 * Fix problems when a broken Kerberos installation is found.
407 * When verifying SSL certificates, check iPaddress names in the
408 subjectAltName extension.
410 Changes in release 0.24.1:
411 * Add support for "GSS-Negotiate" Kerberos authentication scheme (from
412 Risko Gergely and Burjan Gabor).
413 * Disable Nagle to improve performance of small requests (thanks to
414 Jim Whitehead and Teng Xu).
415 * Fix compatibility with OpenSSL 0.9.6 (broken in 0.24.0).
416 * Fix prototype mismatch in ne_207.c.
417 * Define ssize_t from ne_request.h for Win32.
418 * Prevent segfault on zlib initialization failures.
419 * ne_sock_init does not fail if PRNG could not be seeded.
420 * Fix segfault in cookies code (Markus Mueller).
421 * Documentation updates.
423 Changes in release 0.24.0:
424 * Major changes to XML interface:
425 - have the start-element callback either accept, decline, abort,
426 or return a state integer.
427 - remove 'struct ne_xml_elm'; callbacks are passed {nspace, name}
428 strings along with a state integer.
429 - dropped "collect", "strip-leading-whitespace" modes
430 - push responsibility for accumulating cdata onto caller; drop 'cdata'
431 argument from end-element callback.
432 - don't abort if no handler accepts a particular element, just ignore
433 that branch of the tree.
434 - dropped support for libxml 1.x and expat < 1.95.0.
435 - guarantee that start_element callback is not passed attrs=NULL
436 - add ne_xml_doc_encoding() to retrieve encoding of parsed XML document.
437 * Major changes to SSL interface:
438 - rewrite of interfaces for handling server and client certificates;
439 ne_ssl.h: many new functions available.
440 - only PKCS#12-encoded client certs are supported.
441 - changes to most names of SSL-related functions operating on an
442 ne_session, e.g. ne_ssl_load_cert->ne_ssl_trust_cert.
443 - client cert provider callback is passed the set of acceptable CA
444 names sent by the server
445 - the entire chain of certs presented by server is now accessible
446 * Remove unused ne_register_progress() from socket layer.
447 * Changes to resolver interface: ne_addr_first and _next return const;
448 ne_addr_print renamed to ne_iaddr_print; ne_iaddr_make and ne_iaddr_free
450 * ne_request_create() now duplicates the method string passed in.
451 * ne_redirect_location() will now return NULL in some cases.
452 * Split socket creation to ne_sock_create() from ne_sock_connect:
453 - should report connect() error messages properly on Win32.
454 * Fix several memory leaks in error handling paths.
455 * Add a pkg-config file, neon.pc.in.
457 Changes in release 0.23.9:
458 * Fix inability to connect on AIX 4.3.
459 * neon-config exports includes needed for OpenSSL given by pkg-config.
460 * ne_redirect_location will return NULL if redirect hooks have not
461 been registered for the session (Ralf Mattes <rm@fabula.de>).
463 Changes in release 0.23.8:
464 * SECURITY: Prevent control characters from being included in the
465 reason_phrase field filled in by ne_parse_statusline(), and in
466 the session error string.
467 * Disable getaddrinfo() support on HP-UX; fix resolver for HP-UX 11.11.
468 * Fix digest auth response verification for >9 responses in session
469 (bug manifests as "Server was not authenticated correctly" error).
470 * On Linux, skip slow lookup for IPv6 addresses when IPv6 support is
471 not loaded in kernel (thanks to Daniel Stenberg for this technique).
472 * Update to autoconf 2.57 and libtool 1.4.3.
474 Changes in release 0.23.7:
475 * Fix for handling EINTR during write() call (Sergey N Ushakov).
476 * When available, use pkg-config to determine compiler flags needed to
477 use OpenSSL headers and libraries.
479 Changes in release 0.23.6:
480 * Fixes for error handling in socket layer on Win32 from Johan Lindh
481 and Sergey N Ushakov <ushakov@int.com.ru>:
482 - meaningful error messages rather than "No error"
483 - handle persistent connection timeouts properly
484 * Fix to use RFC2617-style digest auth when possible (had reverted to
485 only using RFC2068-style in 0.16.1).
486 * Fix NULL pointer dereference on certain ill-formed PROPFIND responses.
487 * Allow ne_sock_init to re-initialize after ne_sock_finish has been called
490 Changes in release 0.23.5:
491 * Fix rejection of SSL server certificates which had commonName as
492 the least specific attribute in the subject name.
493 * Fix to dereference entities (e.g. "&") in attribute values with libxml.
494 * Fix ne_socket.c build on HP-UX 10.20 (thanks to Branko Èibej)
495 * Remove misguided insistence on "secure" versions of zlib/OpenSSL;
496 no checks for zlib version are now performed, only OpenSSL 0.9.6 is
497 required. --with-force-ssl, --with-force-zlib option removed.
498 * Add --with-egd[=PATH] option, conditionally enable EGD support; either
499 using EGD socket at PATH, or fall back on system defaults. $EGDSOCKET
500 and $HOME/.entropy are no longer used.
501 * Add support for `--la-file' argument to neon-config, which prints the
502 full path of the installed libneon.la file.
504 Changes in release 0.23.4:
505 * Ignore an unclean SSL shutdown on persistent connection timeout
506 (fixing spurious "Secure connection truncated" errors).
507 * Fix a segfault on second and subsequent requests using a given
508 session, when the first fails with NE_LOOKUP.
509 * Fix configure for gcc installations which produce warnings by default
510 (such as gcc on hppa2.0n-hp-hpux11.00 using native as)
512 Changes in release 0.23.3:
513 * Further build fixes for Win32 (Blair Zajac).
514 * Another fix for use of SSL against Tomcat 3.2.
516 Changes in release 0.23.2:
517 * Build fix for Win32 (Blair Zajac).
519 Changes in release 0.23.1:
520 * Identify as correct version, not 0.22.
522 Changes in release 0.23.0:
523 * Improved address resolver (ne_addr_*) replacing ne_name_lookup():
524 - use getaddrinfo() if found; include support for IPv6 (based on work
525 by Noriaki Takamiya <takamiya@po.ntts.co.jp>)
526 * For a hostname with multiple addresses, each address is tried in turn
527 until a connection is made.
528 * Support for seeding OpenSSL's PRNG via $EGDSOCKET or $HOME/.entropy,
529 to enable SSL on platforms which lack a /dev/random device.
530 * RFC2818 compliance for certificate identity checks in SSL:
531 - use `dNSname' values in subjectAltName extension if present
532 - hostname comparison fixed to not be case-sensitive
533 * Fix interop with buggy SSL implementation in Tomcat 3.2.
534 * Added NE_DBG_SSL debug channel.
535 * ne_strerror changed to return the passed-in buffer.
536 * Added ne_strnzcpy macro to ne_string.h.
537 * Win32 build fixes, improvements, and documentation updates, from
538 Blair Zajac <blair@orcaware.com>.
539 * Fix ne_sock_init so SIGPIPE signals are ignored even if SSL library
540 initialization fails (e.g. platforms without /dev/random).
541 * Added reference documentation:
542 - ne_sock_init, ne_addr_*.
544 Changes in release 0.22.0:
545 * Remove the const qualifier from the reason_phrase field in ne_status.
546 - ne_parse_statusline() now strdup's the reason_phrase
547 * Remove the status_line argument from ne_207_end_propstat and _end_response
548 * Change ne_session_create, ne_session_proxy, ne_sock_connect, and the
549 'port' field of the ne_uri structure to use an unsigned int for port numbers
550 * ne_uri_defaultport returns unsigned and '0' on an unknown port (not -1).
551 * Changes to hooks interface:
552 - pass an ne_request pointer to per-request hooks
553 - replace "accessor" hooks with ne_{get,set}_{request,session}_private
554 * Authentication changes:
555 - the hooks changes fix a segfault if auth is enabled for an SSL session
556 through a proxy server
557 - fix ne_forget_auth segfault if either proxy or server auth are not used
558 * Improvements to persistent connection retry logic and error handling
559 in request code; fixing some cases where some errors where incorrectly
560 treated as a persistent connection timeout
561 - a TCP RST at the appropriate time is now treated as a persistent
563 - handle persistent connection timeouts on SSL connections
564 * Changes to SSL support:
565 - improved error handling
566 - OpenSSL 0.9.6f or later is required for security fixes and functional
567 correctness; 0.9.6 or later required for functional correctness
568 - use --with-force-ssl to override OpenSSL version check
569 - fix for proxy CONNECT tunnelling with some proxies (e.g. Traffic-Server)
570 - fix potential segfault if client cert. provider callback is used
571 - fix to use supplied password callback for PEM-encoded client certificates
572 (Daniel Berlin <dberlin@dberlin.org>)
573 * strerror_r is used if available for thread-safe error handling.
574 * Remove ne_read_file().
575 * ne_version_match replaces ne_version_minimum (semantics changed slightly).
576 * XML request bodies use a content-type of "application/xml" now;
577 applications can use NE_XML_MEDIA_TYPE from ne_xml.h
578 * Fix decompress code on big-endian or 64-bit platforms.
579 * Fix to build on Darwin 6 (aka Mac OS X 10.2) (Wilfredo Sánchez,
582 - remove conflict between OpenSSL's X509_NAME and recent versions of
583 the Platform SDK (Branko Èibej)
584 - fix inverted debug/non-debug build logic (Branko Èibej)
585 - add NODAV and OPENSSL_STATIC flags to neon.mak (Gerald Richter)
587 Changes in release 0.21.3:
588 * Fix segfault if using proxy server with SSL session and server
589 certificate verification fails.
590 * Fix leak of proxy hostname once per session (if a proxy is used).
591 * Add --with-libs configure argument; e.g. --with-libs=/usr/local picks
592 up any support libraries in /usr/local/{lib,include}
594 Changes in release 0.21.2:
595 * Fix 'make install' for VPATH builds.
596 * Use $(mandir) for installing man pages (Rodney Dawes).
597 * Follow some simple (yet illegal) relativeURI redirects.
598 * Always build ne_compress.obj in Win32 build (Branko Èibej).
599 * Fix decompression logic bug (Justin Erenkrantz <jerenkrantz@apache.org>)
600 (could give a decompress failure for particular responses)
601 * Fix ne_proppatch() to submit lock tokens for available locks.
602 * More optimisation of ne_sock_readline.
604 Changes in release 0.21.1:
605 * Don't include default SSL port in Host request header, which can
606 help interoperability with misbehaving servers (thanks to Rodney Dawes
608 * Don't give a "truncated response" error from ne_decompress_destroy if
609 the acceptance function returns non-zero.
610 * Fix for Win32 build (Sander Striker <striker@apache.org>).
611 * Fix for cookie name/value being free()d (thanks to Dan Mullen).
612 * Optimisation of ne_sock_readline.
614 Changes in release 0.21.0:
615 * Socket layer implements read buffering; efficiency and performance
616 improvement. Based on work by Jeff Johnson <jbj@redhat.com>
617 * Cleanup of socket interface:
618 - renamed everything, s/sock_/ne_sock_/, s/SOCK_/NE_SOCK_/
619 - removed unused and inappropriate interfaces.
620 - renaming done by Olof Oberg <mill@pedgr571.sn.umu.se>
621 - see src/ChangeLog for the gory details.
622 * Fix typoed 'ne_destroy_fn' typedef (Olof Oberg).
623 * Support OpenSSL/ENGINE branch.
624 * Bogus ne_utf8_encode/decode functions removed.
625 * ne_base64() moved to ne_string.[ch].
626 * ne_token drops 'quotes' parameter; ne_qtoken added.
627 * ne_buffer_create_sized renamed to ne_buffer_ncreate.
628 * ne_xml_get_attr takes extra arguments and can resolve namespaces.
629 * ne_accept_response function type takes const ne_status pointer.
630 * Drop support for automatically following redirects:
631 - ne_redirect_register just takes a session pointer
632 - ne_redirect_location returns an ne_uri pointer
633 * configure changes: --with-ssl and --with-socks no longer take a directory
634 argument. To use SOCKS or SSL libraries/headers in non-system locations,
635 use ./configure CPPFLAGS=-I/... LDFLAGS=-L/...
636 * Reference documentation included for most of ne_alloc.h and ne_string.h,
637 and parts of ne_session.h and ne_request.h.
638 - see installed man pages, HTML documentation.
640 Changes in release 0.20.0:
641 * Major changes to DAV lock handling interface (ne_locks.h):
642 - struct ne_lock uses a full URI structure to identify locked resource
643 - ne_lock() requires that owner/token fields are malloc-allocated (or NULL)
645 - introduce a "lock store" type, ne_lock_store, to replace the lock session;
646 accessor functions all renamed to ne_lockstore_*.
647 - ne_lock_iterate replaced with a first/next "cursor"-style interface
648 - If: headers use an absoluteURI (RFC2518 compliance fix).
649 - fix for handling shared locks on DAV servers which return many active locks
650 in the LOCK response (thanks to Keith Wannamaker)
651 * Moved URI/path manipulation functions under ne_* namespace (ne_uri.h):
652 - path handling functions renamed to ne_path_*
653 - URI structure handling to ne_uri_*; struct uri becomes ne_uri.
654 - ne_uri_parse doesn't take a 'defaults' parameter any more
655 - if URI port is unspecified, ne_uri_parse sets port to 0 not -1.
656 - added ne_uri_unparse and ne_uri_defaultport functions.
657 * New 'ne_fill_server_uri' function to initialize a URI structure with
658 the server details for a given session (useful with locks interface).
659 * ne_decompress_{reader,destroy} are defined as passthrough-functions
660 if zlib support is not enabled.
661 * API change: ne_ssl_provide_fn returns void not int.
662 * Added NE_SSL_FAILMASK for verify failure sanity check.
663 * Removed return codes NE_SERVERAUTH and and NE_AUTHPROXY; correct
664 documentation, NE_PROXYAUTH is given for proxy auth failure.
665 * Require zlib >= 1.1.4 to avoid possible vulnerability in earlier versions.
666 See http://www.gzip.org/zlib/advisory-2002-03-11.txt for more details.
667 (version check can be skipped by passing --with-force-zlib to configure)
668 * New 'ne_ssl_readable_dname' function to create a human-readable string
669 from an X509 distinguished name.
670 * Fix support for newer versions of libxml2 (thanks to Jon Trowbridge
672 * Fix corruption of reason_phrase in status object returned by
674 * More lenient handling of whitespace in response headers.
675 * ne_content_type_handler will give a charset of "ISO-8859-1" if no charset
676 parameter is specified for a text/* media type (as per RFC2616).
677 * Miscellaneous cleanups and fixes (Jeff Johnson <jbj@redhat.com>).
679 Changes in release 0.19.4:
680 * Support bundled build of expat 1.95.x (Branko Èibej).
682 Changes in release 0.19.3:
683 * For platforms lacking snprintf or vsnprintf in libc, require trio.
684 * Add NE_FMT_OFF_T to fix Win32 build (Dan Berlin, Branko Èibej).
685 * Fix SSL support in Win32 build (Branko Èibej).
687 Changes in release 0.19.2:
688 * Fix non-SSL build broken in 0.19.1.
689 * Working SOCKSv5 support (thanks to Torsten Kalix <torsten.kalix@bredex.de>)
691 Changes in release 0.19.1:
692 * Add missing stubs for ne_ssl_* functions for non-SSL build.
693 * Fix some error messages in new SSL code.
695 Changes in release 0.19.0:
696 * Major API change: ne_session_create now takes (scheme, hostname, port)
697 arguments: a session is clarified to be "a group of requests to a
699 - removal of ne_session_server, ne_set_secure, and ne_set_proxy_decider
700 - ne_session_proxy returns void.
701 - DNS lookups are delayed until request dispatch time.
702 * Significant improvements to TLS/SSL support:
703 - SSL is enabled if scheme passed to ne_session_create is "https"
704 - new interfaces to load CA certs and to load SSL library's bundled CA certs
705 - add server cert verification callback. An SSL connection to a server
706 with an unknown CA will now fail unless a verification callback is used.
707 - enable SSL session caching (performance improvement)
708 - support for wildcard server certs where commonName is "*.example.com".
709 - thanks to Tommi Komulainen for the contribution of code from mutt's
710 IMAP/SSL implementation under the LGPL, from which bits of this were derived.
711 * Improved SSL client certificate support:
712 - far simpler interface, all done at ne_session.h level.
713 - supports PKCS#12 and PEM-encoded certificates.
714 - optional callback for only providing client when demanded by server.
715 * Support for TLS upgrade is removed, since it isn't useful.
716 * If NEON_SSL is defined, API extensions are available to:
717 - allow access to the SSL_CTX * to adjust session SSL options
718 - retrieve the server certificate (X509 *)
720 - fix potential segfault in ne_decompress_destroy
721 - check the CRC of the deflated output (and fail if it doesn't match)
722 - fail appropriately on truncated responses, and trailing bytes in response.
723 * Added ne_set_read_timeout to use configurable timeout on socket reads.
724 * Malformed response headers will be ignored rather than failing the request.
725 * ne_set_error takes printf-style vararg.
726 * Fixes for ne_get_range and improve error handling.
727 * Functions which append to an ne_buffer do not return a success value,
728 but they do use ne_realloc/ne_malloc under the hood now, so an OOM callback
729 will be used (with the usual caveats).
730 * XML interface does not strip leading whitespace from cdata by default,
731 the NE_XML_STRIPWS flag is available to restore this feature if required.
732 * Upgraded to libtool 1.4.2:
733 - should fix --enable-shared on Mac OS X 10.1
734 * Test suite now contains over one hundred tests.
736 Changes in release 0.18.5:
737 * Removed old neon.dsp, neon.dsw.
738 * Update Win32 build to add OpenSSL and zlib support (Branko Èibej).
739 * Fix ne_compress.c to compile on Win32 (Branko Èibej).
741 Changes in release 0.18.4:
742 * Fixes for Content-Type parsing using ne_content_type_handler (Greg Stein)
743 - also now parses the charset parameter from header value.
744 * Removed ne_concat() function, which didn't work and wasn't used.
746 Changes in release 0.18.3:
747 * Fix parsing lock timeout from server (Arun Garg).
748 * Send Timeout headers in LOCK and refresh LOCK requests (Arun Garg).
749 * Updated neon.mak and config.hw.in for Win32 build (patch from
750 Branko Èibej <brane@xbc.nu>).
751 * Define XML_BYTE_ORDER for bundled expat build in support macro
754 Changes in release 0.18.2:
755 * Fix --with-neon=PATH in support macros.
756 * Support DESTDIR in Makefile install targets (patch by
757 Pawel Golaszewski <blues@blysk.ds.pg.gda.pl>).
759 - fix configure check for time_t on some platforms (e.g Solaris 2.6).
760 - remove expect100_works bitfield in ne_session structure (thanks to
761 Yan Periard <yperiard@ems.net>).
763 Changes in release 0.18.1:
764 * Minor fix for authentication: "attempt" counter was not reset correctly
765 after authentication failed, so subsequent requests would not authenticate
767 * API change: ne_session_destroy returns void (there was no error case).
768 * Portability fixes (non-GCC compilers, 64-bit platforms, UnixWare 7)
769 * Optimisations in string manipulation routines.
770 * config.hw is included in the release tarball again.
771 * Improvements in the autoconf support macros:
772 - check for neon-config in PATH if --with-neon is not given
773 - stop if --with-neon is used, and the check for external neon fails
774 - added NEON_WITHOUT_ACL to prevent build of ne_acl.o
776 Changes in release 0.18.0:
777 * API change: authentication callback is passed fixed-size username/password
778 buffers, and an 'attempt' counter. Authentication is retried *forever*
779 until either it succeeds, or the callback returns non-zero.
780 * API clarifications:
781 - ne_propname may have a NULL nspace field, indicating the property has no
782 namespace. This holds for properties returned by the propfind interfaces.
783 - added NE_ELM_PROPS_UNUSED as the lowest element number which should
784 be used with handlers added to the XML parser returned by
785 ne_propfind_get_parser.
786 * Fixes and cleanups of lock discovery interface.
787 * Fix for short write handling in ne_get() (thanks to rado <dzusto@yahoo.com>).
788 * Fix for XML namespace prefix handling where a prefix could be mapped to an
789 incorrect URI (e.g. in PROPFINDs against mod_dav with >10 namespaces used)
790 * Add '--support <feature>' option to neon-config; the script exits with
791 success if given feature is supported. Known features are ssl, dav, zlib.
792 * Support for SSL, DAV, zlib is exported by neon.m4 as shell variable
793 NEON_SUPPORTS_{SSL,DAV,ZLIB}={yes,no} for bundled and external builds.
794 * `neon-config --cflags` won't include -I/usr/include for SSL build.
795 * Fix to call progress callbacks while sending request bodies again.
797 - portability fixes, auth interface and progress tests.
799 Changes in release 0.17.2:
800 * Accept Status-Lines with no reason phrase (Jeremy Elson).
801 * Fix handling of persistent connection timeout, and better error
802 handling if sending a request fails.
803 * Fix crashes in locking code.
804 * Return parse error on XML namespace prefix declaration with
805 an empty value. Thanks to Julian Reschke.
806 * Allow passing property names with NULL namespace to ne_proppatch.
807 * Fix for cross-compilation (Mo DeJong).
808 * Moved ne_propname definition from ne_207.h to ne_props.h.
810 - updated for Status-Line parsing changes (Jeremy Elson)
811 - better persistent connection tests
812 - fixed for --disable-webdav build
814 Changes in release 0.17.1:
815 * Add support for ACL method (Arun Garg <arung@pspl.co.in>),
817 * Fixes and clean up of libraries exported via `neon-config --libs'
818 * Fix timezone handling when parsing dates (on some platforms).
819 * Upgrade to autoconf 2.52 and libtool 1.4 (thanks to Mo DeJong).
820 * Cleanup/simplification of request dispatching:
821 - better handling of error cases, including fix for a possible
822 infinite loop when the server closes the connection prematurely.
823 * Add '--without-zlib' configure option.
825 - prettify output; imitate Perl test suite output.
826 - add tests for interim 1xx responses, persistent connections, more
827 unbounded operations.
829 Changes in release 0.17.0:
830 * Add support for decoding gzip Content-Encoding: see ne_compress.h.
831 - built if zlib is found; `neon-config --cflags' will define NEON_ZLIB if so.
832 * Rewrite hooks interface to register individual callbacks.
833 - inspired by the Apache 2.0/APR hooks interface
834 * Register cookies hooks using ne_cookie_register().
835 * Clean up configure scripts to enable use of autoconf 2.5x (Mo DeJong).
836 * Use new endianess configure macro to allow cross-compiling (Mo DeJong).
837 * Fix invalid C code in sock_init() in Win32 build (Mo DeJong).
838 * Fix use of signal() on Win32 (Mo DeJong).
839 * Workaround libxml 1.x string handling not being UTF-8.
841 - add tests for decompression interface.
843 Changes in release 0.16.1:
844 * Also handle write errors in ne_get_range.
845 * Dump request body blocks in debugging mode.
846 * Fix ne_shave() causing memory corruption when the result should
847 have been the empty string.
848 * Refactor auth header parsing code; more efficient now.
849 - fixes digest auth RFC2617-style broken in 0.16.0
851 Changes in release 0.16.0:
852 * API change: ne_copy takes a depth parameter (thanks to Arun Garg, Medha Atre)
853 * API change: validate callback to ne_xml also takes a userdata arg.
854 * Added 'ne_lock_refresh' for performing lock refresh (Arun Garg).
855 * Add SSL support to Win32 build (Peter Boos <PediB@colorfullife.com>)
856 (see INSTALL.win32 for details). Compile with USE_DAV_LOCKS also.
857 * Remove Server header parser for 100-continue support in ne_options.
858 (and remove broken_expect100 from ne_server_capabilities).
859 * Set SIGPIPE disposition to "ignored" in sock_init().
860 * On platforms with setvbuf(), turn off buffering for the debug log
862 * Ignore repeated calls to sock_init().
863 * Fixes to error handling in ne_get_range.
864 * Minor improvements to memory handling in auth code.
865 * Fix for start_propstat callback being called with NULL response
866 argument when given invalid XML, causing a segfault in propfind code.
868 - add regression test for the propfind segfault.
869 - handle segfaults better (reap the child, flush the debug log).
871 Changes in release 0.15.3:
872 * Fix --with-expat=DIR build.
874 Changes in release 0.15.2:
875 * Fix Win32 for XML parser changes (Gerald Richter).
876 * Substitute versions into config.hw at distribution time.
877 * Add date parser for ISO8601-formatted dates as defined by RFC2518, e.g.
878 the creationdate property (Taisuke Yamada <tai@iij.ad.jp>).
879 * Fix Y2K bug in RFC1036 date parsing algorithm.
881 - add tests for date parsing functions.
883 Changes in release 0.15.1:
884 * Win32 update from Gerald Richter <richter@ecos.de>
885 - new files neon.mak, INSTALL.win32
886 * Fix for ne_socket.h includes (Mo DeJong).
887 * More improvements for XML parser selection logic:
888 - if parser is required, be sure to fail configure if none is found.
889 - added --with-included-expat for bundled expat logic.
890 * Rename --enable-debugging to --enable-debug (Mo DeJong).
891 - added NEON_DEBUG macro to exported autoconf macros.
892 * Call progress callbacks for request bodies.
894 - check that reading response headers is a bounded operation.
895 - use a pipe between child and parent to avoid race condition and
898 Changes in release 0.15.0:
899 * Major API renaming to use ne_/NE_ namespace:
900 - http_ to ne_, HTTP_ to NE_, dav_ to ne_, DAV_ to NE_, neon_ to ne_
901 - hip_xml_ to ne_xml_, HIP_ELM_ to NE_ELM_, HIP_XML_ -> NE_XML_
902 - sbuffer_ to ne_buffer_
903 - DEBUG() to NE_DEBUG(), DEBUG_ to NE_DBG_
905 - http_req to ne_request
906 - sbuffer to 'ne_buffer *'
907 * Note, 'ne_buffer' is not an implicit pointer type, you must
908 specify the '*' now, e.g. 'ne_buffer *buf = ne_buffer_create();'.
909 * ne_buffer is no longer opaque.
910 - ne_buffer_data() removed: use buf->data instead.
911 - ne_buffer_size() is a macro.
912 * Header renames and additions:
913 - http_request.h -> ne_request.h
914 - Session code split into ne_session.h
915 - hip_xml.h -> ne_xml.h, nsocket.h -> ne_socket.h, http_utils.h -> ne_utils.h
916 - neon_md5.h -> ne_md5.h, dav_207.h -> ne_207.h
917 - http_basic.h and dav_basic.h merged into ne_basic.h
919 - ne_token and ne_shave, to obsolete split_string, shave_string.
920 * Removed: ne_get_request_headers().
922 - disable building shared neon library by default.
923 - option --enable-libxml is replaced by --with-libxml1 and
924 --with-libxml2 to force use of a particular parser.
925 * Fix auth code to only take MD5 digests of response body blocks when
926 necessary (thanks to Kai Sommerfeld).
927 * Fix alignment bug in MD5 code which could cause SIGBUS on Sparc
928 architectures (Kai Sommerfeld).
929 * Rewrite of request body handling:
930 - ne_set_request_body_fd replaces _stream, using an int fd rather than
932 - added ne_set_request_body_provider to give a callback which is called
933 to provide request body blocks.
934 - removal of 'use_body' hook in favour of 'ne_pull_request_body' function
935 to allow hooks to manually read the request body.
936 - ne_{put,get,post,put_if_unmodified} all take an integer fd rather than a
939 - added framework for testing "over the wire" (fork a server process)
940 - added tests for response message length handling, chunked responses,
941 header folding, sending request bodies.
942 - start at listing RFC2616 requirements and whether they are met
943 or not in test/STATUS.
944 - test for MD5 alignment bug on Sparc (thanks to Kai Sommerfeld).
946 Changes in release 0.14.0:
947 * Add C++ inclusion safety to http_auth.h (Kai Sommerfeld).
948 * Define ssize_t on Win32. (Kai Sommerfeld).
949 * Add C++ inclusion safety to dav_locks.h and ne_alloc.h (thanks to
950 Gregor Bornemann <Gregor.Bornemann@germany.sun.com>).
951 * Significant API change to properties code, to allow use of allprop
952 and complex properties:
953 - dav_propfind_set_complex and _set_flat are removed.
954 - add parameter to dav_propfind_named to take the list of property names
956 - new function dav_propfind_set_private to set private callback.
957 - all properties not handled by caller are stored as flat properties.
958 * Untested: add basic SOCKSv5 support: configure --with-socks.
959 - please report success/failure to neon@webdav.org
960 * Win32/MSVC build files from Magnus Sirwiö <sirwio@hotmail.com>.
961 * Fix for expat detection from Shane Mayer <shanemayer42@yahoo.com>.
962 * Namespace-protect md5 code and more.
964 - ascii_to_md5 -> ne_ascii_to_md5 (and moved to neon_md5.h)
965 * Parse authinfo segment in URIs (Johan Lindh <johan@link-Data.com>).
966 - added 'authinfo' field to struct uri.
967 * New API: hip_xml_get_attr to retrieve attributes.
968 * Store language for properties, access with dav_propset_lang.
969 - only if property is defined on the property element itself.
970 * Started a simple test suite (test/*).
971 - includes some simple HTTP server tests.
972 * Remove "Content-Length: 0" header for request with no body, fixing
973 interop with Squid 2.3-STABLE1 (thanks to Kai Sommerfeld).
974 * http_parse_statusline skips leading whitespace. (Johan Lindh).
975 * Partial fix for timezone/date parsing problems.
977 Changes in release 0.13.0:
978 * Fix ne_strndup allocating one byte less than it should (Kai Sommerfeld)
979 - if you use uri_parse, this bug may have caused subtle memory corruption
981 * Revert API changes in 0.12: property values are not UTF-8 encoded/decoded
982 internally. (thanks to Greg Stein)
983 * Add another optional argument to NEON_BUNDLED macros, actions to
984 be run if bundled build is *not* selected.
985 * API change: added argument to http_add_hooks to register cleanup function
987 * Removed dav_lock_unregister in favour of automatic cleanup when session
989 * Fixed leaks in redirect code (Kai Sommerfeld).
990 * Fixed crashes in hip_xml_destroy (Kai Sommerfeld).
991 * Redirects to a different hostname/port/scheme are never followed: the request
992 will fail with HTTP_REDIRECT instead. Redirect notification callback is
993 only called for *followed* redirects.
994 New API: http_redirect_location() for retrieving location of last redirect.
995 * Authentication is now implemented as a hook, independently of http_request.c:
996 - API change: removed 'hostname' argument from auth callbacks.
997 - API change: you must now include http_auth.h from your application.
998 - Also fixes case of using server and proxy authentication simultaneously
999 * Added 'http_forget_auth' to clear authentication session.
1000 * New API: http_session_hook_private for retrieving private per-session cookie
1002 * API change: http_set_request_body_stream has a return error value.
1003 * API change: http_set_request_body_buffer now takes the buffer length too.
1004 * New API: caller-pulls interface for reading response body:
1005 http_begin_request, http_end_request, http_read_response_block.
1006 An alternative to using the (much simpler) http_request_dispatch.
1007 * Make --disable-webdav build work.
1008 * New API: dav_propnames for retrieving property names.
1009 * New API: dav_propfind_get_request to access request object of handler.
1010 * API change: progress and connection status callbacks implemented at
1011 http_request.h level. Socket-level status callbacks removed, progress
1012 callbacks made per-socket.
1013 * Supports new expat (Sam TH <sam@uchicago.edu>)
1014 * Supports libxml2 (in preference to libxml1).
1015 * API change: added namespace protection to base64 and dates functions:
1016 all have ne_ prefix now.
1017 * Fixed ranged GETs where a specific range is requested (Johan Lindh
1018 <johan@linkdata.se>).
1019 * Limit number of response header fields to 100.
1020 * Allow requests for the '*' URI even if a proxy server is in use.
1021 * libxml: Get useful error messages for parse errors.
1023 Changes in release 0.12.0:
1024 * Portability fixes to http_request.c and http_auth.c.
1025 - fixes digest auth on big-endian architectures.
1026 * Fix warnings from stray tokens after #endif's in uri.h and string_utils.h.
1027 * Add C++ inclusion safety to http_redirect.h (Kai Sommerfeld
1028 <kai.sommerfeld@germany.sun.com>).
1029 * Make redirects to a different host work (Kai Sommerfeld).
1030 * Fix reading response bodies when non-chunked and no Content-Length
1032 * API change: 'http_add_hooks takes a 'const' request object.
1033 * Fixed memory leaks in session hooks (thanks to Kai Sommerfeld).
1034 * Fix passing NULL props argument to dav_simple_propfind, to support
1036 **** MAJOR INTERFACE CHANGE ****
1037 - URIs passed to http_request_create() are NOT escaped by neon. You
1038 MUST do this yourself to remain HTTP compliant, using e.g.
1039 uri_abspath_escape. (Kai Sommerfeld)
1040 * Added --disable-webdav flag to configure, to disable DAV support in
1041 the library. This allows building neon without an XML parser.
1042 * Corresponding NEON_WITHOUT_WEBDAV macro for use in bundled builds.
1043 * Fix Makefile dependancies.
1044 * A bundled neon directory builds or doesn't build automatically
1045 (i.e. you recurse into it unconditionally).
1046 * API clarification:
1047 - dav_propset_status may return NULL if the server does not return
1048 a response for the given property (issue is open for debate).
1049 * API change up for debate:
1050 - Property values to dav_proppatch are UTF-8 encoded internally.
1051 - Property values in dav_propfind_* are UTF-8 decoded internally.
1052 * API additions: ne_realloc, ne_utf8_encode.
1054 Changes in release 0.11.0:
1055 * Added SSL client certificate support with 'sock_set_client_cert'.
1056 - Supports certs in PEM-encoded files.
1057 - Specify a callback for prompting the user for the password with
1058 sock_set_key_prompt.
1059 * Added 'ne_oom_callback', to register a callback which is used if
1060 malloc() returns NULL. (Mike Rosellini <m@icopyright.com>)
1061 * Register appropriate callback with libxml to handle <![CDATA blocks
1062 as normal character data (fixes PROPFINDs against sharemation.com).
1063 * Added 'NEON_REQUIRE' macro to declare that you require a neon library
1064 of a given minimum version, e.g. NEON_REQUIRE(0,10) means "I need
1065 neon 0.11 or later". The _BUNDLED macros will fall back on the bundled
1066 copy if an external library is found which is not of a new enough version.
1067 * Added neon_version_minimum() function call for run-time version detection.
1068 * neon_config.h has been removed.
1069 * Use closesocket() to close sockets on Win32 (Markus Fleck <fleck@isoc.de>).
1071 Changes in release 0.10.1:
1072 * Default expect-100 to OFF.
1074 Changes in release 0.10.0:
1075 * hip_xml API changes:
1076 - The search for a handler for a new child element begins at the
1077 handler of the parent element, and carries on up the stack.
1078 (previously, it always started from the base of the stack)
1079 - Documentation written: doc/parsing-xml.txt
1080 * Remove memory leaks and tidy debugging output in new properties code.
1081 * API changes to DAV locking interface:
1082 - New function: dav_lock_copy to copy a lock object.
1083 - Re-ordered arguments to callback of dav_lock_discover, and made the
1084 lock object passed back const.
1085 - Fix leaks and crashes due to vague interface definitions.
1086 * API change to dav_propfind_set_complex: use a callback to return the
1087 'private' structure.
1088 * NEON_NORMAL_BUILD and NEON_LIBTOOL_BUILD macros defined for setting
1089 up neon's Makefile in a bundled build: see macros/neon.m4.
1090 * NEON_VPATH_BUNDLED macro added which takes separate srcdir and
1091 builddir arguments for supporting VPATH builds (thanks to Peter Moulder
1093 * Added optional final argument to NEON_(VPATH_)BUNDLED, which gives
1094 a set of actions to be run if the bundled build is chosen.
1095 * NEON_SSL checks for OpenSSL in /usr too.
1096 * API change: when using http_session_decide_proxy, it MUST be called
1097 before using http_session_server to prevent the DNS lookup on the origin
1098 server being optimised out. The real scheme in use is passed to the
1100 * New function, dav_207_ignore_unknown, to ignore any unknown XML fragments
1101 in the 207 response. Used by properties layer.
1103 Changes in release 0.9.2:
1104 * Fix using both dav_propfind_set_complex and dav_propfind_set_flat with the
1105 same propfind_handler.
1107 Changes in release 0.9.1:
1108 * dav_propfind interface
1109 - Guarantee that the 'private' structure will be initialized to zero on
1111 - Make it the *callers* responsibility to free() the private structure.
1112 * Fix a few arguments/variables which mirrored globally declared symbols.
1114 Changes in release 0.9.0:
1115 * Removed old dav_propfind_* interface, replaced with a better, more
1116 powerful, and easier to use interface:
1117 - 'dav_simple_propfind' interface for just fetching "flat" (byte-string)
1119 - 'dav_propfind_*' interface for fetching flat and/or "complex" (structured
1121 - Lets you retrieve the 'status' information, to see what happened if
1122 fetching the property failed (e.g 404 Not Found).
1123 * Fixes to doc/using-neon.txt (thanks to Greg Stein).
1124 * Allow building when srcdir != builddir (Mo DeJong <mdejong@cygnus.com>)
1126 Changes in release 0.8.1:
1127 * Fix segfault in PROPFIND code.
1129 Changes in release 0.8.0:
1130 * Fix for using COPY/MOVE over SSL (thanks to David Sloat).
1131 * Fix for using a proxy server and SSL.
1132 * Added 'http_get_scheme' API call.
1133 * Added 'http_redirect.h' to list of installed headers (thanks to everyone ;).
1134 * Changes for building on Windows (Peter Boos <PediB@colorfullife.com>)
1135 * Fixes for building on BeOS (Sam TH <sam@uchicago.edu> and David Reid
1136 <dreid@jetnet.co.uk>).
1137 * Add buffering to socket code for pre-BONE BeOS systems (David Reid).
1138 * Interface changes for hip_xml:
1139 - Renamed hip_xml_add_(mixed_)handler to hip_xml_push_(mixed_)handler
1140 - Documentation updates.
1141 - Added HIP_ELM_UNUSED for lowest element id which should be used.
1142 *** MAJOR INTERFACE CHANGE ***
1143 - Removed 'http_status *' pointer from http_request_dispatch.
1144 - Added http_get_status(req) to retrieve the response-status information
1145 instead. You don't have to declare an http_status object yourself now.
1146 * Similarly, added DAV_ELM_207_UNUSED for lowest element id which should
1147 be used by users of dav_207_* code (incl. use of dav_propfind_*
1149 * New NEON_* autoconf macro interface:
1150 - Use NEON_BUNDLED if sources are bundled, otherwise NEON_LIBRARY.
1151 - The NEON_XML_PARSER macro is NOT called automatically. You must
1152 call this yourself if using NEON_BUNDLED; see doc/using-neon.txt
1154 * Fix use of 'socket' in nsocket.h function prototypes (Greg Stein).
1155 * Remove extra backslash at line 69 of src/Makefile.incl (Dirk Bergstrom).
1156 * Examples directory is now a separate package.
1158 Changes in release 0.7.7:
1159 * Another fix for linking against a libtool-built expat (Greg Stein).
1161 Changes in release 0.7.6:
1162 * Better check for closed SSL connection after doing SSL_peek. (thanks
1163 to Jeff Costlow <j.costlow@f5.com>).
1164 * Attempt at correct sock_block() implementation for SSL.
1165 * sock_peek() will return SOCK_CLOSED correctly.
1167 Changes in release 0.7.5:
1168 * Fixed workaround for linking against a libtool-built expat (Greg Stein).
1170 Changes in release 0.7.4:
1171 * Fix for fd leak on connect failure (David Sloat <d.sloat@f5.com>).
1172 * Fix for Digest auth against IIS5 (David Sloat).
1173 * Workaround for linking against a libtool-built libexpat.la (Greg Stein).
1175 Changes in release 0.7.3:
1176 * Check for -lsocket and -linet in configure.
1177 * Workaround for SSL problems.
1179 Changes in release 0.7.2:
1180 * Define SHELL in Makefile (thanks to Eric Mumpower <nocturne@arepa.com>).
1181 * Added 'all' target to Makefile (Greg Stein <gstein@lyra.org>)
1182 * Added '--with-expat' argument to configure (Greg Stein)
1183 * Added 'dav_propfind_destroy' function.
1185 Changes in release 0.7.1:
1186 * Don't register response body/header authentication callbacks if no
1187 credentials-supplying callback has been registered (speed optimisation).
1189 Changes in release 0.7.0:
1190 * Deprecated use of 'NULL' to http_add_response_header_handler.
1191 New interface, http_add_response_header_catcher, to register
1192 a callback which is passed ALL response headers regardless of name.
1193 * Speed optimisation (~10%?): storing response-header handlers in a
1194 hash table for faster look.
1195 * New SBUFFER_CAST() macro for getting to the 'char *' of an sbuffer
1196 as fast as possible.
1198 Changes in release 0.6.1:
1199 * Fix for retrying request if connection is closed by server.
1200 * Make redirect hook work for >1 request per session.
1202 Changes in release 0.6.0:
1203 * New interface to allow following HTTP redirects (301/302 responses).
1204 A callback must be given to get user confirmation if the request method
1205 is not GET, HEAD, or PROPFIND.
1206 * New interface to determine whether the proxy server should be used
1207 for a given request: http_session_decide_proxy.
1208 * Fix nget build again. Support automatic redirects in 'nget'.
1209 * Add --with-extra-includes and --with-extra-libs configure parameters
1210 to point configure at
1212 Changes in release 0.5.1:
1213 * Prevent segfault if USE_DAV_LOCKS is defined, and a locking session
1214 is not registered (thanks to David Sloat).
1216 Changes in release 0.5.0:
1217 * Rename xmalloc, xstrdup etc to ne_malloc, ne_strdup etc.
1218 * Some speed optimisation in response-header reading.
1219 * Use 'off_t' rather than 'size_t' in sock_progress callback,
1220 sock_readfile_blocked, and sock_transfer.
1222 Changes in release 0.4.2:
1223 * Fix for sending request bodies after getting 100-continue response.
1225 Changes in release 0.4.1:
1228 Changes in release 0.4.0:
1229 * Install library headers into .../include/neon not .../include/libneon
1230 * Install all necessary library headers.
1231 * Compile support for WebDAV locking throughout the library
1232 * Rename md5.h to neon_md5.h (avoids conflict with md5.h in OpenSSL)
1233 * Rename socket.h to nsocket.h (avoids possible conflict with C library)
1234 * Update licensing notice on macros/neon*.m4: note that these files are
1235 NOT under the LGPL, and can be used in other packages regardless of
1236 the license the package uses.
1237 * Update NEON_LIBRARY m4 function to allow optional specification of
1238 names of bundled neon/expat source directories.
1239 * Increase socket read timeout to 60 seconds.
1240 * Added an POST method: from Sander Alberink <sander.alberink@cmg.nl>.
1241 * Added 'http_get_request_headers' to return the sbuffer containing
1242 all request headers.
1243 * Allow passing NULL as name to http_add_response_header_handler:
1244 the handler callback is passed the entire header string, of ALL
1247 Changes in release 0.3.1:
1248 * Compile fix for dav_locks.c (thanks to Paul D'Anna)
1250 Changes in release 0.3.0:
1251 * Rewrite of socket handling layer. All sock_* functions changed.
1252 * Added basic SSL support: --with-ssl (requires OpenSSL).
1253 NOTE: Certificates are NOT presented for verification.
1254 * 'nget' accepts URL's using the 'https' scheme.
1255 * New example program, 'nserver', to display the Server: string,
1256 e.g. 'nserver https://www.eu.c2.net/'
1257 * Fixed request re-send when persistent connection times out.
1258 * "Hooks" support: allow external hooks into the HTTP request/
1259 response dispatch loop.
1260 * New printf-style interface for adding request headers.
1261 * Make symbols used in header files C++-safe (Tom Bednarz).
1262 * WebDAV locking support: lock discovery, LOCK (exclusive/shared)
1263 UNLOCK. "If:" headers are sent as appropriate. Simple interface
1264 for implementors of new methods to indicate which locks are
1265 required for the method.
1266 * Primitive HTTP cookies support.
1267 * Primitive hack at a GNOME-based GUI example program "nbrowse".
1268 Enable build with --enable-gnome-examples. It crashes, and
1269 not much else. Requires GNOME and POSIX threads. Example usage:
1270 'nbrowse dav.ics.uci.edu /msdav/'
1271 Many thanks to Lee Mallabone for Gtk help, and showing how to
1272 use Gtk and threads.
1274 Changes in release 0.2.0:
1275 * Use libtool: new configure options to select whether to build
1276 shared and/or static libraries. Should build shared libraries
1278 * Complete rewrite of the hip_xml interface to use opaque pointers.
1279 New functions: hip_xml_create, hip_xml_destroy: create parser.
1280 hip_xml_{set,get}_error: Access to error string.
1281 hip_xml_add_handler: Register callbacks for a set of elements.
1282 hip_xml_valid: Returns whether the parse was valid or not.
1283 Removed functions: hip_xml_init, hip_xml_finish.
1284 * Removed functions made reduntant by above changes in dav_207.
1285 * Don't include config.h in header files
1286 * Fix PROPFIND allprop request body (Michael Sobolev)
1287 * Added C++ safety macros around header files.
1288 * Added neon-config script for getting correct CFLAGS and LIBS
1289 values for using libneon in applications.
1291 Changes in release 0.1.1:
1292 * Fix for short writes in GET
1294 Changes in release 0.1.0: