Date: Tue, 12 Jun 2001 23:30:03 -0700 (PDT) From: Maxim Konovalov <maxim@macomnet.ru> To: freebsd-doc@freebsd.org Subject: Re: docs/28104: [PATCH] man pages for named.reload(8) and named.restart(8) are incorrect Message-ID: <200106130630.f5D6U3w36398@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
The following reply was made to PR docs/28104; it has been noted by GNATS. 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 To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200106130630.f5D6U3w36398>