mox!

mox-/setcaphint.go

@@ -0,0 +1,18 @@
+package mox
+
+import (
+	"errors"
+	"os"
+	"runtime"
+)
+
+// todo: perhaps find and document the recommended way to get this on other platforms?
+
+// LinuxSetcapHint returns a hint about using setcap for binding to privileged
+// ports, only if relevant the error and GOOS (Linux).
+func LinuxSetcapHint(err error) string {
+	if runtime.GOOS == "linux" && errors.Is(err, os.ErrPermission) {
+		return " (privileged port? try again after: sudo setcap 'cap_net_bind_service=+ep' mox)"
+	}
+	return ""
+}