aboutsummaryrefslogtreecommitdiff
path: root/contrib/ntp/scripts/ntp-wait/invoke-ntp-wait.texi
blob: 3387634b1df70a2bd04c1afaafbe4b1124fec88d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
@node ntp-wait Invocation
@section Invoking ntp-wait
@pindex ntp-wait
@cindex Wait for ntpd to stabilize the system clock
@ignore
#
# EDIT THIS FILE WITH CAUTION  (invoke-ntp-wait.texi)
#
# It has been AutoGen-ed  June  2, 2016 at 07:24:39 AM by AutoGen 5.18.5
# From the definitions    ntp-wait-opts.def
# and the template file   agtexi-cmd.tpl
@end ignore



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

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

This section was generated by @strong{AutoGen},
using the @code{agtexi-cmd} template and the option descriptions for the @code{ntp-wait} program.

@menu
* ntp-wait usage::                  ntp-wait help/usage (@option{--help})
* ntp-wait tries::                  tries option (-n)
* ntp-wait sleep::                  sleep option (-s)
* ntp-wait verbose::                verbose option (-v)
* ntp-wait exit status::            exit status
* ntp-wait Authors::                Authors
* ntp-wait Notes::                  Notes
@end menu

@node ntp-wait usage
@subsection ntp-wait help/usage (@option{--help})
@cindex ntp-wait help

This is the automatically generated usage text for ntp-wait.

The text printed is the same whether selected with the @code{help} option
(@option{--help}) or the @code{more-help} option (@option{--more-help}).  @code{more-help} will print
the usage text by passing it through a pager program.
@code{more-help} is disabled on platforms without a working
@code{fork(2)} function.  The @code{PAGER} environment variable is
used to select the program, defaulting to @file{more}.  Both will exit
with a status code of 0.

@exampleindent 0
@example
ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p8
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... 

    -n, --tries=num              Number of times to check ntpd
    -s, --sleep=num              How long to sleep between tries
    -v, --verbose                Be verbose
    -?, --help                   Display usage information and exit
        --more-help              Pass the extended usage text through a pager

Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
@end example
@exampleindent 4

@node ntp-wait tries
@subsection tries option (-n)
@cindex ntp-wait-tries

This is the ``number of times to check ntpd'' option.
This option takes a number argument.
        The maximum number of times we will check @code{ntpd} to see if
        it has been able to synchronize and stabilize the system clock.
@node ntp-wait sleep
@subsection sleep option (-s)
@cindex ntp-wait-sleep

This is the ``how long to sleep between tries'' option.
This option takes a number argument @file{secs-between-tries}.
        We will sleep for @file{secs-between-tries} after each query
        of @code{ntpd} that returns "the time is not yet stable".
@node ntp-wait verbose
@subsection verbose option (-v)
@cindex ntp-wait-verbose

This is the ``be verbose'' option.
        By default, @code{ntp-wait} is silent.
        With this option, @code{ntp-wait} will provide status information.
@node ntp-wait exit status
@subsection ntp-wait exit status

One of the following exit values will be returned:
@table @samp
@item 0 (EXIT_SUCCESS)
Successful program execution.
@item 1 (EXIT_FAILURE)
The operation failed or the command syntax was not valid.
@end table
@node ntp-wait Authors
@subsection ntp-wait Authors
@node ntp-wait Notes
@subsection ntp-wait Notes