mirror of
https://github.com/moparisthebest/curl
synced 2024-12-23 16:48:49 -05:00
006ff62d8c
Added CURLOPT_HTTP09_ALLOWED and --http0.9 for this purpose. For now, both the tool and library allow HTTP/0.9 by default. docs/DEPRECATE.md lays out the plan for when to reverse that default: 6 months after the 7.64.0 release. The options are added already now so that applications/scripts can start using them already now. Fixes #2873 Closes #3383
82 lines
3.1 KiB
Markdown
82 lines
3.1 KiB
Markdown
# Items to be removed from future curl releases
|
|
|
|
If any of these deprecated features is a cause for concern for you, please
|
|
email the curl-library mailing list as soon as possible and explain to us why
|
|
this is a problem for you and how your use case can't be satisfied properly
|
|
using a work around.
|
|
|
|
## HTTP pipelining
|
|
|
|
HTTP pipelining is badly supported by curl in the sense that we have bugs and
|
|
it is a fragile feature without enough tests. Also, when something turns out
|
|
to have problems it is really tricky to debug due to the timing sensitivity so
|
|
very often enabling debug outputs or similar completely changes the nature of
|
|
the behavior and things are not reproducing anymore!
|
|
|
|
HTTP pipelining was never enabled by default by the large desktop browsers due
|
|
to all the issues with it. Both Firefox and Chrome have also dropped
|
|
pipelining support entirely since a long time back now. We are in fact over
|
|
time becoming more and more lonely in supporting pipelining.
|
|
|
|
The bad state of HTTP pipelining was a primary driving factor behind HTTP/2
|
|
and its multiplexing feature. HTTP/2 multiplexing is truly and really
|
|
"pipelining done right". It is way more solid, practical and solves the use
|
|
case in a better way with better performance and fewer downsides and problems.
|
|
|
|
In 2018, pipelining *should* be abandoned and HTTP/2 should be used instead.
|
|
|
|
### State
|
|
|
|
In 7.62.0, we will add code that ignores the "enable pipeline" option
|
|
setting). The *setopt() function would still return "OK" though so the
|
|
application couldn't tell that this is happening.
|
|
|
|
Users who truly need pipelining from that version will need to modify the code
|
|
(ever so slightly) and rebuild.
|
|
|
|
### Removal
|
|
|
|
Six months later, in sync with the planned release happen in April 2019,
|
|
(might be 7.66.0), assuming no major riots have occurred due to this in the
|
|
mean time, we rip out the pipelining code. It is in the order of 1000 lines of
|
|
libcurl code.
|
|
|
|
Left to answer: should the *setopt() function start to return error when these
|
|
options are set to be able to tell when they're trying to use options that are
|
|
no longer around or should we maintain behavior as much as possible?
|
|
|
|
## `CURLOPT_DNS_USE_GLOBAL_CACHE`
|
|
|
|
This option makes libcurl use a global non-thread-safe cache for DNS if
|
|
enabled. The option has been marked as "obsolete" in the header file and in
|
|
documentation for several years already.
|
|
|
|
There's proper and safe method alternative provided since many years: the
|
|
share API.
|
|
|
|
### State
|
|
|
|
In curl 7.62.0 setting this option to TRUE will not have any effect. The
|
|
global cache will not be enabled. The code still remains so it is easy to
|
|
revert if need be.
|
|
|
|
### Removal
|
|
|
|
Remove all global-cache related code from curl around April 2019 (might be
|
|
7.66.0).
|
|
|
|
## HTTP/0.9
|
|
|
|
Supporting this is non-obvious and might even come as a surprise to some
|
|
users. Potentially even being a security risk in some cases.
|
|
|
|
### State
|
|
|
|
curl 7.64.0 introduces options to disable/enable support for this protocol
|
|
version. The default remains supported for now.
|
|
|
|
### Removal
|
|
|
|
The support for HTTP/0.9 will be switched to disabled by default in 6 months,
|
|
in the September 2019 release (possibly called curl 7.68.0).
|