From c2d1f045073ae7912f2fc4e52752d84ad23fdb09 Mon Sep 17 00:00:00 2001
From: Mike Black W9MDB <mdblack98@yahoo.com>
Date: Sat, 13 May 2023 14:54:43 -0500
Subject: [PATCH] Add comments about multicast mutex
 https://github.com/Hamlib/Hamlib/issues/695

---
 include/hamlib/rig.h | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/include/hamlib/rig.h b/include/hamlib/rig.h
index b6e262e11..29047c041 100644
--- a/include/hamlib/rig.h
+++ b/include/hamlib/rig.h
@@ -2488,6 +2488,9 @@ struct multicast_s
     int seqnumber;
     int runflag; // = 0;
     pthread_t threadid;
+    // this mutex is needed to control serial access
+    // as of 2023-05-13 we have main thread and multicast thread needing it
+    // eventually we should be able to use cached info only in the main thread to avoid contention
     pthread_mutex_t mutex;
     int mutex_initialized;
 //#ifdef HAVE_ARPA_INET_H