cprover
Loading...
Searching...
No Matches
bmc_util.h
Go to the documentation of this file.
1/*******************************************************************\
2
3Module: Bounded Model Checking Utilities
4
5Author: Daniel Kroening, Peter Schrammel
6
7\*******************************************************************/
8
11
12#ifndef CPROVER_GOTO_CHECKER_BMC_UTIL_H
13#define CPROVER_GOTO_CHECKER_BMC_UTIL_H
14
16
18
20#include "properties.h"
21
22#include <chrono> // IWYU pragma: keep
23#include <memory>
24
27class goto_tracet;
30class namespacet;
31class optionst;
32class symex_bmct;
34struct trace_optionst;
36
38 symex_target_equationt &equation,
39 decision_proceduret &decision_procedure,
41
46
49
52 const namespacet &,
54 const decision_proceduret &,
56
58 const goto_tracet &,
59 const namespacet &,
60 const trace_optionst &,
62
63void output_graphml(const goto_tracet &, const namespacet &, const optionst &);
66 const namespacet &,
67 const optionst &);
68
69std::unique_ptr<memory_model_baset>
70get_memory_model(const optionst &options, const namespacet &);
71
72void setup_symex(
73 symex_bmct &,
74 const namespacet &,
75 const optionst &,
77
78void slice(
79 symex_bmct &,
80 symex_target_equationt &symex_target_equation,
81 const namespacet &,
82 const optionst &,
84
90 symex_bmct &symex,
91 symex_target_equationt &equation,
92 const optionst &options,
93 const namespacet &ns,
94 ui_message_handlert &ui_message_handler);
95
104 const std::string &cov_out,
105 const abstract_goto_modelt &goto_model,
106 const symex_bmct &symex,
107 ui_message_handlert &ui_message_handler);
108
116 propertiest &properties,
117 std::unordered_set<irep_idt> &updated_properties,
118 const symex_target_equationt &equation);
119
127 propertiest &properties,
128 std::unordered_set<irep_idt> &updated_properties);
129
137 propertiest &properties,
138 std::unordered_set<irep_idt> &updated_properties);
139
149std::chrono::duration<double> prepare_property_decider(
150 propertiest &properties,
151 symex_target_equationt &equation,
152 goto_symex_property_decidert &property_decider,
153 ui_message_handlert &ui_message_handler);
154
167 propertiest &properties,
168 goto_symex_property_decidert &property_decider,
169 ui_message_handlert &ui_message_handler,
170 std::chrono::duration<double> solver_runtime,
171 bool set_pass = true);
172
173#define OPT_BMC \
174 "(program-only)" \
175 "(show-byte-ops)" \
176 "(show-vcc)" \
177 "(show-goto-symex-steps)" \
178 "(show-points-to-sets)" \
179 "(slice-formula)" \
180 "(unwinding-assertions)" \
181 "(no-unwinding-assertions)" \
182 "(no-self-loops-to-assumptions)" \
183 "(partial-loops)" \
184 "(paths):" \
185 "(show-symex-strategies)" \
186 "(depth):" \
187 "(max-field-sensitivity-array-size):" \
188 "(no-array-field-sensitivity)" \
189 "(graphml-witness):" \
190 "(symex-complexity-limit):" \
191 "(symex-complexity-failed-child-loops-limit):" \
192 "(incremental-loop):" \
193 "(unwind-min):" \
194 "(unwind-max):" \
195 "(ignore-properties-before-unwind-min)" \
196 "(symex-cache-dereferences)" OPT_UNWINDSET
197
198#define HELP_BMC \
199 " {y--paths} [strategy] \t explore paths one at a time\n" \
200 " {y--show-symex-strategies} \t list strategies for use with {y--paths}\n" \
201 " {y--show-goto-symex-steps} \t show which steps symex travels, includes " \
202 "diagnostic information\n" \
203 " {y--show-points-to-sets} \t show points-to sets for pointer dereference. " \
204 "Requires {y--json-ui}.\n" \
205 " {y--program-only} \t only show program expression\n" \
206 " {y--show-byte-ops} \t show all byte extracts and updates\n" \
207 " {y--depth} {unr} \t limit search depth\n" \
208 " {y--max-field-sensitivity-array-size} {uM} \t " \
209 "maximum size {uM} of arrays for which field sensitivity will be " \
210 "applied to array, the default is 64\n" \
211 " {y--no-array-field-sensitivity} \t " \
212 "deactivate field sensitivity for arrays, this is equivalent to setting " \
213 "the maximum field sensitivity size for arrays to 0\n" HELP_UNWINDSET \
214 " {y--incremental-loop} {uL} \t " \
215 "check properties after each unwinding of loop {uL} (use {y--show-loops} " \
216 "to get the loop IDs)\n" \
217 " {y--unwind-min} {unr} \t " \
218 "start incremental-loop after {unr} unwindings but before solving that " \
219 "iteration. If for example it is 1, then the loop will be unwound once, " \
220 "and immediately checked. Note: this means for {y--unwind-min} 1 or 0 all " \
221 "properties are checked.\n" \
222 " {y--unwind-max} {unr} \t stop incremental-loop after {unr} unwindings\n" \
223 " {y--ignore-properties-before-unwind-min} \t " \
224 "do not check properties before unwind-min when using " \
225 "{y--incremental-loop}\n" \
226 " {y--show-vcc} \t show the verification conditions\n" \
227 " {y--slice-formula} \t remove assignments unrelated to property\n" \
228 " {y--unwinding-assertions} \t generate unwinding assertions (cannot be " \
229 "used with {y--cover})\n" \
230 " {y--partial-loops} \t permit paths with partial loops\n" \
231 " {y--no-self-loops-to-assumptions} \t do not simplify while(1){ {}} to " \
232 "assume(0)\n" \
233 " {y--symex-complexity-limit} {uN} \t " \
234 "how complex ({uN}) a path can become before symex abandons it. Currently " \
235 "uses guard size to calculate complexity.\n" \
236 " {y--symex-complexity-failed-child-loops-limit} {uN} \t " \
237 "how many child branches ({uN}) in an iteration are allowed to fail due to " \
238 "complexity violations before the loop gets blacklisted\n" \
239 " {y--graphml-witness} {ufilename} \t write the witness in GraphML format " \
240 "to {ufilename}\n" \
241 " {y--symex-cache-dereferences} \t enable caching of repeated " \
242 "dereferences\n"
243
244#endif // CPROVER_GOTO_CHECKER_BMC_UTIL_H
void run_property_decider(incremental_goto_checkert::resultt &result, propertiest &properties, goto_symex_property_decidert &property_decider, ui_message_handlert &ui_message_handler, std::chrono::duration< double > solver_runtime, bool set_pass=true)
Runs the property decider to solve the equation.
Definition bmc_util.cpp:382
void slice(symex_bmct &, symex_target_equationt &symex_target_equation, const namespacet &, const optionst &, ui_message_handlert &)
Definition bmc_util.cpp:198
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 setup_symex(symex_bmct &, const namespacet &, const optionst &, ui_message_handlert &)
Definition bmc_util.cpp:178
std::chrono::duration< double > prepare_property_decider(propertiest &properties, symex_target_equationt &equation, goto_symex_property_decidert &property_decider, ui_message_handlert &ui_message_handler)
Converts the equation and sets up the property decider, but does not call solve.
Definition bmc_util.cpp:358
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 output_graphml(const goto_tracet &, const namespacet &, const optionst &)
outputs an error witness in graphml format
Definition bmc_util.cpp:107
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 output_error_trace(const goto_tracet &, const namespacet &, const trace_optionst &, ui_message_handlert &)
Definition bmc_util.cpp:64
void message_building_error_trace(messaget &)
Outputs a message that an error trace is being built.
Definition bmc_util.cpp:35
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
ssa_step_predicatet ssa_step_matches_failing_property(const irep_idt &property_id)
Returns a function that checks whether an SSA step is an assertion with property_id.
Definition bmc_util.cpp:54
std::unique_ptr< memory_model_baset > get_memory_model(const optionst &options, const namespacet &)
Definition bmc_util.cpp:162
void convert_symex_target_equation(symex_target_equationt &equation, decision_proceduret &decision_procedure, message_handlert &message_handler)
Definition bmc_util.cpp:150
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
void build_error_trace(goto_tracet &, const namespacet &, const symex_target_equationt &, const decision_proceduret &, ui_message_handlert &)
Definition bmc_util.cpp:40
Traces of GOTO Programs.
std::function< bool(symex_target_equationt::SSA_stepst::const_iterator, const decision_proceduret &)> ssa_step_predicatet
Abstract interface to eager or lazy GOTO models.
An interface for a decision procedure for satisfiability problems.
Provides management of goal variables that encode properties.
Trace of a GOTO program.
Definition goto_trace.h:177
Class that provides messages with a built-in verbosity 'level'.
Definition message.h:154
A namespacet is essentially one or two symbol tables bound together, to allow for symbol lookups in t...
Definition namespace.h:91
Inheriting the interface of symex_targett this class represents the SSA form of the input program as ...
message_handlert * message_handler
Definition ui_message.h:49
Incremental Goto Checker Interface.
Properties.
std::map< irep_idt, property_infot > propertiest
A map of property IDs to property infos.
Definition properties.h:76
Options for printing the trace using show_goto_trace.
Definition goto_trace.h:221
Loop unwinding.
dstringt irep_idt