1275970Scy@node ntp-wait Invocation 2275970Scy@section Invoking ntp-wait 3275970Scy@pindex ntp-wait 4275970Scy@cindex Wait for ntpd to stabilize the system clock 5275970Scy@ignore 6275970Scy# 7275970Scy# EDIT THIS FILE WITH CAUTION (invoke-ntp-wait.texi) 8275970Scy# 9338531Sdelphij# It has been AutoGen-ed August 14, 2018 at 08:09:07 AM by AutoGen 5.18.5 10275970Scy# From the definitions ntp-wait-opts.def 11275970Scy# and the template file agtexi-cmd.tpl 12275970Scy@end ignore 13275970Scy 14275970Scy 15275970Scy 16275970Scy@code{ntp-wait} 17275970Scywill send at most 18275970Scy@kbd{num-tries} 19275970Scyqueries to 20275970Scy@code{ntpd(8)}, 21275970Scysleeping for 22275970Scy@kbd{secs-between-tries} 23275970Scyafter each status return that says 24275970Scy@code{ntpd(8)} 25275970Scyhas not yet produced a synchronized and stable system clock. 26275970Scy 27275970Scy@code{ntp-wait} 28275970Scywill do this quietly, unless the 29275970Scy@code{-v} 30275970Scyflag is provided. 31275970ScyThis can be useful at boot time, to delay the boot sequence until after 32275970Scy@kbd{ntpd} @kbd{-g} 33275970Scyhas set the time. 34275970Scy 35275970ScyThis section was generated by @strong{AutoGen}, 36275970Scyusing the @code{agtexi-cmd} template and the option descriptions for the @code{ntp-wait} program. 37275970Scy 38275970Scy@menu 39275970Scy* ntp-wait usage:: ntp-wait help/usage (@option{--help}) 40275970Scy* ntp-wait tries:: tries option (-n) 41275970Scy* ntp-wait sleep:: sleep option (-s) 42275970Scy* ntp-wait verbose:: verbose option (-v) 43275970Scy* ntp-wait exit status:: exit status 44275970Scy* ntp-wait Authors:: Authors 45275970Scy* ntp-wait Notes:: Notes 46275970Scy@end menu 47275970Scy 48275970Scy@node ntp-wait usage 49275970Scy@subsection ntp-wait help/usage (@option{--help}) 50275970Scy@cindex ntp-wait help 51275970Scy 52275970ScyThis is the automatically generated usage text for ntp-wait. 53275970Scy 54275970ScyThe text printed is the same whether selected with the @code{help} option 55275970Scy(@option{--help}) or the @code{more-help} option (@option{--more-help}). @code{more-help} will print 56275970Scythe usage text by passing it through a pager program. 57275970Scy@code{more-help} is disabled on platforms without a working 58275970Scy@code{fork(2)} function. The @code{PAGER} environment variable is 59275970Scyused to select the program, defaulting to @file{more}. Both will exit 60275970Scywith a status code of 0. 61275970Scy 62275970Scy@exampleindent 0 63275970Scy@example 64338531Sdelphijntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p12 65275970ScyUSAGE: ntp-wait [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... 66275970Scy 67275970Scy -n, --tries=num Number of times to check ntpd 68275970Scy -s, --sleep=num How long to sleep between tries 69275970Scy -v, --verbose Be verbose 70275970Scy -?, --help Display usage information and exit 71275970Scy --more-help Pass the extended usage text through a pager 72275970Scy 73275970ScyOptions are specified by doubled hyphens and their name or by a single 74275970Scyhyphen and the flag character. 75275970Scy@end example 76275970Scy@exampleindent 4 77275970Scy 78275970Scy@node ntp-wait tries 79275970Scy@subsection tries option (-n) 80275970Scy@cindex ntp-wait-tries 81275970Scy 82275970ScyThis is the ``number of times to check ntpd'' option. 83275970ScyThis option takes a number argument. 84275970Scy The maximum number of times we will check @code{ntpd} to see if 85275970Scy it has been able to synchronize and stabilize the system clock. 86275970Scy@node ntp-wait sleep 87275970Scy@subsection sleep option (-s) 88275970Scy@cindex ntp-wait-sleep 89275970Scy 90275970ScyThis is the ``how long to sleep between tries'' option. 91275970ScyThis option takes a number argument @file{secs-between-tries}. 92275970Scy We will sleep for @file{secs-between-tries} after each query 93275970Scy of @code{ntpd} that returns "the time is not yet stable". 94275970Scy@node ntp-wait verbose 95275970Scy@subsection verbose option (-v) 96275970Scy@cindex ntp-wait-verbose 97275970Scy 98275970ScyThis is the ``be verbose'' option. 99275970Scy By default, @code{ntp-wait} is silent. 100275970Scy With this option, @code{ntp-wait} will provide status information. 101275970Scy@node ntp-wait exit status 102275970Scy@subsection ntp-wait exit status 103275970Scy 104275970ScyOne of the following exit values will be returned: 105275970Scy@table @samp 106275970Scy@item 0 (EXIT_SUCCESS) 107275970ScySuccessful program execution. 108275970Scy@item 1 (EXIT_FAILURE) 109275970ScyThe operation failed or the command syntax was not valid. 110275970Scy@end table 111275970Scy@node ntp-wait Authors 112275970Scy@subsection ntp-wait Authors 113275970Scy@node ntp-wait Notes 114275970Scy@subsection ntp-wait Notes 115