umgeher/cowboy
0
Fork 0
mirror of https://github.com/ninenines/cowboy.git synced 2025-07-14 20:30:23 +00:00
Code Issues Wiki Activity

Document stopping the listener in App:stop/1

Browse source
This commit is contained in:
Loïc Hoguin 2019-10-03 10:09:35 +02:00
parent e4a535cfa6
commit 99df823cc3
No known key found for this signature in database
GPG key ID: 8A9DF795F6FED764
16 changed files with 29 additions and 16 deletions
Download patch file Download diff file Expand all files Collapse all files

15
doc/src/guide/listeners.asciidoc
View file

@ -75,7 +75,7 @@ start(_Type, _Args) ->
Dispatch = cowboy_router:compile([
{'_', [{"/", hello_handler, []}]}
]),
{ok, _} = cowboy:start_tls(my_http_listener,
{ok, _} = cowboy:start_tls(my_https_listener,
[
{port, 8443},
{certfile, "/path/to/certfile"},
@ -101,6 +101,19 @@ Cowboy 2.0 gets released.
Compatibility with HTTP/1.0 is provided by Cowboy's HTTP/1.1
implementation.
=== Stopping the listener
When starting listeners along with the application it is
a good idea to also stop the listener when the application
stops. This can be done by calling `cowboy:stop_listener/1`
in the application's stop function:
[source,erlang]
----
stop(_State) ->
ok = cowboy:stop_listener(my_http_listener).
----
=== Protocol configuration
The HTTP/1.1 and HTTP/2 protocols share the same semantics;