ntp-wait(8)

ntp-wait8

Wait for ntpd to stabilize the system clock

Usage

ntp-wait [-flags] [-flag [value]] [--option-name [[{= | }] value]]

Overview

ntp-wait will send at most num-tries queries to ntpd(8), sleeping for secs-between-tries after each status return that says ntpd(8) has not yet produced a synchronized and stable system clock.

ntp-wait will do this quietly, unless the -v flag is provided. This can be useful at boot time, to delay the boot sequence until after ntpd -g has set the time.

Options

-n number, --tries=number

Number of times to check ntpd. This option takes an integer number as its argument. The default number for this option is:
100

The maximum number of times we will check ntpd to see if
it has been able to synchronize and stabilize the system clock.

-s secs-between-tries, --sleep=secs-between-tries

How long to sleep between tries. This option takes an integer number as its argument. The default secs-between-tries for this option is:
6

We will sleep for secs-between-tries after each query
of ntpd that returns "the time is not yet stable".

-v, --verbose

Be verbose.

By default, ntp-wait is silent.
With this option, ntp-wait will provide status information.

-?, --help

Display usage information and exit.

-!, --more-help

Pass the extended usage information through a pager.

-v [{v|c|n --version [{v|c|n}]}]

Output version of program and exit. The default mode is `v', a simple version. The `c' mode will print copyright information and `n' will print the full copyright notice.

Exit status

One of the following exit values will be returned:

0 (EXIT_SUCCESS)

Successful program execution.

1 (EXIT_FAILURE)

The operation failed or the command syntax was not valid.

70 (EX_SOFTWARE)

libopts had an internal operational error. Please report it to [email protected]. Thank you.

Notes

This document corresponds to version 4.2.8p15 of NTP.

This manual page was AutoGen-erated from the ntp-wait option definitions.

Releases

8 releases since Debian 4.0 (Etch); the text changed 3 times.

  1. 4.0–5.0
  2. 6.0–9
  3. 10
  4. 11

-! since Debian 10 (Buster); --help since Debian 10 (Buster); --more-help since Debian 10 (Buster); --sleep since Debian 10 (Buster); --tries since Debian 10 (Buster); --verbose since Debian 10 (Buster); --version since Debian 10 (Buster); -? since Debian 10 (Buster).

-f until Debian 9 (Stretch).

Authors

Harlan Stenn

From ntp 1:4.2.8p15+dfsg-1 in Debian 11 (Bullseye). Parsed by carta from the page's mdoc source.