ntp-wait.mdoc.in revision 294904
1168404Spjd.Dd January 20 2016 2168404Spjd.Dt NTP_WAIT @NTP_WAIT_MS@ User Commands 3168404Spjd.Os 4168404Spjd.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc) 5168404Spjd.\" 6168404Spjd.\" It has been AutoGen-ed January 20, 2016 at 04:09:59 AM by AutoGen 5.18.5 7168404Spjd.\" From the definitions ntp-wait-opts.def 8168404Spjd.\" and the template file agmdoc-cmd.tpl 9168404Spjd.Sh NAME 10168404Spjd.Nm ntp-wait 11168404Spjd.Nd Wait for ntpd to stabilize the system clock 12168404Spjd.Sh SYNOPSIS 13168404Spjd.Nm 14168404Spjd.\" Mixture of short (flag) options and long options 15168404Spjd.Op Fl flags 16168404Spjd.Op Fl flag Op Ar value 17168404Spjd.Op Fl \-option\-name Ns Oo Oo Ns "=| " Oc Ns Ar value Oc 18168404Spjd.Pp 19168404SpjdAll arguments must be options. 20168404Spjd.Pp 21168404Spjd.Sh DESCRIPTION 22168404Spjd.Nm 23185029Spjdwill send at most 24168404Spjd.Ar num\-tries 25168404Spjdqueries to 26168404Spjd.Xr ntpd 8 , 27168404Spjdsleeping for 28168404Spjd.Ar secs\-between\-tries 29168404Spjdafter each status return that says 30168404Spjd.Xr ntpd 8 31168404Spjdhas not yet produced a synchronized and stable system clock. 32168404Spjd.Pp 33168404Spjd.Nm 34168404Spjdwill do this quietly, unless the 35168404Spjd.Fl v 36168404Spjdflag is provided. 37168404SpjdThis can be useful at boot time, to delay the boot sequence until after 38185029Spjd.Ar ntpd \-g 39168404Spjdhas set the time. 40168404Spjd.Sh "OPTIONS" 41168404Spjd.Bl -tag 42168404Spjd.It Fl n Ar number , Fl \-tries Ns = Ns Ar number 43168404SpjdNumber of times to check ntpd. 44168404SpjdThis option takes an integer number as its argument. 45168404SpjdThe default 46168404Spjd.Ar number 47168404Spjdfor this option is: 48168404Spjd.ti +4 49168404Spjd 100 50168404Spjd.sp 51168404Spjd The maximum number of times we will check \fBntpd\fP to see if 52168404Spjd it has been able to synchronize and stabilize the system clock. 53168404Spjd.It Fl s Ar secs\-between\-tries , Fl \-sleep Ns = Ns Ar secs\-between\-tries 54168404SpjdHow long to sleep between tries. 55168404SpjdThis option takes an integer number as its argument. 56168404SpjdThe default 57168404Spjd.Ar secs\-between\-tries 58168404Spjdfor this option is: 59168404Spjd.ti +4 60168404Spjd 6 61168404Spjd.sp 62168404Spjd We will sleep for \fIsecs\-between\-tries\fP after each query 63185029Spjd of \fBntpd\fP that returns "the time is not yet stable". 64168404Spjd.It Fl v , Fl \-verbose 65168404SpjdBe verbose. 66168404Spjd.sp 67168404Spjd By default, \fBntp\-wait\fP is silent. 68168404Spjd With this option, \fBntp\-wait\fP will provide status information. 69168404Spjd.It Fl \&? , Fl \-help 70168404SpjdDisplay usage information and exit. 71168404Spjd.It Fl \&! , Fl \-more\-help 72168404SpjdPass the extended usage information through a pager. 73168404Spjd.It Fl v Op Brq Ar v|c|n Fl \-version Op Brq Ar v|c|n 74168404SpjdOutput version of program and exit. The default mode is `v', a simple 75168404Spjdversion. The `c' mode will print copyright information and `n' will 76168404Spjdprint the full copyright notice. 77168404Spjd.El 78168404Spjd.Sh "EXIT STATUS" 79168404SpjdOne of the following exit values will be returned: 80168404Spjd.Bl -tag 81168404Spjd.It 0 " (EXIT_SUCCESS)" 82168404SpjdSuccessful program execution. 83168404Spjd.It 1 " (EXIT_FAILURE)" 84168404SpjdThe operation failed or the command syntax was not valid. 85168404Spjd.It 70 " (EX_SOFTWARE)" 86168404Spjdlibopts had an internal operational error. Please report 87168404Spjdit to autogen\-users@lists.sourceforge.net. Thank you. 88168404Spjd.El 89168404Spjd.Sh AUTHORS 90168404Spjd.An "Harlan Stenn" 91168404Spjd.Sh NOTES 92168404SpjdThis document corresponds to version @VERSION@ of NTP. 93168404Spjd.Pp 94168404SpjdThis manual page was \fIAutoGen\fP\-erated from the \fBntp\-wait\fP 95168404Spjdoption definitions. 96168404Spjd