chronyc
chronyc is a command-line interface program which can be used to monitor chronyd's performance and to change various operating parameters whilst it is running.[1]
If no commands are specified on the command line, chronyc will expect input from the user. The prompt chronyc> will be displayed when it is being run from a terminal. If chronyc's input or output are redirected from or to a file, the prompt is not shown.[1]
There are two ways chronyc can access chronyd. One is the Internet Protocol (IPv4 or IPv6) and the other is a Unix domain socket, which is accessible locally by the root or chrony user. By default, chronyc first tries to connect to the Unix domain socket. The compiled-in default path is /var/run/chrony/chronyd.sock. If that fails (e.g. because chronyc is running under a non-root user), it will try to connect to 127.0.0.1 and then ::1.[1]
Documentation
- man 1 'chronyc' [EN]
Syntax
chronyc [PARAMETER ...] [SUBCOMMAND]
Subcommands & Parameters
- tracking
- The tracking command displays parameters about the system’s clock performance.
- sources
- This command displays information about the current time sources that chronyd is accessing.
- -v
- This parameter can be specified, meaning verbose. In this case, extra caption lines are shown as a reminder of the meanings of the columns.
Examples
- Display information about the clock performance
chronyc tracking
Output:
Reference ID : C0216066 (time2.ethz.ch)
Stratum : 2
Ref time (UTC) : Wed Apr 29 07:33:16 2020
System time : 0.000034553 seconds fast of NTP time
Last offset : +0.000037063 seconds
RMS offset : 0.000089152 seconds
Frequency : 18.569 ppm slow
Residual freq : +0.001 ppm
Skew : 0.022 ppm
Root delay : 0.005085546 seconds
Root dispersion : 0.001178392 seconds
Update interval : 1041.8 seconds
Leap status : Normal
- Display information about the current time sources
chronyc sources
Output:
210 Number of sources = 4
MS Name/IP address Stratum Poll Reach LastRx Last sample
===============================================================================
^+ mirror.tillo.ch 2 10 377 177 -845us[ -808us] +/- 13ms
^- 45.91.92.111 2 10 377 967 +270us[ +302us] +/- 18ms
^- 213.251.52.217 2 10 377 381 +3202us[+3238us] +/- 48ms
^* time2.ethz.ch 1 10 377 169 +400us[ +437us] +/- 3822us