feat: Add optional hot-swap hook for PCI device reopening.

Author: jerzyjamroz

pciApp/devLibPCI.h

@@ -451,6 +451,16 @@ int devPCIDisableInterrupt(const epicsPCIDevice *dev);
 epicsShareFunc
 const char* devPCIDeviceClassToString(int classId);
 
+/**
+ * @brief Optional callback invoked on PCI device hot-swap.
+ *
+ * This function pointer may be set to a custom handler that will be called
+ * when a PCI device is successfully reopened (e.g. after hot-swap).
+ *
+ * @param name  Identifier or name of the reopened PCI device.
+ */
+epicsShareExtern void (*devPCIonHotSwapHook)(const char*);
+
 #ifdef __cplusplus
 } /* extern "C" */
 #endif

pciApp/os/Linux/devLibPCIOSD.c

@@ -944,6 +944,8 @@ static int reopen_uio(struct osdPCIDevice *osd)
     return 0;
 }
 
+epicsShareDef void (*devPCIonHotSwapHook)(const char* name) = NULL;
+
 static
 void isrThread(void* arg)
 {
@@ -995,6 +997,7 @@ void isrThread(void* arg)
                 epicsMutexMustLock(osd->devLock);
                 if (reopen_uio(osd) == 0) {
                     errlogPrintf("isrThread '%s': Successfully reopened UIO device\n", name);
+                    if (devPCIonHotSwapHook) devPCIonHotSwapHook(name);
                 } else {
                     errlogPrintf("isrThread '%s': UIO reopen failed. Will retry.\n", name);
                 }