| [chrony-dev] [RFC PATCH v1 12/17] doc/chrony.conf: Update chrony.conf manpage adding 'auxclockid' and 'nooffsetsanitycheck' directives |
[ Thread Index |
Date Index
| More chrony.tuxfamily.org/chrony-dev Archives
]
- To: chrony-dev@xxxxxxxxxxxxxxxxxxxx
- Subject: [chrony-dev] [RFC PATCH v1 12/17] doc/chrony.conf: Update chrony.conf manpage adding 'auxclockid' and 'nooffsetsanitycheck' directives
- From: Christopher S M Hall <christopher.s.hall@xxxxxxxxx>
- Date: Sat, 6 Dec 2025 06:10:58 +0000
- Cc: christopher.s.hall@xxxxxxxxx, david.zage@xxxxxxxxx, yoong.siang.song@xxxxxxxxx
- Dkim-signature: v=1; a=rsa-sha256; c=relaxed/simple; d=intel.com; i=@intel.com; q=dns/txt; s=Intel; t=1765002156; x=1796538156; h=from:to:cc:subject:date:message-id:in-reply-to: references:mime-version:content-transfer-encoding; bh=GZjsCmovTiaEE6myDhcuN65AYJayNGFjBTfxdfcGCKQ=; b=WQgNiic5YBXtvkCx7Ex1BMc6keDCFdYzLx4Ub3lXvzWGw7kJdthyepyy nW2/ObmSf86Ph9lfRKsPJYa02/KS6zvTJahA6AiEIahtNaPZwtMQ4Ls8B xTPWalvB8syD4cC8jSkQuMYGb/s5RvHBQA0pbOLEEvBWbk7muAWxqO1tu 3GYkTRRaaPZz+bVao6O7mUewnKTLTE5Yrhicx0HhNCCAOoTaMTRGLwfhd +C07ceUzWKiVtAwJ2pZwCmlpuZI1zHwh8l1zwelT2QTl99Th9r4XZe+wC 3eCU6YqYo2Hfzo2DVP0OdLAvKo2xwXGF7bFti64CrRMStIuR9IKU6Pxl+ A==;
The auxclockid directive takes one of option: 'set'
- set: takes one argument that is the clock ID of an already allocated auxiliary clock
The nooffsetsanitycheck directive disables offset sanity checking. It is available on all builds, but
is most useful for Linux builds use auxiliary clocks because those clocks may not be traceable to UTC/TAI.
Checking their offset with respect to the reference clock is not useful.
---
doc/chrony.conf.adoc | 23 +++++++++++++++++++++++
1 file changed, 23 insertions(+)
diff --git a/doc/chrony.conf.adoc b/doc/chrony.conf.adoc
index 7ac6366..c50de6e 100644
--- a/doc/chrony.conf.adoc
+++ b/doc/chrony.conf.adoc
@@ -1566,6 +1566,29 @@ where the _/etc/chrony.tempcomp_ file could have
Valid measurements with corresponding compensations are logged to the
_tempcomp.log_ file if enabled by the <<log,*log tempcomp*>> directive.
+[[auxclockid]]
+*auxclockid* set <Clock ID>::
+The *auxclockid* directive is used to specify use of an auxiliary clock. Currently,
+this is only available using Linux. An auxiliary clock is implemented as a standard
+POSIX clock, but can be adjusted independently from the standard CLOCK_REALTIME.
++
+The only currently supported option is 'set'. The argument to the 'set' option
+is the numerical clock ID of the already allocated auxiliary clock.
++
+An example of the _auxclockid_ directive to set the clock ID to 16:
++
+----
+auxclockid set 16
+----
+
+[[nooffsetsanitycheck]]
+*nooffsetsanitycheck* ::
+The *nooffsetsanity* directive is used to disable offset sanity checking. Normally, Chrony
+attempts to verify that the offset between the reference clock and the local clock is reasonable
+assuming that the reference clock is traceable to UTC/TAI. This check can be disabled on any
+platform, but is most useful when working with Linux auxiliary clocks whose time is not required
+to be traceable. There are no options for this directive.
+
=== NTP server
[[allow]]*allow* [*all*] [_subnet_]::
--
2.34.1
--
To unsubscribe email chrony-dev-request@xxxxxxxxxxxxxxxxxxxx with "unsubscribe" in the subject.
For help email chrony-dev-request@xxxxxxxxxxxxxxxxxxxx with "help" in the subject.
Trouble? Email listmaster@xxxxxxxxxxxxxxxxxxxx.