blob: f552e2b20b89f9fb5507aeeeda3509373c14c5b8 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
|
// *****************************************************************************
// * This file is part of the FreeFileSync project. It is distributed under *
// * GNU General Public License: https://www.gnu.org/licenses/gpl-3.0 *
// * Copyright (C) Zenju (zenju AT freefilesync DOT org) - All Rights Reserved *
// *****************************************************************************
#ifndef DIR_WATCHER_348577025748023458
#define DIR_WATCHER_348577025748023458
#include <vector>
#include <memory>
#include <chrono>
#include <functional>
#include "file_error.h"
namespace zen
{
//Windows: ReadDirectoryChangesW https://msdn.microsoft.com/en-us/library/aa365465
//Linux: inotify http://linux.die.net/man/7/inotify
//OS X: kqueue http://developer.apple.com/library/mac/documentation/Darwin/Reference/ManPages/man2/kqueue.2.html
//watch directory including subdirectories
/*
!Note handling of directories!:
Windows: removal of top watched directory is NOT notified when watching the dir handle, e.g. brute force usb stick removal,
(watchting for GUID_DEVINTERFACE_WPD OTOH works fine!)
however manual unmount IS notified (e.g. usb stick removal, then re-insert), but watching is stopped!
Renaming of top watched directory handled incorrectly: Not notified(!) + additional changes in subfolders
now do report FILE_ACTION_MODIFIED for directory (check that should prevent this fails!)
Linux: newly added subdirectories are reported but not automatically added for watching! -> reset Dirwatcher!
removal of top watched directory is NOT notified!
OS X: everything works as expected; renaming of top level folder is also detected
Overcome all issues portably: check existence of top watched directory externally + reinstall watch after changes in directory structure (added directories) are detected
*/
class DirWatcher
{
public:
DirWatcher(const Zstring& dirPath); //throw FileError
~DirWatcher();
enum ActionType
{
ACTION_CREATE, //informal!
ACTION_UPDATE, //use for debugging/logging only!
ACTION_DELETE, //
};
struct Entry
{
ActionType action = ACTION_CREATE;
Zstring itemPath;
};
//extract accumulated changes since last call
std::vector<Entry> getChanges(const std::function<void()>& requestUiRefresh, std::chrono::milliseconds cbInterval); //throw FileError
private:
DirWatcher (const DirWatcher&) = delete;
DirWatcher& operator=(const DirWatcher&) = delete;
const Zstring baseDirPath_;
struct Impl;
const std::unique_ptr<Impl> pimpl_;
};
}
#endif
|
