Skip site navigation (1)Skip section navigation (2)
Date:      Tue, 12 Jun 2001 22:41:00 +0400 (MSD)
From:      maxim@macomnet.ru
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/28104: [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect
Message-ID:  <200106121841.f5CIf0473372@news1.macomnet.ru>

index | next in thread | raw e-mail


>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:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 12 11:50:04 PDT 2001
>Closed-Date:
>Last-Modified:
>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:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message



home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200106121841.f5CIf0473372>