README.asciidoc 1.4 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. = Ranch
  2. Ranch is a socket acceptor pool for TCP protocols.
  3. == Goals
  4. Ranch aims to provide everything you need to accept TCP connections with
  5. a **small** code base and **low latency** while being easy to use directly
  6. as an application or to **embed** into your own.
  7. Ranch provides a **modular** design, letting you choose which transport
  8. and protocol are going to be used for a particular listener. Listeners
  9. accept and manage connections on one port, and include facilities to
  10. limit the number of **concurrent** connections. Connections are sorted
  11. into **pools**, each pool having a different configurable limit.
  12. Ranch also allows you to **upgrade** the acceptor pool without having
  13. to close any of the currently opened sockets.
  14. == Online documentation
  15. * http://ninenines.eu/docs/en/ranch/1.3/guide[User guide]
  16. * http://ninenines.eu/docs/en/ranch/1.3/manual[Function reference]
  17. == Offline documentation
  18. * While still online, run `make docs`
  19. * User guide available in `doc/` in PDF and HTML formats
  20. * Function reference man pages available in `doc/man3/` and `doc/man7/`
  21. * Run `make install-docs` to install man pages on your system
  22. * Full documentation in Asciidoc available in `doc/src/`
  23. * Examples available in `examples/`
  24. == Support
  25. * Official IRC Channel: #ninenines on irc.freenode.net
  26. * https://github.com/ninenines/ranch/issues[Issues tracker]
  27. * http://ninenines.eu/services[Commercial Support]