X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;f=man%2Ftimedatectl.xml;h=afcb716e4ea6b5c94ed06181cb0a7a23dd47ee69;hb=f9f4dd51bdb016bab84f7fb3cf47a2ad102b4c76;hp=9065577692655c9195e6497dd36a6530d5442703;hpb=dbc4fbae58e39cb0d33738f0a4d1e74511ed1fb5;p=elogind.git
diff --git a/man/timedatectl.xml b/man/timedatectl.xml
index 906557769..afcb716e4 100644
--- a/man/timedatectl.xml
+++ b/man/timedatectl.xml
@@ -21,7 +21,7 @@
along with systemd; If not, see .
-->
-
+timedatectl
@@ -68,8 +68,8 @@
-
+ Prints a short help
text and exits.
@@ -92,33 +92,42 @@
- Don't query the user
+ Do not query the user
for authentication for privileged
operations.
-
+
- Execute operation
+ Execute the operation
remotely. Specify a hostname, or
- username and hostname separated by @,
+ username and hostname separated by @,
to connect to. This will use SSH to
- talk to a remote
- system.
+ talk to the remote machine manager
+ instance.
-
+
+
+
+ Execute operation on a
+ local container. Specify a container
+ name to connect to.
+
+
+
+ If
set-local-rtc is
- invoked and this option is passed the
+ invoked and this option is passed, the
system clock is synchronized from the
RTC again, taking the new setting into
- account. Otherwise the RTC is
- synchonized from the system
+ account. Otherwise, the RTC is
+ synchronized from the system
clock.
@@ -150,10 +159,10 @@
Set the system time
zone to the specified value. Available
- time zones my be listed with
+ timezones can be listed with
list-timezones. If
the RTC is configured to be in the
- local time this will also update the
+ local time, this will also update the
RTC time. This call will alter the
/etc/localtime
symlink. See
@@ -167,7 +176,7 @@
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
set-timezone.
@@ -176,20 +185,20 @@
set-local-rtc [BOOL]Takes a boolean
- argument. If 0 the
+ argument. If 0, the
system is configured to maintain the
- RTC in universal time, if
- 1 it will maintain
+ RTC in universal time. If
+ 1, 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
+ adjustments. If at all possible, keep the
+ RTC in UTC mode. Note that invoking this
will also synchronize the RTC from the
system clock, unless
- is
+ is
passed (see above). This command will
change the 3rd line of
/etc/adjtime, as
@@ -221,7 +230,7 @@
Environment
-
+ $SYSTEMD_PAGERPager to use when
@@ -234,6 +243,50 @@
+
+ Examples
+ Show current settings:
+
+$ 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
+
+
+
+ Enable an NTP daemon (chronyd):
+
+$ 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 ===
+
+
+
+$ 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
+...
+
+
+
+
See Also