docs/KNOWN_BUGS

   1 These are problems known to exist at the time of this release. Feel free to
   2 join in and help us correct one or more of these! Also be sure to check the
   3 changelog of the current development status, as one or more of these problems
   4 may have been fixed since this was written!
   5
   6 40. HTTP Pipelining, NULL content
   7   http://curl.haxx.se/bug/view.cgi?id=1631566
   8
   9 39. Steffen Rumler's Race Condition in Curl_proxyCONNECT:
  10   http://curl.haxx.se/mail/lib-2007-01/0045.html
  11
  12 38. Kumar Swamy Bhatt's problem in ftp/ssl "LIST" operation:
  13   http://curl.haxx.se/mail/lib-2007-01/0103.html
  14
  15 37. Having more than one connection to the same host when doing NTLM
  16   authentication (with performs multiple "passes" and authenticates a
  17   connection rather than a HTTP request), and particularly when using the
  18   multi interface, there's a risk that libcurl will re-use a wrong connection
  19   when doing the different passes in the NTLM negotiation and thus fail to
  20   negotiate (in seemingly mysterious ways).
  21
  22 35. Both SOCKS5 and SOCKS4 proxy connections are done blocking, which is very
  23   bad when used with the multi interface.
  24
  25 34. The SOCKS4 connection codes don't properly acknowledge (connect) timeouts.
  26   Also see #12. According to bug #1556528, even the SOCKS5 connect code does
  27   not do it right: http://curl.haxx.se/bug/view.cgi?id=1556528,
  28
  29 33. Doing multi-pass HTTP authentication on a non-default port does not work.
  30   This happens because the multi-pass code abuses the redirect following code
  31   for doing multiple requests, and when we following redirects to an absolute
  32   URL we must use the newly specified port and not the one specified in the
  33   original URL. A proper fix to this would need to separate the negotiation
  34   "redirect" from an actual redirect.
  35
  36 32. (At least on Windows) If libcurl is built with c-ares and there's no DNS
  37   server configured in the system, the ares_init() call fails and thus
  38   curl_easy_init() fails as well. This causes weird effects for people who use
  39   numerical IP addresses only.
  40
  41 31. "curl-config --libs" will include details set in LDFLAGS when configure is
  42   run that might be needed only for building libcurl. Similarly, it might
  43   include options that perhaps aren't suitable both for static and dynamic
  44   linking. Further, curl-config --cflags suffers from the same effects with
  45   CFLAGS/CPPFLAGS.
  46
  47 30. You need to use -g to the command line tool in order to use RFC2732-style
  48   IPv6 numerical addresses in URLs.
  49
  50 29. IPv6 URLs with zone ID is not supported.
  51   http://www.ietf.org/internet-drafts/draft-fenner-literal-zone-02.txt
  52   specifies the use of a plus sign instead of a percent when specifying zone
  53   IDs in URLs to get around the problem of percent signs being
  54   special. According to the reporter, Firefox deals with the URL _with_ a
  55   percent letter (which seems like a blatant URL spec violation).
  56
  57    See http://curl.haxx.se/bug/view.cgi?id=1371118
  58
  59 26. NTLM authentication using SSPI (on Windows) when (lib)curl is running in
  60   "system context" will make it use wrong(?) user name - at least when compared
  61   to what winhttp does. See http://curl.haxx.se/bug/view.cgi?id=1281867
  62
  63 23. SOCKS-related problems:
  64   A) libcurl doesn't support SOCKS for IPv6.
  65   B) libcurl doesn't support FTPS over a SOCKS proxy.
  66   C) We don't have any test cases for SOCKS proxy.
  67   E) libcurl doesn't support active FTP over a SOCKS proxy
  68
  69   We probably have even more bugs and lack of features when a SOCKS proxy is
  70   used.
  71
  72 22. Sending files to a FTP server using curl on VMS, might lead to curl
  73   complaining on "unaligned file size" on completion. The problem is related
  74   to VMS file structures and the perceived file sizes stat() returns. A
  75   possible fix would involve sending a "STRU VMS" command.
  76   http://curl.haxx.se/bug/view.cgi?id=1156287
  77
  78 21. FTP ASCII transfers do not follow RFC959. They don't convert the data
  79    accordingly (not for sending nor for receiving). RFC 959 section 3.1.1.1
  80    clearly describes how this should be done:
  81
  82      The sender converts the data from an internal character representation to
  83      the standard 8-bit NVT-ASCII representation (see the Telnet
  84      specification).  The receiver will convert the data from the standard
  85      form to his own internal form.
  86
  87    Since 7.15.4 at least line endings are converted.
  88
  89 16. FTP URLs passed to curl may contain NUL (0x00) in the RFC 1738 <user>,
  90   <password>, and <fpath> components, encoded as "%00".  The problem is that
  91   curl_unescape does not detect this, but instead returns a shortened C
  92   string.  From a strict FTP protocol standpoint, NUL is a valid character
  93   within RFC 959 <string>, so the way to handle this correctly in curl would
  94   be to use a data structure other than a plain C string, one that can handle
  95   embedded NUL characters.  From a practical standpoint, most FTP servers
  96   would not meaningfully support NUL characters within RFC 959 <string>,
  97   anyway (e.g., UNIX pathnames may not contain NUL).
  98
  99 14. Test case 165 might fail on system which has libidn present, but with an
 100   old iconv version (2.1.3 is a known bad version), since it doesn't recognize
 101   the charset when named ISO8859-1. Changing the name to ISO-8859-1 makes the
 102   test pass, but instead makes it fail on Solaris hosts that use its native
 103   iconv.
 104
 105 13. curl version 7.12.2 fails on AIX if compiled with --enable-ares.
 106   The workaround is to combine --enable-ares with --disable-shared
 107
 108 12. When connecting to a SOCKS proxy, the (connect) timeout is not properly
 109   acknowledged after the actual TCP connect (during the SOCKS "negotiate"
 110   phase).
 111
 112 11. Using configure --disable-[protocol] may cause 'make test' to fail for
 113   tests using the disabled protocol(s).
 114
 115 10. To get HTTP Negotiate authentication to work fine, you need to provide a
 116   (fake) user name (this concerns both curl and the lib) because the code
 117   wrongly only considers authentication if there's a user name provided.
 118   http://curl.haxx.se/bug/view.cgi?id=1004841. How?
 119   http://curl.haxx.se/mail/lib-2004-08/0182.html
 120
 121 8. Doing resumed upload over HTTP does not work with '-C -', because curl
 122   doesn't do a HEAD first to get the initial size. This needs to be done
 123   manually for HTTP PUT resume to work, and then '-C [index]'.
 124
 125 7. CURLOPT_USERPWD and CURLOPT_PROXYUSERPWD have no way of providing user names
 126   that contain a colon. This can't be fixed easily in a backwards compatible
 127   way without adding new options (and then, they should most probably allow
 128   setting user name and password separately).
 129
 130 6. libcurl ignores empty path parts in FTP URLs, whereas RFC1738 states that
 131   such parts should be sent to the server as 'CWD ' (without an argument).
 132   The only exception to this rule, is that we knowingly break this if the
 133   empty part is first in the path, as then we use the double slashes to
 134   indicate that the user wants to reach the root dir (this exception SHALL
 135   remain even when this bug is fixed).
 136
 137 5. libcurl doesn't treat the content-length of compressed data properly, as
 138   it seems HTTP servers send the *uncompressed* length in that header and
 139   libcurl thinks of it as the *compressed* length. Some explanations are here:
 140   http://curl.haxx.se/mail/lib-2003-06/0146.html
 141
 142 2. If a HTTP server responds to a HEAD request and includes a body (thus
 143   violating the RFC2616), curl won't wait to read the response but just stop
 144   reading and return back. If a second request (let's assume a GET) is then
 145   immediately made to the same server again, the connection will be re-used
 146   fine of course, and the second request will be sent off but when the
 147   response is to get read, the previous response-body is what curl will read
 148   and havoc is what happens.
 149   More details on this is found in this libcurl mailing list thread:
 150   http://curl.haxx.se/mail/lib-2002-08/0000.html