From nobody Mon Dec 06 21:15:58 2021 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id B938318D76AE; Mon, 6 Dec 2021 21:15:59 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4J7GSG5RDpz3FlC; Mon, 6 Dec 2021 21:15:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 9AC8813464; Mon, 6 Dec 2021 21:15:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1B6LFwMu067483; Mon, 6 Dec 2021 21:15:58 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1B6LFwCZ067482; Mon, 6 Dec 2021 21:15:58 GMT (envelope-from git) Date: Mon, 6 Dec 2021 21:15:58 GMT Message-Id: <202112062115.1B6LFwCZ067482@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 593ad024e4ed - main - inetd.8: Sort options List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 593ad024e4ed04e4c875446e5277d82e3111848f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1638825358; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=qiNkfT0trscqbtCgi0OvIn6WBWJUSFDdtAd6NZtkf/I=; b=oW7E4UDEZvAZCPkSnjmFg1eG/vw7az37mxiAfiQ+cyYmS+t/9fM31RLn3J0W81SYksi2H4 dJ0KttYORjCMWvdLzPEDHzccmOBX/s/SkUbihrg1IoW6C2cuH+nBgDcAOUgRblsVwc9Kv0 ZODl+YyGnIpF120gfIc9RQH89nloNlpIe9bBVftq/b2ZT+kdkf2mpps5roRcKdrJDWeGgh pMA9T5hhYAwhLYOMhC5xCTvwJ7qabrHQOSf9vS3cNTiEz48eUeIcnAAewmKsqJMMG+2+8P Y1cnrBzBkZiByS7Px7RIejUzGnC2Dhh/LvRaLU2niApltKx10WsMPFzdPWfQqw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1638825358; a=rsa-sha256; cv=none; b=iMyLznMjqEQFkPdR/O+HS0NfF8IciJnNQBw35Xcm2QpwATkRrqD6rX/aZzYtoPzRDa4Px0 lyuOitF0h3hRrc4gfoehU1AqLv6jmjHTpWhNkowGc70uhJEmCmsx68vezEf+HIB4d3Y9af UtAsYHYWpLrDLA1ovpWVZ2eeOFRoMweInJSW1fA5n8DgVBzNI2+MGOq9UoNNSZgA75jQiV SlA402UmbwITVXt9oY1XdqWSFPXpoQ9ZKcx3VFGJOXcDQrSok1flb0tW0L7xTQwY96FH3Z 75faEinTV4+HYij9PgA78LX+5PNG7EERfXpMvvfxa9366jtj+pogUVTyD72PGw== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=593ad024e4ed04e4c875446e5277d82e3111848f commit 593ad024e4ed04e4c875446e5277d82e3111848f Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2021-12-06 20:56:42 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2021-12-06 21:15:19 +0000 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(-) 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