All handler types provide the optional terminate/3
callback.
-
@@ -208,6 +208,8 @@ process will terminate soon after this call returns.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/index.html b/docs/en/cowboy/2.0/guide/index.html
index c10c7d5f..8226f7cd 100644
--- a/docs/en/cowboy/2.0/guide/index.html
+++ b/docs/en/cowboy/2.0/guide/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Cowboy User Guide
@@ -294,6 +294,8 @@
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/introduction/index.html b/docs/en/cowboy/2.0/guide/introduction/index.html
index a6b83502..e170569f 100644
--- a/docs/en/cowboy/2.0/guide/introduction/index.html
+++ b/docs/en/cowboy/2.0/guide/introduction/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Introduction
@@ -196,6 +196,8 @@ when sending responses.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/listeners/index.html b/docs/en/cowboy/2.0/guide/listeners/index.html
index 2a79dd4c..071dbe6d 100644
--- a/docs/en/cowboy/2.0/guide/listeners/index.html
+++ b/docs/en/cowboy/2.0/guide/listeners/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Listeners
@@ -88,7 +88,7 @@ however so a common alternative is port 8080.
-
@@ -128,7 +128,7 @@ may be disabled. This also applies to HTTP/1.1 connections
on this listener. If this is not desirable, Ranch can be
used directly to setup a custom listener.
-
@@ -226,6 +226,8 @@ shared.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/loop_handlers/index.html b/docs/en/cowboy/2.0/guide/loop_handlers/index.html
index eb0a0caf..fcf0450d 100644
--- a/docs/en/cowboy/2.0/guide/loop_handlers/index.html
+++ b/docs/en/cowboy/2.0/guide/loop_handlers/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Loop handlers
@@ -95,7 +95,7 @@ a timeout value and/or the atom
hibernate
to make the
process enter hibernation until a message is received.
This snippet enables the loop handler:
-
@@ -103,7 +103,7 @@ http://www.gnu.org/software/src-highlite -->
{cowboy_loop, Req, State}.
This also makes the process hibernate:
-
@@ -122,7 +122,7 @@ and the handler’s state.
reply
message from another process, or waits for another
message otherwise.
-
@@ -155,7 +155,7 @@ every time a message is received.
a chunk is sent every time an
event
message is received,
and the loop is stopped by sending an
eof
message.
-
@@ -248,6 +248,8 @@ accordingly.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/middlewares/index.html b/docs/en/cowboy/2.0/guide/middlewares/index.html
index f764a1cb..b3312263 100644
--- a/docs/en/cowboy/2.0/guide/middlewares/index.html
+++ b/docs/en/cowboy/2.0/guide/middlewares/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Middlewares
@@ -209,6 +209,8 @@ values. It puts the result of the request handling into
result
.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/migrating_from_1.0/index.html b/docs/en/cowboy/2.0/guide/migrating_from_1.0/index.html
index 75e3ffd1..d85a06e7 100644
--- a/docs/en/cowboy/2.0/guide/migrating_from_1.0/index.html
+++ b/docs/en/cowboy/2.0/guide/migrating_from_1.0/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Migrating from Cowboy 1.0 to 2.0
@@ -495,6 +495,8 @@ The static file handler has been improved to handle more special
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/modern_web/index.html b/docs/en/cowboy/2.0/guide/modern_web/index.html
index 9b30ce92..3b51efe1 100644
--- a/docs/en/cowboy/2.0/guide/modern_web/index.html
+++ b/docs/en/cowboy/2.0/guide/modern_web/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: The modern Web
@@ -228,6 +228,8 @@ the HTTP protocol.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/multipart/index.html b/docs/en/cowboy/2.0/guide/multipart/index.html
index 74ce4800..a290b34f 100644
--- a/docs/en/cowboy/2.0/guide/multipart/index.html
+++ b/docs/en/cowboy/2.0/guide/multipart/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Multipart requests
@@ -108,7 +108,7 @@ Proper investigation of the contents is recommended.
-
@@ -129,7 +129,7 @@ need to call the function multiple times.
To read a multipart message you need to iterate over
all its parts:
-
@@ -153,7 +153,7 @@ is a normal field or a file being uploaded.
use different strategies depending on whether the
part is a file:
-
@@ -186,14 +186,14 @@ up to 64KB for up to 5 seconds. cowboy_req:read_part_body/1
has the same defaults as cowboy_req:read_body/1
.
To change the defaults for part headers:
-
cowboy_req:read_part(Req, #{length => 128000}).
-
@@ -208,7 +208,7 @@ skip it when you request the next part’s body.
The following snippet reads all part headers and skips
all bodies:
-
@@ -286,6 +286,8 @@ reading as soon as you find the data you need.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/req/index.html b/docs/en/cowboy/2.0/guide/req/index.html
index 1b81cdfc..d6f7a2fd 100644
--- a/docs/en/cowboy/2.0/guide/req/index.html
+++ b/docs/en/cowboy/2.0/guide/req/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: The Req object
@@ -91,7 +91,7 @@ head. The following example sends a simple "Hello world!"
response when the
method
is GET, and a 405 error
otherwise.
-
@@ -146,14 +146,14 @@ where the crash occurred.
The request method can be retrieved directly:
-
#{method := Method} = Req.
-
@@ -175,14 +175,14 @@ want to redirect HTTP/1.1 clients to use Websocket, while HTTP/2
clients keep using HTTP/2.
The HTTP version can be retrieved directly:
-
#{version := Version} = Req.
-
@@ -198,7 +198,7 @@ atoms.
The scheme, host, port, path and query string components
of the effective request URI can all be retrieved directly:
-
@@ -211,7 +211,7 @@ http://www.gnu.org/software/src-highlite -->
} = Req.
Or using the related functions:
-
@@ -230,7 +230,7 @@ for requests on secure HTTP/1.1 or HTTP/2 connections.
the
cowboy_req:uri/1,2
function. By default, an absolute
URI is returned:
-
@@ -240,7 +240,7 @@ http://www.gnu.org/software/src-highlite -->
or all of the components. Various URIs or URI formats can
be generated this way, including the origin form:
-
@@ -248,7 +248,7 @@ http://www.gnu.org/software/src-highlite -->
URI = cowboy_req:uri(Req, #{host => undefined}).
The protocol relative form:
-
@@ -256,14 +256,14 @@ http://www.gnu.org/software/src-highlite -->
URI = cowboy_req:uri(Req, #{scheme => undefined}).
The absolute URI without a query string:
-
URI = cowboy_req:uri(Req, #{qs => undefined}).
-
@@ -280,7 +280,7 @@ They are only available after the routing.
Cowboy provides functions to retrieve one or all bindings.
To retrieve a single value:
-
@@ -289,14 +289,14 @@ http://www.gnu.org/software/src-highlite -->
undefined
will be returned. A different default value
can be provided:
-
Value = cowboy_req:binding(userid, Req, 42).
To retrieve everything that was bound:
-
@@ -306,14 +306,14 @@ http://www.gnu.org/software/src-highlite -->
or path segments at once using the ...
qualifier.
To retrieve the segments captured from the host name:
-
HostInfo = cowboy_req:host_info(Req).
-
@@ -328,7 +328,7 @@ in the route.
Cowboy provides two functions to access query parameters.
You can use the first to get the entire list of parameters.
-
@@ -351,7 +351,7 @@ only the parameters you are interested in, and at the same
time do any post processing you require using
constraints.
This function returns a map.
-
@@ -361,7 +361,7 @@ snippet will crash when the id
parameter is not an integer,
or when the lang
parameter is empty. At the same time, the
value for id
will be converted to an integer term:
-
@@ -370,7 +370,7 @@ http://www.gnu.org/software/src-highlite -->
if the lang
key is not found. It will not be used if
the key is found but has an empty value.
-
@@ -390,7 +390,7 @@ ensure that only one value was passed through.
or parsed into a more meaningful representation.
-
@@ -401,21 +401,21 @@ regardless of the underlying protocol.
When the header is missing from the request, undefined
will be returned. A different default can be provided:
-
HeaderVal = cowboy_req:header(<<"content-type">>, Req, <<"text/plain">>).
All headers can be retrieved at once, either directly:
-
#{headers := AllHeaders} = Req.
-
@@ -424,7 +424,7 @@ http://www.gnu.org/software/src-highlite -->
headers. There is no function to parse all headers at once.
To parse a specific header:
-
@@ -436,7 +436,7 @@ and default values can be found in the manual.
change the default value. Note that it should be the parsed value
directly:
-
@@ -451,14 +451,14 @@ http://www.gnu.org/software/src-highlite -->
retrieved either directly or using a function.
To retrieve the peer directly:
-
#{peer := {IP, Port}} = Req.
-
@@ -524,6 +524,8 @@ client itself. It may also be a proxy or a gateway.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/req_body/index.html b/docs/en/cowboy/2.0/guide/req_body/index.html
index f9e056c9..38056650 100644
--- a/docs/en/cowboy/2.0/guide/req_body/index.html
+++ b/docs/en/cowboy/2.0/guide/req_body/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Reading the request body
@@ -85,7 +85,7 @@ The latter is covered in its own chapter.
Not all requests come with a body. You can check for
the presence of a request body with this function:
-
@@ -102,7 +102,7 @@ just attempt to read it directly.
You can obtain the length of the body:
-
@@ -122,7 +122,7 @@ after reading the body completely.
You can read the entire body with one function call:
-
@@ -136,7 +136,7 @@ the end of the 15 seconds period.
These values can be customized. For example, to read
only up to 1MB for up to 5 seconds:
-
@@ -144,7 +144,7 @@ http://www.gnu.org/software/src-highlite -->
#{length => 1000000, period => 5000}).
You may also disable the length limit:
-
@@ -164,7 +164,7 @@ a more
tuple instead of ok
. You can call the
function again to read more of the body, reading
it one chunk at a time.
-
@@ -187,7 +187,7 @@ They need to be passed for every call.
Cowboy provides a convenient function for reading and
parsing bodies sent as application/x-www-form-urlencoded.
-
@@ -197,7 +197,7 @@ the function cowboy_req:parse_qs/1
.
The defaults for this function are different. Cowboy will
read for up to 64KB and up to 5 seconds. They can be modified:
-
@@ -261,6 +261,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/resource_design/index.html b/docs/en/cowboy/2.0/guide/resource_design/index.html
index 11e06315..efcfed82 100644
--- a/docs/en/cowboy/2.0/guide/resource_design/index.html
+++ b/docs/en/cowboy/2.0/guide/resource_design/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Designing a resource handler
@@ -330,6 +330,8 @@ no way of knowing it has been completed yet, implement the
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/resp/index.html b/docs/en/cowboy/2.0/guide/resp/index.html
index e555fe38..53db6025 100644
--- a/docs/en/cowboy/2.0/guide/resp/index.html
+++ b/docs/en/cowboy/2.0/guide/resp/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Sending a response
@@ -90,7 +90,7 @@ cases, Cowboy will add any headers required by the protocol
When you need to set only the status code,
use cowboy_req:reply/2
:
-
@@ -98,7 +98,7 @@ http://www.gnu.org/software/src-highlite -->
When you need to set response headers at the same time,
use cowboy_req:reply/3
:
-
@@ -110,7 +110,7 @@ binary.
When you also need to set the response body,
use cowboy_req:reply/4
:
-
@@ -126,7 +126,7 @@ binaries, characters, strings or other iolists. This
allows you to build a response from different parts
without having to do any concatenation:
-
@@ -151,7 +151,7 @@ Cowboy will add any required headers to the response.
When you need to set only the status code,
use cowboy_req:stream_reply/2
:
-
@@ -168,7 +168,7 @@ not recommended. All responses with a body should have
a content-type. The header can be set beforehand, or
using the cowboy_req:stream_reply/3
:
-
@@ -197,7 +197,7 @@ and sent as part of the response when a reply function is
called.
-
@@ -207,7 +207,7 @@ http://www.gnu.org/software/src-highlite -->
the
Cookies chapter for more information.
To check if a response header has already been set:
-
@@ -215,7 +215,7 @@ http://www.gnu.org/software/src-highlite -->
It returns true
if the header was set, false
otherwise.
To delete a response header that was set previously:
-
@@ -269,7 +269,7 @@ headers.
default sends the server header with the value "Cowboy".
We can override it:
-
@@ -286,14 +286,14 @@ immediately sending it. It is stored in the Req object and
sent when the reply function is called.
To set the response body:
-
Req = cowboy_req:set_resp_body("Hello world!", Req0).
To check if a response body has already been set:
-
@@ -312,7 +312,7 @@ using cowboy_req:reply/4
, or when presetting the
response header, you can give a sendfile
tuple to
Cowboy:
-
@@ -323,7 +323,7 @@ entire file may be sent, or just a part of it.
Cowboy sends it in the content-length header.
To send a file while replying:
-
@@ -352,7 +352,7 @@ string, set to empty) and the method is GET by default.
The following snippet pushes a CSS file that is linked to
in the response:
-
@@ -368,7 +368,7 @@ http://www.gnu.org/software/src-highlite -->
simply pass in a fourth argument. The following snippet
uses a different host name:
-
@@ -439,6 +439,8 @@ ultimately send a response to the client.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/rest_flowcharts/index.html b/docs/en/cowboy/2.0/guide/rest_flowcharts/index.html
index 8d398a24..43a7f706 100644
--- a/docs/en/cowboy/2.0/guide/rest_flowcharts/index.html
+++ b/docs/en/cowboy/2.0/guide/rest_flowcharts/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: REST flowcharts
@@ -361,6 +361,8 @@ the results for subsequent use.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/rest_handlers/index.html b/docs/en/cowboy/2.0/guide/rest_handlers/index.html
index a39b88ed..7dc0f9fa 100644
--- a/docs/en/cowboy/2.0/guide/rest_handlers/index.html
+++ b/docs/en/cowboy/2.0/guide/rest_handlers/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: REST handlers
@@ -78,7 +78,7 @@ describing the resource and modifying the machine’s behavior.
to all handlers. To use REST for the current request, this function
must return a
cowboy_rest
tuple.
-
@@ -400,6 +400,8 @@ cellspacing="0" cellpadding="4">
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/rest_principles/index.html b/docs/en/cowboy/2.0/guide/rest_principles/index.html
index 6bb1a90c..1a37f5c8 100644
--- a/docs/en/cowboy/2.0/guide/rest_principles/index.html
+++ b/docs/en/cowboy/2.0/guide/rest_principles/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: REST principles
@@ -270,6 +270,8 @@ anything specific to the service to operate on it.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/routing/index.html b/docs/en/cowboy/2.0/guide/routing/index.html
index 715b4111..70e53566 100644
--- a/docs/en/cowboy/2.0/guide/routing/index.html
+++ b/docs/en/cowboy/2.0/guide/routing/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Routing
@@ -80,7 +80,7 @@ The result of the compilation is the dispatch rules.
The general structure for the routes is defined as follow.
-
@@ -88,7 +88,7 @@ http://www.gnu.org/software/src-highlite -->
Each host contains matching rules for the host along with optional
constraints, and a list of routes for the path component.
-
@@ -97,7 +97,7 @@ http://www.gnu.org/software/src-highlite -->
The list of routes for the path component is defined similar to the
list of hosts.
-
@@ -106,7 +106,7 @@ http://www.gnu.org/software/src-highlite -->
optional constraints, and gives us the handler module to be used
along with its initial state.
-
@@ -130,7 +130,7 @@ when encountered.
the simplest match value is a host or a path. It can be given as either
a
string()
or a
binary()
.
-
@@ -142,7 +142,7 @@ http://www.gnu.org/software/src-highlite -->
character. Note that these two paths are identical as far as routing
is concerned.
-
@@ -151,7 +151,7 @@ http://www.gnu.org/software/src-highlite -->
Hosts with and without a trailing dot are equivalent for routing.
Similarly, hosts with and without a leading dot are also equivalent.
-
@@ -165,7 +165,7 @@ values bindings.
the
:
character means that what follows until the end of the segment
is the name of the binding in which the segment value will be stored.
-
@@ -184,7 +184,7 @@ variable in Erlang. Any match against the _
binding will succeed
but the data will be discarded. This is especially useful for
matching against many domain names in one go.
-
@@ -192,7 +192,7 @@ http://www.gnu.org/software/src-highlite -->
Similarly, it is possible to have optional segments. Anything
between brackets is optional.
-
@@ -200,7 +200,7 @@ http://www.gnu.org/software/src-highlite -->
HostMatch = "[www.]ninenines.eu".
You can also have imbricated optional segments.
-
@@ -213,7 +213,7 @@ zero, one or many segments. You can then find the segments using
cowboy_req:host_info/1
and cowboy_req:path_info/1
respectively.
They will be represented as a list of segments.
-
@@ -223,7 +223,7 @@ http://www.gnu.org/software/src-highlite -->
will succeed only if they share the same value. This copies the
Erlang pattern matching behavior.
-
@@ -232,7 +232,7 @@ http://www.gnu.org/software/src-highlite -->
case the two values must be identical only if the segment is
available.
-
@@ -240,7 +240,7 @@ http://www.gnu.org/software/src-highlite -->
If a binding is defined in both the host and path, then they must
also share the same value.
-
@@ -249,7 +249,7 @@ http://www.gnu.org/software/src-highlite -->
Finally, there are two special match values that can be used. The
first is the atom '_'
which will match any host or path.
-
@@ -258,7 +258,7 @@ http://www.gnu.org/software/src-highlite -->
The second is the special host match "*"
which will match the
wildcard path, generally used alongside the OPTIONS
method.
-
@@ -291,7 +291,7 @@ Faster compilation strategies could be to compile the routes directly
to Erlang code, but would require heavier dependencies.
To compile routes, just call the appropriate function:
-
@@ -313,7 +313,7 @@ http://www.gnu.org/software/src-highlite -->
list used by routing. This will apply to all new connections accepted
by the listener:
-
@@ -378,6 +378,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/specs/index.html b/docs/en/cowboy/2.0/guide/specs/index.html
index 658a452c..ac5e8483 100644
--- a/docs/en/cowboy/2.0/guide/specs/index.html
+++ b/docs/en/cowboy/2.0/guide/specs/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: HTTP and other specifications
@@ -952,6 +952,8 @@ for or related to HTTP.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/static_files/index.html b/docs/en/cowboy/2.0/guide/static_files/index.html
index a60d9564..03456b77 100644
--- a/docs/en/cowboy/2.0/guide/static_files/index.html
+++ b/docs/en/cowboy/2.0/guide/static_files/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Static files
@@ -88,7 +88,7 @@ to the given application’s private directory.
from the application
my_app
's priv directory whenever the
path
/
is accessed:
-
@@ -96,7 +96,7 @@ http://www.gnu.org/software/src-highlite -->
You can also specify the absolute path to a file, or the
path to the file relative to the current directory:
-
@@ -118,7 +118,7 @@ private directory.
my_app
's priv directory inside the
static/assets
folder
whenever the requested path begins with
/assets/
:
-
@@ -126,7 +126,7 @@ http://www.gnu.org/software/src-highlite -->
You can also specify the absolute path to the directory or
set it relative to the current directory:
-
@@ -152,7 +152,7 @@ you may have. You can of course create your own function.
anything, as it is the default. If you insist, though, the
following will do the job:
-
@@ -164,7 +164,7 @@ types have this optional field.
To use the function that will detect almost any mimetype,
the following configuration will do:
-
@@ -174,7 +174,7 @@ http://www.gnu.org/software/src-highlite -->
expects a module and a function name, so you can use any
of your own functions instead:
-
@@ -194,7 +194,7 @@ directly to disk.
This is especially useful in combination with the
file
and
priv_file
options as it avoids needless computation:
-
@@ -213,7 +213,7 @@ file metadata will vary from server to server, giving a
different etag on each server.
You can however change the way the etag is calculated:
-
@@ -226,7 +226,7 @@ file path to retrieve an etag value that is identical across
all your servers.
You can also completely disable etag handling:
-
@@ -290,6 +290,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/streams/index.html b/docs/en/cowboy/2.0/guide/streams/index.html
index 393328b5..7abf3a07 100644
--- a/docs/en/cowboy/2.0/guide/streams/index.html
+++ b/docs/en/cowboy/2.0/guide/streams/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Streams
@@ -178,6 +178,8 @@ that will modify responses.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/ws_handlers/index.html b/docs/en/cowboy/2.0/guide/ws_handlers/index.html
index 4a450e1d..882f9e24 100644
--- a/docs/en/cowboy/2.0/guide/ws_handlers/index.html
+++ b/docs/en/cowboy/2.0/guide/ws_handlers/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: Websocket handlers
@@ -83,7 +83,7 @@ close the connection.
To establish a Websocket connection, you must switch to the
cowboy_websocket
module:
-
@@ -118,7 +118,7 @@ Websocket, and provide the header:
This selection must be done in init/2
. An example usage could
be:
-
@@ -154,7 +154,7 @@ from the connection process.
or be tied to the current pid, will not work as intended.
The optional
websocket_init/1
can be used instead:
-
@@ -165,7 +165,7 @@ http://www.gnu.org/software/src-highlite -->
means that we can send frames to the client right after
the upgrade:
-
@@ -183,7 +183,7 @@ send frames back to the client or stop the connection.
The following snippet echoes back any text frame received and
ignores all others:
-
@@ -206,7 +206,7 @@ send frames to the client or stop the connection.
The following snippet forwards log messages to the client
and ignores all others:
-
@@ -223,7 +223,7 @@ http://www.gnu.org/software/src-highlite -->
send zero, one or many frames to the client.
To send nothing, just return an ok tuple:
-
@@ -231,7 +231,7 @@ http://www.gnu.org/software/src-highlite -->
{ok, State}.
To send one frame, return a reply tuple with the frame to send:
-
@@ -242,7 +242,7 @@ or close frames.
To send many frames at once, return a reply tuple with the
list of frames to send:
-
@@ -275,7 +275,7 @@ than needed.
for the connection. For example, this would make Cowboy
close connections idle for more than 30 seconds:
-
@@ -293,7 +293,7 @@ http://www.gnu.org/software/src-highlite -->
after the callback returns.
Simply add an hibernate
field to the ok or reply tuples:
-
@@ -319,7 +319,7 @@ for the more busy connections.
Cowboy to stop it or by sending a close frame.
To tell Cowboy to close the connection, use a stop tuple:
-
@@ -387,6 +387,8 @@ close frame will not be sent.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/guide/ws_protocol/index.html b/docs/en/cowboy/2.0/guide/ws_protocol/index.html
index aaae883a..1dfa8145 100644
--- a/docs/en/cowboy/2.0/guide/ws_protocol/index.html
+++ b/docs/en/cowboy/2.0/guide/ws_protocol/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: The Websocket protocol
@@ -187,6 +187,8 @@ extensions.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy.set_env/index.html b/docs/en/cowboy/2.0/manual/cowboy.set_env/index.html
index 660da1e7..c5b6e538 100644
--- a/docs/en/cowboy/2.0/manual/cowboy.set_env/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy.set_env/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy:set_env(3)
@@ -77,7 +77,7 @@
Description
-
@@ -155,7 +155,7 @@ not exist.
Update a listener’s routes
-
@@ -212,6 +212,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html b/docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html
index d986b8cc..ec923e04 100644
--- a/docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy:start_clear(3)
@@ -77,7 +77,7 @@
Description
-
@@ -172,7 +172,7 @@ configured for Cowboy is already in use.
Start a listener
-
@@ -187,7 +187,7 @@ http://www.gnu.org/software/src-highlite -->
}).
Start a listener on a random port
-
@@ -243,6 +243,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy.start_tls/index.html b/docs/en/cowboy/2.0/manual/cowboy.start_tls/index.html
index 9d239789..e96a0865 100644
--- a/docs/en/cowboy/2.0/manual/cowboy.start_tls/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy.start_tls/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy:start_tls(3)
@@ -77,7 +77,7 @@
Description
-
@@ -172,7 +172,7 @@ configured for Cowboy is already in use.
Start a listener
-
@@ -190,7 +190,7 @@ http://www.gnu.org/software/src-highlite -->
}).
Start a listener on a random port
-
@@ -248,6 +248,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy.stop_listener/index.html b/docs/en/cowboy/2.0/manual/cowboy.stop_listener/index.html
index 94f803de..9b98630d 100644
--- a/docs/en/cowboy/2.0/manual/cowboy.stop_listener/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy.stop_listener/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy:stop_listener(3)
@@ -77,7 +77,7 @@
Description
-
@@ -131,7 +131,7 @@ does not exist.
Stop a listener
-
@@ -182,6 +182,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy/index.html b/docs/en/cowboy/2.0/manual/cowboy/index.html
index 6e844a62..915fc64b 100644
--- a/docs/en/cowboy/2.0/manual/cowboy/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy(3)
@@ -113,7 +113,7 @@ manipulating Ranch listeners.
fields()
-
@@ -133,7 +133,7 @@ for matching bindings and in the match functions found in
-
@@ -143,7 +143,7 @@ http://www.gnu.org/software/src-highlite -->
http_status()
-
@@ -156,7 +156,7 @@ the reason phrase entirely.
http_version()
-
@@ -167,7 +167,7 @@ http://www.gnu.org/software/src-highlite -->
opts()
-
@@ -224,6 +224,8 @@ and the HTTP/2 options in
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_app/index.html b/docs/en/cowboy/2.0/manual/cowboy_app/index.html
index d20f61fc..906e3032 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_app/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_app/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy(7)
@@ -211,7 +211,7 @@ crypto - Crypto functions
All these applications must be started before the cowboy
application. To start Cowboy and all dependencies at once:
-
@@ -266,6 +266,8 @@ environment configuration parameters.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_constraints.int/index.html b/docs/en/cowboy/2.0/manual/cowboy_constraints.int/index.html
index e3c0c1c2..aca6441f 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_constraints.int/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_constraints.int/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_constraints:int(3)
@@ -78,7 +78,7 @@
Constraint functions implement a number of different operations.
-
@@ -88,14 +88,14 @@ http://www.gnu.org/software/src-highlite -->
Int :: integer()
Validate and convert the text representation of an integer.
-
int(reverse, Int) -> {ok, Bin} | {error, not_an_integer}
Convert an integer back to its text representation.
-
@@ -187,6 +187,8 @@ and the value as second argument.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_constraints.nonempty/index.html b/docs/en/cowboy/2.0/manual/cowboy_constraints.nonempty/index.html
index 975b29b4..c1b7b3f1 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_constraints.nonempty/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_constraints.nonempty/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_constraints:nonempty(3)
@@ -78,14 +78,14 @@
Constraint functions implement a number of different operations.
-
nonempty(forward | reverse, <<>>) -> {error, empty}
-
@@ -94,7 +94,7 @@ http://www.gnu.org/software/src-highlite -->
Bin :: binary()
Accept any other binary values.
-
@@ -186,6 +186,8 @@ and the value as second argument.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_constraints/index.html b/docs/en/cowboy/2.0/manual/cowboy_constraints/index.html
index 93085a69..2d627f51 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_constraints/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_constraints/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_constraints(3)
@@ -108,7 +108,7 @@ from the router to query strings to cookies.
constraint()
-
@@ -120,7 +120,7 @@ function in the exports list above.
reason()
-
@@ -179,6 +179,8 @@ made the constraint fail.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_handler.terminate/index.html b/docs/en/cowboy/2.0/manual/cowboy_handler.terminate/index.html
index 50a9c993..c580f3a2 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_handler.terminate/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_handler.terminate/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_handler:terminate(3)
@@ -77,7 +77,7 @@
Description
-
@@ -157,7 +157,7 @@ Handler module.
Terminate a handler normally
-
@@ -204,6 +204,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_handler/index.html b/docs/en/cowboy/2.0/manual/cowboy_handler/index.html
index 70bc1b52..b48cdf52 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_handler/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_handler/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_handler(3)
@@ -92,7 +92,7 @@ HTTP requests.
Plain HTTP handlers implement the following interface:
-
@@ -191,6 +191,8 @@ custom handlers to execute the optional terminate callback:
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_http/index.html b/docs/en/cowboy/2.0/manual/cowboy_http/index.html
index c6e4568d..068263b2 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_http/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_http/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_http(3)
@@ -84,7 +84,7 @@ as a Ranch protocol.
Options
-
@@ -335,6 +335,8 @@ stream_handlers ([cowboy_stream_h])
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_http2/index.html b/docs/en/cowboy/2.0/manual/cowboy_http2/index.html
index e9a57871..9e97022c 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_http2/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_http2/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_http2(3)
@@ -84,7 +84,7 @@ as a Ranch protocol.
Options
-
@@ -218,6 +218,8 @@ stream_handlers ([cowboy_stream_h])
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_loop/index.html b/docs/en/cowboy/2.0/manual/cowboy_loop/index.html
index 7e9d6707..e7b5543a 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_loop/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_loop/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_loop(3)
@@ -102,7 +102,7 @@ Or initiate a response in
init/2
and stream the
Loop handlers implement the following interface:
-
@@ -215,6 +215,8 @@ stop
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_middleware/index.html b/docs/en/cowboy/2.0/manual/cowboy_middleware/index.html
index 31d3703f..a3e03b8f 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_middleware/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_middleware/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_middleware(3)
@@ -87,7 +87,7 @@ are configured.
Middlewares implement the following interface:
-
@@ -139,7 +139,7 @@ the request.
env()
-
@@ -210,6 +210,8 @@ contains the name of the listener for this connection.
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.binding/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.binding/index.html
index 8dfcdf19..e5b5b9b1 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.binding/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.binding/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:binding(3)
@@ -77,7 +77,7 @@
Description
-
@@ -151,7 +151,7 @@ automatically converting numbers to integer).
Get the username from the path
-
@@ -159,7 +159,7 @@ http://www.gnu.org/software/src-highlite -->
Username = cowboy_req:binding(user, Req).
Get the branch name, with a default
-
@@ -211,6 +211,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.bindings/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.bindings/index.html
index 148a9d8f..7efb249e 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.bindings/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.bindings/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:bindings(3)
@@ -77,7 +77,7 @@
Description
-
@@ -130,7 +130,7 @@ automatically converting numbers to integer).
Get all bindings
-
@@ -181,6 +181,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.body_length/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.body_length/index.html
index 5cd380bf..4cc0a251 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.body_length/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.body_length/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:body_length(3)
@@ -77,7 +77,7 @@
Description
-
@@ -132,7 +132,7 @@ not known.
Get the body length
-
@@ -184,6 +184,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.delete_resp_header/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.delete_resp_header/index.html
index dd48e288..23d75d90 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.delete_resp_header/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.delete_resp_header/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:delete_resp_header(3)
@@ -77,7 +77,7 @@
Description
-
@@ -138,7 +138,7 @@ otherwise the header will still be sent in the response.
Remove the content-type header from the response
-
@@ -190,6 +190,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.has_body/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.has_body/index.html
index 0aeb3ecc..cde55e7c 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.has_body/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.has_body/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:has_body(3)
@@ -77,7 +77,7 @@
Description
-
@@ -123,7 +123,7 @@ The Req object.
Ensure the request has a body
-
@@ -175,6 +175,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_body/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_body/index.html
index e25d60e5..fa95ecc4 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_body/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_body/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:has_resp_body(3)
@@ -77,7 +77,7 @@
Description
-
@@ -125,7 +125,7 @@ body has been set.
Check whether a body has been set
-
@@ -177,6 +177,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_header/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_header/index.html
index 08324a08..d167f682 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_header/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.has_resp_header/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:has_resp_header(3)
@@ -77,7 +77,7 @@
Description
-
@@ -136,7 +136,7 @@ The Req object.
Check whether the content-type header has been set
-
@@ -190,6 +190,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.header/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.header/index.html
index 72a9abc6..2ca20833 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.header/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.header/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:header(3)
@@ -77,7 +77,7 @@
Description
-
@@ -93,7 +93,7 @@ While header names are case insensitive, Cowboy requires them
to be given as lowercase to function properly.
Headers can also be obtained using pattern matching:
-
@@ -161,14 +161,14 @@ header is missing, the default argument is returned.
Get the accept header
-
Accept = cowboy_req:header(<<"accept">>, Req).
Get the content-length header with a default value
-
@@ -217,6 +217,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.headers/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.headers/index.html
index ed700882..970bfc42 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.headers/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.headers/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:headers(3)
@@ -77,7 +77,7 @@
Description
-
@@ -85,7 +85,7 @@ http://www.gnu.org/software/src-highlite -->
Return all request headers.
Request headers can also be obtained using pattern matching:
-
@@ -136,7 +136,7 @@ binary strings, and values as binary strings.
Get all headers
-
@@ -185,6 +185,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.host/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.host/index.html
index d26e0244..0b68ac8b 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.host/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.host/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:host(3)
@@ -77,7 +77,7 @@
Description
-
@@ -85,7 +85,7 @@ http://www.gnu.org/software/src-highlite -->
Return the host name of the effective request URI.
The host name can also be obtained using pattern matching:
-
@@ -136,7 +136,7 @@ It is case insensitive.
Get the effective request URI’s host name
-
@@ -186,6 +186,8 @@ http://www.gnu.org/software/src-highlite -->
+
2.3
+
2.2
2.1
diff --git a/docs/en/cowboy/2.0/manual/cowboy_req.host_info/index.html b/docs/en/cowboy/2.0/manual/cowboy_req.host_info/index.html
index ee968e16..189f34da 100644
--- a/docs/en/cowboy/2.0/manual/cowboy_req.host_info/index.html
+++ b/docs/en/cowboy/2.0/manual/cowboy_req.host_info/index.html
@@ -7,7 +7,7 @@
-
+
Nine Nines: cowboy_req:host_info(3)
@@ -77,7 +77,7 @@
Description