X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Ftimedatectl.xml;h=f3edb8d61add36691cf9edc99258f46c30fa001f;hb=edf2573743b25273bee020230a60f1a054b8ec60;hp=01ca0a73d5d640238fb3d2f0fcbccdb50adbd1e2;hpb=f274ece0f76b5709408821e317e87aef76123db6;p=elogind.git
diff --git a/man/timedatectl.xml b/man/timedatectl.xml
index 01ca0a73d..f3edb8d61 100644
--- a/man/timedatectl.xml
+++ b/man/timedatectl.xml
@@ -21,7 +21,8 @@
along with systemd; If not, see .
-->
-
+timedatectl
@@ -59,6 +60,11 @@
timedatectl may be used to
query and change the system clock and its
settings.
+
+ Use
+ systemd-firstboot1
+ to initialize the system time zone for mounted (but not
+ booted) system images.
@@ -67,60 +73,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.
-
-
-
-
- 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:
@@ -150,10 +129,10 @@
Set the system time
zone to the specified value. Available
- time zones can 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
@@ -168,7 +147,7 @@
List available time
zones, one per line. Entries from the
list can be set as the system
- time zone with
+ timezone with
set-timezone.
@@ -176,17 +155,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
- time zone 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
@@ -194,7 +173,7 @@
change the 3rd line of
/etc/adjtime, as
documented in
- hwclock8.
+ hwclock8.
@@ -214,31 +193,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
@@ -254,27 +218,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
-...
-
+...
@@ -282,11 +241,12 @@ chronyd.service - NTP client/server
See Alsosystemd1,
- hwclock8,
- date1,
+ hwclock8,
+ date1,
localtime5,
systemctl1,
- systemd-timedated.service8
+ systemd-timedated.service8,
+ systemd-firstboot1