+/** @file model.h
+ * @brief Core model checker.
+ */
+
#ifndef __MODEL_H__
#define __MODEL_H__
-#include <list>
-#include <map>
+#include <cstddef>
+#include <inttypes.h>
+
+#include "mymemory.h"
+#include "hashtable.h"
+#include "config.h"
+#include "modeltypes.h"
+#include "stl-model.h"
+#include "context.h"
+#include "params.h"
+
+/* Forward declaration */
+class Node;
+class NodeStack;
+class CycleGraph;
+class Promise;
+class Scheduler;
+class Thread;
+class ClockVector;
+class TraceAnalysis;
+class ModelExecution;
+class ModelAction;
+
+typedef SnapList<ModelAction *> action_list_t;
+
+/** @brief Model checker execution stats */
+struct execution_stats {
+ int num_total; /**< @brief Total number of executions */
+ int num_infeasible; /**< @brief Number of infeasible executions */
+ int num_buggy_executions; /** @brief Number of buggy executions */
+ int num_complete; /**< @brief Number of feasible, non-buggy, complete executions */
+ int num_redundant; /**< @brief Number of redundant, aborted executions */
+};
-#include "schedule.h"
-#include "libthreads.h"
-#include "libatomic.h"
-#include "threads.h"
-#include "tree.h"
+/** @brief The central structure for model-checking */
+class ModelChecker {
+public:
+ ModelChecker(struct model_params params);
+ ~ModelChecker();
-#define VALUE_NONE -1
+ void run();
-typedef enum action_type {
- THREAD_CREATE,
- THREAD_YIELD,
- THREAD_JOIN,
- ATOMIC_READ,
- ATOMIC_WRITE
-} action_type_t;
+ /** @returns the context for the main model-checking system thread */
+ ucontext_t * get_system_context() { return &system_context; }
-class ModelAction {
-public:
- ModelAction(action_type_t type, memory_order order, void *loc, int value);
- void print(void);
+ ModelExecution * get_execution() const { return execution; }
+
+ int get_execution_number() const { return execution_number; }
+
+ Thread * get_thread(thread_id_t tid) const;
+ Thread * get_thread(const ModelAction *act) const;
+
+ Thread * get_current_thread() const;
+
+ void switch_from_master(Thread *thread);
+ uint64_t switch_to_master(ModelAction *act);
+
+ bool assert_bug(const char *msg, ...);
+ void assert_user_bug(const char *msg);
- thread_id_t get_tid() { return tid; }
- action_type get_type() { return type; }
- memory_order get_mo() { return order; }
- void *get_location() { return location; }
+ const model_params params;
+ void add_trace_analysis(TraceAnalysis *a) {
+ trace_analyses.push_back(a);
+ }
- TreeNode *get_node() { return node; }
- void set_node(TreeNode *n) { node = n; }
+ MEMALLOC
private:
- action_type type;
- memory_order order;
- void *location;
- thread_id_t tid;
- int value;
- TreeNode *node;
-};
+ /** The scheduler to use: tracks the running/ready Threads */
+ Scheduler * const scheduler;
+ NodeStack * const node_stack;
+ ModelExecution *execution;
-class ModelChecker {
-public:
- ModelChecker();
- ~ModelChecker();
- class Scheduler *scheduler;
- Thread *system_thread;
+ int execution_number;
- void add_system_thread(Thread *t);
+ unsigned int get_num_threads() const;
- void set_current_action(ModelAction *act) { current_action = act; }
- ModelAction *get_last_conflict(ModelAction *act);
- void check_current_action(void);
- void set_backtracking(ModelAction *act);
- void print_trace(void);
+ void execute_sleep_set();
- int add_thread(Thread *t);
- Thread *get_thread(thread_id_t tid) { return thread_map[tid]; }
+ bool next_execution();
+ bool should_terminate_execution();
- void assign_id(Thread *t);
+ Thread * get_next_thread();
+ void reset_to_initial_state();
- int switch_to_master(ModelAction *act);
-private:
- int used_thread_id;
- class ModelAction *current_action;
- std::list<class ModelAction *> action_trace;
- std::map<thread_id_t, class Thread *> thread_map;
- class TreeNode *rootNode, *currentNode;
+
+ ModelAction *diverge;
+ ModelAction *earliest_diverge;
+
+ ucontext_t system_context;
+
+ ModelVector<TraceAnalysis *> trace_analyses;
+
+ /** @brief The cumulative execution stats */
+ struct execution_stats stats;
+ void record_stats();
+ void run_trace_analyses();
+ void print_bugs() const;
+ void print_execution(bool printbugs) const;
+ void print_stats() const;
+
+ friend void user_main_wrapper();
};
extern ModelChecker *model;
-int thread_switch_to_master(ModelAction *act);
-
#endif /* __MODEL_H__ */