CBMC
single_path_symex_only_checker.cpp
Go to the documentation of this file.
1 /*******************************************************************\
2 
3 Module: Goto Checker using Single Path Symbolic Execution only
4 
5 Author: Daniel Kroening, Peter Schrammel
6 
7 \*******************************************************************/
8 
11 
13 
14 #include <util/ui_message.h>
15 
19 #include <goto-symex/show_vcc.h>
20 
21 #include "bmc_util.h"
22 #include "symex_bmc.h"
23 
25  const optionst &options,
26  ui_message_handlert &ui_message_handler,
27  abstract_goto_modelt &goto_model)
28  : incremental_goto_checkert(options, ui_message_handler),
29  goto_model(goto_model),
30  ns(goto_model.get_symbol_table(), symex_symbol_table),
31  worklist(get_path_strategy(options.get_option("exploration-strategy"))),
32  symex_runtime(0),
33  unwindset(goto_model)
34 {
35 }
36 
38 operator()(propertiest &properties)
39 {
40  resultt result(resultt::progresst::DONE);
41 
43 
44  while(!has_finished_exploration(properties))
45  {
46  path_storaget::patht &path = worklist->peek();
47 
48  (void)resume_path(path);
49 
50  update_properties(properties, result.updated_properties, path.equation);
51 
52  worklist->pop();
53  }
54 
55  log.status() << "Runtime Symex: " << symex_runtime.count() << "s"
56  << messaget::eom;
57 
58  final_update_properties(properties, result.updated_properties);
59 
60  return result;
61 }
62 
64 {
65  // Put initial state into the work list
67  symex_bmct symex(
70  equation,
71  options,
72  *worklist,
74  unwindset);
75  setup_symex(symex);
76 
77  // Gather fields for shadow memory instrumentation
78  const auto fields =
80 
83 }
84 
86  const propertiest &properties)
87 {
88  return worklist->empty() ||
89  (!options.get_bool_option("paths-symex-explore-all") &&
90  !has_properties_to_check(properties));
91 }
92 
94 {
95  const auto symex_start = std::chrono::steady_clock::now();
96 
97  symex_bmct symex(
100  path.equation,
101  options,
102  *worklist,
104  unwindset);
105  setup_symex(symex);
106 
109 
110  const auto symex_stop = std::chrono::steady_clock::now();
111  symex_runtime += std::chrono::duration<double>(symex_stop - symex_start);
112 
114 
115  equation_output(symex, path.equation);
116 
117  return is_ready_to_decide(symex, path);
118 }
119 
121  const symex_bmct &,
122  const path_storaget::patht &)
123 {
124  // we don't check anything here
125  return false;
126 }
127 
129  const symex_bmct &symex,
130  const symex_target_equationt &equation)
131 {
133  options.get_option("symex-coverage-report"),
134  goto_model,
135  symex,
137 
138  if(options.get_bool_option("show-vcc"))
139  show_vcc(options, ui_message_handler, equation);
140 
141  if(options.get_bool_option("program-only"))
142  show_program(ns, equation);
143 
144  if(options.get_bool_option("show-byte-ops"))
146 
147  if(options.get_bool_option("validate-ssa-equation"))
148  {
150  }
151 }
152 
154 {
156 }
157 
159  propertiest &properties,
160  std::unordered_set<irep_idt> &updated_properties,
161  const symex_target_equationt &equation)
162 {
163  if(options.get_bool_option("symex-driven-lazy-loading"))
165 
167  properties, updated_properties, equation);
168 }
169 
171  propertiest &properties,
172  std::unordered_set<irep_idt> &updated_properties)
173 {
174  // For now, we assume that NOT_REACHED properties are PASS.
175  update_status_of_not_checked_properties(properties, updated_properties);
176 
177  // For now, we assume that UNKNOWN properties are PASS.
178  update_status_of_unknown_properties(properties, updated_properties);
179 }
void output_coverage_report(const std::string &cov_out, const abstract_goto_modelt &goto_model, const symex_bmct &symex, ui_message_handlert &ui_message_handler)
Output a coverage report as generated by symex_coveraget if cov_out is non-empty.
Definition: bmc_util.cpp:306
void update_status_of_unknown_properties(propertiest &properties, std::unordered_set< irep_idt > &updated_properties)
Sets the property status of UNKNOWN properties to PASS.
Definition: bmc_util.cpp:290
void update_properties_status_from_symex_target_equation(propertiest &properties, std::unordered_set< irep_idt > &updated_properties, const symex_target_equationt &equation)
Sets property status to PASS for properties whose conditions are constant true in the equation.
Definition: bmc_util.cpp:238
void update_status_of_not_checked_properties(propertiest &properties, std::unordered_set< irep_idt > &updated_properties)
Sets the property status of NOT_CHECKED properties to PASS.
Definition: bmc_util.cpp:274
void postprocess_equation(symex_bmct &symex, symex_target_equationt &equation, const optionst &options, const namespacet &ns, ui_message_handlert &ui_message_handler)
Post process the equation.
Definition: bmc_util.cpp:322
Bounded Model Checking Utilities.
Abstract interface to eager or lazy GOTO models.
virtual const symbol_tablet & get_symbol_table() const =0
Accessor to get the symbol table.
static get_goto_functiont get_goto_function(abstract_goto_modelt &goto_model)
Return a function to get/load a goto function from the given goto model Create a default delegate to ...
Definition: symex_main.cpp:494
virtual symbol_tablet resume_symex_from_saved_state(const get_goto_functiont &get_goto_function, const statet &saved_state, symex_target_equationt *saved_equation)
Performs symbolic execution using a state and equation that have already been used to symbolically ex...
Definition: symex_main.cpp:381
void validate(const validation_modet vm) const
Definition: goto_symex.h:866
virtual void initialize_path_storage_from_entry_point_of(const get_goto_functiont &get_goto_function, symbol_table_baset &new_symbol_table, const shadow_memory_field_definitionst &fields)
Puts the initial state of the entry point function into the path storage.
Definition: symex_main.cpp:477
An implementation of incremental_goto_checkert provides functionality for checking a set of propertie...
ui_message_handlert & ui_message_handler
mstreamt & status() const
Definition: message.h:414
static eomt eom
Definition: message.h:297
bool get_bool_option(const std::string &option) const
Definition: options.cpp:44
const std::string get_option(const std::string &option) const
Definition: options.cpp:67
static shadow_memory_field_definitionst gather_field_declarations(const abstract_goto_modelt &goto_model, message_handlert &message_handler)
Gathers the available shadow memory field definitions (__CPROVER_field_decl calls) from the goto mode...
virtual bool is_ready_to_decide(const symex_bmct &symex, const path_storaget::patht &path)
Returns whether the given path produced by symex is ready to be checked.
virtual void final_update_properties(propertiest &properties, std::unordered_set< irep_idt > &updated_properties)
Updates the properties after having finished exploration and adds their property IDs to updated_prope...
virtual void initialize_worklist()
Adds the initial goto-symex state as a path to the worklist.
std::chrono::duration< double > symex_runtime
std::unique_ptr< path_storaget > worklist
virtual void update_properties(propertiest &properties, std::unordered_set< irep_idt > &updated_properties, const symex_target_equationt &equation)
Updates the properties from the equation and adds their property IDs to updated_properties.
single_path_symex_only_checkert(const optionst &options, ui_message_handlert &ui_message_handler, abstract_goto_modelt &goto_model)
virtual bool resume_path(path_storaget::patht &path)
Continues exploring the given path using goto-symex.
virtual bool has_finished_exploration(const propertiest &)
Returns whether we should stop exploring paths.
virtual void setup_symex(symex_bmct &symex)
void equation_output(const symex_bmct &symex, const symex_target_equationt &equation)
resultt operator()(propertiest &) override
Check whether the given properties with status NOT_CHECKED, UNKNOWN or properties newly discovered by...
Inheriting the interface of symex_targett this class represents the SSA form of the input program as ...
std::unique_ptr< path_storaget > get_path_strategy(const std::string strategy)
Ensure that is_valid_strategy() returns true for a particular string before calling this function on ...
Storage of symbolic execution paths to resume.
bool has_properties_to_check(const propertiest &properties)
Return true if there as a property with NOT_CHECKED or UNKNOWN status.
Definition: properties.cpp:181
void update_properties_from_goto_model(propertiest &properties, const abstract_goto_modelt &goto_model)
Updates properties with the assertions in goto_model.
Definition: properties.cpp:77
std::map< irep_idt, property_infot > propertiest
A map of property IDs to property infos.
Definition: properties.h:76
Symex Shadow Memory Instrumentation.
void show_program(const namespacet &ns, const symex_target_equationt &equation)
Print the steps of equation on the standard output.
void show_byte_ops(const optionst &options, ui_message_handlert &ui_message_handler, const namespacet &ns, const symex_target_equationt &equation)
Count and display all byte extract and byte update operations from equation on standard output or fil...
Output of the program (SSA) constraints.
void show_vcc(const optionst &options, ui_message_handlert &ui_message_handler, const symex_target_equationt &equation)
Output equations from equation to a file or to the standard output.
Definition: show_vcc.cpp:168
Output of the verification conditions (VCCs)
Goto Checker using Single Path Symbolic Execution only.
std::unordered_set< irep_idt > updated_properties
Changed properties since the last call to incremental_goto_checkert::operator()
Information saved at a conditional goto to resume execution.
Definition: path_storage.h:42
symex_target_equationt equation
Definition: path_storage.h:43
goto_symex_statet state
Definition: path_storage.h:44
Bounded Model Checking for ANSI-C.