docs/93522: [patch] use rc.d script in example describing how to restart mountd in nework-servers chapter

[Dmitry Morozovsky]

The following reply was made to PR docs/93522; it has been noted by GNATS.

From: Dmitry Morozovsky <marck at rinet.ru>
To: "Simon L. Nielsen" <simon at FreeBSD.org>
Cc: Christian Brueffer <chris at unixpages.org>, freebsd-gnats-submit at 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 at 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 at 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--