cprover
shared_buffers.h
Go to the documentation of this file.
1 /*******************************************************************\
2 
3 Module:
4 
5 Author: Daniel Kroening, kroening@kroening.com
6 
7 \*******************************************************************/
8 
9 
10 #ifndef CPROVER_GOTO_INSTRUMENT_WMM_SHARED_BUFFERS_H
11 #define CPROVER_GOTO_INSTRUMENT_WMM_SHARED_BUFFERS_H
12 
13 #include <map>
14 #include <set>
15 
17 #include <util/cprover_prefix.h>
18 #include <util/namespace.h>
19 #include <util/prefix.h>
20 #include <util/symbol_table.h>
21 
22 #include "wmm.h"
23 
24 class goto_functionst;
25 class messaget;
26 class value_setst;
27 
29 {
30 public:
31  shared_bufferst(symbol_tablet &_symbol_table, unsigned _nb_threads,
32  messaget &_message):
33  symbol_table(_symbol_table),
34  nb_threads(_nb_threads+1),
35  uniq(0),
36  cav11(false),
37  message(_message)
38  {
39  }
40 
42  {
43  if(model!=TSO)
44  throw "sorry, CAV11 only available for TSO";
45  cav11 = true;
46  }
47 
48  /* instrumentation of a variable */
49  class varst
50  {
51  public:
52  // Older stuff has the higher index.
53  // Shared buffer.
55 
56  // Are those places empty?
58 
59  // Delays write buffer flush: just to make some swaps between mem and buff
60  // -- this is to model lhs := rhs with rhs reading in the buffer without
61  // affecting the memory (Note: we model lhs := rhs by rhs := ..., then
62  // lhs := rhs)
65 
66  // Thread: Was it me who wrote at this place?
67  std::vector<irep_idt> r_buff0_thds, r_buff1_thds;
68 
69  // for delayed read:
72 
74  };
75 
76  typedef std::map<irep_idt, varst> var_mapt;
78 
79  /* instructions in violation cycles (to instrument): */
80  // variables in the cycles
81  std::set<irep_idt> cycles;
82  // events instrumented: var->locations in the code
83  std::multimap<irep_idt, source_locationt> cycles_loc;
84  // events in cycles: var->locations (for read instrumentations)
85  std::multimap<irep_idt, source_locationt> cycles_r_loc;
86 
87  const varst &operator()(const irep_idt &object);
88 
89  void add_initialization_code(goto_functionst &goto_functions);
90 
91  void delay_read(
92  goto_programt &goto_program,
94  const source_locationt &source_location,
95  const irep_idt &read_object,
96  const irep_idt &write_object);
97 
98  void flush_read(
99  goto_programt &goto_program,
101  const source_locationt &source_location,
102  const irep_idt &write_object);
103 
104  void write(
105  goto_programt &goto_program,
107  const source_locationt &source_location,
108  const irep_idt &object,
109  goto_programt::instructiont &original_instruction,
110  const unsigned current_thread);
111 
112  void det_flush(
113  goto_programt &goto_program,
115  const source_locationt &source_location,
116  const irep_idt &object,
117  const unsigned current_thread);
118 
119  void nondet_flush(
120  const irep_idt &function_id,
121  goto_programt &goto_program,
123  const source_locationt &source_location,
124  const irep_idt &object,
125  const unsigned current_thread,
126  const bool tso_pso_rmo);
127 
128  void assignment(
129  goto_programt &goto_program,
131  const source_locationt &source_location,
132  const irep_idt &id_lhs,
133  const exprt &rhs);
134 
136  goto_programt &goto_program,
138  const source_locationt &source_location,
139  const irep_idt &id_lhs,
140  const irep_idt &id_rhs)
141  {
143  assignment(goto_program, t, source_location, id_lhs,
144  ns.lookup(id_rhs).symbol_expr());
145  }
146 
147  bool track(const irep_idt &id) const
148  {
150 
151  const symbolt &symbol=ns.lookup(id);
152  if(symbol.is_thread_local)
153  return false;
155  return false;
156 
157  return true;
158  }
159 
160  irep_idt choice(const irep_idt &function_id, const std::string &suffix)
161  {
162  const auto maybe_symbol = symbol_table.lookup(function_id);
163  CHECK_RETURN(maybe_symbol);
164  return add(*maybe_symbol, "_weak_choice" + suffix, bool_typet());
165  }
166 
167  bool is_buffered(
168  const namespacet&,
169  const symbol_exprt&,
170  bool is_write);
171 
173  const symbol_exprt&,
174  bool is_write);
175 
177  value_setst &value_sets,
179  goto_programt &goto_program,
180  memory_modelt model,
181  goto_functionst &goto_functions);
182 
183  void affected_by_delay(
184  value_setst &value_sets,
185  goto_functionst &goto_functions);
186 
188  {
189  protected:
193 
194  /* for thread marking (dynamic) */
195  unsigned current_thread;
196  unsigned coming_from;
197  unsigned max_thread;
198 
199  /* data propagated through the CFG */
200  std::set<irep_idt> past_writes;
201 
202  public:
203  cfg_visitort(shared_bufferst &_shared, symbol_tablet &_symbol_table,
204  goto_functionst &_goto_functions)
205  :shared_buffers(_shared), symbol_table(_symbol_table),
206  goto_functions(_goto_functions)
207  {
208  current_thread = 0;
209  coming_from = 0;
210  max_thread = 0;
211  }
212 
213  void weak_memory(
214  value_setst &value_sets,
215  const irep_idt &function_id,
216  memory_modelt model);
217  };
218 
219 protected:
221 
222  // number of threads interfering
223  unsigned nb_threads;
224 
225  // instrumentations (not to be instrumented again)
226  std::set<irep_idt> instrumentations;
227 
228  // variables (non necessarily shared) affected by reads delay
229 public:
230  std::set<irep_idt> affected_by_delay_set;
231 
232 protected:
233  // for fresh variables
234  unsigned uniq;
235 
236  std::string unique();
237 
238  bool cav11;
239 
240  /* message */
242 
243  irep_idt add(
244  const symbolt &object,
245  const std::string &suffix,
246  const typet &type,
247  bool added_as_instrumentation);
248 
249  irep_idt
250  add(const symbolt &object, const std::string &suffix, const typet &type)
251  {
252  return add(object, suffix, type, true);
253  }
254 
255  /* inserting a non-instrumenting, fresh variable */
257  const symbolt &object,
258  const std::string &suffix,
259  const typet &type)
260  {
261  return add(object, suffix, type, false);
262  }
263 
264  void add_initialization(goto_programt &goto_program);
265 };
266 
267 #endif // CPROVER_GOTO_INSTRUMENT_WMM_SHARED_BUFFERS_H
The Boolean type.
Definition: std_types.h:36
dstringt has one field, an unsigned integer no which is an index into a static table of strings.
Definition: dstring.h:37
Base class for all expressions.
Definition: expr.h:54
A collection of goto functions.
This class represents an instruction in the GOTO intermediate representation.
Definition: goto_program.h:180
A generic container class for the GOTO intermediate representation of one function.
Definition: goto_program.h:73
instructionst::iterator targett
Definition: goto_program.h:592
Class that provides messages with a built-in verbosity 'level'.
Definition: message.h:155
A namespacet is essentially one or two symbol tables bound together, to allow for symbol lookups in t...
Definition: namespace.h:91
bool lookup(const irep_idt &name, const symbolt *&symbol) const override
See documentation for namespace_baset::lookup().
Definition: namespace.cpp:138
cfg_visitort(shared_bufferst &_shared, symbol_tablet &_symbol_table, goto_functionst &_goto_functions)
shared_bufferst & shared_buffers
void weak_memory(value_setst &value_sets, const irep_idt &function_id, memory_modelt model)
instruments the program for the pairs detected through the CFG
std::set< irep_idt > past_writes
goto_functionst & goto_functions
std::vector< irep_idt > r_buff0_thds
std::vector< irep_idt > r_buff1_thds
std::multimap< irep_idt, source_locationt > cycles_loc
const varst & operator()(const irep_idt &object)
instruments the variable
void set_cav11(memory_modelt model)
void nondet_flush(const irep_idt &function_id, goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &object, const unsigned current_thread, const bool tso_pso_rmo)
instruments read
std::string unique()
returns a unique id (for fresh variables)
void write(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &object, goto_programt::instructiont &original_instruction, const unsigned current_thread)
instruments write
void weak_memory(value_setst &value_sets, symbol_tablet &symbol_table, goto_programt &goto_program, memory_modelt model, goto_functionst &goto_functions)
void affected_by_delay(value_setst &value_sets, goto_functionst &goto_functions)
analysis over the goto-program which computes in affected_by_delay_set the variables (non necessarily...
void det_flush(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &object, const unsigned current_thread)
flush buffers (instruments fence)
irep_idt add_fresh_var(const symbolt &object, const std::string &suffix, const typet &type)
void add_initialization(goto_programt &goto_program)
bool is_buffered_in_general(const symbol_exprt &, bool is_write)
void assignment(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &id_lhs, const exprt &rhs)
add an assignment in the goto-program
irep_idt add(const symbolt &object, const std::string &suffix, const typet &type, bool added_as_instrumentation)
add a new var for instrumenting the input var
std::set< irep_idt > affected_by_delay_set
std::set< irep_idt > cycles
void delay_read(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &read_object, const irep_idt &write_object)
delays a read (POWER)
void flush_read(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &write_object)
flushes read (POWER)
std::multimap< irep_idt, source_locationt > cycles_r_loc
messaget & message
std::map< irep_idt, varst > var_mapt
irep_idt choice(const irep_idt &function_id, const std::string &suffix)
void add_initialization_code(goto_functionst &goto_functions)
bool track(const irep_idt &id) const
shared_bufferst(symbol_tablet &_symbol_table, unsigned _nb_threads, messaget &_message)
irep_idt add(const symbolt &object, const std::string &suffix, const typet &type)
bool is_buffered(const namespacet &, const symbol_exprt &, bool is_write)
std::set< irep_idt > instrumentations
class symbol_tablet & symbol_table
void assignment(goto_programt &goto_program, goto_programt::targett &t, const source_locationt &source_location, const irep_idt &id_lhs, const irep_idt &id_rhs)
Expression to hold a symbol (variable)
Definition: std_expr.h:80
const symbolt * lookup(const irep_idt &name) const
Find a symbol in the symbol table for read-only access.
The symbol table.
Definition: symbol_table.h:14
Symbol table entry.
Definition: symbol.h:28
bool is_thread_local
Definition: symbol.h:65
The type of an expression, extends irept.
Definition: type.h:29
bool has_prefix(const std::string &s, const std::string &prefix)
Definition: converter.cpp:13
#define CPROVER_PREFIX
Concrete Goto Program.
const std::string & id2string(const irep_idt &d)
Definition: irep.h:47
#define CHECK_RETURN(CONDITION)
Definition: invariant.h:495
Author: Diffblue Ltd.
memory models
memory_modelt
Definition: wmm.h:18
@ TSO
Definition: wmm.h:20