From maxim@news1.macomnet.ru  Tue Jun 12 11:41:07 2001
Return-Path: <maxim@news1.macomnet.ru>
Received: from news1.macomnet.ru (news1.macomnet.ru [195.128.64.14])
	by hub.freebsd.org (Postfix) with ESMTP id 37E7C37B405
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 12 Jun 2001 11:41:06 -0700 (PDT)
	(envelope-from maxim@news1.macomnet.ru)
Received: (from maxim@localhost)
	by news1.macomnet.ru (8.11.1/8.11.1) id f5CIf0473372;
	Tue, 12 Jun 2001 22:41:00 +0400 (MSD)
	(envelope-from maxim)
Message-Id: <200106121841.f5CIf0473372@news1.macomnet.ru>
Date: Tue, 12 Jun 2001 22:41:00 +0400 (MSD)
From: maxim@macomnet.ru
Reply-To: maxim@macomnet.ru
To: FreeBSD-gnats-submit@freebsd.org
Subject: [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect
X-Send-Pr-Version: 3.2

>Number:         28104
>Category:       docs
>Synopsis:       [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dd
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 12 11:50:04 PDT 2001
>Closed-Date:    Wed Jul 18 23:04:56 PDT 2001
>Last-Modified:  Wed Jul 18 23:05:06 PDT 2001
>Originator:     Maxim Konovalov
>Release:        FreeBSD 5.0-CURRENT i386
>Organization:
>Environment:

	FreeBSD 5.0-CURRENT
	FreeBSD 4.3-STABLE

>Description:

	named.reload(8) and named.restart(8) do not send
	any signals to named(8), but man pages claim that.

>How-To-Repeat:

	more /usr/sbin/named.reload /usr/sbin/named.restart
	man 8 ndc
	more /usr/src/contrib/bind/bin/ndc/ndc.c
	man 8 named.reload
	man 8 named.restart

>Fix:

--- named.reload.8.orig	Tue Jun 12 21:32:27 2001
+++ named.reload.8	Tue Jun 12 22:09:46 2001
@@ -61,16 +61,10 @@
 .Nm @INDOT@named.reload
 .Nd "cause the name server to synchronize its database"
 .Sh DESCRIPTION
-This command sends a
-.Dv SIGHUP
-to the running name server.
-This
-signal is documented in
-.Xr named @SYS_OPS_EXT@ .
-.Sh BUGS
-Does not check to see if the name server is actually running, and could
-use a stale PID cache file which may result in the death of an unrelated
-process.
+This command runs
+.Xr ndc
+which reloads the running name server.
 .Sh SEE ALSO
 .Xr @INDOT@named @SYS_OPS_EXT@ ,
-.Xr @INDOT@named.restart @SYS_OPS_EXT@
+.Xr @INDOT@named.restart @SYS_OPS_EXT@ ,
+.Xr @INDOT@ndc @SYS_OPS_EXT@

--- named.restart.8.orig	Tue Jun 12 21:32:05 2001
+++ named.restart.8	Tue Jun 12 22:09:58 2001
@@ -61,20 +61,17 @@
 .Nm @INDOT@named.restart
 .Nd "stop and restart the name server"
 .Sh DESCRIPTION
-This command sends a
-.Dv SIGKILL
-to the running name server and then
-starts a new one with the command line options specified in
+This command runs 
+.Xr ndc
+which restarts the running name server with the command line options
+specified in
 .Xr rc.conf 5 .
 .Sh BUGS
-Does not check to see if the name server is actually running, and could
-use a stale PID cache file which may result in the death of an unrelated
-process.
-.Pp
 Does not wait after killing the old server before starting a new one; since
 the server could take some time to die and the new one will experience a
 fatal error if the old one isn't gone by the time it starts, you can be left
 in a situation where you have no name server at all.
 .Sh SEE ALSO
 .Xr @INDOT@named @SYS_OPS_EXT@ ,
-.Xr @INDOT@named.reload @SYS_OPS_EXT@
+.Xr @INDOT@named.reload @SYS_OPS_EXT@ ,
+.Xr @INDOT@ndc @SYS_OPS_EXT@
>Release-Note:
>Audit-Trail:

From: Dima Dorfman <dima@unixfreak.org>
To: maxim@macomnet.ru
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/28104: [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect 
Date: Tue, 12 Jun 2001 17:20:57 -0700

 maxim@macomnet.ru writes:
 > --- named.reload.8.orig	Tue Jun 12 21:32:27 2001
 > +++ named.reload.8	Tue Jun 12 22:09:46 2001
 > @@ -61,16 +61,10 @@
 ...
 > +This command runs
 > +.Xr ndc
  ^^^^^^^^^^
 Did you actually look at the output?  Did it look right?  The .Xr
 macro takes two arguments, the name and the section of the manual
 page.  It's used correctly in the SEE ALSO section:
 
 >  .Sh SEE ALSO
 >  .Xr @INDOT@named @SYS_OPS_EXT@ ,
 > -.Xr @INDOT@named.restart @SYS_OPS_EXT@
 > +.Xr @INDOT@named.restart @SYS_OPS_EXT@ ,
 > +.Xr @INDOT@ndc @SYS_OPS_EXT@
 > 
 > --- named.restart.8.orig	Tue Jun 12 21:32:05 2001
 > +++ named.restart.8	Tue Jun 12 22:09:58 2001
 
 Same applies here.

From: Maxim Konovalov <maxim@macomnet.ru>
To: Dima Dorfman <dima@unixfreak.org>
Cc: <FreeBSD-gnats-submit@freebsd.org>
Subject: Re: docs/28104: [PATCH] man pages for named.reload(8) and named.restart(8)
 are incorrect 
Date: Wed, 13 Jun 2001 10:27:16 +0400 (MSD)

 On Tue, 12 Jun 2001, Dima Dorfman wrote:
 
 > maxim@macomnet.ru writes:
 > > --- named.reload.8.orig	Tue Jun 12 21:32:27 2001
 > > +++ named.reload.8	Tue Jun 12 22:09:46 2001
 > > @@ -61,16 +61,10 @@
 > ...
 > > +This command runs
 > > +.Xr ndc
 >  ^^^^^^^^^^
 > Did you actually look at the output?  Did it look right?  The .Xr
 > macro takes two arguments, the name and the section of the manual
 > page.  It's used correctly in the SEE ALSO section:
 >
 > >  .Sh SEE ALSO
 > >  .Xr @INDOT@named @SYS_OPS_EXT@ ,
 > > -.Xr @INDOT@named.restart @SYS_OPS_EXT@
 > > +.Xr @INDOT@named.restart @SYS_OPS_EXT@ ,
 > > +.Xr @INDOT@ndc @SYS_OPS_EXT@
 > >
 > > --- named.restart.8.orig	Tue Jun 12 21:32:05 2001
 > > +++ named.restart.8	Tue Jun 12 22:09:58 2001
 >
 > Same applies here.
 
 How about this one?
 
 --- named.reload.8.orig	Tue Jun 12 21:32:27 2001
 +++ named.reload.8	Tue Jun 12 22:09:46 2001
 @@ -61,16 +61,10 @@
  .Nm @INDOT@named.reload
  .Nd "cause the name server to synchronize its database"
  .Sh DESCRIPTION
 -This command sends a
 -.Dv SIGHUP
 -to the running name server.
 -This
 -signal is documented in
 -.Xr named @SYS_OPS_EXT@ .
 -.Sh BUGS
 -Does not check to see if the name server is actually running, and could
 -use a stale PID cache file which may result in the death of an unrelated
 -process.
 +This command runs
 +.Xr ndc @SYS_OPS_EXT@
 +which reloads the running name server.
  .Sh SEE ALSO
  .Xr @INDOT@named @SYS_OPS_EXT@ ,
 -.Xr @INDOT@named.restart @SYS_OPS_EXT@
 +.Xr @INDOT@named.restart @SYS_OPS_EXT@ ,
 +.Xr @INDOT@ndc @SYS_OPS_EXT@
 
 --- named.restart.8.orig	Tue Jun 12 21:32:05 2001
 +++ named.restart.8	Tue Jun 12 22:09:58 2001
 @@ -61,20 +61,17 @@
  .Nm @INDOT@named.restart
  .Nd "stop and restart the name server"
  .Sh DESCRIPTION
 -This command sends a
 -.Dv SIGKILL
 -to the running name server and then
 -starts a new one with the command line options specified in
 +This command runs
 +.Xr ndc @SYS_OPS_EXT@
 +which restarts the running name server with the command line options
 +specified in
  .Xr rc.conf 5 .
  .Sh BUGS
 -Does not check to see if the name server is actually running, and could
 -use a stale PID cache file which may result in the death of an unrelated
 -process.
 -.Pp
  Does not wait after killing the old server before starting a new one; since
  the server could take some time to die and the new one will experience a
  fatal error if the old one isn't gone by the time it starts, you can be left
  in a situation where you have no name server at all.
  .Sh SEE ALSO
  .Xr @INDOT@named @SYS_OPS_EXT@ ,
 -.Xr @INDOT@named.reload @SYS_OPS_EXT@
 +.Xr @INDOT@named.reload @SYS_OPS_EXT@ ,
 +.Xr @INDOT@ndc @SYS_OPS_EXT@
 
 -- 
 Maxim Konovalov, MAcomnet, Internet-Intranet Dept., system engineer
 phone: +7 (095) 796-9079, mailto: maxim@macomnet.ru
 
State-Changed-From-To: open->analyzed 
State-Changed-By: dd 
State-Changed-When: Wed Jun 13 21:28:50 PDT 2001 
State-Changed-Why:  
Committed, thanks! 


Responsible-Changed-From-To: freebsd-doc->dd 
Responsible-Changed-By: dd 
Responsible-Changed-When: Wed Jun 13 21:28:50 PDT 2001 
Responsible-Changed-Why:  
My MFC reminder. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=28104 
State-Changed-From-To: analyzed->closed 
State-Changed-By: dd 
State-Changed-When: Wed Jul 18 23:04:56 PDT 2001 
State-Changed-Why:  
MFC'd by kris, thanks. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=28104 
>Unformatted:
