View source for Package:Chrony

{{Ebuild
|Summary=Chrony is a pair of programs (chronyd and chronyc) which are used to maintain the accuracy of the system clock on a computer. chronyd has been specifically written to work well for systems which have only an intermittent (e.g. dial-up) connection to the network where the NTP servers are. It still works well in a "permanently connected" mode.
|CatPkg=net-misc/chrony
|Homepage=http://chrony.tuxfamily.org/
}}

=== Accurate System Time (NTP) ===

It's important that your Funtoo Linux system has an accurate clock. NTP (network time protocol) can ensure your clock is accurate at all time.

The recommended NTP client/server is '''{{Package|net-misc/chrony}}'''.

{{console|body=
###i## emerge chrony
}}

{{important|Chrony ''' ''requires'' ''' you set an upstream ntp server.}}

For broadband users:
{{console|body=###i## echo "server pool.ntp.org iburst" >> /etc/chrony/chrony.conf}}

For dial up or slow connections:
{{console|body=###i## echo "server pool.ntp.org offline" >> /etc/chrony/chrony.conf}}

Use something like the following for your {{c|/etc/chrony/chrony.conf}}:

<pre>
server time.apple.com
maxupdateskew 100
driftfile /etc/chrony/chrony.drift
keyfile /etc/chrony/chrony.keys
commandkey 1
dumponexit
dumpdir /var/log/chrony
initstepslew 10 time.apple.com
logdir /var/log/chrony
log measurements statistics tracking
logchange 0.5
mailonchange me@emailprovider.com 0.5
rtcfile /etc/chrony/chrony.rtc
rtconutc
sched_priority 1
lock_all
</pre>

Chronyd can then be started immediately by running <code>rc</code> to start all new services:

=== Set Time ===
To test chronyd, set the time immediately, & exit:
{{console|body=###i## chronyd -q}}

=== Service ===
To start the chronyd service:
{{console|body=
###i## rc-update add chronyd default
###i## rc
}}

Because Funtoo Linux starts network daemons without waiting for an Internet connection to become available, and because chrony will attempt to synchronize the clock over the Internet when it first starts, you must manually configure chronyd to be dependent on whatever method you use to enable your outbound network connectivity. For example, if using {{c|dhcpcd}}, add the following to {{c|/etc/conf.d/chronyd}}:

<pre>
rc_need=dhcpcd
</pre>

You should notice a marked improvement in your system clock's accuracy. If your system time was off by a significant amount, {{c|chronyd}} will gradually correct your clock while the system runs.

==== Hardware Clock ====
To write your NTP sync time to the hardware at shutdown, and read hw clock at start.

{{console|body=
###i## echo 'clock_hctosys="YES"' >> /etc/conf.d/hwclock
###i## echo 'clock_systohc="YES"' >> /etc/conf.d/hwclock
###i## rc-service hwclock restart
###i## rc-update add hwclock boot
}}

[[Category:System]]
[[Category:Official Documentation]]

{{EbuildFooter}}