From chris@leviathan.houseness.org  Thu Oct 16 09:51:54 2003
Return-Path: <chris@leviathan.houseness.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id B44B216A4B3
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 16 Oct 2003 09:51:54 -0700 (PDT)
Received: from leviathan.houseness.org (64-121-34-194.c3-0.rdwd-ubr2.sfrn-rdwd.ca.cable.rcn.com [64.121.34.194])
	by mx1.FreeBSD.org (Postfix) with ESMTP id EFA3243FCB
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 16 Oct 2003 09:51:51 -0700 (PDT)
	(envelope-from chris@leviathan.houseness.org)
Received: from leviathan.houseness.org (localhost [127.0.0.1])
	by leviathan.houseness.org (8.12.9p2/8.12.9) with ESMTP id h9GGpp6w050330
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 16 Oct 2003 09:51:51 -0700 (PDT)
	(envelope-from chris@leviathan.houseness.org)
Received: (from root@localhost)
	by leviathan.houseness.org (8.12.9p2/8.12.9/Submit) id h9GGppl3050329;
	Thu, 16 Oct 2003 09:51:51 -0700 (PDT)
	(envelope-from chris)
Message-Id: <200310161651.h9GGppl3050329@leviathan.houseness.org>
Date: Thu, 16 Oct 2003 09:51:51 -0700 (PDT)
From: Chris <chris-gnats33@randomcamel.net>
Reply-To: Chris <chris-gnats33@randomcamel.net>
To: FreeBSD-gnats-submit@freebsd.org
Cc:
Subject: ntpdate documented as obsolete, and shouldn't be.
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         58134
>Category:       misc
>Synopsis:       ntpdate documented as obsolete, and shouldn't be.
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Oct 16 10:00:34 PDT 2003
>Closed-Date:    Sun May 30 09:00:28 PDT 2004
>Last-Modified:  Sun May 30 09:00:28 PDT 2004
>Originator:     Chris
>Release:        FreeBSD 4.9-PRERELEASE i386
>Organization:
>Environment:
System: FreeBSD leviathan.houseness.org 4.9-PRERELEASE FreeBSD 4.9-PRERELEASE #20: Sun Sep 28 10:30:19 PDT 2003 root@leviathan.houseness.org:/usr/obj/usr/src/sys/LEVIATHAN i386


        ntpdate, ntpd on -STABLE, going back several years.

>Description:

        the ntpdate(8) manpage claims:

        DESCRIPTION
             Note: The functionality of this program is now
             available in the ntpd(8) program.  See the -q command line
             option in the ntpd(8) page.  After a suitable period of
             mourning, the ntpdate utility is to be retired from this
             distribution.

        and the ntpd(8) manpage claims:

        -q  Exit the ntpd just after the first time the clock is set.
            This behavior mimics that of the ntpdate(8) program, which is
            to be retired.  The -g and -x options can be used with this
            option.

        however, ntpd -q has never seemed to work properly, just hanging
        even with an ntp.conf with valid servers. on top of that, ntpdate
        seems to be standard everywhere else (NetBSD and Linux sysadmins
        have never heard of -q), so removing it would violate POLA for
        anyone moving scripts to FreeBSD from other OSen.
                  
>How-To-Repeat:
        read manpages, try running ntpd -q.
>Fix:

        I'd suggest fixing the manpages and forgetting anyone ever planned
        to obsolete ntpdate, whether this involves emailing the ntp
        maintainers or not. the current manpages are confusing and
        apparently inaccurate.


>Release-Note:
>Audit-Trail:

From: John Hay <jhay@icomtek.csir.co.za>
To: Chris <chris-gnats33@randomcamel.net>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: misc/58134: ntpdate documented as obsolete, and shouldn't be.
Date: Thu, 16 Oct 2003 19:55:00 +0200

 >         the ntpdate(8) manpage claims:
 > 
 >         DESCRIPTION
 >              Note: The functionality of this program is now
 >              available in the ntpd(8) program.  See the -q command line
 >              option in the ntpd(8) page.  After a suitable period of
 >              mourning, the ntpdate utility is to be retired from this
 >              distribution.
 > 
 >         and the ntpd(8) manpage claims:
 > 
 >         -q  Exit the ntpd just after the first time the clock is set.
 >             This behavior mimics that of the ntpdate(8) program, which is
 >             to be retired.  The -g and -x options can be used with this
 >             option.
 > 
 >         however, ntpd -q has never seemed to work properly, just hanging
 >         even with an ntp.conf with valid servers. on top of that, ntpdate
 >         seems to be standard everywhere else (NetBSD and Linux sysadmins
 >         have never heard of -q), so removing it would violate POLA for
 >         anyone moving scripts to FreeBSD from other OSen.
 >                   
 > >How-To-Repeat:
 >         read manpages, try running ntpd -q.
 > >Fix:
 > 
 >         I'd suggest fixing the manpages and forgetting anyone ever planned
 >         to obsolete ntpdate, whether this involves emailing the ntp
 >         maintainers or not. the current manpages are confusing and
 >         apparently inaccurate.
 
 Remember that the official ntp docs are only available in html format.
 It is converted from that to man pages for your convenience. If you
 look at the official pages (which are a little newer than our man pages),
 don't you think it closely reflects that?
 
 http://www.eecis.udel.edu/~mills/ntp/html/ntpdate.html
 
 The fact that NetBSD and Linux hasn't heard of the -q option, is not a
 reflection on FreeBSD, just get them to upgrade their ntp. :-)
 
 I think if you really want something in ntp to change, the place to
 lobby it is with the ntp people.
 
 John
 -- 
 John Hay -- John.Hay@icomtek.csir.co.za / jhay@FreeBSD.org
State-Changed-From-To: open->closed 
State-Changed-By: dwmalone 
State-Changed-When: Sun May 30 08:58:44 PDT 2004 
State-Changed-Why:  
Close this PR - as John points out, the man page really just reflects 
the thinking of the NTP developers. 

David. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=58134 
>Unformatted:
