~ubuntu-branches/ubuntu/lucid/ntp/lucid

« back to all changes in this revision

Viewing changes to debian/man/ntpq.1

  • Committer: Bazaar Package Importer
  • Author(s): Scott Kitterman
  • Date: 2008-02-25 19:36:36 UTC
  • Revision ID: james.westby@ubuntu.com-20080225193636-nrgs3sx4twsui2ut
Tags: 1:4.2.4p4+dfsg-3ubuntu1
* Merge from debian unstable, remaining changes:
  - debian/ntp.conf, debian/ntpdate.default:
    - Change default server to ntp.ubuntu.com.
  - debian/rules:
    - Call update-rcd-params with multiuser instead defaults.
  - debian/control:
    - Set Ubuntu maintainer address.
    - Update version in conflicts/replaces to that which was shipped in
      edgy, which was later than that in Debian (due to the ubuntuX).
    - Add sysv-rc dependency.
  - debian/ntp-server.postinst:
    - Remove stop script symlinks from rc0 and rc6.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
.\" transcribed from ntp 4.2.2p3
2
 
.TH NTPQ 1 "October 7, 2006" "Network Time Protocol"
 
2
.TH NTPQ 1 "November 9, 2007" "Network Time Protocol"
3
3
.SH NAME
4
4
ntpq \- standard NTP query program
5
5
.SH SYNOPSIS
10
10
.PP
11
11
The program can be run either in interactive mode or controlled using command line arguments. Requests to read and write arbitrary variables can be assembled, with raw and pretty-printed output options being available. The ntpq can also obtain and print a list of peers in a common format by sending multiple queries to the server.
12
12
.PP
13
 
If one or more request options is included on the command line when ntpq is executed, each of the requests will be sent to the NTP servers running on each of the hosts given as command line arguments, or on localhost by default. If no request options are given, ntpq will attempt to read commands from the standard input and execute these on the NTP server running on the first host given on the command line, again defaulting to localhost when no other host is specified. ntpqwill prompt for commands if the standard input is a terminal device.
 
13
If one or more request options is included on the command line when ntpq is executed, each of the requests will be sent to the NTP servers running on each of the hosts given as command line arguments, or on localhost by default. If no request options are given, ntpq will attempt to read commands from the standard input and execute these on the NTP server running on the first host given on the command line, again defaulting to localhost when no other host is specified. ntpq will prompt for commands if the standard input is a terminal device.
14
14
.PP
15
15
ntpq uses NTP mode 6 packets to communicate with the NTP server, and hence can be used to query any compatible server on the network which permits it. Note that since NTP is a UDP protocol this communication will be somewhat unreliable, especially over large distances in terms of network topology. ntpq makes one attempt to retransmit requests, and will time requests out if the remote host is not heard from within a suitable timeout time.
16
16
.PP