diff options
author | Loïc Hoguin <[email protected]> | 2021-05-12 11:13:47 +0200 |
---|---|---|
committer | Loïc Hoguin <[email protected]> | 2021-05-12 11:13:47 +0200 |
commit | 48f39402181d959cad88cb3f460210c007169f50 (patch) | |
tree | ee45d02b0683fd88f725fb43c75bdf171cb51568 /docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc | |
parent | 338611332e05e2a35a70f11edd36b050843bcee8 (diff) | |
download | ninenines.eu-48f39402181d959cad88cb3f460210c007169f50.tar.gz ninenines.eu-48f39402181d959cad88cb3f460210c007169f50.tar.bz2 ninenines.eu-48f39402181d959cad88cb3f460210c007169f50.zip |
Cowboy 2.9.0
Diffstat (limited to 'docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc')
-rw-r--r-- | docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc b/docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc new file mode 100644 index 00000000..d7430901 --- /dev/null +++ b/docs/en/ranch/1.8/guide/upcoming_2.0_changes.asciidoc @@ -0,0 +1,34 @@ +[appendix] +== Upcoming changes in Ranch 2.0 + +The following changes will be done in Ranch 2.0. In most +cases an alternative is already available in the most +recent Ranch version. + +* The function `ranch:start_listener/6` has been deprecated + in favor of `ranch:start_listener/5`. The number of acceptors + was removed and will be taken from the transport options. + +* The function `ranch:child_spec/6` has also been deprecated, + in favor of `ranch:child_spec/5`. + +* The function `ranch:accept_ack/1` has been deprecated in + favor of `ranch:handshake/1,2`. + +* The function `ranch:info/1,2` will return a map containing + each listener's information rather than a list of key/values. + The `num_acceptors` key will be removed. + +* The socket will no longer be passed to the protocol when + starting it. It will be available as a return value from + `ranch:handshake/1,2` only. + +* Starting from Ranch 2.0 it will no longer be allowed to + pass Ranch options along with socket options as a proplist. + The only forms allowed will be the `ranch:opts()` map or socket + options as-is. The `ranch:opts()` map must be used in case socket + options also use a map. + +* The `socket` option will be removed. A more viable solution + is to define a custom transport module that returns a fresh + socket when `Transport:listen/1` is called. |