1
0
mirror of https://github.com/systemd/systemd.git synced 2024-10-27 10:25:37 +03:00

man: extend documentation for timedatectl's set-ntp command

This extends on the relationship between timedatectl's set-ntp command
and its effect on the systemd-timesyncd.service unit. This also links
that unit back to the timedatectl man page.

Closes #798.
This commit is contained in:
Lennart Poettering 2015-08-16 18:26:03 +02:00
parent e6a26d8c97
commit 8731be1a52
2 changed files with 25 additions and 6 deletions

View File

@ -71,6 +71,10 @@
files, and the per-link dynamic settings received over DHCP. See files, and the per-link dynamic settings received over DHCP. See
<citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry> <citerefentry><refentrytitle>systemd.network</refentrytitle><manvolnum>5</manvolnum></citerefentry>
for more details.</para> for more details.</para>
<para><citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>'s
<command>set-ntp</command> command may be used to enable and
start, or disable and stop this service.</para>
</refsect1> </refsect1>
<refsect1> <refsect1>

View File

@ -166,12 +166,27 @@
<term><command>set-ntp [BOOL]</command></term> <term><command>set-ntp [BOOL]</command></term>
<listitem><para>Takes a boolean argument. Controls whether <listitem><para>Takes a boolean argument. Controls whether
network time synchronization is enabled (if available). This network time synchronization is active and enabled (if
enables or disables the available). This enables and starts, or disables and stops the
<filename>systemd-timesyncd.service</filename> unit. Note that <filename>systemd-timesyncd.service</filename> unit. It does
even if this command turns time synchronization off a not affect the state of any other, unrelated network time
different system service might still synchronize the clock synchronization services that might be installed on the
with the network.</para></listitem> system. This command is hence mostly equivalent to:
<command>systemctl enable --now
systemd-timesyncd.service</command> and <command>systemctl
disable --now systemd-timesyncd.service</command>, but is
protected by a different access policy.</para>
<para>Note that even if time synchronization is turned off
with this command another, unrelated system service might
still synchronize the clock with the network. Also note that
strictly speaking
<filename>systemd-timesyncd.service</filename> does more than
just network time synchronization as it ensures a monotonic
clock on systems without RTC even if no network is
available. See
<citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
for details about this.</para></listitem>
</varlistentry> </varlistentry>
</variablelist> </variablelist>