ntpd leap-seconds-list file not documented

[RW]

On Mon, 16 May 2016 09:01:13 -0400
Ernie Luzar wrote:

> The 10.3 version of ntpd that is included in the base release has
> manual pages that do not mention anything about the 
> /var/db/ntpd.leap-seconds.list file
> 
> or the
> 
> daily_ntpd_leapfile_enable="YES"
> daily_ntpd_avoid_congestion="YES"
> options in /etc/periodic.conf
> 

This kind of thing is often not documented in man pages, but it seems
fairly well documented in the relevant files, see below. 

The only confusing thing is daily_ntpd_avoid_congestion, which needs
to be set to NO if the machine doesn't run 24/7. 


from ntp.conf

# See http://support.ntp.org/bin/view/Support/ConfiguringNTP#Section_6.14.
# for documentation regarding leapfile. Updates to the file can be obtained
# from ftp://time.nist.gov/pub/ or ftp://tycho.usno.navy.mil/pub/ntp/.
# Use either leapfile in /etc/ntp or weekly updated leapfile in /var/db.
#leapfile "/etc/ntp/leap-seconds"
leapfile "/var/db/ntpd.leap-seconds.list"



from defaults/rc.conf

ntp_src_leapfile="/etc/ntp/leap-seconds"
                                # Initial source for ntpd leapfile
ntp_db_leapfile="/var/db/ntpd.leap-seconds.list"
                                # Working copy (updated weekly) leapfile
ntp_leapfile_sources="https://www.ietf.org/timezones/data/leap-seconds.list"
                                # Source from which to fetch leapfile
ntp_leapfile_fetch_opts="-mq"   # Options to use for ntp leapfile fetch,
                                # e.g. --no-verify-peer
ntp_leapfile_expiry_days=30     # Check for new leapfile 30 days prior
to # expiry.
ntp_leapfile_fetch_verbose="NO" # Be verbose during NTP leapfile fetch



from defaults/periodic.conf

daily_ntpd_leapfile_enable="NO"      # Fetch NTP leapfile
daily_ntpd_avoid_congestion="YES"    # Avoid congesting
                                     # leapfile sources