man/systemd-timedated.service.xml

   1 <?xml version='1.0'?> <!--*-nxml-*-->
   2 <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
   3   "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
   4
   5 <!--
   6   SPDX-License-Identifier: LGPL-2.1+
   7 -->
   8
   9 <refentry id="systemd-timedated.service" conditional='ENABLE_TIMEDATED'>
  10
  11   <refentryinfo>
  12     <title>systemd-timedated.service</title>
  13     <productname>systemd</productname>
  14
  15     <authorgroup>
  16       <author>
  17         <contrib>Developer</contrib>
  18         <firstname>Lennart</firstname>
  19         <surname>Poettering</surname>
  20         <email>lennart@poettering.net</email>
  21       </author>
  22     </authorgroup>
  23   </refentryinfo>
  24
  25   <refmeta>
  26     <refentrytitle>systemd-timedated.service</refentrytitle>
  27     <manvolnum>8</manvolnum>
  28   </refmeta>
  29
  30   <refnamediv>
  31     <refname>systemd-timedated.service</refname>
  32     <refname>systemd-timedated</refname>
  33     <refpurpose>Time and date bus mechanism</refpurpose>
  34   </refnamediv>
  35
  36   <refsynopsisdiv>
  37     <para><filename>systemd-timedated.service</filename></para>
  38     <para><filename>/usr/lib/systemd/systemd-timedated</filename></para>
  39   </refsynopsisdiv>
  40
  41   <refsect1>
  42     <title>Description</title>
  43
  44     <para><filename>systemd-timedated</filename> is a system service
  45     that may be used as a mechanism to change the system clock and
  46     timezone, as well as to enable/disable NTP time synchronization.
  47     <filename>systemd-timedated</filename> is automatically activated
  48     on request and terminates itself when it is unused.</para>
  49
  50     <para>The tool
  51     <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  52     is a command line client to this service.</para>
  53
  54     <para>See the <ulink
  55     url="https://www.freedesktop.org/wiki/Software/systemd/timedated">
  56     developer documentation</ulink> for information about the APIs
  57     <filename>systemd-timedated</filename> provides.</para>
  58   </refsect1>
  59
  60   <refsect1>
  61     <title>Environment</title>
  62
  63     <variablelist class='environment-variables'>
  64       <varlistentry>
  65         <term><varname>$SYSTEMD_TIMEDATED_NTP_SERVICES</varname></term>
  66
  67         <listitem><para>Colon-separated list of unit names of NTP client services.
  68         If not set, then
  69         <citerefentry><refentrytitle>systemd-timesyncd.service</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  70         is used. See the entries of NTP related commands of
  71         <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>
  72         for details about this.</para>
  73
  74         <para>Example:
  75         <programlisting>SYSTEMD_TIMEDATED_NTP_SERVICES=ntpd.service:chronyd.service:systemd-timesyncd.service</programlisting>
  76         </para></listitem>
  77       </varlistentry>
  78     </variablelist>
  79   </refsect1>
  80   <refsect1>
  81     <title>See Also</title>
  82     <para>
  83       <citerefentry><refentrytitle>systemd</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  84       <citerefentry><refentrytitle>timedatectl</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
  85       <citerefentry><refentrytitle>localtime</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
  86       <citerefentry project='man-pages'><refentrytitle>hwclock</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
  87       <citerefentry><refentrytitle>systemd-timesyncd</refentrytitle><manvolnum>8</manvolnum></citerefentry>
  88     </para>
  89   </refsect1>
  90
  91 </refentry>