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>