X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftimedatectl.xml;h=ee75d423d75e773066320d996d8f90fb372bd4cf;hp=16ee3df4be7382c61cb6e67a26801726458bf81d;hb=848e3e24b00a61130f20226ef5f051433d478c69;hpb=05cc726731c5cec952722f1c14acb08e3d4d5e98
diff --git a/man/timedatectl.xml b/man/timedatectl.xml
index 16ee3df4b..ee75d423d 100644
--- a/man/timedatectl.xml
+++ b/man/timedatectl.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+timedatectl
@@ -67,68 +68,33 @@
The following options are understood:
-
-
-
-
- Prints a short help
- text and exits.
-
-
-
-
-
- Prints a short version
- string and exits.
-
-
-
-
-
- Do not pipe output into a
- pager.
-
-
- Don't query the user
+ Do not query the user
for authentication for privileged
operations.
-
-
-
-
- Acquire privileges via PolicyKit
- before executing the operation.
-
-
-
-
-
-
- Execute the operation
- remotely. Specify a hostname, or
- username and hostname separated by @,
- to connect to. This will use SSH to
- talk to a remote
- system.
-
-
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
+ account. Otherwise, the RTC is
synchronized from the system
clock.
+
+
+
+
+
+
+ The following commands are understood:
@@ -161,7 +127,7 @@
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
@@ -184,17 +150,17 @@
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 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
@@ -222,31 +188,16 @@
Exit status
- On success 0 is returned, a non-zero failure
+ On success, 0 is returned, a non-zero failure
code otherwise.
-
- Environment
-
-
-
- $SYSTEMD_PAGER
- Pager to use when
- is not given;
- overrides $PAGER. Setting
- this to an empty string or the value
- cat is equivalent to passing
- .
-
-
-
+ ExamplesShow current settings:
-
-$ timedatectl
+ $ 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
@@ -262,27 +213,22 @@ NTP synchronized: no
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
-
+ Sun, 2013-03-31 03:00:00 CESTEnable an NTP daemon (chronyd):
-
-$ timedatectl set-ntp true
+ $ 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 ===
-
+==== AUTHENTICATION COMPLETE ===
-
-$ systemctl status chronyd.service
+ $ 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
-...
-
+...