src/mc/mc_config.cpp

   1 /* Copyright (c) 2008-2021. 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 "src/mc/mc_config.hpp"
   7 #include "src/mc/mc_replay.hpp"
   8 #include <simgrid/sg_config.hpp>
   9 #if SIMGRID_HAVE_MC
  10 #include "src/mc/mc_safety.hpp"
  11 #endif
  12
  13 #include <climits>
  14
  15 #if SIMGRID_HAVE_MC
  16 namespace simgrid {
  17 namespace mc {
  18 /* Configuration support */
  19 simgrid::mc::ReductionMode reduction_mode = simgrid::mc::ReductionMode::unset;
  20 }
  21 }
  22 #else
  23 #define _sg_do_model_check 0
  24 #endif
  25
  26 static void _mc_cfg_cb_check(const char* spec, bool more_check = true)
  27 {
  28   xbt_assert(_sg_cfg_init_status == 0 || _sg_do_model_check || not more_check,
  29              "You are specifying a %s after the initialization (through MSG_config?), but the program was not run "
  30              "under the model-checker (with simgrid-mc)). This won't work, sorry.",
  31              spec);
  32 }
  33
  34 /* Replay (this part is enabled even if MC it disabled) */
  35 simgrid::config::Flag<std::string> _sg_mc_record_path{
  36     "model-check/replay", "Model-check path to replay (as reported by SimGrid when a violation is reported)", "",
  37     [](const std::string& value) { MC_record_path() = value; }};
  38
  39 simgrid::config::Flag<bool> _sg_mc_timeout{
  40     "model-check/timeout", "Whether to enable timeouts for wait requests", false, [](bool) {
  41       _mc_cfg_cb_check("value to enable/disable timeout for wait requests", not MC_record_replay_is_active());
  42     }};
  43
  44 #if SIMGRID_HAVE_MC
  45 int _sg_do_model_check = 0;
  46 int _sg_mc_max_visited_states = 0;
  47
  48 simgrid::config::Flag<int> _sg_mc_checkpoint{
  49     "model-check/checkpoint", "Specify the amount of steps between checkpoints during stateful model-checking "
  50                               "(default: 0 => stateless verification). If value=1, one checkpoint is saved for each "
  51                               "step => faster verification, but huge memory consumption; higher values are good "
  52                               "compromises between speed and memory consumption.",
  53     0, [](int) { _mc_cfg_cb_check("checkpointing value"); }};
  54
  55 simgrid::config::Flag<std::string> _sg_mc_property_file{
  56     "model-check/property", "Name of the file containing the property, as formatted by the ltl2ba program.", "",
  57     [](const std::string&) { _mc_cfg_cb_check("property"); }};
  58
  59 simgrid::config::Flag<bool> _sg_mc_comms_determinism{
  60     "model-check/communications-determinism",
  61     "Whether to enable the detection of communication determinism",
  62     false,
  63     [](bool) {
  64       _mc_cfg_cb_check("value to enable/disable the detection of determinism in the communications schemes");
  65     }};
  66
  67 simgrid::config::Flag<bool> _sg_mc_send_determinism{
  68     "model-check/send-determinism",
  69     "Enable/disable the detection of send-determinism in the communications schemes",
  70     false,
  71     [](bool) {
  72       _mc_cfg_cb_check("value to enable/disable the detection of send-determinism in the communications schemes");
  73     }};
  74
  75 simgrid::config::Flag<bool> _sg_mc_unfolding_checker{
  76     "model-check/unfolding-checker",
  77     "Whether to enable the unfolding-based dynamic partial order reduction to MPI programs", false, [](bool) {
  78       _mc_cfg_cb_check("value to to enable/disable the unfolding-based dynamic partial order reduction to MPI programs");
  79     }};
  80
  81 simgrid::config::Flag<std::string> _sg_mc_buffering{
  82     "smpi/buffering",
  83     "Buffering semantic to use for MPI (only used in MC)",
  84     "infty",
  85     {{"zero", "No system buffering: MPI_Send is blocking"},
  86      {"infty", "Infinite system buffering: MPI_Send returns immediately"}},
  87     [](const std::string&) { _mc_cfg_cb_check("buffering mode"); }};
  88
  89 static simgrid::config::Flag<std::string> _sg_mc_reduce{
  90     "model-check/reduction", "Specify the kind of exploration reduction (either none or DPOR)", "dpor",
  91     [](const std::string& value) {
  92       _mc_cfg_cb_check("reduction strategy");
  93
  94       if (value == "none")
  95         simgrid::mc::reduction_mode = simgrid::mc::ReductionMode::none;
  96       else if (value == "dpor")
  97         simgrid::mc::reduction_mode = simgrid::mc::ReductionMode::dpor;
  98       else
  99         xbt_die("configuration option model-check/reduction can only take 'none' or 'dpor' as a value");
 100     }};
 101
 102 simgrid::config::Flag<int> _sg_mc_max_depth{"model-check/max-depth",
 103                                             "Maximal exploration depth (default: 1000)",
 104                                             1000,
 105                                             [](int) { _mc_cfg_cb_check("max depth value"); }};
 106
 107 static simgrid::config::Flag<int> _sg_mc_max_visited_states__{
 108     "model-check/visited", "Specify the number of visited state stored for state comparison reduction. If value=5, the "
 109                            "last 5 visited states are stored. If value=0 (the default), all states are stored.",
 110     0, [](int value) {
 111       _mc_cfg_cb_check("number of stored visited states");
 112       _sg_mc_max_visited_states = value;
 113     }};
 114
 115 simgrid::config::Flag<std::string> _sg_mc_dot_output_file{
 116     "model-check/dot-output",
 117     "Name of dot output file corresponding to graph state",
 118     "",
 119     [](const std::string&) { _mc_cfg_cb_check("file name for a dot output of graph state"); }};
 120
 121 simgrid::config::Flag<bool> _sg_mc_termination{
 122     "model-check/termination", "Whether to enable non progressive cycle detection", false,
 123     [](bool) { _mc_cfg_cb_check("value to enable/disable the detection of non progressive cycles"); }};
 124
 125 #endif