From danger@tomas.elvandar.org Sat Feb 4 20:31:52 2006 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BE3C416A420 for ; Sat, 4 Feb 2006 20:31:52 +0000 (GMT) (envelope-from danger@tomas.elvandar.org) Received: from tomas.elvandar.org (tomas.elvandar.org [217.148.169.60]) by mx1.FreeBSD.org (Postfix) with ESMTP id 45FBB43D48 for ; Sat, 4 Feb 2006 20:31:52 +0000 (GMT) (envelope-from danger@tomas.elvandar.org) Received: by tomas.elvandar.org (Postfix, from userid 1002) id 5EEDD48450F; Sat, 4 Feb 2006 20:31:51 +0000 (UTC) Message-Id: <20060204203151.5EEDD48450F@tomas.elvandar.org> Date: Sat, 4 Feb 2006 20:31:51 +0000 (UTC) From: Daniel Gerzo Reply-To: Daniel Gerzo To: FreeBSD-gnats-submit@freebsd.org Cc: Subject: [patch] inetd handbook section: use rc.d script in SigHUP example and remove unnecessary manual page duplicates X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 92819 >Category: docs >Synopsis: [patch] inetd handbook section: use rc.d script in SigHUP example and remove unnecessary manual page duplicates >Confidential: no >Severity: non-critical >Priority: low >Responsible: brd >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Feb 04 20:40:07 GMT 2006 >Closed-Date: Sun Feb 05 05:08:03 GMT 2006 >Last-Modified: Sun Feb 05 05:08:03 GMT 2006 >Originator: Daniel Gerzo >Release: FreeBSD 6.0-RELEASE i386 >Organization: rulez.sk >Environment: System: FreeBSD 6.0-RELEASE #3: Fri Nov 4 21:58:23 CET 2005 i386 >Description: As we have a rc.d script for inetd available and its usage is very simple, use it in the handbook example (and teach people to get used to rc.d scripts since they are nice and simple to use). Also, remove the manual page duplicates from this handbook section as they seem unncessary to me, and they might look too "advanced" for novice users, and they can get out of date sooner of later (if they didn't already :)) and rather point users to read manual page. >How-To-Repeat: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-inetd.html >Fix: Use this diff: --- inetd.diff begins here --- --- /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml.orig Sat Feb 4 18:47:32 2006 +++ /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml Sat Feb 4 20:07:10 2006 @@ -149,130 +149,15 @@ Additionally, different command-line options can be passed to inetd via the - inetd_flags option. - - - - Command-Line Options - - inetd synopsis: - - - - - - -d - - - Turn on debugging. - - - - - -l - - - Turn on logging of successful connections. - - - - - -w - - - Turn on TCP Wrapping for external services (on by - default). - - - - - -W - - - Turn on TCP Wrapping for internal services which are - built into inetd (on by - default). - - - - - -c 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 - parameter. - - - - - -C 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 - - parameter. - - - - - -R 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. - - - - - -a - - - Specify one specific IP address to bind to. - Alternatively, a hostname can be specified, in which case - the IPv4 or IPv6 address which corresponds to that - hostname is used. Usually a hostname is specified when - inetd is run inside a - &man.jail.8;, in which case the hostname corresponds to - the &man.jail.8; environment. - - When hostname specification is used and both IPv4 - and IPv6 bindings are desired, one entry with the - appropriate protocol type for each binding is required - for each service in - /etc/inetd.conf. For example, a - TCP-based service would need two entries, one using - tcp4 for the protocol and the other - using tcp6. - - - - - -p - - - Specify an alternate file in which to store the - process ID. - - - - - These options can be passed to - inetd using the - inetd_flags option in - /etc/rc.conf. By default, + inetd_flags option. By default, inetd_flags is set to -wW, which turns on TCP wrapping for inetd's internal and external services. For novice users, these parameters usually do not need to be modified or even entered in - /etc/rc.conf. + /etc/rc.conf. Other options with their + detailed descriptions can be found in the &man.inetd.8; manual + page. An external service is a daemon outside of @@ -282,7 +167,6 @@ inetd has the facility of offering within itself. - @@ -292,16 +176,15 @@ controlled through the /etc/inetd.conf file. - When a modification is made to - /etc/inetd.conf, - inetd can be forced to re-read its - configuration file by sending a HangUP signal to the - inetd process as shown: + Any modification to + /etc/inetd.conf will not take effect until + inetd is forced to re-read the + configuration file by using the following rc.d script: Sending <application>inetd</application> a HangUP Signal - &prompt.root; kill -HUP `cat /var/run/inetd.pid` + &prompt.root; /etc/rc.d/inetd reload Each line of the configuration file specifies an --- inetd.diff ends here --- >Release-Note: >Audit-Trail: Responsible-Changed-From-To: freebsd-doc->brd Responsible-Changed-By: brd Responsible-Changed-When: Sat Feb 4 20:48:22 UTC 2006 Responsible-Changed-Why: Grab. http://www.freebsd.org/cgi/query-pr.cgi?pr=92819 From: Ceri Davies To: Daniel Gerzo , brd@FreeBSD.org Cc: freebsd-gnats-submit@FreeBSD.org Subject: Re: docs/92819: [patch] inetd handbook section: use rc.d script in SigHUP example and remove unnecessary manual page duplicates Date: Sat, 28 Jan 2006 11:15:51 +0000 This is an OpenPGP/MIME signed message (RFC 2440 and 3156) --Apple-Mail-1--921522051 Content-Transfer-Encoding: 7bit Content-Type: text/plain; charset=US-ASCII; format=flowed This conflicts really badly with work I have been doing on this section, as per the entry in the TODO list. Apologies, but I suggest that the PR be closed or suspended until I commit - my work already covers both the issues raised. Ceri --Apple-Mail-1--921522051 content-type: application/pgp-signature; x-mac-type=70674453; name=PGP.sig content-description: This is a digitally signed message part content-disposition: inline; filename=PGP.sig content-transfer-encoding: 7bit -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.1 (Darwin) iD8DBQFD21Jnme8yCsQvJJ0RAlrjAJ0bI4jyJll8MyRH3Hs+XF2LfHBWTgCfZv8X 3HztQ3K7wuG2zTwT3i/eLZU= =R0or -----END PGP SIGNATURE----- --Apple-Mail-1--921522051-- State-Changed-From-To: open->closed State-Changed-By: brd State-Changed-When: Sun Feb 5 05:07:36 UTC 2006 State-Changed-Why: Close per ceri@. http://www.freebsd.org/cgi/query-pr.cgi?pr=92819 >Unformatted: