1NTPSTAT(1)                  General Commands Manual                 NTPSTAT(1)
2
3
4

NAME

6       ntpstat - Print NTP synchronisation status
7
8

SYNOPSIS

10       ntpstat [-m MAXERROR]
11
12

DESCRIPTION

14       ntpstat  is a script which prints a brief summary of the system clock's
15       synchronisation status when the ntpd or chronyd daemon is running.   It
16       prints  the  time  source  (NTP server or reference clock) to which the
17       system clock is currently synchronised, its stratum, how often  is  the
18       server polled, and the maximum estimated error of the clock. The script
19       uses the ntpq or chronyc program to obtain  the  information  from  the
20       daemon.
21
22       Following  the  NTPv4  specification  (RFC  5905),  if  the time source
23       becomes unreachable and there  are  no  other  sources  that  could  be
24       selected, the status of the clock will still be “synchronised”, but the
25       maximum error will be slowly increasing.
26
27       ntpstat exits with a status of 0 if the clock is synchronised, 1 if the
28       clock  is  not  synchronised,  2 if the status could not be determined,
29       e.g.  when the daemon is not running, or 3 if an  invalid  command-line
30       option was specified.
31
32

OPTIONS

34       -m MAXERROR
35               Specify  a  maximum  acceptable error of the clock in millisec‐
36               onds. If the clock is synchronised, but its  maximum  estimated
37               error is larger than MAXERROR, or is unknown, ntpstat will exit
38               with a status of 1.
39
40       -h      Print a help message.
41
42

SEE ALSO

44       ntpd(8), ntpq(8), chronyd(8), chronyc(1)
45
46
47
48ntpstat                                                             NTPSTAT(1)
Impressum