From 4855ff63536430b1cd26734a0eeeaf0c25df553e Mon Sep 17 00:00:00 2001
From: tv <tv@krebsco.de>
Date: Sat, 31 Oct 2026 06:51:17 +0100
Subject: calculate peer clock drift

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

(limited to 'docs/openapi.yaml')

diff --git a/docs/openapi.yaml b/docs/openapi.yaml
index b7c632d..d1f5935 100644
--- a/docs/openapi.yaml
+++ b/docs/openapi.yaml
@@ -1366,6 +1366,10 @@ components:
           oneOf:
             - $ref: '#/components/schemas/Throughput'
             - type: 'null'
+        clock:
+          oneOf:
+            - $ref: '#/components/schemas/ClockOffset'
+            - type: 'null'
 
     Counter:
       type: object
@@ -1433,6 +1437,18 @@ components:
           type: integer
           description: Time spent dormant up to the last return (the current dormancy isn't included).
 
+    ClockOffset:
+      type: object
+      description: How far a peer's clock is ahead of ours, from its PONGs (`measurements.md`, Per peer).
+      required: [offsetMs, withinMs]
+      properties:
+        offsetMs:
+          type: integer
+          description: Ahead of ours; behind if negative.
+        withinMs:
+          type: integer
+          description: Give or take this much (half the round trip).
+
     Throughput:
       type: object
       required: [bytesPerSec, samples, secsAgo]
-- 
cgit v1.3.1