"Fossies" - the Fresh Open Source Software Archive

Member "ntp-4.2.8p15/ntpd/invoke-ntpd.texi" (23 Jun 2020, 24245 Bytes) of package /linux/misc/ntp-4.2.8p15.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file. See also the latest Fossies "Diffs" side-by-side code changes report for "invoke-ntpd.texi": 4.2.8p14_vs_4.2.8p15.

A hint: This file contains one or more very long lines, so maybe it is better readable using the pure text view mode that shows the contents as wrapped lines within the browser window.


    1 @node ntpd Invocation
    2 @section Invoking ntpd
    3 @pindex ntpd
    4 @cindex NTP daemon program
    5 @ignore
    6 #
    7 # EDIT THIS FILE WITH CAUTION  (invoke-ntpd.texi)
    8 #
    9 # It has been AutoGen-ed  June 23, 2020 at 02:20:35 AM by AutoGen 5.18.5
   10 # From the definitions    ntpd-opts.def
   11 # and the template file   agtexi-cmd.tpl
   12 @end ignore
   13 
   14 
   15 
   16 The
   17 @code{ntpd}
   18 utility is an operating system daemon which sets
   19 and maintains the system time of day in synchronism with Internet
   20 standard time servers.
   21 It is a complete implementation of the
   22 Network Time Protocol (NTP) version 4, as defined by RFC-5905,
   23 but also retains compatibility with
   24 version 3, as defined by RFC-1305, and versions 1
   25 and 2, as defined by RFC-1059 and RFC-1119, respectively.
   26 
   27 The
   28 @code{ntpd}
   29 utility does most computations in 64-bit floating point
   30 arithmetic and does relatively clumsy 64-bit fixed point operations
   31 only when necessary to preserve the ultimate precision, about 232
   32 picoseconds.
   33 While the ultimate precision is not achievable with
   34 ordinary workstations and networks of today, it may be required
   35 with future gigahertz CPU clocks and gigabit LANs.
   36 
   37 Ordinarily,
   38 @code{ntpd}
   39 reads the
   40 @code{ntp.conf(5)}
   41 configuration file at startup time in order to determine the
   42 synchronization sources and operating modes.
   43 It is also possible to
   44 specify a working, although limited, configuration entirely on the
   45 command line, obviating the need for a configuration file.
   46 This may
   47 be particularly useful when the local host is to be configured as a
   48 broadcast/multicast client, with all peers being determined by
   49 listening to broadcasts at run time.
   50 
   51 If NetInfo support is built into
   52 @code{ntpd}
   53 then
   54 @code{ntpd}
   55 will attempt to read its configuration from the
   56 NetInfo if the default
   57 @code{ntp.conf(5)}
   58 file cannot be read and no file is
   59 specified by the
   60 @code{-c}
   61 option.
   62 
   63 Various internal
   64 @code{ntpd}
   65 variables can be displayed and
   66 configuration options altered while the
   67 @code{ntpd}
   68 is running
   69 using the
   70 @code{ntpq(1ntpqmdoc)}
   71 and
   72 @code{ntpdc(1ntpdcmdoc)}
   73 utility programs.
   74 
   75 When
   76 @code{ntpd}
   77 starts it looks at the value of
   78 @code{umask(2)},
   79 and if zero
   80 @code{ntpd}
   81 will set the
   82 @code{umask(2)}
   83 to 022.
   84 
   85 This section was generated by @strong{AutoGen},
   86 using the @code{agtexi-cmd} template and the option descriptions for the @code{ntpd} program.
   87 This software is released under the NTP license, <http://ntp.org/license>.
   88 
   89 @menu
   90 * ntpd usage::                  ntpd help/usage (@option{--help})
   91 * ntpd ipv4::                   ipv4 option (-4)
   92 * ntpd ipv6::                   ipv6 option (-6)
   93 * ntpd authreq::                authreq option (-a)
   94 * ntpd authnoreq::              authnoreq option (-A)
   95 * ntpd configfile::             configfile option (-c)
   96 * ntpd driftfile::              driftfile option (-f)
   97 * ntpd panicgate::              panicgate option (-g)
   98 * ntpd force-step-once::        force-step-once option (-G)
   99 * ntpd jaildir::                jaildir option (-i)
  100 * ntpd interface::              interface option (-I)
  101 * ntpd keyfile::                keyfile option (-k)
  102 * ntpd logfile::                logfile option (-l)
  103 * ntpd novirtualips::           novirtualips option (-L)
  104 * ntpd modifymmtimer::          modifymmtimer option (-M)
  105 * ntpd nice::                   nice option (-N)
  106 * ntpd pidfile::                pidfile option (-p)
  107 * ntpd priority::               priority option (-P)
  108 * ntpd quit::                   quit option (-q)
  109 * ntpd propagationdelay::       propagationdelay option (-r)
  110 * ntpd saveconfigquit::         saveconfigquit option
  111 * ntpd statsdir::               statsdir option (-s)
  112 * ntpd trustedkey::             trustedkey option (-t)
  113 * ntpd user::                   user option (-u)
  114 * ntpd updateinterval::         updateinterval option (-U)
  115 * ntpd wait-sync::              wait-sync option (-w)
  116 * ntpd slew::                   slew option (-x)
  117 * ntpd usepcc::                 usepcc option
  118 * ntpd pccfreq::                pccfreq option
  119 * ntpd mdns::                   mdns option (-m)
  120 * ntpd config::                 presetting/configuring ntpd
  121 * ntpd exit status::            exit status
  122 * ntpd Usage::                  Usage
  123 * ntpd Files::                  Files
  124 * ntpd See Also::               See Also
  125 * ntpd Bugs::                   Bugs
  126 * ntpd Notes::                  Notes
  127 @end menu
  128 
  129 @node ntpd usage
  130 @subsection ntpd help/usage (@option{--help})
  131 @cindex ntpd help
  132 
  133 This is the automatically generated usage text for ntpd.
  134 
  135 The text printed is the same whether selected with the @code{help} option
  136 (@option{--help}) or the @code{more-help} option (@option{--more-help}).  @code{more-help} will print
  137 the usage text by passing it through a pager program.
  138 @code{more-help} is disabled on platforms without a working
  139 @code{fork(2)} function.  The @code{PAGER} environment variable is
  140 used to select the program, defaulting to @file{more}.  Both will exit
  141 with a status code of 0.
  142 
  143 @exampleindent 0
  144 @example
  145 ntpd - NTP daemon program - Ver. 4.2.8p15
  146 Usage:  ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
  147                 [ <server1> ... <serverN> ]
  148   Flg Arg Option-Name    Description
  149    -4 no  ipv4           Force IPv4 DNS name resolution
  150                                 - prohibits the option 'ipv6'
  151    -6 no  ipv6           Force IPv6 DNS name resolution
  152                                 - prohibits the option 'ipv4'
  153    -a no  authreq        Require crypto authentication
  154                                 - prohibits the option 'authnoreq'
  155    -A no  authnoreq      Do not require crypto authentication
  156                                 - prohibits the option 'authreq'
  157    -b no  bcastsync      Allow us to sync to broadcast servers
  158    -c Str configfile     configuration file name
  159    -d no  debug-level    Increase debug verbosity level
  160                                 - may appear multiple times
  161    -D Num set-debug-level Set the debug verbosity level
  162                                 - may appear multiple times
  163    -f Str driftfile      frequency drift file name
  164    -g no  panicgate      Allow the first adjustment to be Big
  165                                 - may appear multiple times
  166    -G no  force-step-once Step any initial offset correction.
  167    -i --- jaildir        built without --enable-clockctl or --enable-linuxcaps or --enable-solarisprivs
  168    -I Str interface      Listen on an interface name or address
  169                                 - may appear multiple times
  170    -k Str keyfile        path to symmetric keys
  171    -l Str logfile        path to the log file
  172    -L no  novirtualips   Do not listen to virtual interfaces
  173    -n no  nofork         Do not fork
  174                                 - prohibits the option 'wait-sync'
  175    -N no  nice           Run at high priority
  176    -p Str pidfile        path to the PID file
  177    -P Num priority       Process priority
  178    -q no  quit           Set the time and quit
  179                                 - prohibits these options:
  180                                 saveconfigquit
  181                                 wait-sync
  182    -r Str propagationdelay Broadcast/propagation delay
  183       Str saveconfigquit Save parsed configuration and quit
  184                                 - prohibits these options:
  185                                 quit
  186                                 wait-sync
  187    -s Str statsdir       Statistics file location
  188    -t Str trustedkey     Trusted key number
  189                                 - may appear multiple times
  190    -u --- user           built without --enable-clockctl or --enable-linuxcaps or --enable-solarisprivs
  191    -U Num updateinterval interval in seconds between scans for new or dropped interfaces
  192       Str var            make ARG an ntp variable (RW)
  193                                 - may appear multiple times
  194       Str dvar           make ARG an ntp variable (RW|DEF)
  195                                 - may appear multiple times
  196    -w Num wait-sync      Seconds to wait for first clock sync
  197                                 - prohibits these options:
  198                                 nofork
  199                                 quit
  200                                 saveconfigquit
  201    -x no  slew           Slew up to 600 seconds
  202       opt version        output version information and exit
  203    -? no  help           display extended usage information and exit
  204    -! no  more-help      extended usage information passed thru pager
  205 
  206 Options are specified by doubled hyphens and their name or by a single
  207 hyphen and the flag character.
  208 
  209 
  210 The following option preset mechanisms are supported:
  211  - examining environment variables named NTPD_*
  212 
  213 Please send bug reports to:  <http://bugs.ntp.org, bugs@@ntp.org>
  214 @end example
  215 @exampleindent 4
  216 
  217 @node ntpd ipv4
  218 @subsection ipv4 option (-4)
  219 @cindex ntpd-ipv4
  220 
  221 This is the ``force ipv4 dns name resolution'' option.
  222 
  223 @noindent
  224 This option has some usage constraints.  It:
  225 @itemize @bullet
  226 @item
  227 must not appear in combination with any of the following options:
  228 ipv6.
  229 @end itemize
  230 
  231 Force DNS resolution of following host names on the command line
  232 to the IPv4 namespace.
  233 @node ntpd ipv6
  234 @subsection ipv6 option (-6)
  235 @cindex ntpd-ipv6
  236 
  237 This is the ``force ipv6 dns name resolution'' option.
  238 
  239 @noindent
  240 This option has some usage constraints.  It:
  241 @itemize @bullet
  242 @item
  243 must not appear in combination with any of the following options:
  244 ipv4.
  245 @end itemize
  246 
  247 Force DNS resolution of following host names on the command line
  248 to the IPv6 namespace.
  249 @node ntpd authreq
  250 @subsection authreq option (-a)
  251 @cindex ntpd-authreq
  252 
  253 This is the ``require crypto authentication'' option.
  254 
  255 @noindent
  256 This option has some usage constraints.  It:
  257 @itemize @bullet
  258 @item
  259 must not appear in combination with any of the following options:
  260 authnoreq.
  261 @end itemize
  262 
  263 Require cryptographic authentication for broadcast client,
  264 multicast client and symmetric passive associations.
  265 This is the default.
  266 @node ntpd authnoreq
  267 @subsection authnoreq option (-A)
  268 @cindex ntpd-authnoreq
  269 
  270 This is the ``do not require crypto authentication'' option.
  271 
  272 @noindent
  273 This option has some usage constraints.  It:
  274 @itemize @bullet
  275 @item
  276 must not appear in combination with any of the following options:
  277 authreq.
  278 @end itemize
  279 
  280 Do not require cryptographic authentication for broadcast client,
  281 multicast client and symmetric passive associations.
  282 This is almost never a good idea.
  283 @node ntpd configfile
  284 @subsection configfile option (-c)
  285 @cindex ntpd-configfile
  286 
  287 This is the ``configuration file name'' option.
  288 This option takes a string argument.
  289 The name and path of the configuration file,
  290 @file{/etc/ntp.conf}
  291 by default.
  292 @node ntpd driftfile
  293 @subsection driftfile option (-f)
  294 @cindex ntpd-driftfile
  295 
  296 This is the ``frequency drift file name'' option.
  297 This option takes a string argument.
  298 The name and path of the frequency file,
  299 @file{/etc/ntp.drift}
  300 by default.
  301 This is the same operation as the
  302 @code{driftfile} @kbd{driftfile}
  303 configuration specification in the
  304 @file{/etc/ntp.conf}
  305 file.
  306 @node ntpd panicgate
  307 @subsection panicgate option (-g)
  308 @cindex ntpd-panicgate
  309 
  310 This is the ``allow the first adjustment to be big'' option.
  311 
  312 @noindent
  313 This option has some usage constraints.  It:
  314 @itemize @bullet
  315 @item
  316 may appear an unlimited number of times.
  317 @end itemize
  318 
  319 Normally,
  320 @code{ntpd}
  321 exits with a message to the system log if the offset exceeds the panic threshold, which is 1000 s by default. This option allows the time to be set to any value without restriction; however, this can happen only once. If the threshold is exceeded after that,
  322 @code{ntpd}
  323 will exit with a message to the system log. This option can be used with the
  324 @code{-q}
  325 and
  326 @code{-x}
  327 options.
  328 See the
  329 @code{tinker}
  330 configuration file directive for other options.
  331 @node ntpd force-step-once
  332 @subsection force-step-once option (-G)
  333 @cindex ntpd-force-step-once
  334 
  335 This is the ``step any initial offset correction.'' option.
  336 Normally,
  337 @code{ntpd}
  338 steps the time if the time offset exceeds the step threshold,
  339 which is 128 ms by default, and otherwise slews the time.
  340 This option forces the initial offset correction to be stepped,
  341 so the highest time accuracy can be achieved quickly.
  342 However, this may also cause the time to be stepped back
  343 so this option must not be used if
  344 applications requiring monotonic time are running.
  345 See the @code{tinker} configuration file directive for other options.
  346 @node ntpd jaildir
  347 @subsection jaildir option (-i)
  348 @cindex ntpd-jaildir
  349 
  350 This is the ``jail directory'' option.
  351 This option takes a string argument.
  352 
  353 @noindent
  354 This option has some usage constraints.  It:
  355 @itemize @bullet
  356 @item
  357 must be compiled in by defining @code{HAVE_DROPROOT} during the compilation.
  358 @end itemize
  359 
  360 Chroot the server to the directory
  361 @kbd{jaildir}
  362 .
  363 This option also implies that the server attempts to drop root privileges at startup.
  364 You may need to also specify a
  365 @code{-u}
  366 option.
  367 This option is only available if the OS supports adjusting the clock
  368 without full root privileges.
  369 This option is supported under NetBSD (configure with
  370 @code{--enable-clockctl}) or Linux (configure with
  371 @code{--enable-linuxcaps}) or Solaris (configure with @code{--enable-solarisprivs}).
  372 @node ntpd interface
  373 @subsection interface option (-I)
  374 @cindex ntpd-interface
  375 
  376 This is the ``listen on an interface name or address'' option.
  377 This option takes a string argument @file{iface}.
  378 
  379 @noindent
  380 This option has some usage constraints.  It:
  381 @itemize @bullet
  382 @item
  383 may appear an unlimited number of times.
  384 @end itemize
  385 
  386 Open the network address given, or all the addresses associated with the
  387 given interface name.  This option may appear multiple times.  This option
  388 also implies not opening other addresses, except wildcard and localhost.
  389 This option is deprecated. Please consider using the configuration file
  390 @code{interface} command, which is more versatile.
  391 @node ntpd keyfile
  392 @subsection keyfile option (-k)
  393 @cindex ntpd-keyfile
  394 
  395 This is the ``path to symmetric keys'' option.
  396 This option takes a string argument.
  397 Specify the name and path of the symmetric key file.
  398 @file{/etc/ntp.keys}
  399 is the default.
  400 This is the same operation as the
  401 @code{keys} @kbd{keyfile}
  402 configuration file directive.
  403 @node ntpd logfile
  404 @subsection logfile option (-l)
  405 @cindex ntpd-logfile
  406 
  407 This is the ``path to the log file'' option.
  408 This option takes a string argument.
  409 Specify the name and path of the log file.
  410 The default is the system log file.
  411 This is the same operation as the
  412 @code{logfile} @kbd{logfile}
  413 configuration file directive.
  414 @node ntpd novirtualips
  415 @subsection novirtualips option (-L)
  416 @cindex ntpd-novirtualips
  417 
  418 This is the ``do not listen to virtual interfaces'' option.
  419 Do not listen to virtual interfaces, defined as those with
  420 names containing a colon.  This option is deprecated.  Please
  421 consider using the configuration file @code{interface} command, which
  422 is more versatile.
  423 @node ntpd modifymmtimer
  424 @subsection modifymmtimer option (-M)
  425 @cindex ntpd-modifymmtimer
  426 
  427 This is the ``modify multimedia timer (windows only)'' option.
  428 
  429 @noindent
  430 This option has some usage constraints.  It:
  431 @itemize @bullet
  432 @item
  433 must be compiled in by defining @code{SYS_WINNT} during the compilation.
  434 @end itemize
  435 
  436 Set the Windows Multimedia Timer to highest resolution.  This
  437 ensures the resolution does not change while ntpd is running,
  438 avoiding timekeeping glitches associated with changes.
  439 @node ntpd nice
  440 @subsection nice option (-N)
  441 @cindex ntpd-nice
  442 
  443 This is the ``run at high priority'' option.
  444 To the extent permitted by the operating system, run
  445 @code{ntpd}
  446 at the highest priority.
  447 @node ntpd pidfile
  448 @subsection pidfile option (-p)
  449 @cindex ntpd-pidfile
  450 
  451 This is the ``path to the pid file'' option.
  452 This option takes a string argument.
  453 Specify the name and path of the file used to record
  454 @code{ntpd}'s
  455 process ID.
  456 This is the same operation as the
  457 @code{pidfile} @kbd{pidfile}
  458 configuration file directive.
  459 @node ntpd priority
  460 @subsection priority option (-P)
  461 @cindex ntpd-priority
  462 
  463 This is the ``process priority'' option.
  464 This option takes a number argument.
  465 To the extent permitted by the operating system, run
  466 @code{ntpd}
  467 at the specified
  468 @code{sched_setscheduler(SCHED_FIFO)}
  469 priority.
  470 @node ntpd quit
  471 @subsection quit option (-q)
  472 @cindex ntpd-quit
  473 
  474 This is the ``set the time and quit'' option.
  475 
  476 @noindent
  477 This option has some usage constraints.  It:
  478 @itemize @bullet
  479 @item
  480 must not appear in combination with any of the following options:
  481 saveconfigquit, wait-sync.
  482 @end itemize
  483 
  484 @code{ntpd}
  485 will not daemonize and will exit after the clock is first
  486 synchronized.  This behavior mimics that of the
  487 @code{ntpdate}
  488 program, which will soon be replaced with a shell script.
  489 The
  490 @code{-g}
  491 and
  492 @code{-x}
  493 options can be used with this option.
  494 Note: The kernel time discipline is disabled with this option.
  495 @node ntpd propagationdelay
  496 @subsection propagationdelay option (-r)
  497 @cindex ntpd-propagationdelay
  498 
  499 This is the ``broadcast/propagation delay'' option.
  500 This option takes a string argument.
  501 Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol.
  502 @node ntpd saveconfigquit
  503 @subsection saveconfigquit option
  504 @cindex ntpd-saveconfigquit
  505 
  506 This is the ``save parsed configuration and quit'' option.
  507 This option takes a string argument.
  508 
  509 @noindent
  510 This option has some usage constraints.  It:
  511 @itemize @bullet
  512 @item
  513 must be compiled in by defining @code{SAVECONFIG} during the compilation.
  514 @item
  515 must not appear in combination with any of the following options:
  516 quit, wait-sync.
  517 @end itemize
  518 
  519 Cause @code{ntpd} to parse its startup configuration file and save an
  520 equivalent to the given filename and exit.  This option was
  521 designed for automated testing.
  522 @node ntpd statsdir
  523 @subsection statsdir option (-s)
  524 @cindex ntpd-statsdir
  525 
  526 This is the ``statistics file location'' option.
  527 This option takes a string argument.
  528 Specify the directory path for files created by the statistics facility.
  529 This is the same operation as the
  530 @code{statsdir} @kbd{statsdir}
  531 configuration file directive.
  532 @node ntpd trustedkey
  533 @subsection trustedkey option (-t)
  534 @cindex ntpd-trustedkey
  535 
  536 This is the ``trusted key number'' option.
  537 This option takes a string argument @file{tkey}.
  538 
  539 @noindent
  540 This option has some usage constraints.  It:
  541 @itemize @bullet
  542 @item
  543 may appear an unlimited number of times.
  544 @end itemize
  545 
  546 Add the specified key number to the trusted key list.
  547 @node ntpd user
  548 @subsection user option (-u)
  549 @cindex ntpd-user
  550 
  551 This is the ``run as userid (or userid:groupid)'' option.
  552 This option takes a string argument.
  553 
  554 @noindent
  555 This option has some usage constraints.  It:
  556 @itemize @bullet
  557 @item
  558 must be compiled in by defining @code{HAVE_DROPROOT} during the compilation.
  559 @end itemize
  560 
  561 Specify a user, and optionally a group, to switch to.
  562 This option is only available if the OS supports adjusting the clock
  563 without full root privileges.
  564 This option is supported under NetBSD (configure with
  565 @code{--enable-clockctl}) or Linux (configure with
  566 @code{--enable-linuxcaps}) or Solaris (configure with @code{--enable-solarisprivs}).
  567 @node ntpd updateinterval
  568 @subsection updateinterval option (-U)
  569 @cindex ntpd-updateinterval
  570 
  571 This is the ``interval in seconds between scans for new or dropped interfaces'' option.
  572 This option takes a number argument.
  573 Give the time in seconds between two scans for new or dropped interfaces.
  574 For systems with routing socket support the scans will be performed shortly after the interface change
  575 has been detected by the system.
  576 Use 0 to disable scanning. 60 seconds is the minimum time between scans.
  577 @node ntpd wait-sync
  578 @subsection wait-sync option (-w)
  579 @cindex ntpd-wait-sync
  580 
  581 This is the ``seconds to wait for first clock sync'' option.
  582 This option takes a number argument.
  583 
  584 @noindent
  585 This option has some usage constraints.  It:
  586 @itemize @bullet
  587 @item
  588 must be compiled in by defining @code{HAVE_WORKING_FORK} during the compilation.
  589 @item
  590 must not appear in combination with any of the following options:
  591 nofork, quit, saveconfigquit.
  592 @end itemize
  593 
  594 If greater than zero, alters @code{ntpd}'s behavior when forking to
  595 daemonize.  Instead of exiting with status 0 immediately after
  596 the fork, the parent waits up to the specified number of
  597 seconds for the child to first synchronize the clock.  The exit
  598 status is zero (success) if the clock was synchronized,
  599 otherwise it is @code{ETIMEDOUT}.
  600 This provides the option for a script starting @code{ntpd} to easily
  601 wait for the first set of the clock before proceeding.
  602 @node ntpd slew
  603 @subsection slew option (-x)
  604 @cindex ntpd-slew
  605 
  606 This is the ``slew up to 600 seconds'' option.
  607 Normally, the time is slewed if the offset is less than the step threshold, which is 128 ms by default, and stepped if above the threshold.
  608 This option sets the threshold to 600 s, which is well within the accuracy window to set the clock manually.
  609 Note: Since the slew rate of typical Unix kernels is limited to 0.5 ms/s, each second of adjustment requires an amortization interval of 2000 s.
  610 Thus, an adjustment as much as 600 s will take almost 14 days to complete.
  611 This option can be used with the
  612 @code{-g}
  613 and
  614 @code{-q}
  615 options.
  616 See the
  617 @code{tinker}
  618 configuration file directive for other options.
  619 Note: The kernel time discipline is disabled with this option.
  620 @node ntpd usepcc
  621 @subsection usepcc option
  622 @cindex ntpd-usepcc
  623 
  624 This is the ``use cpu cycle counter (windows only)'' option.
  625 
  626 @noindent
  627 This option has some usage constraints.  It:
  628 @itemize @bullet
  629 @item
  630 must be compiled in by defining @code{SYS_WINNT} during the compilation.
  631 @end itemize
  632 
  633 Attempt to substitute the CPU counter for @code{QueryPerformanceCounter}.
  634 The CPU counter and @code{QueryPerformanceCounter} are compared, and if
  635 they have the same frequency, the CPU counter (RDTSC on x86) is
  636 used directly, saving the overhead of a system call.
  637 @node ntpd pccfreq
  638 @subsection pccfreq option
  639 @cindex ntpd-pccfreq
  640 
  641 This is the ``force cpu cycle counter use (windows only)'' option.
  642 This option takes a string argument.
  643 
  644 @noindent
  645 This option has some usage constraints.  It:
  646 @itemize @bullet
  647 @item
  648 must be compiled in by defining @code{SYS_WINNT} during the compilation.
  649 @end itemize
  650 
  651 Force substitution the CPU counter for @code{QueryPerformanceCounter}.
  652 The CPU counter (RDTSC on x86) is used unconditionally with the
  653 given frequency (in Hz).
  654 @node ntpd mdns
  655 @subsection mdns option (-m)
  656 @cindex ntpd-mdns
  657 
  658 This is the ``register with mdns as a ntp server'' option.
  659 
  660 @noindent
  661 This option has some usage constraints.  It:
  662 @itemize @bullet
  663 @item
  664 must be compiled in by defining @code{HAVE_DNSREGISTRATION} during the compilation.
  665 @end itemize
  666 
  667 Registers as an NTP server with the local mDNS server which allows
  668 the server to be discovered via mDNS client lookup.
  669 
  670 
  671 @node ntpd config
  672 @subsection presetting/configuring ntpd
  673 
  674 Any option that is not marked as @i{not presettable} may be preset by
  675 loading values from environment variables named @code{NTPD} and @code{NTPD_<OPTION_NAME>}.  @code{<OPTION_NAME>} must be one of
  676 the options listed above in upper case and segmented with underscores.
  677 The @code{NTPD} variable will be tokenized and parsed like
  678 the command line.  The remaining variables are tested for existence and their
  679 values are treated like option arguments.
  680 
  681 
  682 The command line options relating to configuration and/or usage help are:
  683 
  684 @subsubheading version (-)
  685 
  686 Print the program version to standard out, optionally with licensing
  687 information, then exit 0.  The optional argument specifies how much licensing
  688 detail to provide.  The default is to print just the version.  The licensing infomation may be selected with an option argument.
  689 Only the first letter of the argument is examined:
  690 
  691 @table @samp
  692 @item version
  693 Only print the version.  This is the default.
  694 @item copyright
  695 Name the copyright usage licensing terms.
  696 @item verbose
  697 Print the full copyright usage licensing terms.
  698 @end table
  699 
  700 @node ntpd exit status
  701 @subsection ntpd exit status
  702 
  703 One of the following exit values will be returned:
  704 @table @samp
  705 @item 0 (EXIT_SUCCESS)
  706 Successful program execution.
  707 @item 1 (EXIT_FAILURE)
  708 The operation failed or the command syntax was not valid.
  709 @end table
  710 @node ntpd Usage
  711 @subsection ntpd Usage
  712 @node ntpd Files
  713 @subsection ntpd Files
  714 @node ntpd See Also
  715 @subsection ntpd See Also
  716 @node ntpd Bugs
  717 @subsection ntpd Bugs
  718 @node ntpd Notes
  719 @subsection ntpd Notes