Ranch is a socket acceptor pool for TCP protocols.
Ranch aims to provide everything you need to accept TCP connections with a small code base and low latency while being easy to use directly as an application or to embed into your own.
Ranch provides a modular design, letting you choose which transport and protocol are going to be used for a particular listener. Listeners accept and manage connections on one port, and include facilities to limit the number of concurrent connections. Connections are sorted into pools. Each pool keeps its own connection count, and the connection limit applies per pool.
Ranch also allows you to upgrade the acceptor pool without having to close any of the currently opened sockets.
-
While still online, run
make docs -
User guide available in
doc/in PDF and HTML formats -
Function reference man pages available in
doc/man3/anddoc/man7/ -
Run
make install-docsto install man pages on your system -
Full documentation in Asciidoc available in
doc/src/ -
Examples available in
examples/