chrony/doc
Michael Witten cd98516cae doc: diagnose problem with RTC interrupts on Linux
This commit updates the FAQ with a new entry.

chronyd's Linux RTC driver (rtc_linux.c) requires the following ioctl
requests to be functional:

  RTC_UIE_ON
  RTC_UIE_OFF

However, a Linux system's RTC driver does not necessarily implement them,
as noted in these previous commits:

  d66b2f2b24
  rtc: handle RTCs that don't support interrupts
  Tue Dec 10 17:45:28 2019 +0100

  bff3f51d13
  rtc: extend check for RTCs that don't support interrupts
  Thu Dec 12 12:50:19 2019 +0100

Fortunately, the Linux kernel can be built with software emulation of
these hardware requests, by enabling the following config variable:

  CONFIG_RTC_INTF_DEV_UIE_EMUL
    Provides an emulation for RTC_UIE if the underlying rtc chip
    driver does not expose RTC_UIE ioctls. Those requests generate
    once-per-second update interrupts, used for synchronization.

    The emulation code will read the time from the hardware
    clock several times per second, please enable this option
    only if you know that you really need it.

This commit records these facts for the benefit of the user.
2020-12-15 10:41:53 +01:00
..
chrony.conf.adoc doc: fix ntsntpserver reference in chrony.conf man page 2020-11-26 15:09:38 +01:00
chronyc.adoc cmdmon: add leap status to selectdata report 2020-10-05 18:56:37 +02:00
chronyd.adoc doc: document long options 2020-09-23 15:10:43 +02:00
faq.adoc doc: diagnose problem with RTC interrupts on Linux 2020-12-15 10:41:53 +01:00
installation.adoc doc+examples: update http links to https 2020-09-23 15:10:43 +02:00
Makefile.in configure: rename SOCKDIR to RUNDIR 2016-12-02 14:53:03 +01:00