src/mc/mc_client_api.cpp

   1 /* Copyright (c) 2008-2023. The SimGrid Team. All rights reserved.          */
   2
   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. */
   5
   6 #include "simgrid/simix.hpp"
   7 #include "src/kernel/actor/ActorImpl.hpp"
   8 #include "src/mc/mc_config.hpp"
   9 #include "src/mc/mc_private.hpp"
  10 #include "src/mc/mc_record.hpp"
  11 #include "src/mc/mc_replay.hpp"
  12 #include "src/mc/remote/AppSide.hpp"
  13 #include "xbt/asserts.h"
  14 #include "xbt/random.hpp"
  15
  16 /* Implementation of the user API from the App to the Checker (see modelchecker.h)  */
  17
  18 int MC_random(int min, int max)
  19 {
  20   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  21              "This should be called from the client side");
  22
  23   if (not MC_is_active() && not MC_record_replay_is_active()) { // no need to do a simcall in this case
  24     static simgrid::xbt::random::XbtRandom prng;
  25     return prng.uniform_int(min, max);
  26   }
  27   simgrid::kernel::actor::RandomSimcall observer{simgrid::kernel::actor::ActorImpl::self(), min, max};
  28   return simgrid::kernel::actor::simcall_answered([&observer] { return observer.get_value(); }, &observer);
  29 }
  30
  31 void MC_assert(int prop)
  32 {
  33   // Cannot used xbt_assert here, or it would be an infinite recursion.
  34   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  35              "This should be called from the client side");
  36   if (not prop) {
  37     if (MC_is_active())
  38       simgrid::mc::AppSide::get()->report_assertion_failure();
  39     if (MC_record_replay_is_active())
  40       xbt_die("MC assertion failed");
  41   }
  42 }
  43
  44 int MC_is_active()
  45 {
  46   return simgrid::mc::model_checking_mode == simgrid::mc::ModelCheckingMode::APP_SIDE ||
  47          simgrid::mc::model_checking_mode == simgrid::mc::ModelCheckingMode::CHECKER_SIDE;
  48 }
  49
  50 void MC_automaton_new_propositional_symbol_pointer(const char *name, int* value)
  51 {
  52   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  53              "This should be called from the client side");
  54   simgrid::mc::AppSide::get()->declare_symbol(name, value);
  55 }
  56
  57 void MC_ignore(void* addr, size_t size)
  58 {
  59   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  60              "This should be called from the client side");
  61   simgrid::mc::AppSide::get()->ignore_memory(addr, size);
  62 }
  63
  64 void MC_ignore_heap(void *address, size_t size)
  65 {
  66   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  67              "This should be called from the client side");
  68   simgrid::mc::AppSide::get()->ignore_heap(address, size);
  69 }
  70
  71 void MC_unignore_heap(void* address, size_t size)
  72 {
  73   xbt_assert(simgrid::mc::model_checking_mode != simgrid::mc::ModelCheckingMode::CHECKER_SIDE,
  74              "This should be called from the client side");
  75   simgrid::mc::AppSide::get()->unignore_heap(address, size);
  76 }