• Stars
    star
    1,153
  • Rank 40,455 (Top 0.8 %)
  • Language
    Erlang
  • License
    ISC License
  • Created over 12 years ago
  • Updated about 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Socket acceptor pool for TCP protocols.

Ranch

Ranch is a socket acceptor pool for TCP protocols.

Goals

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 having a different configurable limit.

Ranch also allows you to upgrade the acceptor pool without having to close any of the currently opened sockets.

Online documentation

Offline documentation

  • While still online, run make docs

  • User guide available in doc/ in PDF and HTML formats

  • Function reference man pages available in doc/man3/ and doc/man7/

  • Run make install-docs to install man pages on your system

  • Full documentation in Asciidoc available in doc/src/

  • Examples available in examples/