X-Git-Url: http://git.ipfire.org/?a=blobdiff_plain;f=man%2Ftimedatectl.xml;h=b75b4cc72ac96e5d6dc688f0e9b6ca36b3d069cf;hb=9066811e5ab12367b6d87f1659b8ed98dabd554d;hp=0dacd059581abcc7b49b0c4d736e3ebd51053281;hpb=b6e386ca1cae182933ef243f5561777ba618327d;p=thirdparty%2Fsystemd.git diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 0dacd059581..b75b4cc72ac 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -3,39 +3,15 @@ "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd"> - timedatectl systemd - - - - Developer - Lennart - Poettering - lennart@poettering.net - - @@ -64,6 +40,11 @@ systemd-firstboot1 to initialize the system time zone for mounted (but not booted) system images. + + timedatectl may be used to show the current status of + systemd-timesyncd.service8. + + @@ -89,6 +70,44 @@ clock. + + + + If timesync-status is invoked and this option is passed, then + timedatectl monitors the status of + systemd-timesyncd.service8 + and updates the outputs. Use CtrlC to terminate the + monitoring. + + + + + + + When showing properties of + systemd-timesyncd.service8, + show all properties regardless of whether they are set or not. + + + + + + + When showing properties of + systemd-timesyncd.service8, + limit display to certain properties as specified as argument. If not specified, all set properties are shown. + The argument should be a property name, such as ServerName. If specified more than once, + all properties with the specified names are shown. + + + + + + + When printing properties with show-timesync, only print the value, and skip the + property name and =. + + @@ -96,6 +115,10 @@ + + + + Commands The following commands are understood: @@ -103,11 +126,22 @@ status - Show current settings of the system clock and - RTC, including whether network time synchronization through - systemd-timesyncd.service is active. - Even if is off, a different service might still synchronize the - clock with the network. + Show current settings of the system clock and RTC, + including whether network time synchronization through + systemd-timesyncd.service is active. Even if it is + inactive, a different service might still synchronize the clock. + If no command is specified, this is the implied default. + + + + + show + + Show the same information as , but in machine readable form. + This command is intended to be used whenever computer-parsable output is required. + Use if you are looking for formatted human-readable output. + By default, empty properties are suppressed. Use to show those too. + To select specific properties to show, use . @@ -162,32 +196,44 @@ set-ntp [BOOL] - Takes a boolean argument. Controls whether - network time synchronization is active and enabled (if - available). This enables and starts, or disables and stops the - systemd-timesyncd.service unit. It does - not affect the state of any other, unrelated network time - synchronization services that might be installed on the - system. This command is hence mostly equivalent to: - systemctl enable --now - systemd-timesyncd.service and systemctl - disable --now systemd-timesyncd.service, but is - protected by a different access policy. - - Note that even if time synchronization is turned off - with this command, another unrelated system service might - still synchronize the clock with the network. Also note that, - strictly speaking, - systemd-timesyncd.service does more than - just network time synchronization, as it ensures a monotonic - clock on systems without RTC even if no network is - available. See - systemd-timesyncd.service8 - for details about this. + Takes a boolean argument. Controls whether network time synchronization is active + and enabled (if available). If the argument is true, this enables and starts the first existed + service listed in the environment variable $SYSTEMD_TIMEDATED_NTP_SERVICES + of systemd-timedated.service. If the argument is false, then this disables and + stops the all services listed in $SYSTEMD_TIMEDATED_NTP_SERVICES. + + systemd-timesyncd Commands + + The following commands are specific to + systemd-timesyncd.service8. + + + + + timesync-status + + Show current status of + systemd-timesyncd.service8. + If is specified, then this will monitor the status updates. + + + + show-timesync + + Show the same information as , but in machine readable form. + This command is intended to be used whenever computer-parsable output is required. + Use if you are looking for formatted human-readable output. + By default, empty properties are suppressed. Use to show those too. + To select specific properties to show, use . + + + + + @@ -203,13 +249,13 @@ Examples Show current settings: $ timedatectl - Local time: Thu 2017-09-21 16:08:56 CEST - Universal time: Thu 2017-09-21 14:08:56 UTC - RTC time: Thu 2017-09-21 14:08:56 - Time zone: Europe/Warsaw (CEST, +0200) - System clock synchronized: yes -systemd-timesyncd.service active: yes - RTC in local TZ: no + Local time: Thu 2017-09-21 16:08:56 CEST + Universal time: Thu 2017-09-21 14:08:56 UTC + RTC time: Thu 2017-09-21 14:08:56 + Time zone: Europe/Warsaw (CEST, +0200) +System clock synchronized: yes + NTP service: active + RTC in local TZ: no Enable network time synchronization: @@ -231,6 +277,25 @@ Password: ******** └─595 /usr/lib/systemd/systemd-timesyncd … + + Show current status of + systemd-timesyncd.service8: + $ timedatectl timesync-status + Server: 216.239.38.15 (time4.google.com) +Poll interval: 1min 4s (min: 32s; max 34min 8s) + Leap: normal + Version: 4 + Stratum: 1 + Reference: GPS + Precision: 1us (-20) +Root distance: 335us (max: 5s) + Offset: +316us + Delay: 349us + Jitter: 0 + Packet count: 1 + Frequency: -8.802ppm + +