cprover
ait< domainT > Class Template Reference

#include <ai.h>

+ Inheritance diagram for ait< domainT >:
+ Collaboration diagram for ait< domainT >:

Public Types

typedef goto_programt::const_targett locationt
 
- Public Types inherited from ai_baset
typedef ai_domain_baset statet
 
typedef goto_programt::const_targett locationt
 

Public Member Functions

 ait ()
 
domainT & operator[] (locationt l)
 
const domainT & operator[] (locationt l) const
 
std::unique_ptr< statetabstract_state_before (locationt t) const override
 Get a copy of the abstract state before the given instruction, without needing to know what kind of domain or history is used. More...
 
void clear () override
 Reset the abstract state. More...
 
- Public Member Functions inherited from ai_baset
 ai_baset ()
 
virtual ~ai_baset ()
 
void operator() (const irep_idt &function_identifier, const goto_programt &goto_program, const namespacet &ns)
 Run abstract interpretation on a single function. More...
 
void operator() (const goto_functionst &goto_functions, const namespacet &ns)
 Run abstract interpretation on a whole program. More...
 
void operator() (const goto_modelt &goto_model)
 Run abstract interpretation on a whole program. More...
 
void operator() (const irep_idt &function_identifier, const goto_functionst::goto_functiont &goto_function, const namespacet &ns)
 Run abstract interpretation on a single function. More...
 
virtual std::unique_ptr< statetabstract_state_after (locationt l) const
 Get a copy of the abstract state after the given instruction, without needing to know what kind of domain or history is used. More...
 
virtual void output (const namespacet &ns, const goto_functionst &goto_functions, std::ostream &out) const
 Output the abstract states for a whole program. More...
 
void output (const goto_modelt &goto_model, std::ostream &out) const
 Output the abstract states for a whole program. More...
 
void output (const namespacet &ns, const goto_programt &goto_program, std::ostream &out) const
 Output the abstract states for a function. More...
 
void output (const namespacet &ns, const goto_functionst::goto_functiont &goto_function, std::ostream &out) const
 Output the abstract states for a function. More...
 
virtual jsont output_json (const namespacet &ns, const goto_functionst &goto_functions) const
 Output the abstract states for the whole program as JSON. More...
 
jsont output_json (const goto_modelt &goto_model) const
 Output the abstract states for a whole program as JSON. More...
 
jsont output_json (const namespacet &ns, const goto_programt &goto_program) const
 Output the abstract states for a single function as JSON. More...
 
jsont output_json (const namespacet &ns, const goto_functionst::goto_functiont &goto_function) const
 Output the abstract states for a single function as JSON. More...
 
virtual xmlt output_xml (const namespacet &ns, const goto_functionst &goto_functions) const
 Output the abstract states for the whole program as XML. More...
 
xmlt output_xml (const goto_modelt &goto_model) const
 Output the abstract states for the whole program as XML. More...
 
xmlt output_xml (const namespacet &ns, const goto_programt &goto_program) const
 Output the abstract states for a single function as XML. More...
 
xmlt output_xml (const namespacet &ns, const goto_functionst::goto_functiont &goto_function) const
 Output the abstract states for a single function as XML. More...
 

Protected Types

typedef std::unordered_map< locationt, domainT, const_target_hash, pointee_address_equaltstate_mapt
 
- Protected Types inherited from ai_baset
typedef std::map< unsigned, locationtworking_sett
 The work queue, sorted by location number. More...
 

Protected Member Functions

virtual statetget_state (locationt l) override
 Get the state for the given location, creating it in a default way if it doesn't exist. More...
 
const statetfind_state (locationt l) const override
 Get the state for the given location if it already exists; throw an exception if it doesn't. More...
 
bool merge (const statet &src, locationt from, locationt to) override
 
std::unique_ptr< statetmake_temporary_state (const statet &s) override
 Make a copy of a state. More...
 
void fixedpoint (const goto_functionst &goto_functions, const namespacet &ns) override
 
- Protected Member Functions inherited from ai_baset
virtual void initialize (const goto_programt &goto_program)
 Initialize all the abstract states for a single function. More...
 
virtual void initialize (const goto_functionst::goto_functiont &goto_function)
 Initialize all the abstract states for a single function. More...
 
virtual void initialize (const goto_functionst &goto_functions)
 Initialize all the abstract states for a whole program. More...
 
virtual void finalize ()
 Override this to add a cleanup or post-processing step after fixedpoint has run. More...
 
void entry_state (const goto_programt &goto_program)
 Set the abstract state of the entry location of a single function to the entry state required by the analysis. More...
 
void entry_state (const goto_functionst &goto_functions)
 Set the abstract state of the entry location of a whole program to the entry state required by the analysis. More...
 
virtual void output (const namespacet &ns, const goto_programt &goto_program, const irep_idt &identifier, std::ostream &out) const
 Output the abstract states for a single function. More...
 
virtual jsont output_json (const namespacet &ns, const goto_programt &goto_program, const irep_idt &identifier) const
 Output the abstract states for a single function as JSON. More...
 
virtual xmlt output_xml (const namespacet &ns, const goto_programt &goto_program, const irep_idt &identifier) const
 Output the abstract states for a single function as XML. More...
 
locationt get_next (working_sett &working_set)
 Get the next location from the work queue. More...
 
void put_in_working_set (working_sett &working_set, locationt l)
 
bool fixedpoint (const irep_idt &function_identifier, const goto_programt &goto_program, const goto_functionst &goto_functions, const namespacet &ns)
 Run the fixedpoint algorithm until it reaches a fixed point. More...
 
void sequential_fixedpoint (const goto_functionst &goto_functions, const namespacet &ns)
 
void concurrent_fixedpoint (const goto_functionst &goto_functions, const namespacet &ns)
 
bool visit (const irep_idt &function_identifier, locationt l, working_sett &working_set, const goto_programt &goto_program, const goto_functionst &goto_functions, const namespacet &ns)
 Perform one step of abstract interpretation from location l Depending on the instruction type it may compute a number of "edges" or applications of the abstract transformer. More...
 
bool do_function_call_rec (const irep_idt &calling_function_identifier, locationt l_call, locationt l_return, const exprt &function, const exprt::operandst &arguments, const goto_functionst &goto_functions, const namespacet &ns)
 
bool do_function_call (const irep_idt &calling_function_identifier, locationt l_call, locationt l_return, const goto_functionst &goto_functions, const goto_functionst::function_mapt::const_iterator f_it, const exprt::operandst &arguments, const namespacet &ns)
 

Protected Attributes

state_mapt state_map
 

Private Member Functions

void dummy (const domainT &s)
 This function exists to enforce that domainT is derived from ai_domain_baset. More...
 
bool merge_shared (const statet &, locationt, locationt, const namespacet &) override
 This function should not be implemented in sequential analyses. More...
 

Detailed Description

template<typename domainT>
class ait< domainT >

Definition at line 365 of file ai.h.

Member Typedef Documentation

◆ locationt

template<typename domainT>
typedef goto_programt::const_targett ait< domainT >::locationt

Definition at line 373 of file ai.h.

◆ state_mapt

template<typename domainT>
typedef std:: unordered_map<locationt, domainT, const_target_hash, pointee_address_equalt> ait< domainT >::state_mapt
protected

Definition at line 415 of file ai.h.

Constructor & Destructor Documentation

◆ ait()

template<typename domainT>
ait< domainT >::ait ( )
inline

Definition at line 369 of file ai.h.

Member Function Documentation

◆ abstract_state_before()

template<typename domainT>
std::unique_ptr<statet> ait< domainT >::abstract_state_before ( locationt  l) const
inlineoverridevirtual

Get a copy of the abstract state before the given instruction, without needing to know what kind of domain or history is used.

Note: intended for users of the abstract interpreter; derived classes should use get_state or find_state to access the actual underlying state. PRECONDITION(l is dereferenceable)

Parameters
lThe location before which we want the abstract state
Returns
The abstract state before l. We return a pointer to a copy as the method should be const and there are some non-trivial cases including merging abstract states, etc.

Implements ai_baset.

Definition at line 393 of file ai.h.

◆ clear()

template<typename domainT>
void ait< domainT >::clear ( )
inlineoverridevirtual

Reset the abstract state.

Reimplemented from ai_baset.

Definition at line 406 of file ai.h.

◆ dummy()

template<typename domainT>
void ait< domainT >::dummy ( const domainT &  s)
inlineprivate

This function exists to enforce that domainT is derived from ai_domain_baset.

Definition at line 456 of file ai.h.

◆ find_state()

template<typename domainT>
const statet& ait< domainT >::find_state ( locationt  l) const
inlineoverrideprotectedvirtual

Get the state for the given location if it already exists; throw an exception if it doesn't.

Implements ai_baset.

Definition at line 425 of file ai.h.

◆ fixedpoint()

template<typename domainT>
void ait< domainT >::fixedpoint ( const goto_functionst goto_functions,
const namespacet ns 
)
inlineoverrideprotectedvirtual

Implements ai_baset.

Reimplemented in concurrency_aware_ait< domainT >, and concurrency_aware_ait< rd_range_domaint >.

Definition at line 446 of file ai.h.

◆ get_state()

template<typename domainT>
virtual statet& ait< domainT >::get_state ( locationt  l)
inlineoverrideprotectedvirtual

Get the state for the given location, creating it in a default way if it doesn't exist.

Implements ai_baset.

Reimplemented in reaching_definitions_analysist, and dependence_grapht.

Definition at line 419 of file ai.h.

◆ make_temporary_state()

template<typename domainT>
std::unique_ptr<statet> ait< domainT >::make_temporary_state ( const statet s)
inlineoverrideprotectedvirtual

Make a copy of a state.

Implements ai_baset.

Definition at line 441 of file ai.h.

◆ merge()

template<typename domainT>
bool ait< domainT >::merge ( const statet src,
locationt  from,
locationt  to 
)
inlineoverrideprotectedvirtual

Implements ai_baset.

Definition at line 434 of file ai.h.

◆ merge_shared()

template<typename domainT>
bool ait< domainT >::merge_shared ( const statet ,
locationt  ,
locationt  ,
const namespacet  
)
inlineoverrideprivatevirtual

This function should not be implemented in sequential analyses.

Implements ai_baset.

Reimplemented in concurrency_aware_ait< domainT >, and concurrency_aware_ait< rd_range_domaint >.

Definition at line 459 of file ai.h.

◆ operator[]() [1/2]

template<typename domainT>
domainT& ait< domainT >::operator[] ( locationt  l)
inline

Definition at line 375 of file ai.h.

◆ operator[]() [2/2]

template<typename domainT>
const domainT& ait< domainT >::operator[] ( locationt  l) const
inline

Definition at line 384 of file ai.h.

Member Data Documentation

◆ state_map

template<typename domainT>
state_mapt ait< domainT >::state_map
protected

Definition at line 416 of file ai.h.


The documentation for this class was generated from the following file: