along with systemd; If not, see <http://www.gnu.org/licenses/>.
-->
-<refentry id="timedatectl">
+<refentry id="timedatectl" conditional='ENABLE_TIMEDATED'>
<refentryinfo>
<title>timedatectl</title>
<variablelist>
<varlistentry>
- <term><option>--help</option></term>
<term><option>-h</option></term>
+ <term><option>--help</option></term>
<listitem><para>Prints a short help
text and exits.</para></listitem>
operations.</para></listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>-P</option></term>
+ <term><option>--privileged</option></term>
+
+ <listitem><para>Acquire privileges via PolicyKit
+ before executing the operation.</para></listitem>
+ </varlistentry>
+
<varlistentry>
<term><option>-H</option></term>
<term><option>--host</option></term>
- <listitem><para>Execute operation
+ <listitem><para>Execute the operation
remotely. Specify a hostname, or
- username and hostname separated by @,
+ username and hostname separated by <literal>@</literal>,
to connect to. This will use SSH to
talk to a remote
system.</para></listitem>
</varlistentry>
<varlistentry>
- <term><option>--fix-system</option></term>
+ <term><option>--adjust-system-clock</option></term>
<listitem><para>If
<command>set-local-rtc</command> is
system clock is synchronized from the
RTC again, taking the new setting into
account. Otherwise the RTC is
- synchonized from the system
+ synchronized from the system
clock.</para></listitem>
</varlistentry>
</variablelist>
<listitem><para>Set the system time
zone to the specified value. Available
- time zones my be listed with
+ timezones can be listed with
<command>list-timezones</command>. If
the RTC is configured to be in the
local time this will also update the
<listitem><para>List available time
zones, one per line. Entries from the
- list may selected as the system
+ list can be set as the system
timezone with
<command>set-timezone</command>.</para></listitem>
</varlistentry>
<literal>1</literal> it will maintain
the RTC in local time instead. Note
that maintaining the RTC in the local
- timezone is is not fully supported and
+ timezone is not fully supported and
will create various problems with time
zone changes and daylight saving
adjustments. If at all possible use
RTC in UTC. Note that invoking this
will also synchronize the RTC from the
system clock, unless
- <option>--fix-system</option> is
+ <option>--adjust-system-clock</option> is
passed (see above). This command will
change the 3rd line of
<filename>/etc/adjtime</filename>, as
<refsect1>
<title>Environment</title>
- <variablelist>
+ <variablelist class='environment-variables'>
<varlistentry>
<term><varname>$SYSTEMD_PAGER</varname></term>
<listitem><para>Pager to use when
</variablelist>
</refsect1>
+ <refsect1>
+ <title>Examples</title>
+ <para>Show current settings:
+ <programlisting>
+$ timedatectl
+ Local time: Fri, 2012-11-02 09:26:46 CET
+ Universal time: Fri, 2012-11-02 08:26:46 UTC
+ RTC time: Fri, 2012-11-02 08:26:45
+ Timezone: Europe/Warsaw
+ UTC offset: +0100
+ NTP enabled: no
+NTP synchronized: no
+ RTC in local TZ: no
+ DST active: no
+ Last DST change: CEST → CET, DST became inactive
+ Sun, 2012-10-28 02:59:59 CEST
+ Sun, 2012-10-28 02:00:00 CET
+ Next DST change: CET → CEST, DST will become active
+ the clock will jump one hour forward
+ Sun, 2013-03-31 01:59:59 CET
+ Sun, 2013-03-31 03:00:00 CEST
+ </programlisting>
+ </para>
+
+ <para>Enable an NTP daemon (chronyd):
+ <programlisting>
+$ timedatectl set-ntp true
+==== AUTHENTICATING FOR org.freedesktop.timedate1.set-ntp ===
+Authentication is required to control whether network time synchronization shall be enabled.
+Authenticating as: user
+Password: ********
+==== AUTHENTICATION COMPLETE ===
+ </programlisting>
+
+ <programlisting>
+$ systemctl status chronyd.service
+chronyd.service - NTP client/server
+ Loaded: loaded (/usr/lib/systemd/system/chronyd.service; enabled)
+ Active: active (running) since Fri, 2012-11-02 09:36:25 CET; 5s ago
+...
+ </programlisting>
+ </para>
+ </refsect1>
+
<refsect1>
<title>See Also</title>
<para>