aboutsummaryrefslogtreecommitdiffstats
path: root/doc/src/manual/ranch.set_max_connections.asciidoc
blob: cc1bb20b54ceaf06e1581c1b4022031722765bf1 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
= ranch:set_max_connections(3)

== Name

ranch:set_max_connections - Set the max number of connections per connection supervisor

== Description

[source,erlang]
----
set_max_connections(Ref      :: ranch:ref(),
                    MaxConns :: ranch:max_conns())
    -> ok
----

Set the max number of connections per connection supervisor.

The change will be applied immediately. If the new value is
smaller than the previous one, Ranch will wait for the extra
connections to terminate and will not accept new connections
until the number of connections goes below the limit.

== Arguments

Ref::

The listener name.

MaxConns::

The new maximum number of connections per connection supervisor.

== Return value

The atom `ok` is always returned. It can be safely ignored.

== Changelog

* *2.0*: The maximum number of connections is now per connection supervisor.

== Examples

.Set the max number of connections per connection supervisor
[source,erlang]
----
ranch:set_max_connections(example, 10000).
----

== See also

link:man:ranch:get_max_connections(3)[ranch:get_max_connections(3)],
link:man:ranch:set_protocol_options(3)[ranch:set_protocol_options(3)],
link:man:ranch:set_transport_options(3)[ranch:set_transport_options(3)],
link:man:ranch(3)[ranch(3)]