Annotation of embedaddon/ntp/ntpdc/ntpdc-opts.texi, revision 1.1.1.1

1.1       misho       1: @node ntpdc Invocation
                      2: @section Invoking ntpdc
                      3: @pindex ntpdc
                      4: @cindex vendor-specific NTP query program
                      5: @ignore
                      6: # 
                      7: # EDIT THIS FILE WITH CAUTION  (ntpdc-opts.texi)
                      8: # 
                      9: # It has been AutoGen-ed  December 24, 2011 at 06:34:25 PM by AutoGen 5.12
                     10: # From the definitions    ntpdc-opts.def
                     11: # and the template file   aginfo.tpl
                     12: @end ignore
                     13: This program has no explanation.
                     14: 
                     15: The
                     16: [= prog-name =]
                     17: utility program is used to query an NTP daemon about its
                     18: current state and to request changes in that state.
                     19: It uses NTP mode 7 control message formats described in the source code.
                     20: The program may
                     21: be run either in interactive mode or controlled using command line
                     22: arguments.
                     23: Extensive state and statistics information is available
                     24: through the
                     25: [= prog-name =]
                     26: interface.
                     27: In addition, nearly all the
                     28: configuration options which can be specified at startup using
                     29: ntpd's configuration file may also be specified at run time using
                     30: [= prog-name =] .
                     31: 
                     32: 
                     33: 
                     34: This section was generated by @strong{AutoGen},
                     35: the aginfo template and the option descriptions for the @command{ntpdc} program.  It documents the @command{ntpdc} usage text and option meanings.
                     36: 
                     37: This software is released under a specialized copyright license.
                     38: 
                     39: @menu
                     40: * ntpdc usage::                  ntpdc usage help (-?)
                     41: * ntpdc command::               command option (-c)
                     42: * ntpdc debug-level::           debug-level option (-d)
                     43: * ntpdc interactive::           interactive option (-i)
                     44: * ntpdc ipv4::                  ipv4 option (-4)
                     45: * ntpdc ipv6::                  ipv6 option (-6)
                     46: * ntpdc listpeers::             listpeers option (-l)
                     47: * ntpdc numeric::               numeric option (-n)
                     48: * ntpdc peers::                 peers option (-p)
                     49: * ntpdc set-debug-level::       set-debug-level option (-D)
                     50: * ntpdc showpeers::             showpeers option (-s)
                     51: @end menu
                     52: 
                     53: @node ntpdc usage
                     54: @subsection ntpdc usage help (-?)
                     55: @cindex ntpdc usage
                     56: 
                     57: This is the automatically generated usage text for ntpdc:
                     58: 
                     59: @exampleindent 0
                     60: @example
                     61: ntpdc - vendor-specific NTP query program - Ver. 4.2.6p5
                     62: USAGE:  ntpdc [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
                     63:   Flg Arg Option-Name    Description
                     64:    -4 no  ipv4           Force IPv4 DNS name resolution
                     65:                                 - prohibits these options:
                     66:                                 ipv6
                     67:    -6 no  ipv6           Force IPv6 DNS name resolution
                     68:                                 - prohibits these options:
                     69:                                 ipv4
                     70:    -c Str command        run a command and exit
                     71:                                 - may appear multiple times
                     72:    -l no  listpeers      Print a list of the peers
                     73:                                 - prohibits these options:
                     74:                                 command
                     75:    -p no  peers          Print a list of the peers
                     76:                                 - prohibits these options:
                     77:                                 command
                     78:    -s no  showpeers      Show a list of the peers
                     79:                                 - prohibits these options:
                     80:                                 command
                     81:    -i no  interactive    Force ntpq to operate in interactive mode
                     82:                                 - prohibits these options:
                     83:                                 command
                     84:                                 listpeers
                     85:                                 peers
                     86:                                 showpeers
                     87:    -d no  debug-level    Increase output debug message level
                     88:                                 - may appear multiple times
                     89:    -D Str set-debug-level Set the output debug message level
                     90:                                 - may appear multiple times
                     91:    -n no  numeric        numeric host addresses
                     92:       opt version        Output version information and exit
                     93:    -? no  help           Display extended usage information and exit
                     94:    -! no  more-help      Extended usage information passed thru pager
                     95:    -> opt save-opts      Save the option state to a config file
                     96:    -< Str load-opts      Load options from a config file
                     97:                                 - disabled as --no-load-opts
                     98:                                 - may appear multiple times
                     99: 
                    100: Options are specified by doubled hyphens and their name or by a single
                    101: hyphen and the flag character.
                    102: 
                    103: The following option preset mechanisms are supported:
                    104:  - reading file $HOME/.ntprc
                    105:  - reading file ./.ntprc
                    106:  - examining environment variables named NTPDC_*
                    107: 
                    108: The [= prog-name =] utility program is used to query an NTP daemon about
                    109: its current state and to request changes in that state.  It uses NTP mode
                    110: 7 control message formats described in the source code.  The program may
                    111: be run either in interactive mode or controlled using command line
                    112: arguments.  Extensive state and statistics information is available
                    113: through the [= prog-name =] interface.  In addition, nearly all the
                    114: configuration options which can be specified at startup using ntpd's
                    115: configuration file may also be specified at run time using [= prog-name =]
                    116: .
                    117: 
                    118: please send bug reports to:  http://bugs.ntp.org, bugs@@ntp.org
                    119: @end example
                    120: @exampleindent 4
                    121: 
                    122: @node ntpdc command
                    123: @subsection command option (-c)
                    124: @cindex ntpdc-command
                    125: 
                    126: This is the ``run a command and exit'' option.
                    127: 
                    128: This option has some usage constraints.  It:
                    129: @itemize @bullet
                    130: @item
                    131: may appear an unlimited number of times.
                    132: @end itemize
                    133: 
                    134: The following argument is interpreted as an interactive format command
                    135: and is added to the list of commands to be executed on the specified
                    136: host(s).
                    137: 
                    138: @node ntpdc debug-level
                    139: @subsection debug-level option (-d)
                    140: @cindex ntpdc-debug-level
                    141: 
                    142: This is the ``increase output debug message level'' option.
                    143: 
                    144: This option has some usage constraints.  It:
                    145: @itemize @bullet
                    146: @item
                    147: may appear an unlimited number of times.
                    148: @end itemize
                    149: 
                    150: Increase the debugging message output level.
                    151: 
                    152: @node ntpdc interactive
                    153: @subsection interactive option (-i)
                    154: @cindex ntpdc-interactive
                    155: 
                    156: This is the ``force ntpq to operate in interactive mode'' option.
                    157: 
                    158: This option has some usage constraints.  It:
                    159: @itemize @bullet
                    160: @item
                    161: must not appear in combination with any of the following options:
                    162: command, listpeers, peers, showpeers.
                    163: @end itemize
                    164: 
                    165: Force ntpq to operate in interactive mode.  Prompts will be written
                    166: to the standard output and commands read from the standard input.
                    167: 
                    168: @node ntpdc ipv4
                    169: @subsection ipv4 option (-4)
                    170: @cindex ntpdc-ipv4
                    171: 
                    172: This is the ``force ipv4 dns name resolution'' option.
                    173: 
                    174: This option has some usage constraints.  It:
                    175: @itemize @bullet
                    176: @item
                    177: must not appear in combination with any of the following options:
                    178: ipv6.
                    179: @end itemize
                    180: 
                    181: Force DNS resolution of following host names on the command line
                    182: to the IPv4 namespace.
                    183: 
                    184: @node ntpdc ipv6
                    185: @subsection ipv6 option (-6)
                    186: @cindex ntpdc-ipv6
                    187: 
                    188: This is the ``force ipv6 dns name resolution'' option.
                    189: 
                    190: This option has some usage constraints.  It:
                    191: @itemize @bullet
                    192: @item
                    193: must not appear in combination with any of the following options:
                    194: ipv4.
                    195: @end itemize
                    196: 
                    197: Force DNS resolution of following host names on the command line
                    198: to the IPv6 namespace.
                    199: 
                    200: @node ntpdc listpeers
                    201: @subsection listpeers option (-l)
                    202: @cindex ntpdc-listpeers
                    203: 
                    204: This is the ``print a list of the peers'' option.
                    205: 
                    206: This option has some usage constraints.  It:
                    207: @itemize @bullet
                    208: @item
                    209: must not appear in combination with any of the following options:
                    210: command.
                    211: @end itemize
                    212: 
                    213: Print a list of the peers known to the server as well as a summary of
                    214: their state. This is equivalent to the 'listpeers' interactive command.
                    215: 
                    216: @node ntpdc numeric
                    217: @subsection numeric option (-n)
                    218: @cindex ntpdc-numeric
                    219: 
                    220: This is the ``numeric host addresses'' option.
                    221: Output all host addresses in dotted-quad numeric format rather than
                    222: converting to the canonical host names. 
                    223: 
                    224: @node ntpdc peers
                    225: @subsection peers option (-p)
                    226: @cindex ntpdc-peers
                    227: 
                    228: This is the ``print a list of the peers'' option.
                    229: 
                    230: This option has some usage constraints.  It:
                    231: @itemize @bullet
                    232: @item
                    233: must not appear in combination with any of the following options:
                    234: command.
                    235: @end itemize
                    236: 
                    237: Print a list of the peers known to the server as well as a summary
                    238: of their state. This is equivalent to the 'peers' interactive command.
                    239: 
                    240: @node ntpdc set-debug-level
                    241: @subsection set-debug-level option (-D)
                    242: @cindex ntpdc-set-debug-level
                    243: 
                    244: This is the ``set the output debug message level'' option.
                    245: 
                    246: This option has some usage constraints.  It:
                    247: @itemize @bullet
                    248: @item
                    249: may appear an unlimited number of times.
                    250: @end itemize
                    251: 
                    252: Set the output debugging level.  Can be supplied multiple times,
                    253: but each overrides the previous value(s).
                    254: 
                    255: @node ntpdc showpeers
                    256: @subsection showpeers option (-s)
                    257: @cindex ntpdc-showpeers
                    258: 
                    259: This is the ``show a list of the peers'' option.
                    260: 
                    261: This option has some usage constraints.  It:
                    262: @itemize @bullet
                    263: @item
                    264: must not appear in combination with any of the following options:
                    265: command.
                    266: @end itemize
                    267: 
                    268: Print a list of the peers known to the server as well as a summary
                    269: of their state. This is equivalent to the 'dmpeers' interactive command.

FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>