fix(folderwatcher): ignore stale inotify descriptors

Assisted-by: Codex:GPT-5
Co-authored-by: Claudio Cambra <developer@claudiocambra.com>
Signed-off-by: thstyl2000 <18458458+thstyl2000@users.noreply.github.com>

Author: thstyl2000

src/gui/folderwatcher_linux.cpp

@@ -168,7 +168,13 @@ void FolderWatcherPrivate::slotReceivedNotification(int fd)
             || fileName.startsWith(".sync_")) {
             continue;
         }
-        const QString p = _watchToPath[event->wd] + '/' + fileName;
+        const auto watchPathIt = _watchToPath.constFind(event->wd);
+        if (watchPathIt == _watchToPath.cend()) {
+            qCDebug(lcFolderWatcher) << "Ignoring event for unknown watch descriptor" << event->wd << fileName;
+            continue;
+        }
+
+        const QString p = *watchPathIt + '/' + fileName;
         _parent->changeDetected(p);
 
         if ((event->mask & (IN_MOVED_TO | IN_CREATE))

src/gui/folderwatcher_linux.h

@@ -41,6 +41,8 @@ protected slots:
     void slotAddFolderRecursive(const QString &path);
 
 protected:
+    [[nodiscard]] bool testWatchContains(int watchDescriptor) const { return _watchToPath.contains(watchDescriptor); }
+
     bool findFoldersBelow(const QDir &dir, QStringList &fullList);
     void inotifyRegisterPath(const QString &path);
     void removeFoldersBelow(const QString &path);

test/testinotifywatcher.cpp

@@ -10,6 +10,11 @@
 
 #include <QtTest>
 
+#include <array>
+#include <climits>
+#include <sys/inotify.h>
+#include <unistd.h>
+
 #include "folderwatcher_linux.h"
 #include "common/utility.h"
 
@@ -64,6 +69,30 @@ private slots:
         QVERIFY2(ok, "findFoldersBelow failed.");
     }
 
+    void testStaleWatchDescriptorIsIgnored()
+    {
+        QVERIFY(!testWatchContains(INT_MAX));
+
+        std::array<int, 2> pipeFds {};
+        QVERIFY(::pipe(pipeFds.data()) == 0);
+
+        QByteArray payload(sizeof(inotify_event) + sizeof("lib"), '\0');
+        const auto event = reinterpret_cast<inotify_event *>(payload.data());
+        event->wd = INT_MAX;
+        event->mask = IN_CREATE;
+        event->cookie = 0;
+        event->len = sizeof("lib");
+        memcpy(event->name, "lib", sizeof("lib"));
+
+        QCOMPARE(::write(pipeFds[1], payload.constData(), payload.size()), payload.size());
+        slotReceivedNotification(pipeFds[0]);
+
+        ::close(pipeFds[0]);
+        ::close(pipeFds[1]);
+
+        QVERIFY(!testWatchContains(INT_MAX));
+    }
+
     void cleanupTestCase() {
         if( _root.startsWith(QDir::tempPath() )) {
            system( QStringLiteral("rm -rf %1").arg(_root).toLocal8Bit() );