From 69192a2a3c5fbfa00c3f4fb7b9628512c8ef55ae Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Lo=C3=AFc=20Hoguin?= Date: Thu, 13 Dec 2012 17:35:07 +0100 Subject: Improve guide on listening on privileged ports Making people happy one IRC channel at a time. --- guide/listeners.md | 17 ++++++++++++----- guide/toc.md | 2 +- 2 files changed, 13 insertions(+), 6 deletions(-) diff --git a/guide/listeners.md b/guide/listeners.md index 59aa990..1f7c430 100644 --- a/guide/listeners.md +++ b/guide/listeners.md @@ -99,12 +99,19 @@ argument is the name of the listener you gave in `ranch:start_listener/6`. Port = ranch:get_port(tcp_echo). ``` -Listening on a port =< 1024 ---------------------------- +Listening on privileged ports +----------------------------- -This is currently not possible. We recommend the use of load balancing -or NAT firewall rules if the need arise. Proxies can sometimes also be -used although that's a less efficient solution. +Some systems limit access to ports below 1024 for security reasons. +This can easily be identified by an `{error, eacces}` error when trying +to open a listening socket on such a port. + +The methods for listening on privileged ports vary between systems, +please refer to your system's documentation for more information. + +We recommend the use of port rewriting for systems with a single server, +and load balancing for systems with multiple servers. Documenting these +solutions is however out of the scope of this guide. Limiting the number of concurrent connections --------------------------------------------- diff --git a/guide/toc.md b/guide/toc.md index 104dd3d..f83b6c6 100644 --- a/guide/toc.md +++ b/guide/toc.md @@ -8,7 +8,7 @@ Ranch User Guide * Purpose * Starting and stopping * Listening on a random port - * Listening on a port =< 1024 + * Listening on privileged ports * Limiting the number of concurrent connections * Upgrading * [Transports](transports.md) -- cgit v1.2.3