From owner-freebsd-doc@FreeBSD.ORG Sat Feb 4 20:40:08 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 98EEB16A420 for ; Sat, 4 Feb 2006 20:40:08 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id AA26E43D58 for ; Sat, 4 Feb 2006 20:40:07 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k14Ke7si046861 for ; Sat, 4 Feb 2006 20:40:07 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k14Ke7rr046860; Sat, 4 Feb 2006 20:40:07 GMT (envelope-from gnats) Resent-Date: Sat, 4 Feb 2006 20:40:07 GMT Resent-Message-Id: <200602042040.k14Ke7rr046860@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Daniel Gerzo 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 To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Cc: Subject: docs/92819: [patch] inetd handbook section: use rc.d script in SigHUP example and remove unnecessary manual page duplicates X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Daniel Gerzo List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 04 Feb 2006 20:40:08 -0000 >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: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Sat Feb 04 20:40:07 GMT 2006 >Closed-Date: >Last-Modified: >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: >Unformatted: