aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2016-12-22 15:19:38 +0100
committerLoïc Hoguin <[email protected]>2016-12-22 15:19:38 +0100
commite584412de7191da83addcde90c193c6b7b99dc7d (patch)
tree54004ab90aab137174b947d607710a5d2581ba7a /doc
parenta9d9c9d9028462720881557ef3ae802612d85f20 (diff)
downloadcowboy-e584412de7191da83addcde90c193c6b7b99dc7d.tar.gz
cowboy-e584412de7191da83addcde90c193c6b7b99dc7d.tar.bz2
cowboy-e584412de7191da83addcde90c193c6b7b99dc7d.zip
Add the manual for cowboy_http2
Diffstat (limited to 'doc')
-rw-r--r--doc/src/manual/cowboy_http2.asciidoc55
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/src/manual/cowboy_http2.asciidoc b/doc/src/manual/cowboy_http2.asciidoc
new file mode 100644
index 0000000..739374b
--- /dev/null
+++ b/doc/src/manual/cowboy_http2.asciidoc
@@ -0,0 +1,55 @@
+= cowboy_http2(3)
+
+== Name
+
+cowboy_http2 - HTTP/2
+
+== Description
+
+The module `cowboy_http2` implements HTTP/2
+as a Ranch protocol.
+
+== Types
+
+=== opts()
+
+[source,erlang]
+----
+opts() :: #{
+ env := cowboy_middleware:env(),
+ middlewares := [module()],
+ preface_timeout := timeout()
+}
+----
+
+Configuration for the HTTP/2 protocol.
+
+This configuration is passed to Cowboy when starting listeners
+using `cowboy:start_clear/4` or `cowboy:start_tls/4` functions.
+
+It can be updated without restarting listeners using the
+Ranch functions `ranch:get_protocol_options/1` and
+`ranch:set_protocol_options/2`.
+
+=== Option descriptions
+
+The default value is given next to the option name.
+
+env (#{})::
+ Middleware environment.
+
+middlewares ([cowboy_router, cowboy_handler])::
+ Middlewares to run for every request.
+
+preface_timeout (5000)::
+ Time in ms Cowboy is willing to wait for the connection preface.
+
+== Changelog
+
+* *2.0*: Protocol introduced.
+
+== See also
+
+link:man:cowboy(7)[cowboy(7)],
+link:man:cowboy_http(3)[cowboy_http(3)],
+link:man:cowboy_websocket(3)[cowboy_websocket(3)]