PandA-2024.02
dom_post_dom_computation.cpp
Go to the documentation of this file.
1 /*
2  *
3  * _/_/_/ _/_/ _/ _/ _/_/_/ _/_/
4  * _/ _/ _/ _/ _/_/ _/ _/ _/ _/ _/
5  * _/_/_/ _/_/_/_/ _/ _/_/ _/ _/ _/_/_/_/
6  * _/ _/ _/ _/ _/ _/ _/ _/ _/
7  * _/ _/ _/ _/ _/ _/_/_/ _/ _/
8  *
9  * ***********************************************
10  * PandA Project
11  * URL: http://panda.dei.polimi.it
12  * Politecnico di Milano - DEIB
13  * System Architectures Group
14  * ***********************************************
15  * Copyright (C) 2004-2024 Politecnico di Milano
16  *
17  * This file is part of the PandA framework.
18  *
19  * The PandA framework is free software; you can redistribute it and/or modify
20  * it under the terms of the GNU General Public License as published by
21  * the Free Software Foundation; either version 3 of the License, or
22  * (at your option) any later version.
23  *
24  * This program is distributed in the hope that it will be useful,
25  * but WITHOUT ANY WARRANTY; without even the implied warranty of
26  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27  * GNU General Public License for more details.
28  *
29  * You should have received a copy of the GNU General Public License
30  * along with this program. If not, see <http://www.gnu.org/licenses/>.
31  *
32  */
44 
46 #include "Parameter.hpp"
47 
49 #include "Dominance.hpp"
50 
52 #include "application_manager.hpp"
53 #include "basic_block.hpp"
55 #include "function_behavior.hpp"
56 
58 #include "design_flow_graph.hpp"
59 #include "design_flow_manager.hpp"
60 
62 #include "graph.hpp"
63 
65 #include "behavioral_helper.hpp"
66 
68 #include "custom_map.hpp"
69 #include "hash_helper.hpp"
70 #include "string_manipulation.hpp" // for GET_CLASS
71 
73  const application_managerRef _AppM, unsigned int _function_id,
74  const DesignFlowManagerConstRef _design_flow_manager)
75  : FunctionFrontendFlowStep(_AppM, _function_id, DOM_POST_DOM_COMPUTATION, _design_flow_manager, _parameters)
76 {
77  debug_level = parameters->get_class_debug_level(GET_CLASS(*this), DEBUG_LEVEL_NONE);
78 }
79 
81 
84 {
86  switch(relationship_type)
87  {
89  {
90  relationships.insert(std::make_pair(BASIC_BLOCKS_CFG_COMPUTATION, SAME_FUNCTION));
91  break;
92  }
95  {
96  break;
97  }
98  default:
99  {
100  THROW_UNREACHABLE("");
101  }
102  }
103  return relationships;
104 }
105 
107 {
108  function_behavior->dominators = nullptr;
109  function_behavior->post_dominators = nullptr;
110 }
111 
113 {
114  const BBGraphConstRef fbb = function_behavior->CGetBBGraph(FunctionBehavior::FBB);
115 
116  const BehavioralHelperConstRef helper = function_behavior->CGetBehavioralHelper();
118  THROW_ASSERT(!function_behavior->dominators, "Dominators already built");
119  const vertex bbentry = fbb->CGetBBGraphInfo()->entry_vertex;
120  const vertex bbexit = fbb->CGetBBGraphInfo()->exit_vertex;
121  function_behavior->dominators = new dominance<BBGraph>(*fbb, bbentry, bbexit, parameters);
122  function_behavior->dominators->calculate_dominance_info(dominance<BBGraph>::CDI_DOMINATORS);
123  const auto& dominator_map = function_behavior->dominators->get_dominator_map();
124  for(auto& it : dominator_map)
125  {
126  if(it.first != bbentry)
127  {
128  function_behavior->bbgc->AddEdge(it.second, it.first, D_SELECTOR);
129  }
130  }
131  PRINT_DBG_MEX(DEBUG_LEVEL_VERY_PEDANTIC, debug_level, "Built dominators tree of " + helper->get_function_name());
132  if(parameters->getOption<bool>(OPT_print_dot))
133  {
134  function_behavior->GetBBGraph(FunctionBehavior::DOM_TREE)->WriteDot("BB_dom_tree.dot");
135  }
137  THROW_ASSERT(!function_behavior->post_dominators, "Post dominators yet built");
138  function_behavior->post_dominators = new dominance<BBGraph>(*fbb, bbentry, bbexit, parameters);
139  function_behavior->post_dominators->calculate_dominance_info(dominance<BBGraph>::CDI_POST_DOMINATORS);
140  const auto& post_dominator_map = function_behavior->post_dominators->get_dominator_map();
141  for(auto& it : post_dominator_map)
142  {
143  if(it.first != bbexit)
144  {
145  function_behavior->bbgc->AddEdge(it.second, it.first, PD_SELECTOR);
146  }
147  }
149  "Built post-dominators tree of " + helper->get_function_name());
150 
151  if(parameters->getOption<bool>(OPT_print_dot))
152  {
153  function_behavior->GetBBGraph(FunctionBehavior::POST_DOM_TREE)->WriteDot("BB_post_dom_tree.dot");
154  }
156 }
#define DEBUG_LEVEL_VERY_PEDANTIC
extremely verbose debugging print is performed.
#define PRINT_DBG_MEX(dbgLevel, curDbgLevel, mex)
We are producing a debug version of the program, so the message is printed;.
#define GET_CLASS(obj)
Macro returning the actual type of an object.
std::string get_function_name() const
Return the name of the function.
Definition of the class representing a generic C application.
RelationshipType
The relationship type.
Source must be executed to satisfy target.
const BBGraphInfoConstRef CGetBBGraphInfo() const
Returns the property associated with the graph.
Class specification of the graph structures.
#define D_SELECTOR
Selectors used only in basic block graphs; numbers continue from cdfg_edge_info.hpp.
Definition: basic_block.hpp:85
const CustomUnorderedSet< std::pair< FrontendFlowStepType, FunctionRelationship > > ComputeFrontendRelationships(const DesignFlowStep::RelationshipType relationship_type) const override
Return the set of analyses in relationship with this design step.
Basic block post-dominator tree.
This class provides methods to build a basic blocks graph.
Analysis step performing dominators and post dominators computation.
redefinition of map to manage ordered/unordered structures
Auxiliary methods for manipulating string.
dom_post_dom_computation(const ParameterConstRef _parameters, const application_managerRef AppM, unsigned int function_id, const DesignFlowManagerConstRef design_flow_manager)
Constructor.
#define THROW_UNREACHABLE(str_expr)
helper function used to specify that some points should never be reached
Definition: exceptions.hpp:292
Basic block dominator tree.
~dom_post_dom_computation() override
Destructor.
Classes to describe design flow graph.
Basic block control flow graph with feedback.
boost::graph_traits< graph >::vertex_descriptor vertex
vertex definition.
Definition: graph.hpp:1303
void Initialize() override
Initialize the step (i.e., like a constructor, but executed just before exec.
const ParameterConstRef parameters
Set of input parameters.
DesignFlowStep_Status
The status of a step.
#define DEBUG_LEVEL_NONE
no debugging print is performed.
Wrapper of design_flow.
DesignFlowStep_Status InternalExec() override
Performs the dominators post-dominators computation step.
Class specification of the basic_block structure.
This file collects some hash functors.
#define PD_SELECTOR
post-dominator graph edge selector
Definition: basic_block.hpp:88
Template borrowed from the ANTLR library by Terence Parr (http://www.jGuru.com - Software rights: htt...
Definition: refcount.hpp:94
this class is used to manage the command-line or XML options.
int debug_level
The debug level.
A brief description of the C++ Header File.
const FunctionBehaviorRef function_behavior
The function behavior of the function to be analyzed.
#define THROW_ASSERT(cond, str_expr)
helper function used to check an assert and if needed to throw an error in a standard way ...
Definition: exceptions.hpp:289

Generated on Mon Feb 12 2024 13:02:51 for PandA-2024.02 by doxygen 1.8.13