Annotation of embedaddon/ntp/ntpq/ntpq-opts.texi, revision 1.1

1.1     ! misho       1: @node ntpq Invocation
        !             2: @section Invoking ntpq
        !             3: @pindex ntpq
        !             4: @cindex standard NTP query program
        !             5: @ignore
        !             6: # 
        !             7: # EDIT THIS FILE WITH CAUTION  (ntpq-opts.texi)
        !             8: # 
        !             9: # It has been AutoGen-ed  December 24, 2011 at 06:34:35 PM by AutoGen 5.12
        !            10: # From the definitions    ntpq-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 NTP servers which
        !            18: implement the standard NTP mode 6 control message formats defined
        !            19: in Appendix B of the NTPv3 specification RFC1305, requesting
        !            20: information about current state and/or changes in that state.
        !            21: The same formats are used in NTPv4, although some of the
        !            22: variables have changed and new ones added.
        !            23: 
        !            24: This section was generated by @strong{AutoGen},
        !            25: the aginfo template and the option descriptions for the @command{ntpq} program.  It documents the @command{ntpq} usage text and option meanings.
        !            26: 
        !            27: This software is released under a specialized copyright license.
        !            28: 
        !            29: @menu
        !            30: * ntpq usage::                  ntpq usage help (-?)
        !            31: * ntpq command::               command option (-c)
        !            32: * ntpq debug-level::           debug-level option (-d)
        !            33: * ntpq interactive::           interactive option (-i)
        !            34: * ntpq ipv4::                  ipv4 option (-4)
        !            35: * ntpq ipv6::                  ipv6 option (-6)
        !            36: * ntpq numeric::               numeric option (-n)
        !            37: * ntpq old-rv::                old-rv option
        !            38: * ntpq peers::                 peers option (-p)
        !            39: * ntpq set-debug-level::       set-debug-level option (-D)
        !            40: @end menu
        !            41: 
        !            42: @node ntpq usage
        !            43: @subsection ntpq usage help (-?)
        !            44: @cindex ntpq usage
        !            45: 
        !            46: This is the automatically generated usage text for ntpq:
        !            47: 
        !            48: @exampleindent 0
        !            49: @example
        !            50: ntpq - standard NTP query program - Ver. 4.2.6p5
        !            51: USAGE:  ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
        !            52:   Flg Arg Option-Name    Description
        !            53:    -4 no  ipv4           Force IPv4 DNS name resolution
        !            54:                                 - prohibits these options:
        !            55:                                 ipv6
        !            56:    -6 no  ipv6           Force IPv6 DNS name resolution
        !            57:                                 - prohibits these options:
        !            58:                                 ipv4
        !            59:    -c Str command        run a command and exit
        !            60:                                 - may appear multiple times
        !            61:    -d no  debug-level    Increase output debug message level
        !            62:                                 - may appear multiple times
        !            63:    -D Str set-debug-level Set the output debug message level
        !            64:                                 - may appear multiple times
        !            65:    -p no  peers          Print a list of the peers
        !            66:                                 - prohibits these options:
        !            67:                                 interactive
        !            68:    -i no  interactive    Force ntpq to operate in interactive mode
        !            69:                                 - prohibits these options:
        !            70:                                 command
        !            71:                                 peers
        !            72:    -n no  numeric        numeric host addresses
        !            73:       no  old-rv         Always output status line with readvar
        !            74:       opt version        Output version information and exit
        !            75:    -? no  help           Display extended usage information and exit
        !            76:    -! no  more-help      Extended usage information passed thru pager
        !            77:    -> opt save-opts      Save the option state to a config file
        !            78:    -< Str load-opts      Load options from a config file
        !            79:                                 - disabled as --no-load-opts
        !            80:                                 - may appear multiple times
        !            81: 
        !            82: Options are specified by doubled hyphens and their name or by a single
        !            83: hyphen and the flag character.
        !            84: 
        !            85: The following option preset mechanisms are supported:
        !            86:  - reading file $HOME/.ntprc
        !            87:  - reading file ./.ntprc
        !            88:  - examining environment variables named NTPQ_*
        !            89: 
        !            90: The [= prog-name =] utility program is used to query NTP servers which
        !            91: implement the standard NTP mode 6 control message formats defined in
        !            92: Appendix B of the NTPv3 specification RFC1305, requesting information
        !            93: about current state and/or changes in that state.  The same formats are
        !            94: used in NTPv4, although some of the variables have changed and new ones
        !            95: added.
        !            96: 
        !            97: please send bug reports to:  http://bugs.ntp.org, bugs@@ntp.org
        !            98: @end example
        !            99: @exampleindent 4
        !           100: 
        !           101: @node ntpq command
        !           102: @subsection command option (-c)
        !           103: @cindex ntpq-command
        !           104: 
        !           105: This is the ``run a command and exit'' option.
        !           106: 
        !           107: This option has some usage constraints.  It:
        !           108: @itemize @bullet
        !           109: @item
        !           110: may appear an unlimited number of times.
        !           111: @end itemize
        !           112: 
        !           113: The following argument is interpreted as an interactive format command
        !           114: and is added to the list of commands to be executed on the specified
        !           115: host(s).
        !           116: 
        !           117: @node ntpq debug-level
        !           118: @subsection debug-level option (-d)
        !           119: @cindex ntpq-debug-level
        !           120: 
        !           121: This is the ``increase output debug message level'' option.
        !           122: 
        !           123: This option has some usage constraints.  It:
        !           124: @itemize @bullet
        !           125: @item
        !           126: may appear an unlimited number of times.
        !           127: @end itemize
        !           128: 
        !           129: Increase the debugging message output level.
        !           130: 
        !           131: @node ntpq interactive
        !           132: @subsection interactive option (-i)
        !           133: @cindex ntpq-interactive
        !           134: 
        !           135: This is the ``force ntpq to operate in interactive mode'' option.
        !           136: 
        !           137: This option has some usage constraints.  It:
        !           138: @itemize @bullet
        !           139: @item
        !           140: must not appear in combination with any of the following options:
        !           141: command, peers.
        !           142: @end itemize
        !           143: 
        !           144: Force ntpq to operate in interactive mode.  Prompts will be written
        !           145: to the standard output and commands read from the standard input.
        !           146: 
        !           147: @node ntpq ipv4
        !           148: @subsection ipv4 option (-4)
        !           149: @cindex ntpq-ipv4
        !           150: 
        !           151: This is the ``force ipv4 dns name resolution'' option.
        !           152: 
        !           153: This option has some usage constraints.  It:
        !           154: @itemize @bullet
        !           155: @item
        !           156: must not appear in combination with any of the following options:
        !           157: ipv6.
        !           158: @end itemize
        !           159: 
        !           160: Force DNS resolution of following host names on the command line
        !           161: to the IPv4 namespace.
        !           162: 
        !           163: @node ntpq ipv6
        !           164: @subsection ipv6 option (-6)
        !           165: @cindex ntpq-ipv6
        !           166: 
        !           167: This is the ``force ipv6 dns name resolution'' option.
        !           168: 
        !           169: This option has some usage constraints.  It:
        !           170: @itemize @bullet
        !           171: @item
        !           172: must not appear in combination with any of the following options:
        !           173: ipv4.
        !           174: @end itemize
        !           175: 
        !           176: Force DNS resolution of following host names on the command line
        !           177: to the IPv6 namespace.
        !           178: 
        !           179: @node ntpq numeric
        !           180: @subsection numeric option (-n)
        !           181: @cindex ntpq-numeric
        !           182: 
        !           183: This is the ``numeric host addresses'' option.
        !           184: Output all host addresses in dotted-quad numeric format rather than
        !           185: converting to the canonical host names. 
        !           186: 
        !           187: @node ntpq old-rv
        !           188: @subsection old-rv option
        !           189: @cindex ntpq-old-rv
        !           190: 
        !           191: This is the ``always output status line with readvar'' option.
        !           192: By default, ntpq now suppresses the associd=... line that
        !           193: precedes the output of "readvar" (alias "rv") when a single
        !           194: variable is requested, such as ntpq -c "rv 0 offset".  This
        !           195: option causes ntpq to include both lines of output for a
        !           196: single-variable readvar.  Using an environment variable to
        !           197: preset this option in a script will enable both older and
        !           198: newer ntpq to behave identically in this regard.
        !           199: 
        !           200: @node ntpq peers
        !           201: @subsection peers option (-p)
        !           202: @cindex ntpq-peers
        !           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: interactive.
        !           211: @end itemize
        !           212: 
        !           213: Print a list of the peers known to the server as well as a summary
        !           214: of their state. This is equivalent to the 'peers' interactive command.
        !           215: 
        !           216: @node ntpq set-debug-level
        !           217: @subsection set-debug-level option (-D)
        !           218: @cindex ntpq-set-debug-level
        !           219: 
        !           220: This is the ``set the output debug message level'' option.
        !           221: 
        !           222: This option has some usage constraints.  It:
        !           223: @itemize @bullet
        !           224: @item
        !           225: may appear an unlimited number of times.
        !           226: @end itemize
        !           227: 
        !           228: Set the output debugging level.  Can be supplied multiple times,
        !           229: but each overrides the previous value(s).

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