// Copyright (C) 2016 The Qt Company Ltd. // SPDX-License-Identifier: LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only #ifndef QFILESYSTEMWATCHER_FSEVENTS_P_H #define QFILESYSTEMWATCHER_FSEVENTS_P_H // // W A R N I N G // ------------- // // This file is not part of the Qt API. It exists purely as an // implementation detail. This header file may change from version to // version without notice, or even be removed. // // We mean it. // #include "qfilesystemwatcher_p.h" #include #include #include #include #include #include QT_REQUIRE_CONFIG(filesystemwatcher); QT_BEGIN_NAMESPACE class QFseventsFileSystemWatcherEngine : public QFileSystemWatcherEngine { Q_OBJECT public: ~QFseventsFileSystemWatcherEngine(); static QFseventsFileSystemWatcherEngine *create(QObject *parent); QStringList addPaths(const QStringList &paths, QStringList *files, QStringList *directories); QStringList removePaths(const QStringList &paths, QStringList *files, QStringList *directories); void processEvent(ConstFSEventStreamRef streamRef, size_t numEvents, char **eventPaths, const FSEventStreamEventFlags eventFlags[], const FSEventStreamEventId eventIds[]); Q_SIGNALS: void emitFileChanged(const QString &path, bool removed); void emitDirectoryChanged(const QString &path, bool removed); void scheduleStreamRestart(); private slots: void doEmitFileChanged(const QString &path, bool removed); void doEmitDirectoryChanged(const QString &path, bool removed); bool restartStream(); private: struct Info { QString origPath; timespec ctime; mode_t mode; QString watchedPath; Info(): mode(0) { ctime.tv_sec = 0; ctime.tv_nsec = 0; } Info(const QString &origPath, const timespec &ctime, mode_t mode, const QString &watchedPath) : origPath(origPath) , ctime(ctime) , mode(mode) , watchedPath(watchedPath) {} }; typedef QHash InfoByName; typedef QHash FilesByPath; struct DirInfo { Info dirInfo; InfoByName entries; }; typedef QHash DirsByName; typedef QHash PathRefCounts; struct WatchingState { // These fields go hand-in-hand. FSEvents watches paths, and there is no use in watching // the same path multiple times. So, the "refcount" on a path is the number of watched // files that have the same path, plus the number of directories that have the same path. // // If the stream fails to start after adding files/directories, the watcher will try to // keep watching files/directories that it was already watching. It does that by restoring // the previous WatchingState and restarting the stream. FilesByPath watchedFiles; DirsByName watchedDirectories; PathRefCounts watchedPaths; }; QFseventsFileSystemWatcherEngine(QObject *parent); bool startStream(); void stopStream(bool isStopped = false); InfoByName scanForDirEntries(const QString &path); bool derefPath(const QString &watchedPath); bool checkDir(DirsByName::iterator &it); bool rescanDirs(const QString &path); bool rescanFiles(InfoByName &filesInPath); bool rescanFiles(const QString &path); QMutex lock; dispatch_queue_t queue; FSEventStreamRef stream; FSEventStreamEventId lastReceivedEvent; WatchingState watchingState; }; QT_END_NAMESPACE #endif // QFILESYSTEMWATCHER_FSEVENTS_P_H