From danger@tomas.elvandar.org  Sat Feb 18 10:19:37 2006
Return-Path: <danger@tomas.elvandar.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 288BE16A420
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 18 Feb 2006 10:19:36 +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 8D0D543D48
	for <FreeBSD-gnats-submit@freebsd.org>; Sat, 18 Feb 2006 10:19:36 +0000 (GMT)
	(envelope-from danger@tomas.elvandar.org)
Received: by tomas.elvandar.org (Postfix, from userid 1002)
	id BC9C2483F51; Sat, 18 Feb 2006 10:19:34 +0000 (UTC)
Message-Id: <20060218101934.BC9C2483F51@tomas.elvandar.org>
Date: Sat, 18 Feb 2006 10:19:34 +0000 (UTC)
From: Daniel Gerzo <danger@rulez.sk>
Reply-To: Daniel Gerzo <danger@rulez.sk>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         93522
>Category:       docs
>Synopsis:       [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    keramida
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Feb 18 10:20:08 GMT 2006
>Closed-Date:    Wed May 10 19:25:05 GMT 2006
>Last-Modified:  Wed May 10 19:25:05 GMT 2006
>Originator:     Daniel Gerzo
>Release:        FreeBSD 6.1-PRERELEASE i386
>Organization:
rulez.sk
>Environment:
System: 6.1-PRERELEASE #0: Wed Feb 15 02:22:30 CET 2006 i386
>Description:
Teach users to get used to use the rc.d scripts since they are nice and
easy-to-use, so reflect them in the handbok.
>How-To-Repeat:
>Fix:
--- chapter.sgml.diff begins here ---
--- /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 10:15:15 2006
@@ -776,10 +776,10 @@
       <para>You must restart
         <application>mountd</application> whenever you modify
         <filename>/etc/exports</filename> so the changes can take effect.
-        This can be accomplished by sending the HUP signal
-        to the <command>mountd</command> process:</para>
+        This can be accomplished by invoking of the
+	<filename>/etc/rc.d/mountd</filename> script:</para>
 
-      <screen>&prompt.root; <userinput>kill -HUP `cat /var/run/mountd.pid`</userinput></screen>
+      <screen>&prompt.root; <userinput>/etc/rc.d/mountd restart</userinput></screen>
 
       <para>Alternatively, a reboot will make FreeBSD set everything
         up properly.  A reboot is not necessary though.
--- chapter.sgml.diff ends here ---
>Release-Note:
>Audit-Trail:

From: Christian Brueffer <chris@unixpages.org>
To: Daniel Gerzo <danger@rulez.sk>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re: docs/93522: [patch] use rc.d script in example describing how to
 restart mountd in nework-servers chapter
Date: Sat, 18 Feb 2006 12:18:50 +0100

 --ikeVEW9yuYc//A+q
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On Sat, Feb 18, 2006 at 10:19:34AM +0000, Daniel Gerzo wrote:
 >=20
 > >Number:         93522
 > >Category:       docs
 > >Synopsis:       [patch] use rc.d script in example describing how to res=
 tart mountd in nework-servers chapter
 > >Confidential:   no
 > >Severity:       non-critical
 > >Priority:       low
 > >Responsible:    freebsd-doc
 > >State:          open
 > >Quarter:       =20
 > >Keywords:      =20
 > >Date-Required:
 > >Class:          doc-bug
 > >Submitter-Id:   current-users
 > >Arrival-Date:   Sat Feb 18 10:20:08 GMT 2006
 > >Closed-Date:
 > >Last-Modified:
 > >Originator:     Daniel Gerzo
 > >Release:        FreeBSD 6.1-PRERELEASE i386
 > >Organization:
 > rulez.sk
 > >Environment:
 > System: 6.1-PRERELEASE #0: Wed Feb 15 02:22:30 CET 2006 i386
 > >Description:
 > Teach users to get used to use the rc.d scripts since they are nice and
 > easy-to-use, so reflect them in the handbok.
 > >How-To-Repeat:
 > >Fix:
 > --- chapter.sgml.diff begins here ---
 > --- /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/c=
 hapter.sgml.orig	Thu Feb 16 09:44:00 2006
 > +++ /usr/home/danger/doc/en_US.ISO8859-1/books/handbook/network-servers/c=
 hapter.sgml	Sat Feb 18 10:15:15 2006
 > @@ -776,10 +776,10 @@
 >        <para>You must restart
 >          <application>mountd</application> whenever you modify
 >          <filename>/etc/exports</filename> so the changes can take effect.
 > -        This can be accomplished by sending the HUP signal
 > -        to the <command>mountd</command> process:</para>
 > +        This can be accomplished by invoking of the
 > +	<filename>/etc/rc.d/mountd</filename> script:</para>
 > =20
 > -      <screen>&prompt.root; <userinput>kill -HUP `cat /var/run/mountd.pi=
 d`</userinput></screen>
 > +      <screen>&prompt.root; <userinput>/etc/rc.d/mountd restart</userinp=
 ut></screen>
 > =20
 
 Sending HUP to a process is not the same as restarting is.  In my book,
 this specific section is fine as it is.
 
 - Christian
 
 --=20
 Christian Brueffer	chris@unixpages.org	brueffer@FreeBSD.org
 GPG Key:	 http://people.freebsd.org/~brueffer/brueffer.key.asc
 GPG Fingerprint: A5C8 2099 19FF AACA F41B  B29B 6C76 178C A0ED 982D
 
 --ikeVEW9yuYc//A+q
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.2.1 (FreeBSD)
 
 iD8DBQFD9wKabHYXjKDtmC0RAtJrAKDPJLCbDoNNguK7nXez4V9qmmdpNQCdFEpH
 Ni/4Repqco5Bk8OcbbTZz1A=
 =+MoT
 -----END PGP SIGNATURE-----
 
 --ikeVEW9yuYc//A+q--
 

From: Daniel Gerzo <danger@rulez.sk>
To: Christian Brueffer <chris@unixpages.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re[2]: docs/93522: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter
Date: Sat, 18 Feb 2006 13:15:48 +0100

 Hello Christian,
 
 Saturday, February 18, 2006, 12:18:50 PM, you wrote:
 
 > On Sat, Feb 18, 2006 at 10:19:34AM +0000, Daniel Gerzo wrote:
 
 > Sending HUP to a process is not the same as restarting is.  In my book,
 > this specific section is fine as it is.
 
 then reload might be sufficient
 
 > - Christian
 
 -- 
 Sincerely,
    Daniel Gerzo
 

From: "Simon L. Nielsen" <simon@FreeBSD.org>
To: Dmitry Morozovsky <marck@rinet.ru>
Cc: Christian Brueffer <chris@unixpages.org>,
	freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/93522: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter
Date: Sat, 18 Feb 2006 13:40:03 +0100

 --RnlQjJ0d97Da+TV1
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 Content-Transfer-Encoding: quoted-printable
 
 On 2006.02.18 14:52:31 +0300, Dmitry Morozovsky wrote:
 > On Sat, 18 Feb 2006, Christian Brueffer wrote:
 >=20
 > CB>  > -      <screen>&prompt.root; <userinput>kill -HUP `cat /var/run/mo=
 untd.pi=3D
 > CB>  d`</userinput></screen>
 > CB>  > +      <screen>&prompt.root; <userinput>/etc/rc.d/mountd restart</=
 userinp=3D
 > CB>  ut></screen>
 > CB>  > =3D20
 > CB> =20
 > CB>  Sending HUP to a process is not the same as restarting is.  In my bo=
 ok,
 > CB>  this specific section is fine as it is.
 >=20
 > Yes. I think `/etc/rc.d/mountd reload' whould be used; however, this is=
 =20
 
 Sending a HUP signal manually seems a bit silly to me now that we have
 the nice way of doing it with the rc.d script.  Being able to simply
 write /etc/rc.d/foo restart/reload is one of the things I really miss
 when using 4.X systems.
 
 Also since, for not quite as experienced people, remembering the
 difference in how to reload/restart different daemons can be hard.  At
 least I remember in my early UNIX days that I had to check the head of
 /etc/inetd.conf about how to reload it each time.
 
 Just my 0.02c.
 
 > depending on mountd_enable rc.conf setting which should be done explicitl=
 y.
 
 How about saying something like:
 
 	See the rc.d chapter for more information on controling services.
 
 Or something like that?  Then we don't have to duplicate the
 explanation about _enable=3D"YES".
 
 --=20
 Simon L. Nielsen
 
 --RnlQjJ0d97Da+TV1
 Content-Type: application/pgp-signature
 Content-Disposition: inline
 
 -----BEGIN PGP SIGNATURE-----
 Version: GnuPG v1.4.2 (FreeBSD)
 
 iD8DBQFD9xWih9pcDSc1mlERAp4pAJ4+JQyI/1a1Dvwjx18MBz5zogoxagCgroNA
 7YTzVKMdRCFLW2hLF1gXQjU=
 =RlFZ
 -----END PGP SIGNATURE-----
 
 --RnlQjJ0d97Da+TV1--

From: Ceri Davies <ceri@submonkey.net>
To: Daniel Gerzo <danger@rulez.sk>,
	<FreeBSD-gnats-submit@FreeBSD.org>
Cc:  
Subject: Re: docs/93522: [patch] use rc.d script in example describing how
 to restart mountd in nework-servers chapter
Date: Sat, 18 Feb 2006 13:02:09 +0000

 On 18/2/06 10:19, "Daniel Gerzo" <danger@rulez.sk> wrote:
 
 > +        This can be accomplished by invoking of the
 > + <filename>/etc/rc.d/mountd</filename> script:</para>
 
 That should be either "invocation of the", or "invoking the", not what
 appears above.
 
 Ceri
 -- 
 That must be wonderful!  I don't understand it at all.
                                       -- Moliere
 
 
 

From: Dmitry Morozovsky <marck@rinet.ru>
To: "Simon L. Nielsen" <simon@FreeBSD.org>
Cc: Christian Brueffer <chris@unixpages.org>, freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/93522: [patch] use rc.d script in example describing how
 to restart mountd in nework-servers chapter
Date: Sat, 18 Feb 2006 16:39:53 +0300 (MSK)

   This message is in MIME format.  The first part should be readable text,
   while the remaining parts are likely unreadable without MIME-aware tools.
 
 --0-1763247244-1140269993=:75131
 Content-Type: TEXT/PLAIN; charset=US-ASCII
 
 On Sat, 18 Feb 2006, Simon L. Nielsen wrote:
 
 SLN> > CB>  > -      <screen>&prompt.root; <userinput>kill -HUP `cat /var/run/mountd.pi=
 SLN> > CB>  d`</userinput></screen>
 SLN> > CB>  > +      <screen>&prompt.root; <userinput>/etc/rc.d/mountd restart</userinp=
 SLN> > CB>  ut></screen>
 SLN> > CB>  > =20
 SLN> > CB>  
 SLN> > CB>  Sending HUP to a process is not the same as restarting is.  In my book,
 SLN> > CB>  this specific section is fine as it is.
 SLN> > 
 SLN> > Yes. I think `/etc/rc.d/mountd reload' whould be used; however, this is 
 SLN> 
 SLN> Sending a HUP signal manually seems a bit silly to me now that we have
 SLN> the nice way of doing it with the rc.d script.  Being able to simply
 SLN> write /etc/rc.d/foo restart/reload is one of the things I really miss
 SLN> when using 4.X systems.
 SLN> 
 SLN> Also since, for not quite as experienced people, remembering the
 SLN> difference in how to reload/restart different daemons can be hard.  At
 SLN> least I remember in my early UNIX days that I had to check the head of
 SLN> /etc/inetd.conf about how to reload it each time.
 SLN> 
 SLN> Just my 0.02c.
 SLN> 
 SLN> > depending on mountd_enable rc.conf setting which should be done explicitly.
 SLN> 
 SLN> How about saying something like:
 SLN> 
 SLN> 	See the rc.d chapter for more information on controling services.
 SLN> 
 SLN> Or something like that?  Then we don't have to duplicate the
 SLN> explanation about _enable="YES".
 
 Agreed.
 
 Something like attached patch? Please fell free to reword and commit.
 
 Sincerely,
 D.Marck                                     [DM5020, MCK-RIPE, DM3-RIPN]
 ------------------------------------------------------------------------
 *** Dmitry Morozovsky --- D.Marck --- Wild Woozle --- marck@rinet.ru ***
 ------------------------------------------------------------------------
 --0-1763247244-1140269993=:75131
 Content-Type: TEXT/PLAIN; charset=US-ASCII; name=networking-servers-montd-reload.patch
 Content-Transfer-Encoding: BASE64
 Content-ID: <20060218163953.T75131@woozle.rinet.ru>
 Content-Description: 
 Content-Disposition: attachment; filename=networking-servers-montd-reload.patch
 
 SW5kZXg6IG5ldHdvcmstc2VydmVycy9jaGFwdGVyLnNnbWwNCj09PT09PT09
 PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09
 PT09PT09PT09PT09PT0NClJDUyBmaWxlOiAvaG9tZS9uY3ZzL2RvYy9lbl9V
 Uy5JU084ODU5LTEvYm9va3MvaGFuZGJvb2svbmV0d29yay1zZXJ2ZXJzL2No
 YXB0ZXIuc2dtbCx2DQpyZXRyaWV2aW5nIHJldmlzaW9uIDEuNzgNCmRpZmYg
 LXUgLXIxLjc4IGNoYXB0ZXIuc2dtbA0KLS0tIG5ldHdvcmstc2VydmVycy9j
 aGFwdGVyLnNnbWwJMTYgRmViIDIwMDYgMDk6NDQ6MDAgLTAwMDAJMS43OA0K
 KysrIG5ldHdvcmstc2VydmVycy9jaGFwdGVyLnNnbWwJMTggRmViIDIwMDYg
 MTM6Mzk6MzkgLTAwMDANCkBAIC03NzMsMTMgKzc3MywxNiBAQA0KIC9leHBv
 cnRzIC1hbGxkaXJzIC1tYXByb290PXJvb3QgICAgICBjbGllbnQwMSBjbGll
 bnQwMg0KIC9leHBvcnRzL29iaiAtcm88L3Byb2dyYW1saXN0aW5nPg0KIA0K
 LSAgICAgIDxwYXJhPllvdSBtdXN0IHJlc3RhcnQNCi0gICAgICAgIDxhcHBs
 aWNhdGlvbj5tb3VudGQ8L2FwcGxpY2F0aW9uPiB3aGVuZXZlciB5b3UgbW9k
 aWZ5DQotICAgICAgICA8ZmlsZW5hbWU+L2V0Yy9leHBvcnRzPC9maWxlbmFt
 ZT4gc28gdGhlIGNoYW5nZXMgY2FuIHRha2UgZWZmZWN0Lg0KLSAgICAgICAg
 VGhpcyBjYW4gYmUgYWNjb21wbGlzaGVkIGJ5IHNlbmRpbmcgdGhlIEhVUCBz
 aWduYWwNCi0gICAgICAgIHRvIHRoZSA8Y29tbWFuZD5tb3VudGQ8L2NvbW1h
 bmQ+IHByb2Nlc3M6PC9wYXJhPg0KKyAgICAgIDxwYXJhPllvdSBtdXN0IHNp
 Z25hbA0KKwk8YXBwbGljYXRpb24+bW91bnRkPC9hcHBsaWNhdGlvbj4gdG8g
 cmVjaGVjayBleHBvcnRzIGZpbGUgd2hlbmV2ZXIgeW91IG1vZGlmeQ0KKwk8
 ZmlsZW5hbWU+L2V0Yy9leHBvcnRzPC9maWxlbmFtZT4gc28gdGhlIGNoYW5n
 ZXMgY2FuIHRha2UgZWZmZWN0Lg0KKwlUaGlzIGNhbiBiZSBhY2NvbXBsaXNo
 ZWQgYnkgaW52b2tpbmcgPGNvbW1hbmQ+bW91bnRkPC9jb21tYW5kPg0KKwkm
 bWFuLnJjLjg7IHNjcmlwdCB3aXRoIHRoZSBhcHByb3ByaWF0ZSBwYXJhbWV0
 ZXI6PC9wYXJhPg0KIA0KLSAgICAgIDxzY3JlZW4+JnByb21wdC5yb290OyA8
 dXNlcmlucHV0PmtpbGwgLUhVUCBgY2F0IC92YXIvcnVuL21vdW50ZC5waWRg
 PC91c2VyaW5wdXQ+PC9zY3JlZW4+DQorICAgICAgPHNjcmVlbj4mcHJvbXB0
 LnJvb3Q7IDx1c2VyaW5wdXQ+L2V0Yy9yYy5kL21vdW50ZCByZWxvYWQ8L3Vz
 ZXJpbnB1dD48L3NjcmVlbj4NCisNCisgICAgICA8cGFyYT5SZWZlciB0byA8
 eHJlZiBsaW5rZW5kPSJjb25maWd0dW5pbmctcmNkIj4gZm9yIG1vcmUgaW5m
 b3JtYXRpb24NCisJb24gY29udHJvbGluZyBzZXJ2aWNlcy48L3BhcmE+DQog
 DQogICAgICAgPHBhcmE+QWx0ZXJuYXRpdmVseSwgYSByZWJvb3Qgd2lsbCBt
 YWtlIEZyZWVCU0Qgc2V0IGV2ZXJ5dGhpbmcNCiAgICAgICAgIHVwIHByb3Bl
 cmx5LiAgQSByZWJvb3QgaXMgbm90IG5lY2Vzc2FyeSB0aG91Z2guDQo=
 
 --0-1763247244-1140269993=:75131--
State-Changed-From-To: open->closed 
State-Changed-By: vanilla 
State-Changed-When: Tue Feb 21 15:11:46 UTC 2006 
State-Changed-Why:  
Committed, thanks. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=93522 
State-Changed-From-To: closed->open 
State-Changed-By: vanilla 
State-Changed-When: Tue Feb 21 15:13:32 UTC 2006 
State-Changed-Why:  
I closed the wrong pr, now open it again. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=93522 

From: Daniel Gerzo <danger@rulez.sk>
To: bug-followup@FreeBSD.org, danger@rulez.sk
Cc:  
Subject: Re: docs/93522: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter
Date: Tue, 21 Feb 2006 17:32:13 +0100

 --n8g4imXOkfNTN/H1
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: inline
 
 Hello,
 
    I hope that this is fine now ;-)
 
 -- 
 Sincerely,
    Daniel Gerzo
 
 --n8g4imXOkfNTN/H1
 Content-Type: text/plain; charset=us-ascii
 Content-Disposition: attachment; filename="rcd.diff"
 
 --- /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</programlisting>
  
 -      <para>You must restart
 -        <application>mountd</application> whenever you modify
 -        <filename>/etc/exports</filename> so the changes can take effect.
 -        This can be accomplished by sending the HUP signal
 -        to the <command>mountd</command> process:</para>
 +      <para>The <application>mountd</application> must be forced to
 +	recheck the <filename>/etc/exports</filename> file whenever it
 +	has been modified, so the changes can take effect.  This can be
 +	accomplished by invoking the <command>mountd</command>
 +	&man.rc.8; script with the appropriate parameter:</para>
  
 -      <screen>&prompt.root; <userinput>kill -HUP `cat /var/run/mountd.pid`</userinput></screen>
 +      <screen>&prompt.root; <userinput>/etc/rc.d/mountd reload</userinput></screen>
 +
 +      <para>Refer to <xref linkend="configtuning-rcd"> for more
 +	information about using rc scripts.</para>
  
        <para>Alternatively, a reboot will make FreeBSD set everything
          up properly.  A reboot is not necessary though.
 
 --n8g4imXOkfNTN/H1--
State-Changed-From-To: open->closed 
State-Changed-By: keramida 
State-Changed-When: Wed May 10 19:23:44 UTC 2006 
State-Changed-Why:  
Committed a slightly modified version of the final patch, 
which mentions both HUP signal, rc.d 'reload' option of mountd 
rc.d script and includes a pointer to linkend="configtuning-rcd". 

Thanks for the patches :) 



Responsible-Changed-From-To: freebsd-doc->keramida 
Responsible-Changed-By: keramida 
Responsible-Changed-When: Wed May 10 19:23:44 UTC 2006 
Responsible-Changed-Why:  

http://www.freebsd.org/cgi/query-pr.cgi?pr=93522 
>Unformatted:
