mirror of
https://github.com/openembedded/meta-openembedded.git
synced 2026-06-05 02:50:46 +00:00
chrony: Versatile implementation of NTP
chrony is an alternative to ntpd. In particular it may be useful for quasi-realtime embedded systems that have a pulse-per-second time reference available and need to rapidly synchronize to it after boot, which appears to be unachievable with ntpd. Signed-off-by: Henry Hallam <henry@pericynthion.org> Reviewed-by: Koen Kooi <koen@dominion.thruhere.net> Signed-off-by: Joe MacDonald <joe_macdonald@mentor.com>
This commit is contained in:
Henry Hallam
committed by
Joe MacDonald
Joe MacDonald
parent
5c8efcc9f5
commit
9cd117a5dc
@@ -0,0 +1,44 @@
|
||||
# Use public NTP servers from the pool.ntp.org project.
|
||||
# Please consider joining the pool project if possible by running your own
|
||||
# server(s).
|
||||
# If you are a vendor distributing a product using chrony, you *MUST*
|
||||
# read and comply with http://www.pool.ntp.org/vendors.html
|
||||
pool 0.openembedded.pool.ntp.org iburst
|
||||
|
||||
# Use a local timeserver in preference to the pool, if it's reachable.
|
||||
#server 192.168.22.22 iburst minpoll 2 prefer
|
||||
|
||||
# Sync to pulse-per-second from an onboard GPS.
|
||||
#refclock PPS /dev/pps0 poll 0 prefer
|
||||
# You'll want to enable CONFIG_PPS and CONFIG_PPS_CLIENT_GPIO in your kernel,
|
||||
# and an entry something like this in your device tree:
|
||||
# pps {
|
||||
# compatible = "pps-gpio";
|
||||
# gpios = <&ps7_gpio_0 56 0>;
|
||||
# };
|
||||
|
||||
# In first three updates step the system clock instead of slew
|
||||
# if the adjustment is larger than 1 second.
|
||||
makestep 1.0 3
|
||||
|
||||
# Record the rate at which the system clock gains/loses time,
|
||||
# improving accuracy after reboot
|
||||
driftfile /var/lib/chrony/drift
|
||||
|
||||
# Enable kernel synchronization of the hardware real-time clock (RTC).
|
||||
rtcsync
|
||||
|
||||
# Allow NTP client access from local network.
|
||||
#allow 192.168/16
|
||||
|
||||
# Serve time even if not synchronized to any NTP server.
|
||||
#local stratum 10
|
||||
|
||||
# Specify file containing keys for NTP authentication.
|
||||
#keyfile /etc/chrony.keys
|
||||
|
||||
# Specify directory for log files.
|
||||
logdir /var/log/chrony
|
||||
|
||||
# Select which information is logged.
|
||||
#log measurements statistics tracking
|
||||
@@ -0,0 +1,58 @@
|
||||
#! /bin/sh
|
||||
|
||||
# System V init script for chrony
|
||||
# Adapted from the script already in meta-networking for ntpd
|
||||
|
||||
### BEGIN INIT INFO
|
||||
# Provides: chrony
|
||||
# Required-Start: $network $remote_fs $syslog
|
||||
# Required-Stop: $network $remote_fs $syslog
|
||||
# Default-Start: 2 3 4 5
|
||||
# Default-Stop:
|
||||
# Short-Description: Start chrony time daemon
|
||||
### END INIT INFO
|
||||
|
||||
PATH=/sbin:/bin:/usr/bin:/usr/sbin
|
||||
|
||||
DAEMON=/usr/sbin/chronyd
|
||||
PIDFILE=/var/run/chronyd.pid
|
||||
|
||||
test -x $DAEMON -a -r /etc/chrony.conf || exit 0
|
||||
|
||||
# Source function library.
|
||||
. /etc/init.d/functions
|
||||
|
||||
# Functions to do individual actions
|
||||
startdaemon(){
|
||||
echo -n "Starting chronyd: "
|
||||
start-stop-daemon --start --quiet --oknodo --pidfile $PIDFILE --startas $DAEMON -- "$@"
|
||||
echo "done"
|
||||
}
|
||||
stopdaemon(){
|
||||
echo -n "Stopping chronyd: "
|
||||
start-stop-daemon --stop --quiet --oknodo -p $PIDFILE
|
||||
echo "done"
|
||||
}
|
||||
|
||||
case "$1" in
|
||||
start)
|
||||
startdaemon
|
||||
;;
|
||||
stop)
|
||||
stopdaemon
|
||||
;;
|
||||
force-reload | restart | reload)
|
||||
stopdaemon
|
||||
startdaemon
|
||||
;;
|
||||
status)
|
||||
status /usr/sbin/chronyd;
|
||||
exit $?
|
||||
;;
|
||||
*)
|
||||
echo "Usage: chronyd { start | stop | status | restart | reload }" >&2
|
||||
exit 1
|
||||
;;
|
||||
esac
|
||||
|
||||
exit 0
|
||||
@@ -0,0 +1,127 @@
|
||||
SUMMARY = "Versatile implementation of the Network Time Protocol"
|
||||
DESCRIPTION = "Chrony can synchronize the system clock with NTP \
|
||||
servers, reference clocks (e.g. GPS receiver), and manual input using \
|
||||
wristwatch and keyboard. It can also operate as an NTPv4 (RFC 5905) \
|
||||
server and peer to provide a time service to other computers in the \
|
||||
network. \
|
||||
\
|
||||
It is designed to perform well in a wide range of conditions, \
|
||||
including intermittent network connections, heavily congested \
|
||||
networks, changing temperatures (ordinary computer clocks are \
|
||||
sensitive to temperature), and systems that do not run continuously, or \
|
||||
run on a virtual machine. \
|
||||
\
|
||||
Typical accuracy between two machines on a LAN is in tens, or a few \
|
||||
hundreds, of microseconds; over the Internet, accuracy is typically \
|
||||
within a few milliseconds. With a good hardware reference clock \
|
||||
sub-microsecond accuracy is possible. \
|
||||
\
|
||||
Two programs are included in chrony: chronyd is a daemon that can be \
|
||||
started at boot time and chronyc is a command-line interface program \
|
||||
which can be used to monitor chronyd's performance and to change \
|
||||
various operating parameters whilst it is running. \
|
||||
\
|
||||
This recipe produces two binary packages: 'chrony' which contains chronyd, \
|
||||
the configuration file and the init script, and 'chronyc' which contains \
|
||||
the client program only."
|
||||
|
||||
HOMEPAGE = "http://chrony.tuxfamily.org/"
|
||||
SECTION = "net"
|
||||
LICENSE = "GPLv2"
|
||||
LIC_FILES_CHKSUM = "file://COPYING;md5=751419260aa954499f7abaabaa882bbe"
|
||||
|
||||
SRC_URI = "https://download.tuxfamily.org/chrony/chrony-${PV}.tar.gz \
|
||||
file://chrony.conf \
|
||||
file://chronyd"
|
||||
SRC_URI[md5sum] = "d0598aa8a9be8faccef9386f6fc0d5f2"
|
||||
SRC_URI[sha256sum] = "8d04e7cda2333289c2104b731d39c3c1db94816e43bae35d7ee4e7ae8af6391f"
|
||||
|
||||
DEPENDS = "pps-tools"
|
||||
|
||||
# Note: Despite being built via './configure; make; make install',
|
||||
# chrony does not use GNU Autotools.
|
||||
inherit update-rc.d systemd
|
||||
|
||||
# Configuration options:
|
||||
# - For command line editing support in chronyc, you may specify either
|
||||
# 'editline' or 'readline' but not both. editline is smaller, but
|
||||
# many systems already have readline for other purposes so you might want
|
||||
# to choose that instead. However, beware license incompatibility
|
||||
# since chrony is GPLv2 and readline versions after 6.0 are GPLv3+.
|
||||
# You can of course choose neither, but if you're that tight on space
|
||||
# consider dropping chronyc entirely (you can use it remotely with
|
||||
# appropriate chrony.conf options).
|
||||
# - Security-related:
|
||||
# - 'sechash' is omitted by default because it pulls in nss which is huge.
|
||||
# - 'privdrop' allows chronyd to run as non-root; would need changes to
|
||||
# chrony.conf and init script.
|
||||
# - 'scfilter' enables support for system call filtering, but requires the
|
||||
# kernel to have CONFIG_SECCOMP enabled.
|
||||
PACKAGECONFIG ??= "editline scfilter"
|
||||
PACKAGECONFIG[readline] = "--without-editline,--without-readline,readline"
|
||||
PACKAGECONFIG[editline] = ",--without-editline,libedit"
|
||||
PACKAGECONFIG[sechash] = "--without-tomcrypt,--disable-sechash,nss"
|
||||
PACKAGECONFIG[privdrop] = ",--disable-privdrop,libcap"
|
||||
PACKAGECONFIG[scfilter] = "--enable-scfilter,--without-seccomp"
|
||||
|
||||
# --disable-static isn't supported by chrony's configure script.
|
||||
DISABLE_STATIC = ""
|
||||
|
||||
do_configure() {
|
||||
./configure --sysconfdir=${sysconfdir} --bindir=${bindir} --sbindir=${sbindir} \
|
||||
--localstatedir=${localstatedir} --datarootdir=${datadir} \
|
||||
${EXTRA_OECONF}
|
||||
}
|
||||
|
||||
do_install() {
|
||||
# Binaries
|
||||
install -d ${D}${bindir}
|
||||
install -m 0755 ${S}/chronyc ${D}${bindir}
|
||||
install -d ${D}${sbindir}
|
||||
install -m 0755 ${S}/chronyd ${D}${sbindir}
|
||||
|
||||
# Config file
|
||||
install -d ${D}${sysconfdir}
|
||||
install -m 644 ${WORKDIR}/chrony.conf ${D}${sysconfdir}
|
||||
|
||||
# System V init script
|
||||
install -d ${D}${sysconfdir}/init.d
|
||||
install -m 755 ${WORKDIR}/chronyd ${D}${sysconfdir}/init.d
|
||||
|
||||
# systemd unit configuration file
|
||||
install -d ${D}${systemd_unitdir}/system
|
||||
install -m 0644 ${S}/examples/chronyd.service ${D}${systemd_unitdir}/system/
|
||||
|
||||
# Variable data (for drift and/or rtc file)
|
||||
install -d ${D}${localstatedir}/lib/chrony
|
||||
|
||||
# Log files
|
||||
install -d ${D}${localstatedir}/log/chrony
|
||||
|
||||
# Fix hard-coded paths in config files and init scripts
|
||||
sed -i -e 's!/var/!${localstatedir}/!g' -e 's!/etc/!${sysconfdir}/!g' \
|
||||
-e 's!/usr/sbin/!${sbindir}/!g' -e 's!/usr/bin/!${bindir}/!g' \
|
||||
${D}${sysconfdir}/chrony.conf \
|
||||
${D}${sysconfdir}/init.d/chronyd \
|
||||
${D}${systemd_unitdir}/system/chronyd.service
|
||||
sed -i 's!^PATH=.*!PATH=${base_sbindir}:${base_bindir}:${sbindir}:${bindir}!' ${D}${sysconfdir}/init.d/chronyd
|
||||
sed -i 's!^EnvironmentFile=.*!EnvironmentFile=-${sysconfdir}/default/chronyd!' ${D}${systemd_unitdir}/system/chronyd.service
|
||||
}
|
||||
|
||||
FILES_${PN} = "${sbindir}/chronyd ${sysconfdir} ${localstatedir}"
|
||||
CONFFILES_${PN} = "${sysconfdir}/chrony.conf"
|
||||
INITSCRIPT_NAME = "chronyd"
|
||||
INITSCRIPT_PARAMS = "defaults"
|
||||
SYSTEMD_PACKAGES = "${PN}"
|
||||
SYSTEMD_SERVICE_${PN} = "chronyd.service"
|
||||
|
||||
# It's probably a bad idea to run chrony and another time daemon on
|
||||
# the same system. systemd includes the SNTP client 'timesyncd', which
|
||||
# will be disabled by chronyd.service, however it will remain on the rootfs
|
||||
# wasting 150 kB unless you put 'PACKAGECONFIG_remove_pn-systemd = "timesyncd"'
|
||||
# in a conf file or bbappend somewhere.
|
||||
RCONFLICTS_${PN} = "ntp ntimed"
|
||||
|
||||
# Separate the client program into its own package
|
||||
PACKAGES =+ "chronyc"
|
||||
FILES_chronyc = "${bindir}/chronyc"
|
||||
Reference in New Issue
Block a user