From owner-freebsd-doc@FreeBSD.ORG Wed Oct 18 20:51:20 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 AB7D416A412 for ; Wed, 18 Oct 2006 20:51:20 +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 CD07F43D62 for ; Wed, 18 Oct 2006 20:51:18 +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.8/8.13.8/Debian-2) with ESMTP id k9IKoxGI008765 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Wed, 18 Oct 2006 23:51:00 +0300 Received: from gothmog.pc (gothmog [127.0.0.1]) by gothmog.pc (8.13.8/8.13.8) with ESMTP id k9IKpagT091683; Wed, 18 Oct 2006 23:51:36 +0300 (EEST) (envelope-from keramida@freebsd.org) Received: (from giorgos@localhost) by gothmog.pc (8.13.8/8.13.8/Submit) id k9IKpZod091682; Wed, 18 Oct 2006 23:51:35 +0300 (EEST) (envelope-from keramida@freebsd.org) Date: Wed, 18 Oct 2006 23:51:35 +0300 From: Giorgos Keramidas To: Volodymyr Kostyrko Message-ID: <20061018205135.GA5665@gothmog.pc> References: <452C187F.5030403@synergetica.dn.ua> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <452C187F.5030403@synergetica.dn.ua> X-Hellug-MailScanner: Found to be clean X-Hellug-MailScanner-SpamCheck: not spam, SpamAssassin (score=-2.667, required 5, AWL -0.27, BAYES_00 -2.60, DNS_FROM_RFC_ABUSE 0.20, UNPARSEABLE_RELAY 0.00) X-Hellug-MailScanner-From: keramida@freebsd.org X-Spam-Status: No Cc: freebsd-doc@freebsd.org Subject: Re: http://www.freebsd.org/doc/en_US.ISO8859-1/books/handbook/network-nfs.html 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: Wed, 18 Oct 2006 20:51:20 -0000 On 2006-10-11 01:02, Volodymyr Kostyrko wrote: > I have a noticed an inconsistance in this section: > > [code] > The mountd daemon must be forced to recheck the /etc/exports file > whenever it has been modified, so the changes can take effect. This can > be accomplished either by sending a HUP signal to the running daemon: > > # kill -HUP `cat /var/run/mountd.pid` > > or by invoking the mountd rc(8) script with the appropriate parameter: > > # /etc/rc.d/mountd reload > > Please refer to Section 11.7 for more information about using rc scripts. > [/code] > > The command "/etc/rc.d/mountd reload" doesn't work neither says nothing. > Yet "/etc/rc.d/mountd forcereload" works and says: "Reloading mountd > config files." > > Section 11.7 states that 'force' is needed when rc script is not enabled > in /etc/rc.conf. There is no place in this document which recommends > turning mountd on. Instead we have: > > [code] > On the NFS server, make sure that the following options are configured > in the /etc/rc.conf file: > > rpcbind_enable="YES" > nfs_server_enable="YES" > mountd_flags="-r" > > mountd runs automatically whenever the NFS server is enabled. > [/code] > > Both this places can't be correct at once. I have committed a change to the `reload' argument of `mountd', to use `onereload' instead of `forcereload' (the second is much more aggressive, and should be avoided if possible). Revision 1.94 was committed with the following text as its commit log: revision 1.94 date: 2006/10/18 20:47:50; author: keramida; state: Exp; lines: +1 -1 Suggest using `/etc/rc.d/mountd onereload' instead of `reload', to make sure that `mountd' is (re)loaded even if it's not yet enabled in `/etc/rc.conf'. Ideally, `mountd' should already be enabled in `rc.conf', but if `mountd_enable' is not set to "YES" in `rc.conf', then running the rc.d script with a plain `reload' argument does nothing. Using `onereload' (with the rc.d-specific `one' prefix) makes sure that `mountd' is temporarily enabled for the run of this rc.d script and it does indeed reload its config files. Suggested by: Volodymyr Kostyrko Mailing List: freebsd-doc Message-Id: <452C187F.5030403@synergetica.dn.ua> Now the text will read: or by invoking the mountd rc(8) script with the appropriate parameter: # /etc/rc.d/mountd onereload which should work as expected. Many thanks for taking the time to report this *and* suggest a candidate fix. Any other help you can give in improving our documentation would be much appreciated :) Regards, Giorgos