| ntpd.8 (55857) | ntpd.8 (55895) |
|---|---|
| 1.\" | 1.\" |
| 2.\" $FreeBSD: head/usr.sbin/ntp/doc/ntpd.8 55857 2000-01-12 14:41:00Z sheldonh $ | 2.\" $FreeBSD: head/usr.sbin/ntp/doc/ntpd.8 55895 2000-01-13 09:59:55Z sheldonh $ |
| 3.\" 4.Dd January 10, 2000 5.Dt NTPD 8 6.Os 7.Sh NAME 8.Nm ntpd 9.Nd Network Time Protocol (NTP) daemon 10.Sh SYNOPSIS --- 39 unchanged lines hidden (view full) --- 50and configure itself automatically. 51This makes it possible to deploy a fleet of workstations 52without specifying configuration details 53specific to the local environment. 54.Pp 55Ordinarily, 56.Nm 57reads the | 3.\" 4.Dd January 10, 2000 5.Dt NTPD 8 6.Os 7.Sh NAME 8.Nm ntpd 9.Nd Network Time Protocol (NTP) daemon 10.Sh SYNOPSIS --- 39 unchanged lines hidden (view full) --- 50and configure itself automatically. 51This makes it possible to deploy a fleet of workstations 52without specifying configuration details 53specific to the local environment. 54.Pp 55Ordinarily, 56.Nm 57reads the |
| 58.Pa ntp.conf | 58.Xr ntp.conf 5 |
| 59configuration file at startup time 60in order to determine the synchronization sources and operating modes. 61It is also possible to specify a working, although limited, 62configuration entirely on the command line, 63obviating the need for a configuration file. 64This may be particularly appropriate 65when the local host is to be configured 66as a broadcast/multicast client or manycast client, --- 83 unchanged lines hidden (view full) --- 150.It Fl x 151Ordinarily, if the time is to be adjusted more than 128 ms, 152it is stepped, not gradually slewed. 153This option forces the time to be slewed in all cases. 154Note: since the slew rate is limited to 0.5 ms/s, 155each second of adjustment requires an amortization interval of 2000 s. 156Thus, an adjustment of many seconds can take hours or days to amortize. 157.El | 59configuration file at startup time 60in order to determine the synchronization sources and operating modes. 61It is also possible to specify a working, although limited, 62configuration entirely on the command line, 63obviating the need for a configuration file. 64This may be particularly appropriate 65when the local host is to be configured 66as a broadcast/multicast client or manycast client, --- 83 unchanged lines hidden (view full) --- 150.It Fl x 151Ordinarily, if the time is to be adjusted more than 128 ms, 152it is stepped, not gradually slewed. 153This option forces the time to be slewed in all cases. 154Note: since the slew rate is limited to 0.5 ms/s, 155each second of adjustment requires an amortization interval of 2000 s. 156Thus, an adjustment of many seconds can take hours or days to amortize. 157.El |
| 158.Ss The Configuration File 159The 160.Nm 161configuration file is read at initial startup by the 162.Xr ntpd 8 163daemon in order to specify the synchronization sources, 164modes and other related information. 165Usually, it is installed in the 166.Pa /etc 167directory, 168but could be installed elsewhere 169(see the daemon's 170.Fl c 171command line option). 172.Pp 173The file format is similar to other Unix configuration files. 174Comments begin with a 175.Qq # 176character and extend to the end of the line; 177blank lines are ignored. 178Configuration commands consist of an initial keyword 179followed by a list of arguments, 180some of which may be optional, separated by whitespace. 181Commands may not be continued over multiple lines. 182Arguments may be host names, 183host addresses written in numeric, dotted-quad form, 184integers, floating point numbers (when specifying times in seconds) 185and text strings. 186.Pp 187See the following pages for configuration and control options. 188While there is a rich set of options available, 189the only required option is one or more 190.Ic server , 191.Ic peer , 192.Ic broadcast 193or 194.Ic manycastclient 195commands 196described in 197.Xr ntp_conf 8 . 198.Pp 199.Bl -tag -width ntp_clockX8X -compact 200.It Xr ntp_conf 8 201Configuration Options 202.It Xr ntp_auth 8 203Authentication Options 204.It Xr ntp_mon 8 205Monitoring Options 206.It Xr ntp_acc 8 207Access Control Options 208.It Xr ntp_clock 8 209Reference Clock Options 210.It Xr ntp_misc 8 211Miscellaneous Options 212.Pp 213.El 214The 215.Qo 216Notes on Configuring NTP and Setting up a NTP Subnet 217.Qc 218page 219(available as part of the HTML documentation 220provided in 221.Pa /usr/share/doc/ntp ) 222contains an extended discussion of these options. | |
| 223.Sh FILES 224.Bl -tag -width /etc/ntp.drift -compact 225.It Pa /etc/ntp.conf 226the default name of the configuration file 227.It Pa /etc/ntp.drift 228the default name of the drift file 229.It Pa /etc/ntp.keys 230the default name of the key file 231.El | 158.Sh FILES 159.Bl -tag -width /etc/ntp.drift -compact 160.It Pa /etc/ntp.conf 161the default name of the configuration file 162.It Pa /etc/ntp.drift 163the default name of the drift file 164.It Pa /etc/ntp.keys 165the default name of the key file 166.El |
| 167.Ss Variables 168Most variables used by the NTP protocol 169can be examined with 170.Xr ntpdc 8 171(mode 7 messages) and 172.Xr ntpq 8 (mode 6 messages). 173Currently, very few variables can be modified via mode 6 messages. 174These variables are either created with the 175.Ic setvar 176directive 177(described in the 178.Qq Miscellaneous Options 179section of the 180.Xr ntp.conf 5 181page) 182or the leap warning bits. 183The leap warning bits can be set in the 184.Va leapwarning 185variable up to one month ahead. 186Both the 187.Va leapwarning 188and 189.Va leapindication 190variables have a slightly different encoding 191than the usual leap bits interpretation: 192.Pp 193.Bl -tag -width indent -compact 194.It 00 195The daemon passes the leap bits of its synchronization source 196(usual mode of operation). 197.It 01 198.It 10 199A leap second is added/deleted (operator forced leap second). 200.It 11 201Leap information from the synchronizations source is ignored 202(thus 203.Dv LEAP_NOWARNING 204is passed on). 205.El |
|
| 232.Sh SEE ALSO | 206.Sh SEE ALSO |
| 233.Xr ntp_acc 8 , 234.Xr ntp_auth 8 , 235.Xr ntp_clock 8 , 236.Xr ntp_conf 8 , 237.Xr ntp_misc 8 , 238.Xr ntp_mon 8 , | 207.Xr ntp.conf 5 , |
| 239.Xr ntpdate 8 , 240.Xr ntpdc 8 , 241.Xr ntpq 8 242.Pp 243In addition to the manual pages provided, 244comprehensive documentation is available on the world wide web 245at 246.Li http://www.ntp.org/ . --- 32 unchanged lines hidden --- | 208.Xr ntpdate 8 , 209.Xr ntpdc 8 , 210.Xr ntpq 8 211.Pp 212In addition to the manual pages provided, 213comprehensive documentation is available on the world wide web 214at 215.Li http://www.ntp.org/ . --- 32 unchanged lines hidden --- |