[ntp:bk-ntp-dev-send] BitKeeper diffs

Harlan Stenn stenn at whimsy.udel.edu
Tue Feb 9 08:37:47 UTC 2010


#### ChangeSet ####
2010-02-09 02:49:34-05:00, stenn at whimsy.udel.edu 
  [Bug 1140] Clean up debug.html, decode.html, and ntpq.html

==== ChangeLog ====
2010-02-09 02:49:18-05:00, stenn at whimsy.udel.edu +1 -0
  [Bug 1140] Clean up debug.html, decode.html, and ntpq.html

--- 1.496.26.39/ChangeLog	2010-02-05 17:26:32 -05:00
+++ 1.496.41.1/ChangeLog	2010-02-09 02:49:18 -05:00
@@ -1,5 +1,6 @@
 ---
 
+* [Bug 1140] Clean up debug.html, decode.html, and ntpq.html.
 * [Bug 1477] 1st non-gmake make in clone w/VPATH can't make COPYRIGHT.
 * [Bug 1480] snprintf() cleanup caused unterminated refclock IDs.
 

==== html/debug.html ====
2010-02-09 02:49:18-05:00, stenn at whimsy.udel.edu +3 -3
  [Bug 1140] Clean up debug.html, decode.html, and ntpq.html

--- 1.27/html/debug.html	2009-07-25 21:46:54 -04:00
+++ 1.27.1.1/html/debug.html	2010-02-09 02:49:18 -05:00
@@ -43,8 +43,8 @@
 			the DNS name or IP address for each association along with selected status
 			and statistics variables. The first character in each line is the tally code,
 			which shows which associations are candidates to set the system clock and
-			of these which one is the system peer. The encoding is shown in the source
-			field of the <a href="decode.html#sys">system status word</a>.</p>
+			of these which one is the system peer. The encoding is shown in the <tt>select</tt>
+			field of the <a href="decode.html#peer">peer status word</a>.</p>
 		<p>The <a href="ntpq.html#as"><tt>as</tt></a> command displays a list of associations and association identifiers. Note the <tt>condition</tt> column, which reflects the tally code. The <a href="ntpq.html#pe"><tt>rv</tt></a> command displays the <a href="ntpq.html#system">system variables</a> billboard, including the <a href="decode.html#sys">system status word</a>. The <a href="ntpq.html#rv"><tt>rv <i>assocID</i></tt></a> command, where <tt><i>assocID</i></tt> is the association ID, displays the <a href="ntpq.html#peer">peer variables</a> billboard, including the <a href="decode.html#peer">peer status word</a>. Note that, except for explicit calendar dates, times are in milliseconds and frequencies are in parts-per-million (PPM).</p>
 		<p>A detailed explanation of the system, peer and clock variables in the billboards is beyond the scope of this page; however, a comprehensive explanation for each one is in the NTPv4 protocol specification. The following observations will be useful in debugging and monitoring.</p>
 		<ol>
@@ -85,7 +85,7 @@
 			<li>Verify using <tt>ping</tt> or other utility that packets actually do make the round trip between the client and server. Verify using <tt>nslookup</tt> or other utility that the DNS server names do exist and resolve to valid Internet addresses.
 			<li>Check that the remote NTP server is up and running. The usual evidence that it is not is a <tt>Connection refused</tt> message.
 			<li>Using the <tt>ntpdc</tt> program, verify that the packets received and packets sent counters are incrementing. If the sent counter does not increment and the configuration file includes configured servers, something may be wrong in the host network or interface configuration. If this counter does increment, but the received counter does not increment, something may be wrong in the network or the server NTP daemon may not be running or the server itself may be down or not responding.
-			<li>If both the sent and received counters do increment, but the <tt>reach</tt> values in the <tt>pe</tt> billboard with <tt>ntpq</tt> continues to show zero, received packets are probably being discarded for some reason. If this is the case, the cause should be evident from the <tt>flash</tt> variable as discussed above and on the <tt>ntpq</tt> page. It could be that the server has disabled access for the client address, in which case the refid field in the <tt>ntpq pe</tt> billboard will show a kiss code. See earlier on this page for a list of kiss codes and their meaning.
+			<li>If both the sent and received counters do increment, but the <tt>reach</tt> values in the <tt>pe</tt> billboard with <tt>ntpq</tt> continues to show zero, received packets are probably being discarded for some reason. If this is the case, the cause should be evident from the <tt>flash</tt> variable as discussed above and on the <tt>ntpq</tt> page. It could be that the server has disabled access for the client address, in which case the <tt>refid</tt> field in the <tt>ntpq pe</tt> billboard will show a kiss code. See earlier on this page for a list of kiss codes and their meaning.
 			<li>If the <tt>reach</tt> values in the <tt>pe</tt> billboard show the servers are alive and responding, note the tattletale symbols at the left margin, which indicate the status of each server resulting from the various grooming and mitigation algorithms. The interpretation of these symbols is discussed on the <tt>ntpq</tt> page. After a few minutes of operation, one or another of the reachable server candidates should show a * tattletale symbol. If this doesn't happen, the intersection algorithm, which classifies the servers as truechimers or falsetickers, may be unable to find a majority of truechimers among the server population.
 			<li>If all else fails, see the FAQ and/or the discussion and briefings at the NTP Project page.
 		</ol>

==== html/decode.html ====
2010-02-09 02:49:19-05:00, stenn at whimsy.udel.edu +11 -7
  [Bug 1140] Clean up debug.html, decode.html, and ntpq.html

--- 1.11/html/decode.html	2009-09-28 22:35:45 -04:00
+++ 1.11.1.1/html/decode.html	2010-02-09 02:49:19 -05:00
@@ -3,7 +3,7 @@
 	<head>
 <meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
 <meta name="generator" content="HTML Tidy, see www.w3.org">
-<title>ntpd System Log Messages</title>
+<title>ntpd Event Messages and Status Words</title>
 <link href="scripts/style.css" type="text/css" rel="stylesheet">
 </head>
 <body>
@@ -173,7 +173,9 @@ UTC</p>
 
 </table>
 
-<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored. The Event Field displays the most recent event message coded as follows:</p>
+<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored.</p>
+
+<p>The Event Field displays the most recent event message coded as follows:</p>
 
 <table width="100%" border="1" cellspacing="2" cellpadding="2">
 
@@ -288,7 +290,7 @@ UTC</p>
 
 <h4 id="peer">Peer Status Word</h4>
 
-<p>The peer status word consists of four fields: Status (0-4, Select (5-7), Count (8-11) and Code (12-15). It is reported in the first line of the <tt>rv <i>associd</i></tt> display produced by the <tt>ntpq</tt> program.</p>
+<p>The peer status word consists of four fields: Status (0-4), Select (5-7), Count (8-11) and Code (12-15). It is reported in the first line of the <tt>rv <i>associd</i></tt> display produced by the <tt>ntpq</tt> program.</p>
 
 <table width="50%" border="1" cellspacing="2" cellpadding="2">
 
@@ -301,7 +303,7 @@ UTC</p>
 
 </table>
 
-<p>The Status Field displays the peer status code bits in hexadecimal as follows:</p>
+<p>The Status Field displays the peer status code bits in hexadecimal; each bit is an independent flag.  (Note this field is 5 bits wide, and combines with the the 3-bit-wide Select Field to create the first full byte of the peer status word.)  The meaning of each bit in the Status Field is listed in the following table:</p>
 
 <table width="100%" border="1" cellspacing="2" cellpadding="2">
 
@@ -343,7 +345,7 @@ UTC</p>
 
 </table>
 
-<p>The Select Field displays the current selection. status The T Field displays the tally codes beginning the <tt>ntpq peers</tt> display. The values are coded as follows:</p>
+<p>The Select Field displays the current selection status. (The T Field in the following table gives the corresponding tally codes used in the <tt>ntpq peers</tt> display.) The values are coded as follows:</p>
 
 <table width="100%" border="1" cellspacing="2" cellpadding="2">
 
@@ -357,7 +359,7 @@ UTC</p>
 <tr>
 <td><tt>0</tt></td>
 <td><tt>sel_reject</tt></td>
-<td></td>
+<td>&nbsp;</td>
 <td>discarded as not valid (TEST10-TEST13)</td>
 </tr>
 
@@ -412,7 +414,9 @@ UTC</p>
 
 </table>
 
-<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored. The Event Field displays the most recent event message coded as follows:</p>
+<p>The Count Field displays the number of events since the last time the code changed. Upon reaching 15, subsequent events with the same code are ignored. </p>
+
+<p>The Event Field displays the most recent event message coded as follows:</p>
 
 <table width="100%" border="1" cellspacing="2" cellpadding="2">
 

==== html/ntpq.html ====
2010-02-09 02:49:19-05:00, stenn at whimsy.udel.edu +11 -7
  [Bug 1140] Clean up debug.html, decode.html, and ntpq.html

--- 1.36/html/ntpq.html	2009-11-04 14:48:07 -05:00
+++ 1.36.1.1/html/ntpq.html	2010-02-09 02:49:19 -05:00
@@ -122,15 +122,15 @@
 					</tr>
 					<tr>
 						<td><tt>condition</tt></td>
-						<td>source (see <a href="decode.html#peer">peer status word</a>)</td>
+						<td>selection status (see the <tt>select</tt> field of the <a href="decode.html#peer">peer status word</a>)</td>
 					</tr>
 					<tr>
 						<td><tt>last_event</tt></td>
-						<td>event report (see <a href="decode.html#peer">peer status word</a>)</td>
+						<td>event report (see the <tt>event</tt> field of the <a href="decode.html#peer">peer status word</a>)</td>
 					</tr>
 					<tr>
 						<td><tt>cnt</tt></td>
-						<td>event count (see <a href="decode.html#peer">peer status word</a>)</td>
+						<td>event count (see the <tt>count</tt> field of the <a href="decode.html#peer">peer status word</a>)</td>
 					</tr>
 				</table>
 			</dd>
@@ -153,8 +153,8 @@
 			<dt><tt>passwd</tt></dt>
 			<dd>Specify the password to use for write requests.</dd>
 			<dt id="pe"><tt>peers</tt></dt>
-			<dd>Display a list of associations in the form</dd>
-			<dd><tt>ind assid status conf reach auth condition last_event cnt</tt></dd>
+			<dd>Display a list of peers in the form</dd>
+			<dd><tt>[tally]remote refid st t when pool reach delay offset jitter</tt></dd>
 			<dd>
 				<table width="100%" border="1" cellspacing="2" cellpadding="2">
 					<tr>
@@ -162,8 +162,12 @@
 						<td>Description</td>
 					</tr>
 					<tr>
+						<td><tt>[tally]</tt></td>
+						<td>single-character code indicating current value of the <tt>select</tt> field of the <a href="decode.html#peer">peer status word</a></td>
+					</tr>
+					<tr>
 						<td><tt>remote</tt></td>
-						<td>index on this list</td>
+						<td>host name (or IP number) of peer</td>
 					</tr>
 					<tr>
 						<td><tt>refid</tt></td>
@@ -171,7 +175,7 @@
 					</tr>
 					<tr>
 						<td><tt>st</tt></td>
-						<td><a href="decode.html#peer">peer status word</a></td>
+						<td>stratum</td>
 					</tr>
 					<tr>
 						<td><tt>t</tt></td>


More information about the bk-ntp-dev-send mailing list