aboutsummaryrefslogtreecommitdiffstats
path: root/manual
diff options
context:
space:
mode:
authorLoïc Hoguin <[email protected]>2013-11-14 16:46:31 +0100
committerLoïc Hoguin <[email protected]>2013-11-14 16:46:31 +0100
commit119d52295f5723ca5ade6661a11621a88e021677 (patch)
tree97879593d909a6e1f7839d04a6a25273f0eec83f /manual
parentd87192b0ed4d2d06ee74ed1b7f1fbb665fae2afe (diff)
downloadcowboy-119d52295f5723ca5ade6661a11621a88e021677.tar.gz
cowboy-119d52295f5723ca5ade6661a11621a88e021677.tar.bz2
cowboy-119d52295f5723ca5ade6661a11621a88e021677.zip
Add documentation for cowboy_spdy
Diffstat (limited to 'manual')
-rw-r--r--manual/cowboy.md11
-rw-r--r--manual/cowboy_spdy.md40
2 files changed, 51 insertions, 0 deletions
diff --git a/manual/cowboy.md b/manual/cowboy.md
index ebfe615..c2ef859 100644
--- a/manual/cowboy.md
+++ b/manual/cowboy.md
@@ -65,6 +65,17 @@ Exports
> Start listening for HTTPS connections. Returns the pid for this
> listener's supervisor.
+### start_spdy(Ref, NbAcceptors, TransOpts, ProtoOpts) -> {ok, pid()}
+
+> Types:
+> * Ref = ranch:ref()
+> * NbAcceptors = non_neg_integer()
+> * TransOpts = ranch_ssl:opts()
+> * ProtoOpts = cowboy_spdy:opts()
+>
+> Start listening for SPDY connections. Returns the pid for this
+> listener's supervisor.
+
### stop_listener(Ref) -> ok
> Types:
diff --git a/manual/cowboy_spdy.md b/manual/cowboy_spdy.md
new file mode 100644
index 0000000..527dbb1
--- /dev/null
+++ b/manual/cowboy_spdy.md
@@ -0,0 +1,40 @@
+cowboy_spdy
+===========
+
+The `cowboy_spdy` module implements SPDY/3 as a Ranch protocol.
+
+Types
+-----
+
+### opts() = [{env, cowboy_middleware:env()}
+ | {middlewares, [module()]}
+ | {onrequest, cowboy:onrequest_fun()}
+ | {onresponse, cowboy:onresponse_fun()}]
+
+> Configuration for the SPDY protocol handler.
+>
+> This configuration is passed to Cowboy when starting listeners
+> using the `cowboy:start_spdy/4` function.
+>
+> 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 ([{listener, Ref}])
+ - Initial middleware environment.
+ - middlewares ([cowboy_router, cowboy_handler])
+ - List of middlewares to execute for every requests.
+ - onrequest (undefined)
+ - Fun called every time a request is received.
+ - onresponse (undefined)
+ - Fun called every time a response is sent.
+
+Exports
+-------
+
+None.