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. * https://ninenines.eu/docs/en/ranch/2.0/guide[User guide]
  16. * https://ninenines.eu/docs/en/ranch/2.0/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. == Getting help
  25. * Official IRC Channel: #ninenines on irc.freenode.net
  26. * https://github.com/ninenines/ranch/issues[Issues tracker]
  27. * https://ninenines.eu/services[Commercial Support]