src/mc/mc_config.cpp

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