From 593ad024e4ed04e4c875446e5277d82e3111848f Mon Sep 17 00:00:00 2001 From: Mateusz Piotrowski <0mp@FreeBSD.org> Date: Mon, 6 Dec 2021 21:56:42 +0100 Subject: inetd.8: Sort options While here: - Cluster flags without arguments together. - Simplify the synopsis of the -a flag. There is no need to distinguish between address and hostname there. - Add a missing argument to the -a flag in the description section. - Fix some typos. MFC after: 3 days --- usr.sbin/inetd/inetd.8 | 139 ++++++++++++++++++++++++------------------------- 1 file changed, 68 insertions(+), 71 deletions(-) (limited to 'usr.sbin/inetd') diff --git a/usr.sbin/inetd/inetd.8 b/usr.sbin/inetd/inetd.8 index ebe968e5f840..6dd1b162c2da 100644 --- a/usr.sbin/inetd/inetd.8 +++ b/usr.sbin/inetd/inetd.8 @@ -37,17 +37,14 @@ .Dq super-server .Sh SYNOPSIS .Nm -.Op Fl d -.Op Fl l -.Op Fl w -.Op Fl W -.Op Fl c Ar maximum +.Op Fl dlWw +.Op Fl a Ar address .Op Fl C Ar rate -.Op Fl a Ar address | hostname +.Op Fl c Ar maximum .Op Fl p Ar filename .Op Fl R Ar rate .Op Fl s Ar maximum -.Op Ar configuration file +.Op Ar configuration_file .Sh DESCRIPTION The .Nm @@ -74,40 +71,7 @@ reducing load on the system. .Pp The following options are available: .Bl -tag -width indent -.It Fl d -Turn on debugging. -.It Fl l -Turn on logging of successful connections. -.It Fl w -Turn on TCP Wrapping for external services. -See the -.Sx "IMPLEMENTATION NOTES" -section for more information on TCP Wrappers support. -.It Fl W -Turn on TCP Wrapping for internal services which are built in to -.Nm . -.It Fl c Ar maximum -Specify the default maximum number of -simultaneous invocations of each service; -the default is unlimited. -May be overridden on a per-service basis with the "max-child" -parameter. -.It Fl C Ar rate -Specify the default maximum number of times a service can be invoked -from a single IP address in one minute; the default is unlimited. -May be overridden on a per-service basis with the -"max-connections-per-ip-per-minute" parameter. -.It Fl R Ar rate -Specify the maximum number of times a service can be invoked -in one minute; the default is 256. -A rate of 0 allows an unlimited number of invocations. -.It Fl s Ar maximum -Specify the default maximum number of -simultaneous invocations of each service from a single IP address; -the default is unlimited. -May be overridden on a per-service basis with the "max-child-per-ip" -parameter. -.It Fl a +.It Fl a Ar address Specify one specific IP address to bind to. Alternatively, a hostname can be specified, in which case the IPv4 or IPv6 address @@ -139,8 +103,41 @@ See the explanation of the .Pa /etc/inetd.conf .Em protocol field below. +.It Fl C Ar rate +Specify the default maximum number of times a service can be invoked +from a single IP address in one minute; the default is unlimited. +May be overridden on a per-service basis with the +"max-connections-per-ip-per-minute" parameter. +.It Fl c Ar maximum +Specify the default maximum number of +simultaneous invocations of each service; +the default is unlimited. +May be overridden on a per-service basis with the "max-child" +parameter. +.It Fl d +Turn on debugging. +.It Fl l +Turn on logging of successful connections. .It Fl p Specify an alternate file in which to store the process ID. +.It Fl R Ar rate +Specify the maximum number of times a service can be invoked +in one minute; the default is 256. +A rate of 0 allows an unlimited number of invocations. +.It Fl s Ar maximum +Specify the default maximum number of +simultaneous invocations of each service from a single IP address; +the default is unlimited. +May be overridden on a per-service basis with the "max-child-per-ip" +parameter. +.It Fl W +Turn on TCP Wrapping for internal services which are built in to +.Nm . +.It Fl w +Turn on TCP Wrapping for external services. +See the +.Sx "IMPLEMENTATION NOTES" +section for more information on TCP Wrappers support. .El .Pp Upon execution, @@ -468,6 +465,26 @@ If the real service is disabled, return this username for every request. This is primarily useful when running this service on a NAT machine. +.It Fl F +Same as +.Fl f +but without the restriction that the username in +.Pa .fakeid +must not match an existing user. +.It Fl f +If the file +.Pa .fakeid +exists in the home directory of the identified user, report the username +found in that file instead of the real username. +If the username found in +.Pa .fakeid +is that of an existing user, +then the real username is reported. +If the +.Fl i +flag is also given then the username in +.Pa .fakeid +is checked against existing user IDs instead. .It Fl g Instead of returning the user's name to the ident requester, @@ -483,38 +500,8 @@ but also any fallback name, or .Pa .noident files. -.It Fl t Xo -.Ar sec Ns Op . Ns Ar usec -.Xc -Specify a timeout for the service. -The default timeout is 10.0 seconds. -.It Fl r -Offer a real -.Dq auth -service, as per RFC 1413. -All the remaining flags apply only in this case. .It Fl i Return numeric user IDs instead of usernames. -.It Fl f -If the file -.Pa .fakeid -exists in the home directory of the identified user, report the username -found in that file instead of the real username. -If the username found in -.Pa .fakeid -is that of an existing user, -then the real username is reported. -If the -.Fl i -flag is also given then the username in -.Pa .fakeid -is checked against existing user IDs instead. -.It Fl F -same as -.Fl f -but without the restriction that the username in -.Pa .fakeid -must not match an existing user. .It Fl n If the file .Pa .noident @@ -528,6 +515,16 @@ Use .Ar osname instead of the name of the system as reported by .Xr uname 3 . +.It Fl r +Offer a real +.Dq auth +service, as per RFC 1413. +All the remaining flags apply only in this case. +.It Fl t Xo +.Ar sec Ns Op Cm \&. Ns Ar usec +.Xc +Specify a timeout for the service. +The default timeout is 10.0 seconds. .El .Pp The -- cgit v1.2.3