1NTPWAIT(8) NTPsec NTPWAIT(8)
2
3
4
6 ntpwait - wait for ntpd to stabilize the system clock
7
9 ntpwait [-vV] [-n number] [-s secs]
10
12 The ntpwait program blocks until ntpd is in synchronized state. This
13 can be useful at boot time, to delay the boot sequence until after
14 "ntpd -g" has set the time.
15
16 ntpwait will send at most number queries to ntpd(8), sleeping for secs
17 seconds after each status return that says ntpd(8) has not yet produced
18 a synchronized and stable system clock.
19
20 ntpwait will do this quietly, unless the -v flag is provided.
21
23 -n number, --tries=number
24 Number of times to check ntpd. This option takes an integer number
25 as its argument. The default number for this option is: 100.
26
27 The maximum number of times we will check ntpd to see if it has
28 been able to synchronize and stabilize the system clock.
29
30 -s secs-between-tries, --sleep=secs-between-tries
31 How long to sleep between tries. This option takes an integer
32 number as its argument. The default secs-between-tries for this
33 option is: 6.
34
35 We will sleep for secs-between-tries after each query of ntpd that
36 returns "the time is not yet stable".
37
38 -v, --verbose
39 Be verbose.
40
41 By default, ntpwait is silent. With this option, ntpwait will
42 provide status information, including time to synchronization in
43 seconds.
44
45 -V, --version
46 Print the version string and exit.
47
49 If you are running Python at a version older than 3.3, the report on
50 time to synchronization may be thrown off by NTP clock stepping.
51
53 One of the following exit values will be returned:
54
55 0
56 Successful program execution.
57
58 1
59 The operation failed or the command syntax was not valid.
60
61 2
62 Operation was interrupted by signal.
63
64
65
66NTPsec 2023-08-03 NTPWAIT(8)