From 1e4acc77b0738b76b982f39eba854e7d81f44b80 Mon Sep 17 00:00:00 2001 From: Yu Watanabe Date: Mon, 30 Apr 2018 22:42:40 +0900 Subject: man: add explanations of show-timesync and timesync-status commands --- man/rules/meson.build | 2 +- man/systemd-timesyncd.service.xml | 4 ++ man/timedatectl.xml | 92 ++++++++++++++++++++++++++++++++++++++- 3 files changed, 96 insertions(+), 2 deletions(-) diff --git a/man/rules/meson.build b/man/rules/meson.build index b0919b9d44..6b07cfc4fe 100644 --- a/man/rules/meson.build +++ b/man/rules/meson.build @@ -706,7 +706,7 @@ manpages = [ ['systemd.unit', '5', [], ''], ['sysusers.d', '5', [], 'ENABLE_SYSUSERS'], ['telinit', '8', [], ''], - ['timedatectl', '1', [], 'ENABLE_TIMEDATED'], + ['timedatectl', '1', [], 'ENABLE_TIMEDATECTL'], ['timesyncd.conf', '5', ['timesyncd.conf.d'], 'ENABLE_TIMESYNCD'], ['tmpfiles.d', '5', [], ''], ['udev', '7', [], ''], diff --git a/man/systemd-timesyncd.service.xml b/man/systemd-timesyncd.service.xml index 49e00e2b91..b5eb8a4ac2 100644 --- a/man/systemd-timesyncd.service.xml +++ b/man/systemd-timesyncd.service.xml @@ -70,6 +70,10 @@ timedatectl1's set-ntp command may be used to enable and start, or disable and stop this service. + + timedatectl1's + timesync-status or show-timesync command can be used to show the + current status of this service. diff --git a/man/timedatectl.xml b/man/timedatectl.xml index 02b86b6641..b6caa5458d 100644 --- a/man/timedatectl.xml +++ b/man/timedatectl.xml @@ -10,7 +10,7 @@ Copyright 2012 Lennart Poettering --> - @@ -53,6 +53,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. + + @@ -78,6 +83,43 @@ 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 Ctrl-C 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 =. + + @@ -165,6 +207,35 @@ + 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 properties of the manager of + systemd-timesyncd.service8. + By default, empty properties are suppressed. Use to show those too. To select specific + properties to show, use . This command is intended to be used whenever + computer-parsable output is required. Use if you are looking for formatted + human-readable output. + + + + + @@ -208,6 +279,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 + + -- cgit v1.2.3