SOURCE_HASH=sha512:6fe3d591eac13d5bf410e377212e3c0848fc0215301c1f6450c3934f20b6e5c21ee75f0ed0fd6798927c053ba2bc53ac4c44875d6517f1f452174c6bba62a4d0
SECURITY_PATCH=1
SOURCE=$SPELL-$VERSION.tar.gz
-SOURCE_DIRECTORY=$BUILD_DIRECTORY/$SPELL-$VERSION
- SOURCE_URL[0]=http://download.tuxfamily.org/chrony/$SOURCE
+SOURCE_DIRECTORY="$BUILD_DIRECTORY/$SPELL-$VERSION"
+ SOURCE_URL[0]=http://download.tuxfamily.org/$SPELL/$SOURCE
WEB_SITE=http://chrony.sunsite.dk/
ENTERED=20021216
LICENSE[0]=GPL
KEYWORDS="net"
- SHORT="chrony syncs your time with an ntp server"
+ SHORT="daemon for maintaining the accuracy of computer clocks"
cat << EOF
-Chrony is an implementation of Network Time Protocol by Richard Curnow.
-It handles an intermittently connected computer better than the ntp program,
-but does not yet know how to use a hardware reference clock (GPS receiver,
-cesium clock, etc.)
+Chrony can be used to keep your computer clock in step with the true time
+(actually UTC), and/or to keep a network of computers in time with one
another.
-It has two programs: chronyd, the daemon, which talks on UDP port 123 to
-other time servers, and chronyc, which asks chronyd on port 323 how well
-it's keeping time.
+To keep in step with true time, your computer has to have a reference to
look at.
+This could be one of the following:
+
+* Network time protocol (NTP) server.
+ The Internet contains a large number of NTP servers which themselves are
+ referenced to UTC (via other servers or directly connected hardware
clocks).
+ If you can find and get access to one or more NTP servers you will be able
to
+ configure Chronyd to synchronise your computer with them. Chronyd can also
act
+ as an NTP server in its own right.
+
+* Your wristwatch.
+ If all else fails, you can periodically use chronyc to tell chronyd the
true
+ time, by typing it into your keyboard and pressing Return at the correct
epoch.
+ chronyd will work out the average rate at which your computer clock loses
or
+ gains time, and compensate accordingly the rest of the time.
+
+ Obviously, the accuracy of this method is rather limited, but it can be
used if
+ you have an isolated network of computers where the primary requirement is
to
+ keep the computers synchronised together, with only a secondary
requirement to
+ have them report the true time of day.
+
+* Hardware reference clock.
+ You might have a GPS receiver or radio clock receiver connected to your
+ computer. Chrony has limited support for some of these.
+
+* Your system’s real-time clock.
+ For all recent versions of Linux, there is support for using the systems
+ real-time clock (RTC) (the one that maintains the time when the system is
+ turned off) at boot time to restart Chronyd with a good estimate of the
true
+ time. This is done by working out how much time the RTC gains or loses
over a
+ certain period, and using this information to correct the RTC reading at
the
+ next boot. This is useful for machines that are only powered up while they
are
+ being used.
+
+ The other major feature is if you have an intermittent (e.g. dial-up)
+ connection to the network where your NTP servers are. Chronyd has been
+ specifically written to work well in this case, and it still works well in
a
+ “permanently connected” mode.
EOF
diff --git a/net/chrony/HISTORY b/net/chrony/HISTORY
index 9b164cb..ff2499c 100644
--- a/net/chrony/HISTORY
+++ b/net/chrony/HISTORY
@@ -1,3 +1,15 @@
+2011-07-16 Vlad Glagolev <stealth AT sourcemage.org>
+ * DETAILS: updated descriptions; quoting paths
+ * DEPENDS: renewed/corrected dependencies
+ * CONFLICTS: removed deprecated conflict with ntp
+ * CONFIGURE: added, for IPv6 option and future use
+ * BUILD: build docs optionally; use CHRONYD_OPTS
+ * INSTALL: install docs optionally; install config for init script;
+ install upstream config examples
+ * chrony.conf: removed deprecated config
+ * init.d/chrony: use CHRONYD_ARGS
+ * init.d/chrony.conf: added, for optional chronyd commandline
arguments
+
2011-07-14 Treeve Jelbert <treeve AT sourcemage.org>
* DETAILS: version 1.26
diff --git a/net/chrony/init.d/chrony.conf b/net/chrony/init.d/chrony.conf
new file mode 100644
index 0000000..1aa824a
--- /dev/null
+++ b/net/chrony/init.d/chrony.conf
@@ -0,0 +1,3 @@
+# For the arguments and description see chronyd(8)
+
+CHRONYD_ARGS=""
[SM-Commit] GIT changes to master grimoire by Vlad Glagolev (a8b7d0a3d2becc1ebf858ab194855b11c9ae3179),
Vlad Glagolev, 07/16/2011