1275970Scy<html lang="en"> 2275970Scy<head> 3275970Scy<title>ntpdc: NTPD Control User's Manual</title> 4275970Scy<meta http-equiv="Content-Type" content="text/html"> 5275970Scy<meta name="description" content="ntpdc: NTPD Control User's Manual"> 6275970Scy<meta name="generator" content="makeinfo 4.7"> 7275970Scy<link title="Top" rel="top" href="#Top"> 8275970Scy<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage"> 9275970Scy<meta http-equiv="Content-Style-Type" content="text/css"> 10275970Scy<style type="text/css"><!-- 11275970Scy pre.display { font-family:inherit } 12275970Scy pre.format { font-family:inherit } 13275970Scy pre.smalldisplay { font-family:inherit; font-size:smaller } 14275970Scy pre.smallformat { font-family:inherit; font-size:smaller } 15275970Scy pre.smallexample { font-size:smaller } 16275970Scy pre.smalllisp { font-size:smaller } 17275970Scy span.sc { font-variant:small-caps } 18275970Scy span.roman { font-family: serif; font-weight: normal; } 19275970Scy--></style> 20275970Scy</head> 21275970Scy<body> 22275970Scy<h1 class="settitle">ntpdc: NTPD Control User's Manual</h1> 23275970Scy<div class="node"> 24275970Scy<p><hr> 25275970Scy<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</a>, 26275970ScyPrevious: <a rel="previous" accesskey="p" href="#dir">(dir)</a>, 27275970ScyUp: <a rel="up" accesskey="u" href="#dir">(dir)</a> 28275970Scy<br> 29275970Scy</div> 30275970Scy 31275970Scy<h2 class="unnumbered">ntpdc: NTPD Control User Manual</h2> 32275970Scy 33275970Scy<p>This document describes the use of the NTP Project's <code>ntpdc</code> program, 34275970Scythat can be used to query a Network Time Protocol (NTP) server and 35275970Scydisplay the time offset of the system clock relative to the server 36275970Scyclock. Run as root, it can correct the system clock to this offset as 37275970Scywell. It can be run as an interactive command or from a cron job. 38275970Scy 39330567Sgordon <p>This document applies to version 4.2.8p11 of <code>ntpdc</code>. 40275970Scy 41275970Scy <p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4 42275970ScyIETF specification. 43275970Scy 44275970Scy <div class="shortcontents"> 45275970Scy<h2>Short Contents</h2> 46275970Scy<ul> 47275970Scy<a href="#Top">ntpdc: NTPD Control User Manual</a> 48275970Scy</ul> 49275970Scy</div> 50275970Scy 51275970Scy<ul class="menu"> 52275970Scy<li><a accesskey="1" href="#ntpdc-Description">ntpdc Description</a>: Description 53275970Scy<li><a accesskey="2" href="#ntpdc-Invocation">ntpdc Invocation</a>: Invoking ntpdc 54275970Scy<li><a accesskey="3" href="#Usage">Usage</a>: Usage 55275970Scy</ul> 56275970Scy 57275970Scy<div class="node"> 58275970Scy<p><hr> 59275970Scy<a name="ntpdc-Description"></a> 60275970Scy<br> 61275970Scy</div> 62275970Scy 63275970Scy<!-- node-name, next, previous, up --> 64275970Scy<h3 class="section">Description</h3> 65275970Scy 66275970Scy<p>By default, <code>ntpdc</code> writes the local data and time (i.e., not UTC) to the 67275970Scystandard output in the format: 68275970Scy 69275970Scy<pre class="example"> 1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs 70275970Scy</pre> 71275970Scy <p>where 72275970ScyYYYY-MM-DD HH:MM:SS.SUBSEC is the local date and time, 73275970Scy(+0800) is the local timezone adjustment (so we would add 8 hours and 0 minutes to convert the reported local time to UTC), 74275970Scyand 75275970Scythe +4.567 +/- 0.089 secs indicates the time offset and 76275970Scyerror bound of the system clock relative to the server clock. 77275970Scy 78275970Scy<div class="node"> 79275970Scy<p><hr> 80275970Scy<a name="ntpdc-Invocation"></a> 81275970Scy<br> 82275970Scy</div> 83275970Scy 84275970Scy<h3 class="section">Invoking ntpdc</h3> 85275970Scy 86275970Scy<p><a name="index-ntpdc-1"></a><a name="index-vendor_002dspecific-NTPD-control-program-2"></a> 87275970Scy 88275970Scy <p><code>ntpdc</code> 89275970Scyis deprecated. 90275970ScyPlease use 91275970Scy<code>ntpq(1ntpqmdoc)</code> instead - it can do everything 92275970Scy<code>ntpdc</code> 93275970Scyused to do, and it does so using a much more sane interface. 94275970Scy 95275970Scy <p><code>ntpdc</code> 96275970Scyis a utility program used to query 97275970Scy<code>ntpd(1ntpdmdoc)</code> 98275970Scyabout its 99275970Scycurrent state and to request changes in that state. 100275970ScyIt uses NTP mode 7 control message formats described in the source code. 101275970ScyThe program may 102275970Scybe run either in interactive mode or controlled using command line 103275970Scyarguments. 104275970ScyExtensive state and statistics information is available 105275970Scythrough the 106275970Scy<code>ntpdc</code> 107275970Scyinterface. 108275970ScyIn addition, nearly all the 109275970Scyconfiguration options which can be specified at startup using 110275970Scyntpd's configuration file may also be specified at run time using 111275970Scy<code>ntpdc</code> 112275970Scy 113275970Scy <p>This section was generated by <strong>AutoGen</strong>, 114275970Scyusing the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpdc</code> program. 115275970ScyThis software is released under the NTP license, <http://ntp.org/license>. 116275970Scy 117275970Scy<ul class="menu"> 118275970Scy<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<span class="option">--help</span>) 119275970Scy<li><a accesskey="2" href="#ntpdc-ipv4">ntpdc ipv4</a>: ipv4 option (-4) 120275970Scy<li><a accesskey="3" href="#ntpdc-ipv6">ntpdc ipv6</a>: ipv6 option (-6) 121275970Scy<li><a accesskey="4" href="#ntpdc-command">ntpdc command</a>: command option (-c) 122275970Scy<li><a accesskey="5" href="#ntpdc-interactive">ntpdc interactive</a>: interactive option (-i) 123275970Scy<li><a accesskey="6" href="#ntpdc-listpeers">ntpdc listpeers</a>: listpeers option (-l) 124275970Scy<li><a accesskey="7" href="#ntpdc-numeric">ntpdc numeric</a>: numeric option (-n) 125275970Scy<li><a accesskey="8" href="#ntpdc-peers">ntpdc peers</a>: peers option (-p) 126275970Scy<li><a accesskey="9" href="#ntpdc-showpeers">ntpdc showpeers</a>: showpeers option (-s) 127275970Scy<li><a href="#ntpdc-config">ntpdc config</a>: presetting/configuring ntpdc 128275970Scy<li><a href="#ntpdc-exit-status">ntpdc exit status</a>: exit status 129275970Scy<li><a href="#ntpdc-Usage">ntpdc Usage</a>: Usage 130275970Scy<li><a href="#ntpdc-See-Also">ntpdc See Also</a>: See Also 131275970Scy<li><a href="#ntpdc-Authors">ntpdc Authors</a>: Authors 132275970Scy<li><a href="#ntpdc-Bugs">ntpdc Bugs</a>: Bugs 133275970Scy</ul> 134275970Scy 135275970Scy<div class="node"> 136275970Scy<p><hr> 137275970Scy<a name="ntpdc-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>, 138275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 139275970Scy<br> 140275970Scy</div> 141275970Scy 142275970Scy<h4 class="subsection">ntpdc help/usage (<span class="option">--help</span>)</h4> 143275970Scy 144275970Scy<p><a name="index-ntpdc-help-3"></a> 145275970ScyThis is the automatically generated usage text for ntpdc. 146275970Scy 147275970Scy <p>The text printed is the same whether selected with the <code>help</code> option 148275970Scy(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print 149275970Scythe usage text by passing it through a pager program. 150275970Scy<code>more-help</code> is disabled on platforms without a working 151275970Scy<code>fork(2)</code> function. The <code>PAGER</code> environment variable is 152275970Scyused to select the program, defaulting to <span class="file">more</span>. Both will exit 153275970Scywith a status code of 0. 154275970Scy 155330567Sgordon<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p11 156275970ScyUsage: ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...] 157275970Scy Flg Arg Option-Name Description 158275970Scy -4 no ipv4 Force IPv4 DNS name resolution 159275970Scy - prohibits the option 'ipv6' 160275970Scy -6 no ipv6 Force IPv6 DNS name resolution 161275970Scy - prohibits the option 'ipv4' 162275970Scy -c Str command run a command and exit 163275970Scy - may appear multiple times 164275970Scy -d no debug-level Increase debug verbosity level 165275970Scy - may appear multiple times 166275970Scy -D Num set-debug-level Set the debug verbosity level 167275970Scy - may appear multiple times 168275970Scy -i no interactive Force ntpq to operate in interactive mode 169275970Scy - prohibits these options: 170275970Scy command 171275970Scy listpeers 172275970Scy peers 173275970Scy showpeers 174275970Scy -l no listpeers Print a list of the peers 175275970Scy - prohibits the option 'command' 176275970Scy -n no numeric numeric host addresses 177275970Scy -p no peers Print a list of the peers 178275970Scy - prohibits the option 'command' 179275970Scy -s no showpeers Show a list of the peers 180275970Scy - prohibits the option 'command' 181275970Scy opt version output version information and exit 182275970Scy -? no help display extended usage information and exit 183275970Scy -! no more-help extended usage information passed thru pager 184275970Scy -> opt save-opts save the option state to a config file 185275970Scy -< Str load-opts load options from a config file 186275970Scy - disabled as '--no-load-opts' 187275970Scy - may appear multiple times 188275970Scy 189275970ScyOptions are specified by doubled hyphens and their name or by a single 190275970Scyhyphen and the flag character. 191275970Scy 192275970Scy 193275970ScyThe following option preset mechanisms are supported: 194275970Scy - reading file $HOME/.ntprc 195275970Scy - reading file ./.ntprc 196275970Scy - examining environment variables named NTPDC_* 197275970Scy 198275970ScyPlease send bug reports to: <http://bugs.ntp.org, bugs@ntp.org> 199275970Scy</pre> 200275970Scy <div class="node"> 201275970Scy<p><hr> 202275970Scy<a name="ntpdc-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>, 203275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-usage">ntpdc usage</a>, 204275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 205275970Scy<br> 206275970Scy</div> 207275970Scy 208275970Scy<h4 class="subsection">ipv4 option (-4)</h4> 209275970Scy 210275970Scy<p><a name="index-ntpdc_002dipv4-4"></a> 211275970ScyThis is the “force ipv4 dns name resolution” option. 212275970Scy 213275970Scy<p class="noindent">This option has some usage constraints. It: 214275970Scy <ul> 215275970Scy<li>must not appear in combination with any of the following options: 216275970Scyipv6. 217275970Scy</ul> 218275970Scy 219275970Scy <p>Force DNS resolution of following host names on the command line 220275970Scyto the IPv4 namespace. 221275970Scy<div class="node"> 222275970Scy<p><hr> 223275970Scy<a name="ntpdc-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</a>, 224275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-ipv4">ntpdc ipv4</a>, 225275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 226275970Scy<br> 227275970Scy</div> 228275970Scy 229275970Scy<h4 class="subsection">ipv6 option (-6)</h4> 230275970Scy 231275970Scy<p><a name="index-ntpdc_002dipv6-5"></a> 232275970ScyThis is the “force ipv6 dns name resolution” option. 233275970Scy 234275970Scy<p class="noindent">This option has some usage constraints. It: 235275970Scy <ul> 236275970Scy<li>must not appear in combination with any of the following options: 237275970Scyipv4. 238275970Scy</ul> 239275970Scy 240275970Scy <p>Force DNS resolution of following host names on the command line 241275970Scyto the IPv6 namespace. 242275970Scy<div class="node"> 243275970Scy<p><hr> 244275970Scy<a name="ntpdc-command"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</a>, 245275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-ipv6">ntpdc ipv6</a>, 246275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 247275970Scy<br> 248275970Scy</div> 249275970Scy 250275970Scy<h4 class="subsection">command option (-c)</h4> 251275970Scy 252275970Scy<p><a name="index-ntpdc_002dcommand-6"></a> 253275970ScyThis is the “run a command and exit” option. 254275970ScyThis option takes a string argument <span class="file">cmd</span>. 255275970Scy 256275970Scy<p class="noindent">This option has some usage constraints. It: 257275970Scy <ul> 258275970Scy<li>may appear an unlimited number of times. 259275970Scy</ul> 260275970Scy 261275970Scy <p>The following argument is interpreted as an interactive format command 262275970Scyand is added to the list of commands to be executed on the specified 263275970Scyhost(s). 264275970Scy<div class="node"> 265275970Scy<p><hr> 266275970Scy<a name="ntpdc-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</a>, 267275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-command">ntpdc command</a>, 268275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 269275970Scy<br> 270275970Scy</div> 271275970Scy 272275970Scy<h4 class="subsection">interactive option (-i)</h4> 273275970Scy 274275970Scy<p><a name="index-ntpdc_002dinteractive-7"></a> 275275970ScyThis is the “force ntpq to operate in interactive mode” option. 276275970Scy 277275970Scy<p class="noindent">This option has some usage constraints. It: 278275970Scy <ul> 279275970Scy<li>must not appear in combination with any of the following options: 280275970Scycommand, listpeers, peers, showpeers. 281275970Scy</ul> 282275970Scy 283275970Scy <p>Force ntpq to operate in interactive mode. Prompts will be written 284275970Scyto the standard output and commands read from the standard input. 285275970Scy<div class="node"> 286275970Scy<p><hr> 287275970Scy<a name="ntpdc-listpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</a>, 288275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-interactive">ntpdc interactive</a>, 289275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 290275970Scy<br> 291275970Scy</div> 292275970Scy 293275970Scy<h4 class="subsection">listpeers option (-l)</h4> 294275970Scy 295275970Scy<p><a name="index-ntpdc_002dlistpeers-8"></a> 296275970ScyThis is the “print a list of the peers” option. 297275970Scy 298275970Scy<p class="noindent">This option has some usage constraints. It: 299275970Scy <ul> 300275970Scy<li>must not appear in combination with any of the following options: 301275970Scycommand. 302275970Scy</ul> 303275970Scy 304275970Scy <p>Print a list of the peers known to the server as well as a summary of 305275970Scytheir state. This is equivalent to the 'listpeers' interactive command. 306275970Scy<div class="node"> 307275970Scy<p><hr> 308275970Scy<a name="ntpdc-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</a>, 309275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-listpeers">ntpdc listpeers</a>, 310275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 311275970Scy<br> 312275970Scy</div> 313275970Scy 314275970Scy<h4 class="subsection">numeric option (-n)</h4> 315275970Scy 316275970Scy<p><a name="index-ntpdc_002dnumeric-9"></a> 317275970ScyThis is the “numeric host addresses” option. 318275970ScyOutput all host addresses in dotted-quad numeric format rather than 319275970Scyconverting to the canonical host names. 320275970Scy<div class="node"> 321275970Scy<p><hr> 322275970Scy<a name="ntpdc-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</a>, 323275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-numeric">ntpdc numeric</a>, 324275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 325275970Scy<br> 326275970Scy</div> 327275970Scy 328275970Scy<h4 class="subsection">peers option (-p)</h4> 329275970Scy 330275970Scy<p><a name="index-ntpdc_002dpeers-10"></a> 331275970ScyThis is the “print a list of the peers” option. 332275970Scy 333275970Scy<p class="noindent">This option has some usage constraints. It: 334275970Scy <ul> 335275970Scy<li>must not appear in combination with any of the following options: 336275970Scycommand. 337275970Scy</ul> 338275970Scy 339275970Scy <p>Print a list of the peers known to the server as well as a summary 340275970Scyof their state. This is equivalent to the 'peers' interactive command. 341275970Scy<div class="node"> 342275970Scy<p><hr> 343275970Scy<a name="ntpdc-showpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</a>, 344275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-peers">ntpdc peers</a>, 345275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 346275970Scy<br> 347275970Scy</div> 348275970Scy 349275970Scy<h4 class="subsection">showpeers option (-s)</h4> 350275970Scy 351275970Scy<p><a name="index-ntpdc_002dshowpeers-11"></a> 352275970ScyThis is the “show a list of the peers” option. 353275970Scy 354275970Scy<p class="noindent">This option has some usage constraints. It: 355275970Scy <ul> 356275970Scy<li>must not appear in combination with any of the following options: 357275970Scycommand. 358275970Scy</ul> 359275970Scy 360275970Scy <p>Print a list of the peers known to the server as well as a summary 361275970Scyof their state. This is equivalent to the 'dmpeers' interactive command. 362275970Scy 363275970Scy<div class="node"> 364275970Scy<p><hr> 365275970Scy<a name="ntpdc-config"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</a>, 366275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-showpeers">ntpdc showpeers</a>, 367275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 368275970Scy<br> 369275970Scy</div> 370275970Scy 371275970Scy<h4 class="subsection">presetting/configuring ntpdc</h4> 372275970Scy 373275970Scy<p>Any option that is not marked as <i>not presettable</i> may be preset by 374275970Scyloading values from configuration ("rc" or "ini") files, and values from environment variables named <code>NTPDC</code> and <code>NTPDC_<OPTION_NAME></code>. <code><OPTION_NAME></code> must be one of 375275970Scythe options listed above in upper case and segmented with underscores. 376275970ScyThe <code>NTPDC</code> variable will be tokenized and parsed like 377275970Scythe command line. The remaining variables are tested for existence and their 378275970Scyvalues are treated like option arguments. 379275970Scy 380275970Scy<p class="noindent"><code>libopts</code> will search in 2 places for configuration files: 381275970Scy <ul> 382275970Scy<li>$HOME 383275970Scy<li>$PWD 384275970Scy</ul> 385275970Scy The environment variables <code>HOME</code>, and <code>PWD</code> 386275970Scyare expanded and replaced when <span class="file">ntpdc</span> runs. 387275970ScyFor any of these that are plain files, they are simply processed. 388275970ScyFor any that are directories, then a file named <span class="file">.ntprc</span> is searched for 389275970Scywithin that directory and processed. 390275970Scy 391275970Scy <p>Configuration files may be in a wide variety of formats. 392275970ScyThe basic format is an option name followed by a value (argument) on the 393275970Scysame line. Values may be separated from the option name with a colon, 394275970Scyequal sign or simply white space. Values may be continued across multiple 395275970Scylines by escaping the newline with a backslash. 396275970Scy 397275970Scy <p>Multiple programs may also share the same initialization file. 398275970ScyCommon options are collected at the top, followed by program specific 399275970Scysegments. The segments are separated by lines like: 400275970Scy<pre class="example"> [NTPDC] 401275970Scy</pre> 402275970Scy <p class="noindent">or by 403275970Scy<pre class="example"> <?program ntpdc> 404275970Scy</pre> 405275970Scy <p class="noindent">Do not mix these styles within one configuration file. 406275970Scy 407275970Scy <p>Compound values and carefully constructed string values may also be 408275970Scyspecified using XML syntax: 409275970Scy<pre class="example"> <option-name> 410275970Scy <sub-opt>...&lt;...&gt;...</sub-opt> 411275970Scy </option-name> 412275970Scy</pre> 413275970Scy <p class="noindent">yielding an <code>option-name.sub-opt</code> string value of 414275970Scy<pre class="example"> "...<...>..." 415275970Scy</pre> 416275970Scy <p><code>AutoOpts</code> does not track suboptions. You simply note that it is a 417275970Scyhierarchicly valued option. <code>AutoOpts</code> does provide a means for searching 418275970Scythe associated name/value pair list (see: optionFindValue). 419275970Scy 420275970Scy <p>The command line options relating to configuration and/or usage help are: 421275970Scy 422275970Scy<h5 class="subsubheading">version (-)</h5> 423275970Scy 424275970Scy<p>Print the program version to standard out, optionally with licensing 425275970Scyinformation, then exit 0. The optional argument specifies how much licensing 426275970Scydetail to provide. The default is to print just the version. The licensing infomation may be selected with an option argument. 427275970ScyOnly the first letter of the argument is examined: 428275970Scy 429275970Scy <dl> 430275970Scy<dt><span class="samp">version</span><dd>Only print the version. This is the default. 431275970Scy<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms. 432275970Scy<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms. 433275970Scy</dl> 434275970Scy 435275970Scy<div class="node"> 436275970Scy<p><hr> 437275970Scy<a name="ntpdc-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</a>, 438275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-config">ntpdc config</a>, 439275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 440275970Scy<br> 441275970Scy</div> 442275970Scy 443275970Scy<h4 class="subsection">ntpdc exit status</h4> 444275970Scy 445275970Scy<p>One of the following exit values will be returned: 446275970Scy <dl> 447275970Scy<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution. 448275970Scy<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid. 449275970Scy<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded. 450275970Scy<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report 451275970Scyit to autogen-users@lists.sourceforge.net. Thank you. 452275970Scy</dl> 453275970Scy <div class="node"> 454275970Scy<p><hr> 455275970Scy<a name="ntpdc-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</a>, 456275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-exit-status">ntpdc exit status</a>, 457275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 458275970Scy<br> 459275970Scy</div> 460275970Scy 461275970Scy<h4 class="subsection">ntpdc Usage</h4> 462275970Scy 463275970Scy<div class="node"> 464275970Scy<p><hr> 465275970Scy<a name="ntpdc-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Authors">ntpdc Authors</a>, 466275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-Usage">ntpdc Usage</a>, 467275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 468275970Scy<br> 469275970Scy</div> 470275970Scy 471275970Scy<h4 class="subsection">ntpdc See Also</h4> 472275970Scy 473275970Scy<div class="node"> 474275970Scy<p><hr> 475275970Scy<a name="ntpdc-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Bugs">ntpdc Bugs</a>, 476275970ScyPrevious: <a rel="previous" accesskey="p" href="#ntpdc-See-Also">ntpdc See Also</a>, 477275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 478275970Scy<br> 479275970Scy</div> 480275970Scy 481275970Scy<h4 class="subsection">ntpdc Authors</h4> 482275970Scy 483275970Scy<div class="node"> 484275970Scy<p><hr> 485275970Scy<a name="ntpdc-Bugs"></a>Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</a>, 486275970ScyUp: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a> 487275970Scy<br> 488275970Scy</div> 489275970Scy 490275970Scy<h4 class="subsection">ntpdc Bugs</h4> 491275970Scy 492275970Scy<div class="node"> 493275970Scy<p><hr> 494275970Scy<a name="Usage"></a> 495275970Scy<br> 496275970Scy</div> 497275970Scy 498275970Scy<!-- node-name, next, previous, up --> 499275970Scy<h3 class="section">Usage</h3> 500275970Scy 501275970Scy<p>The simplest use of this program is as an unprivileged command to 502275970Scycheck the current time, offset, and error in the local clock. 503275970ScyFor example: 504275970Scy 505275970Scy<pre class="example"> ntpdc ntpserver.somewhere 506275970Scy</pre> 507275970Scy <p>With suitable privilege, it can be run as a command or in a 508275970Scy<code>cron</code> job to reset the local clock from a reliable server, like 509275970Scythe <code>ntpdate</code> and <code>rdate</code> commands. 510275970ScyFor example: 511275970Scy 512275970Scy<pre class="example"> ntpdc -a ntpserver.somewhere 513275970Scy</pre> 514275970Scy </body></html> 515275970Scy 516