From owner-freebsd-doc@FreeBSD.ORG Mon Aug 28 05:43:27 2006 Return-Path: X-Original-To: freebsd-doc@FreeBSD.org Delivered-To: freebsd-doc@FreeBSD.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id E03A416A4DA for ; Mon, 28 Aug 2006 05:43:26 +0000 (UTC) (envelope-from keramida@FreeBSD.org) Received: from igloo.linux.gr (igloo.linux.gr [62.1.205.36]) by mx1.FreeBSD.org (Postfix) with ESMTP id 2246343D45 for ; Mon, 28 Aug 2006 05:43:25 +0000 (GMT) (envelope-from keramida@FreeBSD.org) Received: from gothmog.pc (host5.bedc.ondsl.gr [62.103.39.229]) (authenticated bits=128) by igloo.linux.gr (8.13.7/8.13.7/Debian-2) with ESMTP id k7S5hA5C022602 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Mon, 28 Aug 2006 08:43:11 +0300 Received: from gothmog.pc (gothmog [127.0.0.1]) by gothmog.pc (8.13.7/8.13.7) with ESMTP id k7S5hOwd001540; Mon, 28 Aug 2006 08:43:24 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Received: (from giorgos@localhost) by gothmog.pc (8.13.7/8.13.7/Submit) id k7S5hNVA001539; Mon, 28 Aug 2006 08:43:23 +0300 (EEST) (envelope-from keramida@FreeBSD.org) Date: Mon, 28 Aug 2006 08:43:23 +0300 From: Giorgos Keramidas To: Daniel Gerzo Message-ID: <20060828054323.GC1411@gothmog.pc> References: <200602211640.k1LGe9UD002587@freefall.freebsd.org> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200602211640.k1LGe9UD002587@freefall.freebsd.org> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-3.149, required 5, autolearn=not spam, AWL -0.55, BAYES_00 -2.60, UNPARSEABLE_RELAY 0.00) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@FreeBSD.org Subject: Re: docs/93522: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 28 Aug 2006 05:43:27 -0000 On 2006-02-21 16:40, Daniel Gerzo wrote: > I hope that this is fine now ;-) > --- /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml.orig Thu Feb 16 09:44:00 2006 > +++ /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/chapter.sgml Sat Feb 18 15:20:53 2006 > @@ -773,13 +773,16 @@ > /exports -alldirs -maproot=root client01 client02 > /exports/obj -ro > > - You must restart > - mountd whenever you modify > - /etc/exports so the changes can take effect. > - This can be accomplished by sending the HUP signal > - to the mountd process: > + The mountd must be forced to > + recheck the /etc/exports file whenever it > + has been modified, so the changes can take effect. This can be > + accomplished by invoking the mountd > + &man.rc.8; script with the appropriate parameter: > > - &prompt.root; kill -HUP `cat /var/run/mountd.pid` > + &prompt.root; /etc/rc.d/mountd reload > + > + Refer to for more > + information about using rc scripts. I think it is better to use either "mountd must be ..." or "The mountd daemon must be...", but not what starts the newly added stuff above. The order of the first sentence is slightly untasteful (the result (having to restart mountd) precedes its cause (a change in the /etc/exports file)). The use of "it" is also a bit confusing. Does "it" refer to mountd or to the file? Maybe we can use something like this? + Every time a change is applied to the + /etc/exports file, the + mountd daemon must be forced to + recheck this file for changes. This can be accomplished by + invoking the mountd &man.rc.8; script + with the appropriate parameter: + + &prompt.root; /etc/rc.d/mountd reload + + Please refer to for + more information about using rc scripts, + like /etc/rc.d/mountd.