2011-04-06 13:48:02 +04:00
|
|
|
/*
|
2014-01-13 19:16:19 +04:00
|
|
|
* Copyright (C) by Klaas Freitag <freitag@owncloud.com>
|
2011-04-06 13:48:02 +04:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or modify
|
|
|
|
* it under the terms of the GNU General Public License as published by
|
2016-10-25 12:00:07 +03:00
|
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
|
|
* (at your option) any later version.
|
2011-04-06 13:48:02 +04:00
|
|
|
*
|
|
|
|
* This program is distributed in the hope that it will be useful, but
|
|
|
|
* WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
|
|
* or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
|
|
* for more details.
|
|
|
|
*/
|
2011-03-16 16:50:34 +03:00
|
|
|
|
2011-02-17 02:21:45 +03:00
|
|
|
#ifndef MIRALL_FOLDERWATCHER_H
|
|
|
|
#define MIRALL_FOLDERWATCHER_H
|
|
|
|
|
2012-07-20 19:13:23 +04:00
|
|
|
#include "config.h"
|
|
|
|
|
2011-04-04 20:41:14 +04:00
|
|
|
#include <QList>
|
2017-05-09 15:24:11 +03:00
|
|
|
#include <QLoggingCategory>
|
2011-02-17 02:21:45 +03:00
|
|
|
#include <QObject>
|
2011-03-21 00:38:33 +03:00
|
|
|
#include <QString>
|
2011-03-23 01:03:43 +03:00
|
|
|
#include <QStringList>
|
2020-02-05 14:29:06 +03:00
|
|
|
#include <QElapsedTimer>
|
2012-02-16 01:36:52 +04:00
|
|
|
#include <QHash>
|
2014-01-11 23:35:58 +04:00
|
|
|
#include <QScopedPointer>
|
2014-02-18 03:36:41 +04:00
|
|
|
#include <QSet>
|
2019-05-09 11:05:49 +03:00
|
|
|
#include <QDir>
|
2011-02-17 02:21:45 +03:00
|
|
|
|
2011-03-23 01:03:43 +03:00
|
|
|
class QTimer;
|
2012-05-21 18:48:49 +04:00
|
|
|
|
2014-11-10 00:34:07 +03:00
|
|
|
namespace OCC {
|
2012-05-21 18:48:49 +04:00
|
|
|
|
2017-05-09 15:24:11 +03:00
|
|
|
Q_DECLARE_LOGGING_CATEGORY(lcFolderWatcher)
|
|
|
|
|
2012-12-04 21:15:37 +04:00
|
|
|
class FolderWatcherPrivate;
|
2015-10-02 10:40:44 +03:00
|
|
|
class Folder;
|
2011-02-17 02:21:45 +03:00
|
|
|
|
2015-06-29 19:56:09 +03:00
|
|
|
/**
|
2015-10-05 07:21:19 +03:00
|
|
|
* @brief Monitors a directory recursively for changes
|
2015-06-26 18:07:47 +03:00
|
|
|
*
|
2014-01-11 23:35:58 +04:00
|
|
|
* Folder Watcher monitors a directory and its sub directories
|
|
|
|
* for changes in the local file system. Changes are signalled
|
2014-11-07 12:53:41 +03:00
|
|
|
* through the pathChanged() signal.
|
2014-02-03 14:58:37 +04:00
|
|
|
*
|
2015-06-29 19:56:09 +03:00
|
|
|
* @ingroup gui
|
2011-03-21 00:17:23 +03:00
|
|
|
*/
|
2014-01-11 23:35:58 +04:00
|
|
|
|
2011-02-17 02:21:45 +03:00
|
|
|
class FolderWatcher : public QObject
|
|
|
|
{
|
2013-08-07 16:59:41 +04:00
|
|
|
Q_OBJECT
|
2011-02-17 02:21:45 +03:00
|
|
|
public:
|
2018-04-24 10:52:15 +03:00
|
|
|
// Construct, connect signals, call init()
|
2018-11-11 12:56:22 +03:00
|
|
|
explicit FolderWatcher(Folder *folder = nullptr);
|
2021-08-17 13:39:31 +03:00
|
|
|
~FolderWatcher() override;
|
2018-04-24 10:52:15 +03:00
|
|
|
|
2011-03-21 00:17:23 +03:00
|
|
|
/**
|
|
|
|
* @param root Path of the root of the folder
|
|
|
|
*/
|
2018-04-24 10:52:15 +03:00
|
|
|
void init(const QString &root);
|
2011-03-21 00:18:38 +03:00
|
|
|
|
2014-01-13 18:23:38 +04:00
|
|
|
/* Check if the path is ignored. */
|
2017-05-17 11:55:42 +03:00
|
|
|
bool pathIsIgnored(const QString &path);
|
2014-01-13 18:23:38 +04:00
|
|
|
|
2017-10-09 13:06:57 +03:00
|
|
|
/**
|
|
|
|
* Returns false if the folder watcher can't be trusted to capture all
|
|
|
|
* notifications.
|
|
|
|
*
|
|
|
|
* For example, this can happen on linux if the inotify user limit from
|
|
|
|
* /proc/sys/fs/inotify/max_user_watches is exceeded.
|
|
|
|
*/
|
2022-09-30 20:12:08 +03:00
|
|
|
[[nodiscard]] bool isReliable() const;
|
2017-10-09 13:06:57 +03:00
|
|
|
|
2019-06-13 10:59:01 +03:00
|
|
|
/**
|
|
|
|
* Triggers a change in the path and verifies a notification arrives.
|
|
|
|
*
|
|
|
|
* If no notification is seen, the folderwatcher marks itself as unreliable.
|
|
|
|
* The path must be ignored by the watcher.
|
|
|
|
*/
|
|
|
|
void startNotificatonTest(const QString &path);
|
|
|
|
|
2019-03-05 15:20:09 +03:00
|
|
|
/// For testing linux behavior only
|
2022-09-30 20:12:08 +03:00
|
|
|
[[nodiscard]] int testLinuxWatchCount() const;
|
2019-03-05 15:20:09 +03:00
|
|
|
|
2011-02-17 02:21:45 +03:00
|
|
|
signals:
|
2014-11-07 12:53:41 +03:00
|
|
|
/** Emitted when one of the watched directories or one
|
|
|
|
* of the contained files is changed. */
|
|
|
|
void pathChanged(const QString &path);
|
2014-01-11 23:35:58 +04:00
|
|
|
|
2017-10-09 13:06:57 +03:00
|
|
|
/**
|
|
|
|
* Emitted if some notifications were lost.
|
|
|
|
*
|
|
|
|
* Would happen, for example, if the number of pending notifications
|
|
|
|
* exceeded the allocated buffer size on Windows. Note that the folder
|
|
|
|
* watcher could still be able to capture all future notifications -
|
|
|
|
* i.e. isReliable() is orthogonal to losing changes occasionally.
|
|
|
|
*/
|
|
|
|
void lostChanges();
|
2011-03-21 00:17:23 +03:00
|
|
|
|
2018-04-24 10:52:15 +03:00
|
|
|
/**
|
|
|
|
* Signals when the watcher became unreliable. The string is a translated
|
|
|
|
* message that can be shown to users.
|
|
|
|
*/
|
|
|
|
void becameUnreliable(const QString &message);
|
|
|
|
|
2011-02-17 02:21:45 +03:00
|
|
|
protected slots:
|
2014-01-11 23:35:58 +04:00
|
|
|
// called from the implementations to indicate a change in path
|
2017-05-17 11:55:42 +03:00
|
|
|
void changeDetected(const QString &path);
|
|
|
|
void changeDetected(const QStringList &paths);
|
2011-04-04 20:41:14 +04:00
|
|
|
|
2019-07-11 14:31:54 +03:00
|
|
|
private slots:
|
|
|
|
void startNotificationTestWhenReady();
|
|
|
|
|
2012-12-05 21:23:35 +04:00
|
|
|
protected:
|
|
|
|
QHash<QString, int> _pendingPathes;
|
2012-12-04 20:46:44 +04:00
|
|
|
|
2011-02-17 02:21:45 +03:00
|
|
|
private:
|
2014-01-11 23:35:58 +04:00
|
|
|
QScopedPointer<FolderWatcherPrivate> _d;
|
2020-02-05 14:29:06 +03:00
|
|
|
QElapsedTimer _timer;
|
2014-02-18 03:36:41 +04:00
|
|
|
QSet<QString> _lastPaths;
|
2017-05-17 11:55:42 +03:00
|
|
|
Folder *_folder;
|
2017-10-09 13:06:57 +03:00
|
|
|
bool _isReliable = true;
|
2012-12-05 21:30:40 +04:00
|
|
|
|
2019-05-09 11:05:49 +03:00
|
|
|
void appendSubPaths(QDir dir, QStringList& subPaths);
|
|
|
|
|
2019-06-13 10:59:01 +03:00
|
|
|
/** Path of the expected test notification */
|
|
|
|
QString _testNotificationPath;
|
|
|
|
|
2012-12-05 21:30:40 +04:00
|
|
|
friend class FolderWatcherPrivate;
|
2011-02-17 02:21:45 +03:00
|
|
|
};
|
|
|
|
}
|
|
|
|
|
|
|
|
#endif
|