fix ntptrace man page

[John Hay]

On Tue, Aug 25, 2009 at 04:44:32PM +0200, Oliver Pinter wrote:
> On 8/25/09, Oliver Pinter <oliver.pntr at gmail.com> wrote:
> > funny, in /usr/src/usr.sbin/ntp/scripts/ntptrace implemented only the -n
> > switch
> >
> >
> > On 8/25/09, Gavin Atkinson <gavin.atkinson at ury.york.ac.uk> wrote:
> >> On Tue, 2009-08-25 at 04:58 +0200, Oliver Pinter wrote:
> >>> Hi all!
> >>>
> >>> It's a small fix to ntpdate man page for freebsd 7-stable.
> >>
> >> I was looking at this a few days ago.  The problem is not that the man
> >> page is wrong, it's that the man page documents an entirely different
> >> tool.  For some reason, FreeBSD provides it's own version of ntptrace
> >> which lacks anything but the basic functionality, whereas the man page
> >> installed is that of the ntptrace tool as supplied in the ntpd
> >> distribution.  It would seem much more sensible to use the official
> >> ntptrace and retain all the functionality people expoect from ntptrace,
> >> although I haven't yet found time to get to the bottom of why this was
> >> switched over from the official code in the first place.
> the ntpd code is under the contrib dir, but the ntptrace script is
> freebsds own script

This is not true. The script comes with ntpd. The old version of
ntptrace was replaced (in the ntpd tree) when ipv6 support was added.
The reason was that the old version assumed that the refid field
was an ip address. This was never part of the spec and was not true
in a mixed ipv4/ipv6 setup. (Just because you use ipv4 to get to
ntp server A, does not mean that it used ipv4 to sync from its
upstream server.)

The ntptrace html/man docs was just not updated.

John
-- 
John Hay -- jhay at meraka.csir.co.za / jhay at FreeBSD.org