CAPIO-CL 1.3.4
CAPIO-CL: Cross Application Programmable I/O - Coordination Language
Loading...
Searching...
No Matches
monitor.h
1#ifndef CAPIO_CL_MONITOR_H
2#define CAPIO_CL_MONITOR_H
3
4#include <filesystem>
5#include <mutex>
6#include <set>
7#include <string>
8#include <thread>
9#include <unordered_map>
10#include <vector>
11
12#include "configuration.h"
13
14#ifndef PATH_MAX
15#define PATH_MAX 4096
16#endif
17
18#ifndef HOST_NAME_MAX
19#define HOST_NAME_MAX 1024
20#endif
21
24
26static const std::string NO_HOME_NODE = "<NONE>";
27
31class MonitorException final : public std::exception {
32 std::string message{};
33
34 public:
39 explicit MonitorException(const std::string &msg);
40
45 [[nodiscard]] const char *what() const noexcept override { return message.c_str(); }
46};
47
60 protected:
64 mutable std::mutex committed_lock;
65
69 mutable std::mutex home_node_lock;
70
74 mutable std::vector<std::string> _committed_files;
75
81 mutable std::unordered_map<std::string, std::string> _home_nodes;
82
86 mutable char _hostname[HOST_NAME_MAX] = {0};
87
88 public:
92 virtual ~MonitorInterface() = default;
93
100 virtual bool isCommitted(const std::filesystem::path &path) const;
101
107 virtual void setCommitted(const std::filesystem::path &path) const;
108
113 virtual void setHomeNode(const std::filesystem::path &path) const;
114
120 virtual const std::string &getHomeNode(const std::filesystem::path &path) const;
121};
122
133class MulticastMonitor final : public MonitorInterface {
134
135 static constexpr int MESSAGE_SIZE = (2 + PATH_MAX + PATH_MAX);
136
140 std::thread commit_thread, home_node_thread;
141
145 std::string MULTICAST_COMMIT_ADDR;
146
147 std::string MULTICAST_HOME_NODE_ADDR;
148
150 bool terminate = false;
151
153 static constexpr int MULTICAST_THREAD_POLL_INTERVAL = 250;
154
158 int MULTICAST_COMMIT_PORT{};
159
160 int MULTICAST_HOME_NODE_PORT{};
161
163 int MULTICAST_DELAY_MILLIS{};
164
168 typedef enum { SET = '!', GET = '?' } MESSAGE_COMMANDS;
169
178 static void _send_message(const std::string &ip_addr, int ip_port, const std::string &path,
179 MESSAGE_COMMANDS action);
180
194 static void commit_listener(std::vector<std::string> &committed_files, std::mutex &lock,
195 const std::string &ip_addr, int ip_port, const bool *terminate);
196
209 static void home_node_listener(std::unordered_map<std::string, std::string> &home_nodes,
210 std::mutex &lock, const std::string &ip_addr, int ip_port,
211 const bool *terminate);
212
213 public:
220
225
226 bool isCommitted(const std::filesystem::path &path) const override;
227 void setCommitted(const std::filesystem::path &path) const override;
228 void setHomeNode(const std::filesystem::path &path) const override;
229 const std::string &getHomeNode(const std::filesystem::path &path) const override;
230};
231
240
241 typedef enum { COMMIT, HOME_NODE } CAPIO_CL_COMMIT_TOKEN_TYPES;
242
250 static std::filesystem::path
251 compute_capiocl_token_name(const std::filesystem::path &path,
252 CAPIO_CL_COMMIT_TOKEN_TYPES type = COMMIT);
253
261 static void generate_commit_token(const std::filesystem::path &path);
262
271 static void generate_home_node_token(const std::filesystem::path &path,
272 const std::string &home_node);
273
274 public:
279
283 ~FileSystemMonitor() override = default;
284
285 bool isCommitted(const std::filesystem::path &path) const override;
286 void setCommitted(const std::filesystem::path &path) const override;
287 void setHomeNode(const std::filesystem::path &path) const override;
288 const std::string &getHomeNode(const std::filesystem::path &path) const override;
289};
290
295class Monitor {
296 friend class Engine;
297 friend class MonitorInterface;
298
299 std::vector<const MonitorInterface *> interfaces;
300
301 public:
310 [[nodiscard]] bool isCommitted(const std::filesystem::path &path) const;
311
318 void setCommitted(std::filesystem::path path) const;
319
324 void registerMonitorBackend(const MonitorInterface *interface);
325
331 void setHomeNode(const std::filesystem::path &path) const;
332
338 [[nodiscard]] std::set<std::string> getHomeNode(const std::filesystem::path &path) const;
339
340 ~Monitor();
341};
342} // namespace capiocl::monitor
343
344#endif // CAPIO_CL_MONITOR_H
Load configuration and store it from a CAPIO-CL TOML configuration file.
Definition configuration.h:31
bool isCommitted(const std::filesystem::path &path) const override
Check whether the given file has been committed.
FileSystemMonitor()
Construct a filesystem-based commit monitor.
~FileSystemMonitor() override=default
Destructor for FileSystemMonitor.
void setHomeNode(const std::filesystem::path &path) const override
void setCommitted(const std::filesystem::path &path) const override
Mark the given file as committed.
const std::string & getHomeNode(const std::filesystem::path &path) const override
MonitorException(const std::string &msg)
Construct a new CAPIO-CL Exception.
Definition Monitor.cpp:5
const char * what() const noexcept override
Definition monitor.h:45
Abstract interface for monitoring the commit state of files in CAPIO-CL.
Definition monitor.h:59
virtual bool isCommitted(const std::filesystem::path &path) const
Check whether the given file has been committed.
std::vector< std::string > _committed_files
List of committed file paths stored as strings.
Definition monitor.h:74
virtual void setCommitted(const std::filesystem::path &path) const
Mark the given file as committed.
virtual void setHomeNode(const std::filesystem::path &path) const
std::mutex committed_lock
Mutex protecting access to the committed file list.
Definition monitor.h:64
std::unordered_map< std::string, std::string > _home_nodes
Lookup table to get home node staring from path. Key = file path; Value = hostname of home node.
Definition monitor.h:81
virtual const std::string & getHomeNode(const std::filesystem::path &path) const
std::mutex home_node_lock
Mutex protecting access to the home nodes list.
Definition monitor.h:69
char _hostname[HOST_NAME_MAX]
hostname of the current instance
Definition monitor.h:86
virtual ~MonitorInterface()=default
Virtual destructor for safe polymorphic deletion.
Class to monitor runtime dependent information on CAPIO-CL related paths, such as commitment status a...
Definition monitor.h:295
void setHomeNode(const std::filesystem::path &path) const
Definition Monitor.cpp:22
bool isCommitted(const std::filesystem::path &path) const
Definition Monitor.cpp:9
std::set< std::string > getHomeNode(const std::filesystem::path &path) const
Definition Monitor.cpp:28
void setCommitted(std::filesystem::path path) const
Definition Monitor.cpp:14
void registerMonitorBackend(const MonitorInterface *interface)
Definition Monitor.cpp:19
const std::string & getHomeNode(const std::filesystem::path &path) const override
MulticastMonitor(const capiocl::configuration::CapioClConfiguration &config)
Construct a multicast-based monitor.
void setCommitted(const std::filesystem::path &path) const override
Mark the given file as committed.
void setHomeNode(const std::filesystem::path &path) const override
~MulticastMonitor() override
Destructor; stops listener thread and cleans resources.
bool isCommitted(const std::filesystem::path &path) const override
Check whether the given file has been committed.
Namespace containing the CAPIO-CL Monitor components.
Definition monitor.h:23