X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftimedatectl.xml;h=be0ad3f012708b923fd492cff0df71ae06af2137;hp=8fb4e38f3738dedb8f0ec4a6edaf099093b2a145;hb=79640424059328268b9fb6c5fa8eb777b27a177e;hpb=6d0274f11547a0f11200bb82bf598a5a253e12cf diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 8fb4e38f3..be0ad3f01 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,41 @@ - Don't query the user + Do not query the user for authentication for privileged operations. + + + + + Acquire privileges via PolicyKit + before executing the operation. + + - 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. - + 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,11 +158,16 @@ 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 - RTC time. + local time, this will also update the + RTC time. This call will alter the + /etc/localtime + symlink. See + localtime5 + for more + information. @@ -162,7 +175,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. @@ -171,20 +184,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 @@ -216,7 +229,7 @@ Environment - + $SYSTEMD_PAGER Pager to use when @@ -229,12 +242,57 @@ + + 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 systemd1, hwclock8, date1, + localtime5, systemctl1, systemd-timedated.service8