Skip to content

Commit

Permalink
docs/DEVICE-CONNECTIVITY.md: add a few sentences about chronyd daemon
Browse files Browse the repository at this point in the history
Documentation bits. Never harms.

Signed-off-by: Roman Penyaev <r.peniaev@gmail.com>
  • Loading branch information
rouming committed Jun 12, 2024
1 parent b8578cd commit 089d4f2
Showing 1 changed file with 10 additions and 1 deletion.
11 changes: 10 additions & 1 deletion docs/DEVICE-CONNECTIVITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -260,14 +260,23 @@ Note that proxying of application traffic has to be configured on the applicatio

## Network Time Protocol (NTP)

EVE always tries to keep its clock synchronized by embedding a NTP Client that synchronizes
EVE always tries to keep its clock synchronized using NTP daemon (chronyd) that synchronizes
the system's clock since the boot time.
This is especially important on the very first boot to ensure that all device certificates
are generated with valid timestamps. EVE will first try to use NTP servers either received
from DHCP servers or statically configured in the network override configuration used for
bootstrapping (see the next section for more info on the network bootstrapping process).
If no NTP server is provided by DHCP or config, EVE will try to use `pool.ntp.org` by default.

Also EVE reports information about NTP sources to the controller. NTP sources are
are peers to which EVE has established a connection for the NTP synchronization.
The period of reports is defied as a runtime configuration property `timer.ntpsources.interval`
and described in [CONFIG-PROPERTIES.md](CONFIG-PROPERTIES.md).

NTP sources reports consist of fields which are well described on the following resources:
* https://www.ntp.org/documentation/4.2.8-series/ntpq/, "Peer Variables" section

Check failure on line 277 in docs/DEVICE-CONNECTIVITY.md

View workflow job for this annotation

GitHub Actions / yetus

markdownlint:MD032/blanks-around-lists Lists should be surrounded by blank lines [Context: "* https://www.ntp.org/document..."]

Check failure on line 277 in docs/DEVICE-CONNECTIVITY.md

View workflow job for this annotation

GitHub Actions / yetus

markdownlint:MD004/ul-style Unordered list style [Expected: dash; Actual: asterisk]

Check failure on line 277 in docs/DEVICE-CONNECTIVITY.md

View workflow job for this annotation

GitHub Actions / yetus

markdownlint:MD034/no-bare-urls Bare URL used [Context: "https://www.ntp.org/documentat..."]
* https://chrony-project.org/doc/4.5/chronyc.html, "Time sources" section

Check failure on line 278 in docs/DEVICE-CONNECTIVITY.md

View workflow job for this annotation

GitHub Actions / yetus

markdownlint:MD004/ul-style Unordered list style [Expected: dash; Actual: asterisk]

Check failure on line 278 in docs/DEVICE-CONNECTIVITY.md

View workflow job for this annotation

GitHub Actions / yetus

markdownlint:MD034/no-bare-urls Bare URL used [Context: "https://chrony-project.org/doc..."]

For more info on clock synchronization, refer to [CLOCK-SYNCHRONIZATION.md](CLOCK-SYNCHRONIZATION.md).

## Sources of configuration
Expand Down

0 comments on commit 089d4f2

Please sign in to comment.