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/namespace.h>
18 #include <util/cprover_prefix.h>
19 #include <util/prefix.h>
20 #include <util/message.h>
21 
22 #include "wmm.h"
23 
24 class symbol_tablet;
25 class goto_functionst;
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  const std::string function_base_name =
164  maybe_symbol
165  ? id2string(maybe_symbol->base_name)
166  : "main";
167  return add(function_base_name+"_weak_choice",
168  function_base_name+"_weak_choice", suffix, bool_typet());
169  }
170 
171  bool is_buffered(
172  const namespacet&,
173  const symbol_exprt&,
174  bool is_write);
175 
177  const symbol_exprt&,
178  bool is_write);
179 
181  value_setst &value_sets,
183  goto_programt &goto_program,
184  memory_modelt model,
185  goto_functionst &goto_functions);
186 
187  void affected_by_delay(
188  value_setst &value_sets,
189  goto_functionst &goto_functions);
190 
192  {
193  protected:
197 
198  /* for thread marking (dynamic) */
199  unsigned current_thread;
200  unsigned coming_from;
201  unsigned max_thread;
202 
203  /* data propagated through the CFG */
204  std::set<irep_idt> past_writes;
205 
206  public:
207  cfg_visitort(shared_bufferst &_shared, symbol_tablet &_symbol_table,
208  goto_functionst &_goto_functions)
209  :shared_buffers(_shared), symbol_table(_symbol_table),
210  goto_functions(_goto_functions)
211  {
212  current_thread = 0;
213  coming_from = 0;
214  max_thread = 0;
215  }
216 
217  void weak_memory(
218  value_setst &value_sets,
219  const irep_idt &function_id,
220  memory_modelt model);
221  };
222 
223 protected:
225 
226  // number of threads interfering
227  unsigned nb_threads;
228 
229  // instrumentations (not to be instrumented again)
230  std::set<irep_idt> instrumentations;
231 
232  // variables (non necessarily shared) affected by reads delay
233 public:
234  std::set<irep_idt> affected_by_delay_set;
235 
236 protected:
237  // for fresh variables
238  unsigned uniq;
239 
240  std::string unique();
241 
242  bool cav11;
243 
244  /* message */
246 
247  irep_idt add(
248  const irep_idt &object,
249  const irep_idt &base_name,
250  const std::string &suffix,
251  const typet &type,
252  bool added_as_instrumentation);
253 
255  const irep_idt &object,
256  const irep_idt &base_name,
257  const std::string &suffix,
258  const typet &type)
259  {
260  return add(object, base_name, suffix, type, true);
261  }
262 
263  /* inserting a non-instrumenting, fresh variable */
265  const irep_idt &object,
266  const irep_idt &base_name,
267  const std::string &suffix,
268  const typet &type)
269  {
270  return add(object, base_name, suffix, type, false);
271  }
272 
273  void add_initialization(goto_programt &goto_program);
274 };
275 
276 #endif // CPROVER_GOTO_INSTRUMENT_WMM_SHARED_BUFFERS_H
The Boolean type.
Definition: std_types.h:37
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:74
instructionst::iterator targett
Definition: goto_program.h:550
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:92
bool lookup(const irep_idt &name, const symbolt *&symbol) const override
See documentation for namespace_baset::lookup().
Definition: namespace.cpp:140
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
irep_idt add_fresh_var(const irep_idt &object, const irep_idt &base_name, const std::string &suffix, const typet &type)
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)
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
std::set< irep_idt > affected_by_delay_set
std::set< irep_idt > cycles
irep_idt add(const irep_idt &object, const irep_idt &base_name, const std::string &suffix, const typet &type)
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)
bool is_buffered(const namespacet &, const symbol_exprt &, bool is_write)
irep_idt add(const irep_idt &object, const irep_idt &base_name, const std::string &suffix, const typet &type, bool added_as_instrumentation)
add a new var for instrumenting the input var
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:81
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:20
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:28
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:49
memory models
memory_modelt
Definition: wmm.h:18
@ TSO
Definition: wmm.h:20