curl/lib
David Woodhouse 9ad282b1ae Remove all traces of FBOpenSSL SPNEGO support
This is just fundamentally broken. SPNEGO (RFC4178) is a protocol which
allows client and server to negotiate the underlying mechanism which will
actually be used to authenticate. This is *often* Kerberos, and can also
be NTLM and other things. And to complicate matters, there are various
different OIDs which can be used to specify the Kerberos mechanism too.

A SPNEGO exchange will identify *which* GSSAPI mechanism is being used,
and will exchange GSSAPI tokens which are appropriate for that mechanism.

But this SPNEGO implementation just strips the incoming SPNEGO packet
and extracts the token, if any. And completely discards the information
about *which* mechanism is being used. Then we *assume* it was Kerberos,
and feed the token into gss_init_sec_context() with the default
mechanism (GSS_S_NO_OID for the mech_type argument).

Furthermore... broken as this code is, it was never even *used* for input
tokens anyway, because higher layers of curl would just bail out if the
server actually said anything *back* to us in the negotiation. We assume
that we send a single token to the server, and it accepts it. If the server
wants to continue the exchange (as is required for NTLM and for SPNEGO
to do anything useful), then curl was broken anyway.

So the only bit which actually did anything was the bit in
Curl_output_negotiate(), which always generates an *initial* SPNEGO
token saying "Hey, I support only the Kerberos mechanism and this is its
token".

You could have done that by manually just prefixing the Kerberos token
with the appropriate bytes, if you weren't going to do any proper SPNEGO
handling. There's no need for the FBOpenSSL library at all.

The sane way to do SPNEGO is just to *ask* the GSSAPI library to do
SPNEGO. That's what the 'mech_type' argument to gss_init_sec_context()
is for. And then it should all Just Work™.

That 'sane way' will be added in a subsequent patch, as will bug fixes
for our failure to handle any exchange other than a single outbound
token to the server which results in immediate success.
2014-07-16 17:26:08 +02:00
..
vtls gnutls: fix compiler warning 2014-07-15 21:28:10 +02:00
.gitignore
amigaos.c
amigaos.h
arpa_telnet.h
asyn-ares.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
asyn-thread.c bits.close: Fixed compilation warning 2014-05-22 00:29:21 +01:00
asyn.h
base64.c
bundles.c
bundles.h
checksrc.pl
CMakeLists.txt
config-amigaos.h
config-dos.h Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
config-mac.h
config-os400.h
config-riscos.h
config-symbian.h Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
config-tpf.h Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
config-vxworks.h Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
config-win32.h config-win32.h: Updated for VC12 2014-06-05 22:44:46 +01:00
config-win32ce.h
conncache.c conncache: move the connection counter to the cache struct 2014-06-13 15:05:24 +02:00
conncache.h conncache: move the connection counter to the cache struct 2014-06-13 15:05:24 +02:00
connect.c compiler warnings: potentially uninitialized variables 2014-07-05 01:42:10 +02:00
connect.h bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
content_encoding.c
content_encoding.h
cookie.c
cookie.h
curl_addrinfo.c
curl_addrinfo.h
curl_base64.h
curl_config.h.cmake Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
curl_fnmatch.c
curl_fnmatch.h
curl_gethostname.c
curl_gethostname.h
curl_gssapi.c
curl_gssapi.h
curl_hmac.h
curl_ldap.h
curl_md4.h
curl_md5.h
curl_memory.h
curl_memrchr.c
curl_memrchr.h
curl_multibyte.c
curl_multibyte.h
curl_ntlm_core.c NTLM: set a fake entropy for debug builds with CURL_ENTROPY set 2014-06-11 23:15:48 +02:00
curl_ntlm_core.h
curl_ntlm_msgs.c NTLM: set a fake entropy for debug builds with CURL_ENTROPY set 2014-06-11 23:15:48 +02:00
curl_ntlm_msgs.h ntlm: Moved the identity generation into shared SSPI code 2014-04-06 00:35:22 +01:00
curl_ntlm_wb.c ntlm_wb: Avoid invoking ntlm_auth helper with empty username 2014-07-16 17:26:08 +02:00
curl_ntlm_wb.h
curl_ntlm.c
curl_ntlm.h
curl_rtmp.c INFILESIZE: fields in UserDefined must not be changed run-time 2014-04-26 18:17:10 +02:00
curl_rtmp.h
curl_sasl_sspi.c curl_sasl_sspi: Fixed corrupt hostname in DIGEST-MD5 SPN generation 2014-06-01 10:35:52 +01:00
curl_sasl.c sasl: Added back qop argument mistakenly removed in e95ca7ce 2014-06-15 14:11:35 +02:00
curl_sasl.h sasl: Added forward declaration of structures following recent changes 2014-04-06 17:20:08 +01:00
curl_sec.h
curl_setup_once.h
curl_setup.h build: set _POSIX_PTHREAD_SEMANTICS on Solaris to get proper getpwuid_r 2014-07-14 20:11:08 +02:00
curl_sspi.c ntlm: Moved the identity generation into shared SSPI code 2014-04-06 00:35:22 +01:00
curl_sspi.h ntlm: Moved the identity generation into shared SSPI code 2014-04-06 00:35:22 +01:00
curl_threads.c
curl_threads.h
curlx.h
dict.c
dict.h
dotdot.c copyright: Updated following recent edits 2014-04-28 23:20:52 +01:00
dotdot.h copyright: Updated following recent edits 2014-04-28 23:20:52 +01:00
easy.c compiler warnings: potentially uninitialized variables 2014-07-05 01:42:10 +02:00
easyif.h
escape.c
escape.h
file.c INFILESIZE: fields in UserDefined must not be changed run-time 2014-04-26 18:17:10 +02:00
file.h
fileinfo.c
fileinfo.h
firefox-db2pem.sh
formdata.c
formdata.h
ftp.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
ftp.h
ftplistparser.c
ftplistparser.h
getenv.c
getinfo.c getinfo: HTTP CONNECT code not reset between transfers 2014-06-10 22:44:51 +02:00
getinfo.h
gopher.c
gopher.h
hash.c
hash.h
hmac.c
hostasyn.c
hostcheck.c hostcheck: added a system include to define struct in_addr 2014-03-26 22:29:00 +01:00
hostcheck.h
hostip4.c
hostip6.c
hostip.c
hostip.h
hostsyn.c
http2.c http2: better return code error checking 2014-06-14 00:11:01 +02:00
http2.h https: Fix build when http2 is disabled 2014-06-15 12:24:47 +02:00
http_chunks.c chunked-encoding: provide a readable error string for chunked errors 2014-03-14 15:44:18 +01:00
http_chunks.h chunked-encoding: provide a readable error string for chunked errors 2014-03-14 15:44:18 +01:00
http_digest.c random: use Curl_rand() for proper random data 2014-06-03 18:25:48 +02:00
http_digest.h
http_negotiate_sspi.c http_negotiate_sspi: Fixed compilation when USE_HTTP_NEGOTIATE not defined 2014-04-06 01:46:53 +01:00
http_negotiate.c Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
http_negotiate.h
http_proxy.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
http_proxy.h remote_port: allow connect to port 0 2014-03-05 17:38:05 +00:00
http.c https: Fix build when http2 is disabled 2014-06-15 12:24:47 +02:00
http.h CURLOPT_PROXYHEADER: set headers for proxy-only 2014-04-04 17:03:43 +02:00
idn_win32.c
if2ip.c
if2ip.h
imap.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
imap.h imap: Extended FETCH support to include PARTIAL URL specifier 2014-04-18 20:14:09 +01:00
inet_ntop.c
inet_ntop.h
inet_pton.c
inet_pton.h
krb5.c
ldap.c bits.close: Fixed compilation warning 2014-05-22 00:29:21 +01:00
libcurl.def
libcurl.plist
libcurl.rc
libcurl.vers.in
llist.c
llist.h
Makefile.am
makefile.amiga
Makefile.b32 Makefile.b32: Fixed for vtls changes 2014-05-09 21:09:51 +01:00
makefile.dj
Makefile.inc build: Slight rename of new LIB_* makefile file variables 2014-05-18 22:16:54 +01:00
Makefile.m32 Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
Makefile.netware Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
Makefile.vc6 Makefile.vc6: Added curl_sasl_sspi.c 2014-04-06 00:57:23 +01:00
Makefile.vxworks
Makefile.Watcom Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
md4.c
md5.c md5.c: fix use of uninitialized variable 2014-04-18 22:59:25 +02:00
memdebug.c
memdebug.h
mk-ca-bundle.pl mk-ca-bundle: added -p 2014-05-08 11:37:45 +02:00
mk-ca-bundle.vbs
mprintf.c mprintf: allow %.s with data not being zero terminated 2014-05-04 23:39:52 +02:00
multi.c progress callback: skip last callback update on errors 2014-07-02 23:53:25 +02:00
multihandle.h
multiif.h
netrc.c netrc: fixed thread safety problem by using getpwuid_r if available 2014-07-13 00:27:22 +02:00
netrc.h
non-ascii.c
non-ascii.h
nonblock.c
nonblock.h
nwlib.c
nwos.c
objnames-test08.sh
objnames-test10.sh
objnames.inc
openldap.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
parsedate.c parsedate.c: check sscanf result before passing it to strlen 2014-04-19 15:47:07 +02:00
parsedate.h
pingpong.c
pingpong.h
pipeline.c
pipeline.h
pop3.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
pop3.h
progress.c timers: fix timer regression involving redirects / reconnects 2014-05-15 21:28:19 +02:00
progress.h timers: fix timer regression involving redirects / reconnects 2014-05-15 21:28:19 +02:00
rawstr.c
rawstr.h
README.ares
README.curl_off_t
README.curlx
README.encoding
README.hostip lib: documentation updates in README.hostip 2014-06-21 19:49:48 +02:00
README.http2 README.http2: mention some alt-svc thoughts 2014-04-17 19:23:39 +02:00
README.httpauth
README.memoryleak
README.multi_socket
README.pingpong
README.pipelining
rtsp.c INFILESIZE: fields in UserDefined must not be changed run-time 2014-04-26 18:17:10 +02:00
rtsp.h
security.c
select.c select: with winsock, avoid passing unsupported arguments to select() 2014-05-27 23:58:28 +02:00
select.h
sendf.c handler: make 'protocol' always specified as a single bit 2014-04-23 22:36:01 +02:00
sendf.h
setup-os400.h
setup-vms.h
share.c
share.h
sigpipe.h
slist.c
slist.h
smtp.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
smtp.h smtp: Fixed login denied when server doesn't support AUTH capability 2014-03-28 18:21:27 +00:00
sockaddr.h
socks_gssapi.c
socks_sspi.c socks_sspi.c: added pointer guards to FreeContextBuffer calls 2014-04-18 23:24:41 +02:00
socks.c
socks.h
speedcheck.c
speedcheck.h
splay.c copyright: Updated following recent edits 2014-04-28 23:20:52 +01:00
splay.h
ssh.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
ssh.h
strdup.c
strdup.h
strequal.c
strequal.h
strerror.c strerror: fix comment about vxworks' strerror_r buffer size 2014-04-06 23:13:08 +02:00
strerror.h
strtok.c
strtok.h
strtoofft.c
strtoofft.h
telnet.c telnet.c: check sscanf results before passing them to snprintf 2014-04-19 15:23:04 +02:00
telnet.h
tftp.c bits.close: introduce connection close tracking 2014-05-22 00:34:10 +02:00
tftp.h
timeval.c
timeval.h
transfer.c transfer: fix info messages when switching method on 301 and 302 2014-06-09 08:29:37 +02:00
transfer.h
url.c cookie: avoid mutex deadlock 2014-07-15 23:50:56 +02:00
url.h
urldata.h nss: make the list of CRL items global 2014-07-04 13:15:03 +02:00
version.c Remove all traces of FBOpenSSL SPNEGO support 2014-07-16 17:26:08 +02:00
warnless.c tool_getparam.c: Fixed compilation warnings 2014-05-22 21:01:51 +01:00
warnless.h tool_getparam.c: Fixed compilation warnings 2014-05-22 21:01:51 +01:00
wildcard.c
wildcard.h
x509asn1.c
x509asn1.h

HTTP Pipelining with libcurl
============================

Background

Since pipelining implies that one or more requests are sent to a server before
the previous response(s) have been received, we only support it for multi
interface use.

Considerations

When using the multi interface, you create one easy handle for each transfer.
Bascially any number of handles can be created, added and used with the multi
interface - simultaneously. It is an interface designed to allow many
simultaneous transfers while still using a single thread. Pipelining does not
change any of these details.

API

We've added a new option to curl_multi_setopt() called CURLMOPT_PIPELINING
that enables "attempted pipelining" and then all easy handles used on that
handle will attempt to use an existing pipeline.

Details

- A pipeline is only created if a previous connection exists to the same IP
  address that the new request is being made to use.

- Pipelines are only supported for HTTP(S) as no other currently supported
  protocol has features resemembling this, but we still name this feature
  plain 'pipelining' to possibly one day support it for other protocols as
  well.

- HTTP Pipelining is for GET and HEAD requests only.

- When a pipeline is in use, we must take precautions so that when used easy
  handles (i.e those who still wait for a response) are removed from the multi
  handle, we must deal with the outstanding response nicely.

- Explicitly asking for pipelining handle X and handle Y won't be supported.
  It isn't easy for an app to do this association. The lib should probably
  still resolve the second one properly to make sure that they actually _can_
  be considered for pipelining. Also, asking for explicit pipelining on handle
  X may be tricky when handle X get a closed connection.