refclock: describe fields in SOCK sample

diff --git a/refclock_sock.c b/refclock_sock.c
index 97f740b24a95881b693bc10428930671dcd027fb..8ab4d527d29920d3814076de93b245532c68058a 100644 (file)
--- a/refclock_sock.c
+++ b/refclock_sock.c
@@ -37,11 +37,23 @@
 #define SOCK_MAGIC 0x534f434b
 
 struct sock_sample {
+  /* Time of the measurement (system time) */
   struct timeval tv;
+
+  /* Offset between the true time and the system time (in seconds) */
   double offset;
+
+  /* Non-zero if the sample is from a PPS signal, i.e. another source
+     is needed to obtain seconds */
   int pulse;
+
+  /* 0 - normal, 1 - insert leap second, 2 - delete leap second */
   int leap;
+
+  /* Padding, ignored */
   int _pad;
+
+  /* Protocol identifier (0x534f434b) */
   int magic;
 };