From owner-freebsd-doc@FreeBSD.ORG Tue Oct 17 12:50:24 2006 Return-Path: X-Original-To: freebsd-doc@hub.freebsd.org Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C6D2116A501 for ; Tue, 17 Oct 2006 12:50:24 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id CE31243D58 for ; Tue, 17 Oct 2006 12:50:22 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.4/8.13.4) with ESMTP id k9HCoMgQ071723 for ; Tue, 17 Oct 2006 12:50:22 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.4/8.13.4/Submit) id k9HCoMjN071722; Tue, 17 Oct 2006 12:50:22 GMT (envelope-from gnats) Resent-Date: Tue, 17 Oct 2006 12:50:22 GMT Resent-Message-Id: <200610171250.k9HCoMjN071722@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Watanabe Kazuhiro Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 0106416A4CA for ; Tue, 17 Oct 2006 12:40:25 +0000 (UTC) (envelope-from CQG00620@nifty.ne.jp) Received: from mail.asahi-net.or.jp (mail1.asahi-net.or.jp [202.224.39.197]) by mx1.FreeBSD.org (Postfix) with ESMTP id 82E1143D68 for ; Tue, 17 Oct 2006 12:40:19 +0000 (GMT) (envelope-from CQG00620@nifty.ne.jp) Received: from asahi-net.jp (l204142.ppp.asahi-net.or.jp [218.219.204.142]) by mail.asahi-net.or.jp (Postfix) with ESMTP id 93D9B18F9D for ; Tue, 17 Oct 2006 21:40:17 +0900 (JST) Message-Id: <20061017124017.93D9B18F9D@mail.asahi-net.or.jp> Date: Tue, 17 Oct 2006 21:40:17 +0900 From: Watanabe Kazuhiro To: FreeBSD-gnats-submit@FreeBSD.org Cc: Subject: docs/104493: [patch] Wrong description in ntp.conf(5) (CURRENT and 6.2-BETA2) X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list Reply-To: Watanabe Kazuhiro List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Oct 2006 12:50:24 -0000 >Number: 104493 >Category: docs >Synopsis: [patch] Wrong description in ntp.conf(5) (CURRENT and 6.2-BETA2) >Confidential: no >Severity: non-critical >Priority: medium >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Oct 17 12:50:22 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Watanabe Kazuhiro >Release: FreeBSD 7.0-CURRENT i386 >Organization: =09 >Environment: System: FreeBSD scorpio.zodiac.org 7.0-CURRENT FreeBSD 7.0-CURRENT #26: Mon= Oct 16 15:11:12 JST 2006 nabe@scorpio.zodiac.org:/FreeBSD/obj-current/Free= BSD/FreeBSD-current/src/sys/GENERIC i386 There is the same problem on 6.2-BETA2. >Description: In ntp.conf(5), there is a wrong description: allan allan The argument becomes the new value for the minimum Allan intercept, which is a parameter of the PLL/FLL clock dis- cipline algorithm. The value in log2 seconds defaults to 7 (1024 s), which is also the lower limit. Yes. log2(1024) is not 7, but 10. There is also the same description in /usr/share/doc/ntp/miscopt.html, and they have been obsoleted. =46rom ntp-4.2.0 (currently contributed in FreeBSD) and later, this variable "allan" is set a real number (not an exponential number) and defaults to 1500. The default value is defined in src/contrib/ntp/ntpd/ntp_loopfilter.c. The old version (ntp-4.1.2) was: #define CLOCK_ALLAN 10 /* min Allan intercept (log2 s) */ and the recent version (ntp-4.2.0 and later) is: #define CLOCK_ALLAN 1500. /* compromise Allan intercept (s) */ The description has fixed in ntp-4.2.2: allan allan The argument becomes the new value for the Allan intercept, which is a parameter of the PLL/FLL clock discipline algorithm. The value is in seconds with default 1500 s, which is appropriate for most computer clocks. >How-To-Repeat: man ntp.conf >Fix: Here is a patch for CURRENT. --- contrib/ntp/html/miscopt.html.orig Wed Jul 21 00:01:05 2004 +++ contrib/ntp/html/miscopt.html Tue Oct 17 00:34:27 2006 @@ -64,7 +64,7 @@

The variables operate as follows:

allan allan -
The argument becomes the new value for the minimum All= an intercept, which is a parameter of the PLL/FLL clock discipline algorith= m. The value in log2 seconds defaults to 7 (1024 s), which is also the lowe= r limit. +
The argument becomes the new value for the Allan inter= cept, which is a parameter of the PLL/FLL clock discipline algorithm. The v= alue is in seconds with default 1500 s, which is appropriate for most comp= uter clocks.
dispersion dispersion
The argument becomes the new value for the dispersion = increase rate, normally .000015 s/s.
freq freq --- usr.sbin/ntp/doc/ntp.conf.5.orig Mon Oct 16 11:29:06 2006 +++ usr.sbin/ntp/doc/ntp.conf.5 Tue Oct 17 00:31:48 2006 @@ -2600,11 +2600,11 @@ The variables operate as follows: .Bl -tag -width indent .It Cm allan Ar allan -The argument becomes the new value for the minimum Allan +The argument becomes the new value for the Allan intercept, which is a parameter of the PLL/FLL clock discipline algorithm. -The value in log2 seconds defaults to 7 (1024 s), which is also the lower -limit. +The value is in seconds with default 1500 s, which is appropriate +for most computer clocks. .It Cm dispersion Ar dispersion The argument becomes the new value for the dispersion increase rate, normally .000015 s/s. >Release-Note: >Audit-Trail: >Unformatted: