From 1cb2ef3f00e695a414de87acfec090dfde749934 Mon Sep 17 00:00:00 2001
From: tv <tv@krebsco.de>
Date: Sat, 31 Oct 2026 06:53:00 +0100
Subject: add peer clock skew warning

---
 docs/openapi.yaml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

(limited to 'docs')

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index d1f5935..1b20ee9 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1802,6 +1802,26 @@ components:
                     type: [integer, 'null']
                   count:
                     type: integer
+        clock:
+          type: object
+          description: This node's clock against its active peers' (`measurements.md`, Clocks).
+          required: [peers, offsetMs, behind, ahead, off]
+          properties:
+            peers:
+              type: integer
+              description: Active peers whose clocks were compared.
+            offsetMs:
+              type: [integer, 'null']
+              description: How far ours is ahead of theirs (behind if negative), the median.
+            behind:
+              type: integer
+              description: Peers behind ours by more than --clock-skew-warn, for sure.
+            ahead:
+              type: integer
+              description: Peers ahead of ours by more than --clock-skew-warn, for sure.
+            off:
+              type: boolean
+              description: Ours differs from more than half of theirs that way.
 
     LockWaits:
       type: object
-- 
cgit v1.3.1