diff --git a/docs/man/nginx.8 b/docs/man/nginx.8 index 64d9ae76c..82ceb3c35 100644 --- a/docs/man/nginx.8 +++ b/docs/man/nginx.8 @@ -25,7 +25,7 @@ .\" SUCH DAMAGE. .\" .\" -.Dd January 21, 2026 +.Dd September 4, 2026 .Dt NGINX 8 .Os .Sh NAME @@ -37,6 +37,7 @@ .Op Fl c Ar file .Op Fl e Ar file .Op Fl g Ar directives +.Op Fl l Ar address .Op Fl p Ar prefix .Op Fl s Ar signal .Sh DESCRIPTION @@ -66,6 +67,11 @@ Set global configuration directives. See .Sx EXAMPLES for details. +.It Fl l Ar address +Set a control socket listen address. +See +.Sx CONTROL SOCKET +for details. .It Fl p Ar prefix Set the prefix path. The default value is @@ -165,6 +171,27 @@ events { debug_connection 127.0.0.1; } .Ed +.Sh CONTROL SOCKET +To enable a control socket, reconfigure +.Nm +to build with control API: +.Pp +.Dl "./configure --with-control-api ..." +.Pp +and then set the control socket listen address, for example: +.Bd -literal -offset indent +nginx -c ~/mynginx.conf -l 127.0.0.1:8888 +.Ed +.Pp +IPv6 addresses should be enclosed in square brackets: +.Bd -literal -offset indent +nginx -c ~/mynginx.conf -l [::1]:8888 +.Ed +.Pp +It is also possible to set a UNIX-domain socket: +.Bd -literal -offset indent +nginx -c ~/mynginx.conf -l unix:/path/to/socket +.Ed .Sh ENVIRONMENT The .Ev NGINX