From owner-freebsd-doc Tue Jun 12 23:30:27 2001 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 305AF37B401 for ; Tue, 12 Jun 2001 23:30:03 -0700 (PDT) (envelope-from gnats@FreeBSD.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.3/8.11.3) id f5D6U3w36398; Tue, 12 Jun 2001 23:30:03 -0700 (PDT) (envelope-from gnats) Date: Tue, 12 Jun 2001 23:30:03 -0700 (PDT) Message-Id: <200106130630.f5D6U3w36398@freefall.freebsd.org> To: freebsd-doc@freebsd.org Cc: From: Maxim Konovalov Subject: Re: docs/28104: [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect Reply-To: Maxim Konovalov Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org The following reply was made to PR docs/28104; it has been noted by GNATS. From: Maxim Konovalov To: Dima Dorfman Cc: 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message