From 136d443b5c38bee96f5d995dfea3629ef07564c3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Thu, 18 Jul 2019 09:59:28 +0200 Subject: Announce Ranch 2.0.0-rc.1 Adds Ranch 2.0 documentation and removes documentation for very old Cowboy and Ranch, along with Erlang.mk documentation which is available on its own website. --- .../2.0/manual/cowboy.start_clear/index.html | 233 --------------------- 1 file changed, 233 deletions(-) delete mode 100644 docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html (limited to 'docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html') 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 deleted file mode 100644 index 1ff885c3..00000000 --- a/docs/en/cowboy/2.0/manual/cowboy.start_clear/index.html +++ /dev/null @@ -1,233 +0,0 @@ - - - - - - - - - - Nine Nines: cowboy:start_clear(3) - - - - - - - - - - - - - - -

- - - -

- -

cowboy:start_clear(3)

- -

Name

cowboy:start_clear - Listen for connections using plain TCP

Description

start_clear(Name          :: ranch:ref(),
-            TransportOpts :: ranch_tcp:opts(),
-            ProtocolOpts  :: opts())
-    -> {ok, ListenerPid :: pid()}
-     | {error, any()}

Start listening for connections over a clear TCP channel.

Both HTTP/1.1 and HTTP/2 are supported on this listener. HTTP/2 has two methods of establishing a connection over a clear TCP channel. Both the upgrade and the prior knowledge methods are supported.

Arguments

Name

The listener name is used to refer to this listener in future calls, for example when stopping it or when updating the routes defined.

It can be any Erlang term. An atom is generally good enough, for example api, my_app_clear or my_app_tls.

TransportOpts

The transport options are where the TCP options, including the listener's port number, are defined. Transport options are provided as a list of keys and values, for example [{port, 8080}].

The available options are documented in the ranch_tcp(3) manual.

ProtocolOpts

The protocol options are in a map containing all the options for the different protocols that may be involved when connecting to the listener, including HTTP/1.1 and HTTP/2.

The HTTP/1.1 options are documented in the cowboy_http(3) manual; and the HTTP/2 options in cowboy_http2(3).

Return value

An ok tuple is returned on success. It contains the pid of the top-level supervisor for the listener.

An error tuple is returned on error. The error reason may be any Erlang term.

A common error is eaddrinuse. It indicates that the port configured for Cowboy is already in use.

Changelog

2.0: HTTP/2 support added. -
2.0: Function introduced. Replaces cowboy:start_http/4. -

Examples

Start a listener

Dispatch = cowboy_router:compile([
-    {'_', [
-        {"/", toppage_h, []}
-    ]}
-]),
-
-{ok, _} = cowboy:start_clear(example, [{port, 8080}], #{
-    env => #{dispatch => Dispatch}
-}).

Start a listener on a random port

Name = example,
-
-{ok, _} = cowboy:start_clear(Name, [], #{
-    env => #{dispatch => Dispatch}
-}),
-
-Port = ranch:get_port(Name).

99s

cowboy:start_clear(3)

Name

Description

Arguments

Return value

Changelog

Examples

See also

- Cowboy - 2.0 - Function Reference - -

Navigation

Version select

Like my work? Donate!