Date: Tue, 19 Dec 2006 10:03:44 -0800 (PST) From: Jeremy Chadwick <koitsu@FreeBSD.org> To: FreeBSD-gnats-submit@FreeBSD.org Subject: docs/106926: ntp docs incorrectly document maxpoll/minpoll calculation Message-ID: <20061219180344.DBF981FA037@icarus.home.lan> Resent-Message-ID: <200612191820.kBJIKSuJ085035@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>Number: 106926 >Category: docs >Synopsis: ntp docs incorrectly document maxpoll/minpoll calculation >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Tue Dec 19 18:20:27 GMT 2006 >Closed-Date: >Last-Modified: >Originator: Jeremy Chadwick >Release: FreeBSD 6.2-PRERELEASE i386 >Organization: >Environment: System: FreeBSD icarus.home.lan 6.2-PRERELEASE FreeBSD 6.2-PRERELEASE #0: Wed Dec 13 14:55:49 PST 2006 root@icarus.home.lan:/usr/obj/usr/src/sys/ICARUS i386 >Description: ntp.conf(5) incorrectly documents the calculation used to convert the minpoll and maxpoll values into seconds. The manpage states "These options specify the minimum and maximum poll intervals for NTP messages, in seconds to the power of two", then cites examples such as the default value being 10 (thus 1024 seconds). 10^2 = 100, but 2^10 = 1024. So the documentation should really say "These options specify the minimum and maximum poll intervals for NTP messages, as a power of 2 in seconds". Other portions of the ntp.conf manpage use this wording, so let's keep it consistent (and correct :) ). >How-To-Repeat: n/a >Fix: Apply below patch. --- ntp.conf.5.orig Mon Jun 5 01:14:48 2006 +++ ntp.conf.5 Tue Dec 19 10:01:03 2006 @@ -303,7 +303,7 @@ .It Cm minpoll Ar minpoll .It Cm maxpoll Ar maxpoll These options specify the minimum and maximum poll intervals -for NTP messages, in seconds to the power of two. +for NTP messages, as a power of 2 in seconds. The maximum poll interval defaults to 10 (1,024 s), but can be increased by the .Cm maxpoll @@ -2040,7 +2040,7 @@ .It Cm minpoll Ar int .It Cm maxpoll Ar int These options specify the minimum and maximum polling interval -for reference clock messages, in seconds to the power of two. +for reference clock messages, as a power of 2 in seconds. For most directly connected reference clocks, both .Cm minpoll >Release-Note: >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20061219180344.DBF981FA037>