X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Ftimedatectl.xml;h=f3edb8d61add36691cf9edc99258f46c30fa001f;hp=e291f04e1e02dec182c74248ef164b2fe86f1854;hb=edf2573743b25273bee020230a60f1a054b8ec60;hpb=2927b326ccf67236e148444679f582ea1437ef5a diff --git a/man/timedatectl.xml b/man/timedatectl.xml index e291f04e1..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,68 +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. - - - - - 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: @@ -158,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 @@ -176,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. @@ -184,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 @@ -202,7 +173,7 @@ change the 3rd line of /etc/adjtime, as documented in - hwclock8. + hwclock8. @@ -222,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 - . - - - + Examples Show 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 +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 CEST Enable 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 -... - +... @@ -290,11 +241,12 @@ chronyd.service - NTP client/server See Also systemd1, - hwclock8, - date1, + hwclock8, + date1, localtime5, systemctl1, - systemd-timedated.service8 + systemd-timedated.service8, + systemd-firstboot1