1 /* Copyright (c) 2020-2021. The SimGrid Team. All rights reserved. */
3 /* This program is free software; you can redistribute it and/or modify it
4 * under the terms of the license (GNU LGPL) which comes with this package. */
8 #include "src/kernel/activity/MailboxImpl.hpp"
9 #include "src/kernel/activity/MutexImpl.hpp"
10 #include "src/kernel/actor/SimcallObserver.hpp"
11 #include "src/mc/Session.hpp"
12 #include "src/mc/checker/Checker.hpp"
13 #include "src/mc/mc_base.hpp"
14 #include "src/mc/mc_comm_pattern.hpp"
15 #include "src/mc/mc_exit.hpp"
16 #include "src/mc/mc_pattern.hpp"
17 #include "src/mc/mc_private.hpp"
18 #include "src/mc/remote/RemoteProcess.hpp"
19 #include "src/surf/HostImpl.hpp"
21 #include <xbt/asserts.h>
23 #include "simgrid/s4u/Host.hpp"
24 #include "xbt/string.hpp"
26 #include "src/smpi/include/smpi_request.hpp"
29 XBT_LOG_NEW_DEFAULT_SUBCATEGORY(Api, mc, "Logging specific to MC Facade APIs ");
31 using Simcall = simgrid::simix::Simcall;
36 static inline const char* get_color(int id)
38 static constexpr std::array<const char*, 13> colors{{"blue", "red", "green3", "goldenrod", "brown", "purple",
39 "magenta", "turquoise4", "gray25", "forestgreen", "hotpink",
41 return colors[id % colors.size()];
44 static std::string pointer_to_string(void* pointer)
46 return XBT_LOG_ISENABLED(Api, xbt_log_priority_verbose) ? xbt::string_printf("%p", pointer) : "(verbose only)";
49 static std::string buff_size_to_string(size_t buff_size)
51 return XBT_LOG_ISENABLED(Api, xbt_log_priority_verbose) ? std::to_string(buff_size) : "(verbose only)";
54 static void simcall_translate(smx_simcall_t req,
55 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl>& buffered_comm);
57 static bool request_is_enabled_by_idx(const RemoteProcess& process, smx_simcall_t req, unsigned int idx)
59 kernel::activity::CommImpl* remote_act = nullptr;
61 case Simcall::COMM_WAIT:
62 /* FIXME: check also that src and dst processes are not suspended */
63 remote_act = simcall_comm_wait__getraw__comm(req);
66 case Simcall::COMM_WAITANY:
67 remote_act = process.read(remote(simcall_comm_waitany__get__comms(req) + idx));
70 case Simcall::COMM_TESTANY:
71 remote_act = process.read(remote(simcall_comm_testany__get__comms(req) + idx));
78 Remote<kernel::activity::CommImpl> temp_comm;
79 process.read(temp_comm, remote(remote_act));
80 const kernel::activity::CommImpl* comm = temp_comm.get_buffer();
81 return comm->src_actor_.get() && comm->dst_actor_.get();
84 /* Search an enabled transition for the given process.
86 * This can be seen as an iterator returning the next transition of the process.
88 * We only consider the processes that are both
89 * - marked "to be interleaved" in their ActorState (controlled by the checker algorithm).
90 * - which simcall can currently be executed (like a comm where the other partner is already known)
91 * Once we returned the last enabled transition of a process, it is marked done.
93 * Things can get muddled with the WAITANY and TESTANY simcalls, that are rewritten on the fly to a bunch of WAIT
94 * (resp TEST) transitions using the transition.argument field to remember what was the last returned sub-transition.
96 static inline smx_simcall_t MC_state_choose_request_for_process(const RemoteProcess& process, simgrid::mc::State* state,
99 /* reset the outgoing transition */
100 simgrid::mc::ActorState* procstate = &state->actor_states_[actor->get_pid()];
101 state->transition_.aid_ = -1;
102 state->transition_.times_considered_ = -1;
103 state->transition_.textual[0] = '\0';
104 state->executed_req_.call_ = Simcall::NONE;
106 if (not simgrid::mc::actor_is_enabled(actor))
107 return nullptr; // Not executable in the application
109 smx_simcall_t req = nullptr;
110 if (actor->simcall_.observer_ != nullptr) {
111 state->transition_.times_considered_ = procstate->times_considered;
112 procstate->times_considered++;
113 if (actor->simcall_.mc_max_consider_ <= procstate->times_considered)
114 procstate->set_done();
115 req = &actor->simcall_;
117 switch (actor->simcall_.call_) {
118 case Simcall::COMM_WAITANY:
119 state->transition_.times_considered_ = -1;
120 while (procstate->times_considered < simcall_comm_waitany__get__count(&actor->simcall_)) {
121 if (simgrid::mc::request_is_enabled_by_idx(process, &actor->simcall_, procstate->times_considered)) {
122 state->transition_.times_considered_ = procstate->times_considered;
123 ++procstate->times_considered;
126 ++procstate->times_considered;
129 if (procstate->times_considered >= simcall_comm_waitany__get__count(&actor->simcall_))
130 procstate->set_done();
131 if (state->transition_.times_considered_ != -1)
132 req = &actor->simcall_;
135 case Simcall::COMM_TESTANY:
136 state->transition_.times_considered_ = -1;
137 while (procstate->times_considered < simcall_comm_testany__get__count(&actor->simcall_)) {
138 if (simgrid::mc::request_is_enabled_by_idx(process, &actor->simcall_, procstate->times_considered)) {
139 state->transition_.times_considered_ = procstate->times_considered;
140 ++procstate->times_considered;
143 ++procstate->times_considered;
146 if (procstate->times_considered >= simcall_comm_testany__get__count(&actor->simcall_))
147 procstate->set_done();
148 if (state->transition_.times_considered_ != -1)
149 req = &actor->simcall_;
152 case Simcall::COMM_WAIT: {
153 simgrid::mc::RemotePtr<simgrid::kernel::activity::CommImpl> remote_act =
154 remote(simcall_comm_wait__get__comm(&actor->simcall_));
155 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_act;
156 process.read(temp_act, remote_act);
157 const simgrid::kernel::activity::CommImpl* act = temp_act.get_buffer();
158 if (act->src_actor_.get() && act->dst_actor_.get())
159 state->transition_.times_considered_ = 0; // OK
160 else if (act->src_actor_.get() == nullptr && act->state_ == simgrid::kernel::activity::State::READY &&
162 state->transition_.times_considered_ = 0; // OK
164 state->transition_.times_considered_ = -1; // timeout
165 procstate->set_done();
166 req = &actor->simcall_;
171 procstate->set_done();
172 state->transition_.times_considered_ = 0;
173 req = &actor->simcall_;
179 state->transition_.aid_ = actor->get_pid();
180 state->executed_req_ = *req;
182 // Fetch the data of the request and translate it:
183 state->internal_req_ = *req;
184 state->internal_req_.mc_value_ = state->transition_.times_considered_;
185 simcall_translate(&state->internal_req_, state->internal_comm_);
190 static void simcall_translate(smx_simcall_t req,
191 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl>& buffered_comm)
193 simgrid::kernel::activity::CommImpl* chosen_comm;
195 /* The waitany and testany request are transformed into a wait or test request over the corresponding communication
196 * action so it can be treated later by the dependence function. */
197 switch (req->call_) {
198 case Simcall::COMM_WAITANY:
199 req->call_ = Simcall::COMM_WAIT;
201 mc_model_checker->get_remote_process().read(remote(simcall_comm_waitany__get__comms(req) + req->mc_value_));
203 mc_model_checker->get_remote_process().read(buffered_comm, remote(chosen_comm));
204 simcall_comm_wait__set__comm(req, buffered_comm.get_buffer());
205 simcall_comm_wait__set__timeout(req, 0);
208 case Simcall::COMM_TESTANY:
209 req->call_ = Simcall::COMM_TEST;
211 mc_model_checker->get_remote_process().read(remote(simcall_comm_testany__get__comms(req) + req->mc_value_));
213 mc_model_checker->get_remote_process().read(buffered_comm, remote(chosen_comm));
214 simcall_comm_test__set__comm(req, buffered_comm.get_buffer());
215 simcall_comm_test__set__result(req, req->mc_value_);
218 case Simcall::COMM_WAIT:
219 chosen_comm = simcall_comm_wait__get__comm(req);
220 mc_model_checker->get_remote_process().read(buffered_comm, remote(chosen_comm));
221 simcall_comm_wait__set__comm(req, buffered_comm.get_buffer());
224 case Simcall::COMM_TEST:
225 chosen_comm = simcall_comm_test__get__comm(req);
226 mc_model_checker->get_remote_process().read(buffered_comm, remote(chosen_comm));
227 simcall_comm_test__set__comm(req, buffered_comm.get_buffer());
231 /* No translation needed */
236 simgrid::kernel::activity::CommImpl* Api::get_comm_or_nullptr(smx_simcall_t const r) const
238 if (r->call_ == Simcall::COMM_WAIT)
239 return simcall_comm_wait__get__comm(r);
240 if (r->call_ == Simcall::COMM_TEST)
241 return simcall_comm_test__get__comm(r);
245 /** Statically "upcast" a s_smx_actor_t into an ActorInformation
247 * This gets 'actorInfo' from '&actorInfo->copy'. It upcasts in the
248 * sense that we could achieve the same thing by having ActorInformation
249 * inherit from s_smx_actor_t but we don't really want to do that.
251 simgrid::mc::ActorInformation* Api::actor_info_cast(smx_actor_t actor) const
253 simgrid::mc::ActorInformation temp;
254 std::size_t offset = (char*)temp.copy.get_buffer() - (char*)&temp;
256 auto* process_info = reinterpret_cast<simgrid::mc::ActorInformation*>((char*)actor - offset);
260 bool Api::simcall_check_dependency(smx_simcall_t req1, smx_simcall_t req2) const
262 const auto IRECV = Simcall::COMM_IRECV;
263 const auto ISEND = Simcall::COMM_ISEND;
264 const auto TEST = Simcall::COMM_TEST;
265 const auto WAIT = Simcall::COMM_WAIT;
267 if (req1->issuer_ == req2->issuer_)
270 /* The independence theorem only consider 4 simcalls. All others are dependent with anything. */
271 if (req1->call_ != ISEND && req1->call_ != IRECV && req1->call_ != TEST && req1->call_ != WAIT)
273 if (req2->call_ != ISEND && req2->call_ != IRECV && req2->call_ != TEST && req2->call_ != WAIT)
276 /* Timeouts in wait transitions are not considered by the independence theorem, thus assumed dependent */
277 if ((req1->call_ == WAIT && simcall_comm_wait__get__timeout(req1) > 0) ||
278 (req2->call_ == WAIT && simcall_comm_wait__get__timeout(req2) > 0))
281 /* Make sure that req1 and req2 are in alphabetic order */
282 if (req1->call_ > req2->call_) {
288 auto comm1 = get_comm_or_nullptr(req1);
289 auto comm2 = get_comm_or_nullptr(req2);
291 /* First case: that's not the same kind of request (we also know that req1 < req2 alphabetically) */
292 if (req1->call_ != req2->call_) {
293 if (req1->call_ == IRECV && req2->call_ == ISEND)
296 if ((req1->call_ == IRECV || req1->call_ == ISEND) && req2->call_ == WAIT) {
297 auto mbox1 = get_mbox_remote_addr(req1);
298 auto mbox2 = remote(comm2->mbox_cpy);
300 if (mbox1 != mbox2 && simcall_comm_wait__get__timeout(req2) <= 0)
303 if ((req1->issuer_ != comm2->src_actor_.get()) && (req1->issuer_ != comm2->dst_actor_.get()) &&
304 simcall_comm_wait__get__timeout(req2) <= 0)
307 if ((req1->call_ == ISEND) && (comm2->type_ == kernel::activity::CommImpl::Type::SEND) &&
308 (comm2->src_buff_ != simcall_comm_isend__get__src_buff(req1)) && simcall_comm_wait__get__timeout(req2) <= 0)
311 if ((req1->call_ == IRECV) && (comm2->type_ == kernel::activity::CommImpl::Type::RECEIVE) &&
312 (comm2->dst_buff_ != simcall_comm_irecv__get__dst_buff(req1)) && simcall_comm_wait__get__timeout(req2) <= 0)
316 /* FIXME: the following rule assumes that the result of the isend/irecv call is not stored in a buffer used in the
319 if((req1->call == ISEND || req1->call == IRECV)
320 && req2->call == TEST)
324 if (req1->call_ == TEST && req2->call_ == WAIT &&
325 (comm1->src_actor_.get() == nullptr || comm1->dst_actor_.get() == nullptr))
328 if (req1->call_ == TEST &&
329 (simcall_comm_test__get__comm(req1) == nullptr || comm1->src_buff_ == nullptr || comm1->dst_buff_ == nullptr))
331 if (req2->call_ == TEST &&
332 (simcall_comm_test__get__comm(req2) == nullptr || comm2->src_buff_ == nullptr || comm2->dst_buff_ == nullptr))
335 if (req1->call_ == TEST && req2->call_ == WAIT && comm1->src_buff_ == comm2->src_buff_ &&
336 comm1->dst_buff_ == comm2->dst_buff_)
339 if (req1->call_ == TEST && req2->call_ == WAIT && comm1->src_buff_ != nullptr && comm1->dst_buff_ != nullptr &&
340 comm2->src_buff_ != nullptr && comm2->dst_buff_ != nullptr && comm1->dst_buff_ != comm2->src_buff_ &&
341 comm1->dst_buff_ != comm2->dst_buff_ && comm2->dst_buff_ != comm1->src_buff_)
347 /* Second case: req1 and req2 are of the same call type */
348 switch (req1->call_) {
350 return simcall_comm_isend__get__mbox(req1) == simcall_comm_isend__get__mbox(req2);
352 return simcall_comm_irecv__get__mbox(req1) == simcall_comm_irecv__get__mbox(req2);
354 if (comm1->src_buff_ == comm2->src_buff_ && comm1->dst_buff_ == comm2->dst_buff_)
356 if (comm1->src_buff_ != nullptr && comm1->dst_buff_ != nullptr && comm2->src_buff_ != nullptr &&
357 comm2->dst_buff_ != nullptr && comm1->dst_buff_ != comm2->src_buff_ && comm1->dst_buff_ != comm2->dst_buff_ &&
358 comm2->dst_buff_ != comm1->src_buff_)
366 xbt::string const& Api::get_actor_host_name(smx_actor_t actor) const
368 if (mc_model_checker == nullptr)
369 return actor->get_host()->get_name();
371 const simgrid::mc::RemoteProcess* process = &mc_model_checker->get_remote_process();
373 // Read the simgrid::xbt::string in the MCed process:
374 simgrid::mc::ActorInformation* info = actor_info_cast(actor);
376 if (not info->hostname) {
377 Remote<s4u::Host> temp_host = process->read(remote(actor->get_host()));
378 auto remote_string_address = remote(&xbt::string::to_string_data(temp_host.get_buffer()->get_impl()->get_name()));
379 simgrid::xbt::string_data remote_string = process->read(remote_string_address);
380 std::vector<char> hostname(remote_string.len + 1);
381 // no need to read the terminating null byte, and thus hostname[remote_string.len] is guaranteed to be '\0'
382 process->read_bytes(hostname.data(), remote_string.len, remote(remote_string.data));
383 info->hostname = &mc_model_checker->get_host_name(hostname.data());
385 return *info->hostname;
388 xbt::string const& Api::get_actor_name(smx_actor_t actor) const
390 if (mc_model_checker == nullptr)
391 return actor->get_name();
393 simgrid::mc::ActorInformation* info = actor_info_cast(actor);
394 if (info->name.empty()) {
395 const simgrid::mc::RemoteProcess* process = &mc_model_checker->get_remote_process();
397 simgrid::xbt::string_data string_data = simgrid::xbt::string::to_string_data(actor->name_);
398 info->name = process->read_string(remote(string_data.data), string_data.len);
403 std::string Api::get_actor_string(smx_actor_t actor) const
407 res = "(" + std::to_string(actor->get_pid()) + ")";
408 if (actor->get_host())
409 res += std::string(get_actor_host_name(actor)) + " (" + std::string(get_actor_name(actor)) + ")";
411 res += get_actor_name(actor);
417 std::string Api::get_actor_dot_label(smx_actor_t actor) const
419 std::string res = "(" + std::to_string(actor->get_pid()) + ")";
420 if (actor->get_host())
421 res += get_actor_host_name(actor);
425 simgrid::mc::Checker* Api::initialize(char** argv, simgrid::mc::CheckerAlgorithm algo) const
427 auto session = new simgrid::mc::Session([argv] {
429 while (argv[i] != nullptr && argv[i][0] == '-')
431 xbt_assert(argv[i] != nullptr,
432 "Unable to find a binary to exec on the command line. Did you only pass config flags?");
433 execvp(argv[i], argv + i);
434 xbt_die("The model-checked process failed to exec(%s): %s", argv[i], strerror(errno));
437 simgrid::mc::Checker* checker;
439 case CheckerAlgorithm::CommDeterminism:
440 checker = simgrid::mc::create_communication_determinism_checker(session);
443 case CheckerAlgorithm::UDPOR:
444 checker = simgrid::mc::create_udpor_checker(session);
447 case CheckerAlgorithm::Safety:
448 checker = simgrid::mc::create_safety_checker(session);
451 case CheckerAlgorithm::Liveness:
452 checker = simgrid::mc::create_liveness_checker(session);
459 // FIXME: session and checker are never deleted
460 simgrid::mc::session_singleton = session;
461 mc_model_checker->setChecker(checker);
465 std::vector<simgrid::mc::ActorInformation>& Api::get_actors() const
467 return mc_model_checker->get_remote_process().actors();
470 unsigned long Api::get_maxpid() const
472 return mc_model_checker->get_remote_process().get_maxpid();
475 int Api::get_actors_size() const
477 return mc_model_checker->get_remote_process().actors().size();
480 RemotePtr<kernel::activity::CommImpl> Api::get_comm_isend_raw_addr(smx_simcall_t request) const
482 return remote(static_cast<kernel::activity::CommImpl*>(simcall_comm_isend__getraw__result(request)));
485 RemotePtr<kernel::activity::CommImpl> Api::get_comm_waitany_raw_addr(smx_simcall_t request, int value) const
487 auto addr = simcall_comm_waitany__getraw__comms(request) + value;
488 auto comm_addr = mc_model_checker->get_remote_process().read(remote(addr));
489 return RemotePtr<kernel::activity::CommImpl>(static_cast<kernel::activity::CommImpl*>(comm_addr));
492 std::string Api::get_pattern_comm_rdv(RemotePtr<kernel::activity::CommImpl> const& addr) const
494 Remote<kernel::activity::CommImpl> temp_activity;
495 mc_model_checker->get_remote_process().read(temp_activity, addr);
496 const kernel::activity::CommImpl* activity = temp_activity.get_buffer();
498 char* remote_name = mc_model_checker->get_remote_process().read<char*>(RemotePtr<char*>(
499 (uint64_t)(activity->get_mailbox() ? &activity->get_mailbox()->get_name() : &activity->mbox_cpy->get_name())));
500 auto rdv = mc_model_checker->get_remote_process().read_string(RemotePtr<char>(remote_name));
504 unsigned long Api::get_pattern_comm_src_proc(RemotePtr<kernel::activity::CommImpl> const& addr) const
506 Remote<kernel::activity::CommImpl> temp_activity;
507 mc_model_checker->get_remote_process().read(temp_activity, addr);
508 const kernel::activity::CommImpl* activity = temp_activity.get_buffer();
510 mc_model_checker->get_remote_process().resolve_actor(mc::remote(activity->src_actor_.get()))->get_pid();
514 unsigned long Api::get_pattern_comm_dst_proc(RemotePtr<kernel::activity::CommImpl> const& addr) const
516 Remote<kernel::activity::CommImpl> temp_activity;
517 mc_model_checker->get_remote_process().read(temp_activity, addr);
518 const kernel::activity::CommImpl* activity = temp_activity.get_buffer();
520 mc_model_checker->get_remote_process().resolve_actor(mc::remote(activity->dst_actor_.get()))->get_pid();
524 std::vector<char> Api::get_pattern_comm_data(RemotePtr<kernel::activity::CommImpl> const& addr) const
526 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_comm;
527 mc_model_checker->get_remote_process().read(temp_comm, addr);
528 const simgrid::kernel::activity::CommImpl* comm = temp_comm.get_buffer();
530 std::vector<char> buffer{};
531 if (comm->src_buff_ != nullptr) {
532 buffer.resize(comm->src_buff_size_);
533 mc_model_checker->get_remote_process().read_bytes(buffer.data(), buffer.size(), remote(comm->src_buff_));
539 bool Api::check_send_request_detached(smx_simcall_t const& simcall) const
541 Remote<simgrid::smpi::Request> mpi_request;
542 mc_model_checker->get_remote_process().read(
543 mpi_request, remote(static_cast<smpi::Request*>(simcall_comm_isend__get__data(simcall))));
544 return mpi_request.get_buffer()->detached();
548 smx_actor_t Api::get_src_actor(RemotePtr<kernel::activity::CommImpl> const& comm_addr) const
550 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_comm;
551 mc_model_checker->get_remote_process().read(temp_comm, comm_addr);
552 const simgrid::kernel::activity::CommImpl* comm = temp_comm.get_buffer();
554 auto src_proc = mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(comm->src_actor_.get()));
558 smx_actor_t Api::get_dst_actor(RemotePtr<kernel::activity::CommImpl> const& comm_addr) const
560 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_comm;
561 mc_model_checker->get_remote_process().read(temp_comm, comm_addr);
562 const simgrid::kernel::activity::CommImpl* comm = temp_comm.get_buffer();
564 auto dst_proc = mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(comm->dst_actor_.get()));
568 std::size_t Api::get_remote_heap_bytes() const
570 RemoteProcess& process = mc_model_checker->get_remote_process();
571 auto heap_bytes_used = mmalloc_get_bytes_used_remote(process.get_heap()->heaplimit, process.get_malloc_info());
572 return heap_bytes_used;
575 void Api::mc_inc_visited_states() const
577 mc_model_checker->visited_states++;
580 void Api::mc_inc_executed_trans() const
582 mc_model_checker->executed_transitions++;
585 unsigned long Api::mc_get_visited_states() const
587 return mc_model_checker->visited_states;
590 unsigned long Api::mc_get_executed_trans() const
592 return mc_model_checker->executed_transitions;
595 void Api::mc_check_deadlock() const
597 if (mc_model_checker->checkDeadlock()) {
599 throw DeadlockError();
603 /** Get the issuer of a simcall (`req->issuer`)
605 * In split-process mode, it does the black magic necessary to get an address
606 * of a (shallow) copy of the data structure the issuer SIMIX actor in the local
609 * @param process the MCed process
610 * @param req the simcall (copied in the local process)
612 smx_actor_t Api::simcall_get_issuer(s_smx_simcall const* req) const
614 xbt_assert(mc_model_checker != nullptr);
616 // This is the address of the smx_actor in the MCed process:
617 auto address = simgrid::mc::remote(req->issuer_);
619 // Lookup by address:
620 for (auto& actor : mc_model_checker->get_remote_process().actors())
621 if (actor.address == address)
622 return actor.copy.get_buffer();
623 for (auto& actor : mc_model_checker->get_remote_process().dead_actors())
624 if (actor.address == address)
625 return actor.copy.get_buffer();
627 xbt_die("Issuer not found");
630 long Api::simcall_get_actor_id(s_smx_simcall const* req) const
632 return simcall_get_issuer(req)->get_pid();
635 RemotePtr<kernel::activity::MailboxImpl> Api::get_mbox_remote_addr(smx_simcall_t const req) const
637 if (req->call_ == Simcall::COMM_ISEND)
638 return remote(simcall_comm_isend__get__mbox(req));
639 if (req->call_ == Simcall::COMM_IRECV)
640 return remote(simcall_comm_irecv__get__mbox(req));
644 RemotePtr<kernel::activity::ActivityImpl> Api::get_comm_remote_addr(smx_simcall_t const req) const
646 if (req->call_ == Simcall::COMM_ISEND)
647 return remote(simcall_comm_isend__getraw__result(req));
648 if (req->call_ == Simcall::COMM_IRECV)
649 return remote(simcall_comm_irecv__getraw__result(req));
653 bool Api::mc_is_null() const
655 auto is_null = (mc_model_checker == nullptr) ? true : false;
659 Checker* Api::mc_get_checker() const
661 return mc_model_checker->getChecker();
664 void Api::handle_simcall(Transition const& transition) const
666 mc_model_checker->handle_simcall(transition);
669 void Api::mc_wait_for_requests() const
671 mc_model_checker->wait_for_requests();
674 void Api::mc_exit(int status) const
676 mc_model_checker->exit(status);
679 void Api::dump_record_path() const
681 simgrid::mc::dumpRecordPath();
684 smx_simcall_t Api::mc_state_choose_request(simgrid::mc::State* state) const
686 RemoteProcess& process = mc_model_checker->get_remote_process();
687 for (auto& actor : process.actors()) {
688 /* Only consider the actors that were marked as interleaving by the checker algorithm */
689 if (not state->actor_states_[actor.copy.get_buffer()->get_pid()].is_todo())
692 smx_simcall_t res = MC_state_choose_request_for_process(process, state, actor.copy.get_buffer());
699 std::list<transition_detail_t> Api::get_enabled_transitions(simgrid::mc::State* state) const
701 std::list<transition_detail_t> tr_list{};
703 for (auto& actor : mc_model_checker->get_remote_process().actors()) {
704 auto actor_pid = actor.copy.get_buffer()->get_pid();
705 auto actor_impl = actor.copy.get_buffer();
707 // Only consider the actors that were marked as interleaving by the checker algorithm
708 if (not state->actor_states_[actor_pid].is_todo())
710 // Not executable in the application
711 if (not simgrid::mc::actor_is_enabled(actor_impl))
714 auto transition = std::make_unique<s_transition_detail>();
715 Simcall simcall_call = actor_impl->simcall_.call_;
716 smx_simcall_t simcall = &actor_impl->simcall_;
717 transition->call_ = simcall_call;
718 switch (simcall_call) {
719 case Simcall::COMM_ISEND:
720 case Simcall::COMM_IRECV:
721 transition->mbox_remote_addr = get_mbox_remote_addr(simcall);
722 transition->comm_remote_addr = get_comm_remote_addr(simcall);
728 tr_list.emplace_back(std::move(transition));
734 std::string Api::request_to_string(smx_simcall_t req, int value) const
736 xbt_assert(mc_model_checker != nullptr, "Must be called from MCer");
741 smx_actor_t issuer = simcall_get_issuer(req);
743 if (issuer->simcall_.observer_ != nullptr)
744 return mc_model_checker->simcall_to_string(issuer->get_pid(), value);
746 switch (req->call_) {
747 case Simcall::COMM_ISEND:
749 args = "src=" + get_actor_string(issuer);
750 args += ", buff=" + pointer_to_string(simcall_comm_isend__get__src_buff(req));
751 args += ", size=" + buff_size_to_string(simcall_comm_isend__get__src_buff_size(req));
754 case Simcall::COMM_IRECV: {
755 size_t* remote_size = simcall_comm_irecv__get__dst_buff_size(req);
758 mc_model_checker->get_remote_process().read_bytes(&size, sizeof(size), remote(remote_size));
761 args = "dst=" + get_actor_string(issuer);
762 args += ", buff=" + pointer_to_string(simcall_comm_irecv__get__dst_buff(req));
763 args += ", size=" + buff_size_to_string(size);
767 case Simcall::COMM_WAIT: {
768 simgrid::kernel::activity::CommImpl* remote_act = simcall_comm_wait__get__comm(req);
770 type = "WaitTimeout";
771 args = "comm=" + pointer_to_string(remote_act);
775 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_activity;
776 const simgrid::kernel::activity::CommImpl* act;
777 mc_model_checker->get_remote_process().read(temp_activity, remote(remote_act));
778 act = temp_activity.get_buffer();
780 smx_actor_t src_proc =
781 mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(act->src_actor_.get()));
782 smx_actor_t dst_proc =
783 mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(act->dst_actor_.get()));
784 args = "comm=" + pointer_to_string(remote_act);
785 args += " [" + get_actor_string(src_proc) + "-> " + get_actor_string(dst_proc) + "]";
790 case Simcall::COMM_TEST: {
791 simgrid::kernel::activity::CommImpl* remote_act = simcall_comm_test__get__comm(req);
792 simgrid::mc::Remote<simgrid::kernel::activity::CommImpl> temp_activity;
793 const simgrid::kernel::activity::CommImpl* act;
794 mc_model_checker->get_remote_process().read(temp_activity, remote(remote_act));
795 act = temp_activity.get_buffer();
797 if (act->src_actor_.get() == nullptr || act->dst_actor_.get() == nullptr) {
799 args = "comm=" + pointer_to_string(remote_act);
803 smx_actor_t src_proc =
804 mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(act->src_actor_.get()));
805 smx_actor_t dst_proc =
806 mc_model_checker->get_remote_process().resolve_actor(simgrid::mc::remote(act->dst_actor_.get()));
807 args = "comm=" + pointer_to_string(remote_act);
808 args += " [" + get_actor_string(src_proc) + " -> " + get_actor_string(dst_proc) + "]";
813 case Simcall::COMM_WAITANY: {
815 size_t count = simcall_comm_waitany__get__count(req);
817 simgrid::kernel::activity::CommImpl* remote_sync;
819 mc_model_checker->get_remote_process().read(remote(simcall_comm_waitany__get__comms(req) + value));
820 args = "comm=" + pointer_to_string(remote_sync) + xbt::string_printf("(%d of %zu)", value + 1, count);
822 args = "comm at idx " + std::to_string(value);
826 case Simcall::COMM_TESTANY:
828 type = "TestAny FALSE";
832 args = xbt::string_printf("(%d of %zu)", value + 1, simcall_comm_testany__get__count(req));
837 type = SIMIX_simcall_name(*req);
842 return "[" + get_actor_string(issuer) + "] " + type + "(" + args + ")";
845 std::string Api::request_get_dot_output(smx_simcall_t req, int value) const
847 const smx_actor_t issuer = simcall_get_issuer(req);
848 const char* color = get_color(issuer->get_pid() - 1);
852 if (req->observer_ != nullptr) {
853 label = mc_model_checker->simcall_dot_label(issuer->get_pid(), value);
855 switch (req->call_) {
856 case Simcall::COMM_ISEND:
857 label = "[" + get_actor_dot_label(issuer) + "] iSend";
860 case Simcall::COMM_IRECV:
861 label = "[" + get_actor_dot_label(issuer) + "] iRecv";
864 case Simcall::COMM_WAIT:
866 label = "[" + get_actor_dot_label(issuer) + "] WaitTimeout";
868 kernel::activity::ActivityImpl* remote_act = simcall_comm_wait__get__comm(req);
869 Remote<kernel::activity::CommImpl> temp_comm;
870 mc_model_checker->get_remote_process().read(temp_comm,
871 remote(static_cast<kernel::activity::CommImpl*>(remote_act)));
872 const kernel::activity::CommImpl* comm = temp_comm.get_buffer();
874 const kernel::actor::ActorImpl* src_proc =
875 mc_model_checker->get_remote_process().resolve_actor(mc::remote(comm->src_actor_.get()));
876 const kernel::actor::ActorImpl* dst_proc =
877 mc_model_checker->get_remote_process().resolve_actor(mc::remote(comm->dst_actor_.get()));
878 label = "[" + get_actor_dot_label(issuer) + "] Wait";
879 label += " [(" + std::to_string(src_proc ? src_proc->get_pid() : 0) + ")";
880 label += "->(" + std::to_string(dst_proc ? dst_proc->get_pid() : 0) + ")]";
884 case Simcall::COMM_TEST: {
885 kernel::activity::ActivityImpl* remote_act = simcall_comm_test__get__comm(req);
886 Remote<simgrid::kernel::activity::CommImpl> temp_comm;
887 mc_model_checker->get_remote_process().read(temp_comm,
888 remote(static_cast<kernel::activity::CommImpl*>(remote_act)));
889 const kernel::activity::CommImpl* comm = temp_comm.get_buffer();
890 if (comm->src_actor_.get() == nullptr || comm->dst_actor_.get() == nullptr) {
891 label = "[" + get_actor_dot_label(issuer) + "] Test FALSE";
893 label = "[" + get_actor_dot_label(issuer) + "] Test TRUE";
898 case Simcall::COMM_WAITANY:
899 label = "[" + get_actor_dot_label(issuer) + "] WaitAny";
900 label += xbt::string_printf(" [%d of %zu]", value + 1, simcall_comm_waitany__get__count(req));
903 case Simcall::COMM_TESTANY:
905 label = "[" + get_actor_dot_label(issuer) + "] TestAny FALSE";
907 label = "[" + get_actor_dot_label(issuer) + "] TestAny TRUE";
908 label += xbt::string_printf(" [%d of %zu]", value + 1, simcall_comm_testany__get__count(req));
916 return "label = \"" + label + "\", color = " + color + ", fontcolor = " + color;
920 int Api::get_smpi_request_tag(smx_simcall_t const& simcall, simgrid::simix::Simcall type) const
922 void* simcall_data = nullptr;
923 if (type == Simcall::COMM_ISEND)
924 simcall_data = simcall_comm_isend__get__data(simcall);
925 else if (type == Simcall::COMM_IRECV)
926 simcall_data = simcall_comm_irecv__get__data(simcall);
927 Remote<simgrid::smpi::Request> mpi_request;
928 mc_model_checker->get_remote_process().read(mpi_request, remote(static_cast<smpi::Request*>(simcall_data)));
929 return mpi_request.get_buffer()->tag();
933 void Api::restore_state(std::shared_ptr<simgrid::mc::Snapshot> system_state) const
935 system_state->restore(&mc_model_checker->get_remote_process());
938 void Api::log_state() const
940 session_singleton->log_state();
943 bool Api::snapshot_equal(const Snapshot* s1, const Snapshot* s2) const
945 return simgrid::mc::snapshot_equal(s1, s2);
948 simgrid::mc::Snapshot* Api::take_snapshot(int num_state) const
950 auto snapshot = new simgrid::mc::Snapshot(num_state);
954 void Api::s_close() const
956 session_singleton->close();
959 void Api::execute(Transition& transition, smx_simcall_t simcall) const
961 /* FIXME: once all simcalls have observers, kill the simcall parameter and use mc_model_checker->simcall_to_string() */
962 transition.textual = request_to_string(simcall, transition.times_considered_);
963 session_singleton->execute(transition);
966 void Api::automaton_load(const char* file) const
968 MC_automaton_load(file);
971 std::vector<int> Api::automaton_propositional_symbol_evaluate() const
973 unsigned int cursor = 0;
974 std::vector<int> values;
975 xbt_automaton_propositional_symbol_t ps = nullptr;
976 xbt_dynar_foreach (mc::property_automaton->propositional_symbols, cursor, ps)
977 values.push_back(xbt_automaton_propositional_symbol_evaluate(ps));
981 std::vector<xbt_automaton_state_t> Api::get_automaton_state() const
983 std::vector<xbt_automaton_state_t> automaton_stack;
984 unsigned int cursor = 0;
985 xbt_automaton_state_t automaton_state;
986 xbt_dynar_foreach (mc::property_automaton->states, cursor, automaton_state)
987 if (automaton_state->type == -1)
988 automaton_stack.push_back(automaton_state);
989 return automaton_stack;
992 int Api::compare_automaton_exp_label(const xbt_automaton_exp_label* l) const
994 unsigned int cursor = 0;
995 xbt_automaton_propositional_symbol_t p = nullptr;
996 xbt_dynar_foreach (simgrid::mc::property_automaton->propositional_symbols, cursor, p) {
997 if (std::strcmp(xbt_automaton_propositional_symbol_get_name(p), l->u.predicat) == 0)
1003 void Api::set_property_automaton(xbt_automaton_state_t const& automaton_state) const
1005 mc::property_automaton->current_state = automaton_state;
1008 xbt_automaton_exp_label_t Api::get_automaton_transition_label(xbt_dynar_t const& dynar, int index) const
1010 const xbt_automaton_transition* transition = xbt_dynar_get_as(dynar, index, xbt_automaton_transition_t);
1011 return transition->label;
1014 xbt_automaton_state_t Api::get_automaton_transition_dst(xbt_dynar_t const& dynar, int index) const
1016 const xbt_automaton_transition* transition = xbt_dynar_get_as(dynar, index, xbt_automaton_transition_t);
1017 return transition->dst;
1021 } // namespace simgrid