Provide help for users trying to bind to privileged ports.

Closes #2098.
eclipse · Apr 3, 2021 · 983dc14 · 983dc14
1 parent eead0d2
commit 983dc14
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/src/net.c b/src/net.c
@@ -754,6 +754,12 @@ static int net__socket_listen_tcp(struct mosquitto__listener *listener)
 #endif
 
  if(bind(sock, rp->ai_addr, rp->ai_addrlen) == -1){
+#if defined(__linux__)
+ if(errno == EACCES){
+ log__printf(NULL, MOSQ_LOG_ERR, "If you are trying to bind to a privileged port (<1024), try using setcap and do not start the broker as root:");
+ log__printf(NULL, MOSQ_LOG_ERR, " sudo setcap 'CAP_NET_BIND_SERVICE=+ep /usr/sbin/mosquitto'");
+ }
+#endif
  net__print_error(MOSQ_LOG_ERR, "Error: %s");
  COMPAT_CLOSE(sock);
  freeaddrinfo(ainfo);