7 #include "snapshot-interface.h"
9 #include "clockvector.h"
11 #define INITIAL_THREAD_ID 0
15 /** @brief Constructor */
16 ModelChecker::ModelChecker()
18 /* Initialize default scheduler */
19 scheduler(new Scheduler()),
20 /* First thread created will have id INITIAL_THREAD_ID */
21 next_thread_id(INITIAL_THREAD_ID),
22 used_sequence_numbers(0),
27 nextThread(THREAD_ID_T_NONE),
28 action_trace(new action_list_t()),
29 thread_map(new std::map<int, class Thread *>),
30 obj_thrd_map(new std::map<void *, std::vector<action_list_t> >()),
31 thrd_last_action(new std::vector<ModelAction *>(1)),
32 node_stack(new NodeStack()),
37 /** @brief Destructor */
38 ModelChecker::~ModelChecker()
40 std::map<int, class Thread *>::iterator it;
41 for (it = thread_map->begin(); it != thread_map->end(); it++)
47 delete thrd_last_action;
53 * Restores user program to initial state and resets all model-checker data
56 void ModelChecker::reset_to_initial_state()
58 DEBUG("+++ Resetting to initial state +++\n");
59 node_stack->reset_execution();
60 current_action = NULL;
61 next_thread_id = INITIAL_THREAD_ID;
62 used_sequence_numbers = 0;
64 next_backtrack = NULL;
65 snapshotObject->backTrackBeforeStep(0);
68 /** @returns a thread ID for a new Thread */
69 thread_id_t ModelChecker::get_next_id()
71 return next_thread_id++;
74 /** @returns the number of user threads created during this execution */
75 int ModelChecker::get_num_threads()
77 return next_thread_id;
80 /** @returns a sequence number for a new ModelAction */
81 int ModelChecker::get_next_seq_num()
83 return ++used_sequence_numbers;
87 * Performs the "scheduling" for the model-checker. That is, it checks if the
88 * model-checker has selected a "next thread to run" and returns it, if
89 * available. This function should be called from the Scheduler routine, where
90 * the Scheduler falls back to a default scheduling routine if needed.
92 * @return The next thread chosen by the model-checker. If the model-checker
93 * makes no selection, retuns NULL.
95 Thread * ModelChecker::schedule_next_thread()
98 if (nextThread == THREAD_ID_T_NONE)
100 t = (*thread_map)[id_to_int(nextThread)];
108 * Choose the next thread in the replay sequence.
110 * If the replay sequence has reached the 'diverge' point, returns a thread
111 * from the backtracking set. Otherwise, simply returns the next thread in the
112 * sequence that is being replayed.
114 thread_id_t ModelChecker::get_next_replay_thread()
119 /* Have we completed exploring the preselected path? */
121 return THREAD_ID_T_NONE;
123 /* Else, we are trying to replay an execution */
124 next = node_stack->get_next()->get_action();
126 if (next == diverge) {
127 Node *node = next->get_node();
129 /* Reached divergence point */
130 DEBUG("*** Divergence point ***\n");
131 tid = node->get_next_backtrack();
134 tid = next->get_tid();
136 DEBUG("*** ModelChecker chose next thread = %d ***\n", tid);
141 * Queries the model-checker for more executions to explore and, if one
142 * exists, resets the model-checker state to execute a new execution.
144 * @return If there are more executions to explore, return true. Otherwise,
147 bool ModelChecker::next_execution()
153 if ((diverge = model->get_next_backtrack()) == NULL)
157 printf("Next execution will diverge at:\n");
161 model->reset_to_initial_state();
165 ModelAction * ModelChecker::get_last_conflict(ModelAction *act)
167 action_type type = act->get_type();
179 /* linear search: from most recent to oldest */
180 action_list_t::reverse_iterator rit;
181 for (rit = action_trace->rbegin(); rit != action_trace->rend(); rit++) {
182 ModelAction *prev = *rit;
183 if (act->is_synchronizing(prev))
189 void ModelChecker::set_backtracking(ModelAction *act)
193 Thread *t = get_thread(act->get_tid());
195 prev = get_last_conflict(act);
199 node = prev->get_node();
201 while (!node->is_enabled(t))
204 /* Check if this has been explored already */
205 if (node->has_been_explored(t->get_id()))
208 if (!next_backtrack || *prev > *next_backtrack)
209 next_backtrack = prev;
211 /* If this is a new backtracking point, mark the tree */
212 if (!node->set_backtrack(t->get_id()))
214 DEBUG("Setting backtrack: conflict = %d, instead tid = %d\n",
215 prev->get_tid(), t->get_id());
222 ModelAction * ModelChecker::get_next_backtrack()
224 ModelAction *next = next_backtrack;
225 next_backtrack = NULL;
229 void ModelChecker::check_current_action(void)
233 ModelAction *curr = this->current_action;
235 current_action = NULL;
237 DEBUG("trying to push NULL action...\n");
241 tmp = node_stack->explore_action(curr);
243 /* Discard duplicate ModelAction; use action from NodeStack */
248 * Perform one-time actions when pushing new ModelAction onto
251 curr->create_cv(get_parent_action(curr->get_tid()));
252 /* Build may_read_from set */
254 build_reads_from_past(curr);
257 /* Assign 'creation' parent */
258 if (curr->get_type() == THREAD_CREATE) {
259 Thread *th = (Thread *)curr->get_location();
260 th->set_creation(curr);
263 nextThread = get_next_replay_thread();
265 currnode = curr->get_node();
267 if (!currnode->backtrack_empty())
268 if (!next_backtrack || *curr > *next_backtrack)
269 next_backtrack = curr;
271 set_backtracking(curr);
273 add_action_to_lists(curr);
278 * Adds an action to the per-object, per-thread action vector.
279 * @param act is the ModelAction to add.
282 void ModelChecker::add_action_to_lists(ModelAction *act)
284 action_trace->push_back(act);
286 std::vector<action_list_t> *vec = &(*obj_thrd_map)[act->get_location()];
287 if (id_to_int(act->get_tid()) >= (int)vec->size())
288 vec->resize(next_thread_id);
289 (*vec)[id_to_int(act->get_tid())].push_back(act);
291 (*thrd_last_action)[id_to_int(act->get_tid())] = act;
294 ModelAction * ModelChecker::get_last_action(thread_id_t tid)
296 int nthreads = get_num_threads();
297 if ((int)thrd_last_action->size() < nthreads)
298 thrd_last_action->resize(nthreads);
299 return (*thrd_last_action)[id_to_int(tid)];
302 ModelAction * ModelChecker::get_parent_action(thread_id_t tid)
304 ModelAction *parent = get_last_action(tid);
306 parent = get_thread(tid)->get_creation();
311 * Build up an initial set of all past writes that this 'read' action may read
312 * from. This set is determined by the clock vector's "happens before"
314 * @param curr is the current ModelAction that we are exploring; it must be a
317 void ModelChecker::build_reads_from_past(ModelAction *curr)
319 std::vector<action_list_t> *thrd_lists = &(*obj_thrd_map)[curr->get_location()];
322 ASSERT(curr->is_read());
324 for (i = 0; i < thrd_lists->size(); i++) {
325 action_list_t *list = &(*thrd_lists)[i];
326 action_list_t::reverse_iterator rit;
327 for (rit = list->rbegin(); rit != list->rend(); rit++) {
328 ModelAction *act = *rit;
330 /* Only consider 'write' actions */
331 if (!act->is_write())
334 DEBUG("Adding action to may_read_from:\n");
339 curr->get_node()->add_read_from(act);
341 /* Include at most one act that "happens before" curr */
342 if (act->happens_before(curr))
348 void ModelChecker::print_summary(void)
351 printf("Number of executions: %d\n", num_executions);
352 printf("Total nodes created: %d\n", node_stack->get_total_nodes());
356 print_list(action_trace);
360 void ModelChecker::print_list(action_list_t *list)
362 action_list_t::iterator it;
364 printf("---------------------------------------------------------------------\n");
367 for (it = list->begin(); it != list->end(); it++) {
370 printf("---------------------------------------------------------------------\n");
373 int ModelChecker::add_thread(Thread *t)
375 (*thread_map)[id_to_int(t->get_id())] = t;
376 scheduler->add_thread(t);
380 void ModelChecker::remove_thread(Thread *t)
382 scheduler->remove_thread(t);
385 int ModelChecker::switch_to_master(ModelAction *act)
390 old = thread_current();
391 set_current_action(act);
392 old->set_state(THREAD_READY);
393 return Thread::swap(old, get_system_context());