xref: /freebsd/contrib/ntp/html/drivers/driver1.html (revision 416ba5c74546f32a993436a99516d35008e9f384)
19c2daa00SOllivier Robert<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
29c2daa00SOllivier Robert<html>
39c2daa00SOllivier Robert<head>
4ea906c41SOllivier Robert<meta http-equiv="content-type" content="text/html;charset=iso-8859-1">
59c2daa00SOllivier Robert<meta name="generator" content="HTML Tidy, see www.w3.org">
69c2daa00SOllivier Robert<title>Undisciplined Local Clock</title>
7ea906c41SOllivier Robert<link href="scripts/style.css" type="text/css" rel="stylesheet">
89c2daa00SOllivier Robert</head>
99c2daa00SOllivier Robert<body>
109c2daa00SOllivier Robert<h3>Undisciplined Local Clock</h3>
11*2b15cb3dSCy Schubert<p>Author: David L. Mills (mills@udel.edu)<br>
12*2b15cb3dSCy SchubertLast update:
13*2b15cb3dSCy Schubert  <!-- #BeginDate format:En2m -->9-May-2014  08:34<!-- #EndDate -->
14*2b15cb3dSCy Schubert  UTC</p>
159c2daa00SOllivier Robert<hr>
169c2daa00SOllivier Robert<h4>Synopsis</h4>
179c2daa00SOllivier Robert<p>Address: 127.127.1.<i>u</i><br>
18*2b15cb3dSCy Schubert  Reference ID: <tt>LOCL</tt><br>
199c2daa00SOllivier Robert  Driver ID: <tt>LOCAL</tt></p>
209c2daa00SOllivier Robert<h4>Description</h4>
21*2b15cb3dSCy Schubert<p>Note: <strong>We recommend against using this driver.</strong> A much more flexible replacement is described on the <a href="../orphan.html">Orphan Mode</a> page.</p>
22*2b15cb3dSCy Schubert<p>This driver was intended for use in an isolated network where no external source of synchronization such as a radio clock or modem is available. It allows a designated time server to act as a primary server to provide synchronization to other clients on the network. Pick a machine that has a good clock oscillator and configure it with this driver. Set the clock using the best means available, like eyeball-and-wristwatch. Then, point all the other machines at this one or use broadcast mode to distribute time.</p>
23*2b15cb3dSCy Schubert<p>Another application for this driver is if a particular server clock is to be used as the clock of last resort when all other normal synchronization sources have gone away. This is especially useful if that server has an ovenized oscillator. For this you would usually, but not necessarily, configure this driver at a stratum greater than any other likely sources of time, such as the default 5 for this driver, to prevent this driver taking over when legitimate sources elsewhere in the network are  available. To further protect the Internet infrastructure from accidental or malicious exposure to this driver, the driver is disabled if another source is available and operating.</p>
249c2daa00SOllivier Robert<h4>Monitor Data</h4>
259c2daa00SOllivier Robert<p>No <tt>filegen clockstats</tt> monitor data are produced by this driver.</p>
269c2daa00SOllivier Robert<h4>Fudge Factors</h4>
279c2daa00SOllivier Robert<dl>
28*2b15cb3dSCy Schubert  <dt><tt>time1 <i>time</i></tt></dt>
29*2b15cb3dSCy Schubert  <dd>Specifies the time offset calibration factor, in seconds and fraction, with default 0.0.</dd>
30*2b15cb3dSCy Schubert  <dt><tt>time2 <i>time</i></tt></dt>
31*2b15cb3dSCy Schubert  <dd>Specifies the frequency offset calibration factor, in parts per million, with default 0.0.</dd>
32*2b15cb3dSCy Schubert  <dt><tt>stratum <i>number</i></tt></dt>
33*2b15cb3dSCy Schubert  <dd>Specifies the driver stratum, in decimal from 0 to 15, with default 5.</dd>
34*2b15cb3dSCy Schubert  <dt><tt>refid <i>string</i></tt></dt>
35*2b15cb3dSCy Schubert  <dd>Specifies the driver reference identifier, an ASCII string from one to four characters, with default <tt>LOCL</tt>.</dd>
36*2b15cb3dSCy Schubert  <dt><tt>flag1 0 | 1</tt></dt>
37*2b15cb3dSCy Schubert  <dd>Not used by this driver.</dd>
38*2b15cb3dSCy Schubert  <dt><tt>flag2 0 | 1</tt></dt>
39*2b15cb3dSCy Schubert  <dd>Not used by this driver.</dd>
40*2b15cb3dSCy Schubert  <dt><tt>flag3 0 | 1</tt></dt>
41*2b15cb3dSCy Schubert  <dd>Not used by this driver.</dd>
42*2b15cb3dSCy Schubert  <dt><tt>flag4 0 | 1</tt></dt>
43*2b15cb3dSCy Schubert  <dd>Not used by this driver.</dd>
449c2daa00SOllivier Robert</dl>
459c2daa00SOllivier Robert<h4>Additional Information</h4>
469c2daa00SOllivier Robert<p><a href="../refclock.html">Reference Clock Drivers</a></p>
479c2daa00SOllivier Robert<hr>
48ea906c41SOllivier Robert<script type="text/javascript" language="javascript" src="scripts/footer.txt"></script>
499c2daa00SOllivier Robert</body>
509c2daa00SOllivier Robert</html>
51