GCC Middle and Back End API Reference
graphds.cc File Reference
#include "config.h"
#include "system.h"
#include "coretypes.h"
#include "bitmap.h"
#include "graphds.h"
Include dependency graph for graphds.cc:

Functions

void dump_graph (FILE *f, struct graph *g)
 
struct graphnew_graph (int n_vertices)
 
struct graph_edgeadd_edge (struct graph *g, int f, int t)
 
void identify_vertices (struct graph *g, int v, int u)
 
static int dfs_edge_src (struct graph_edge *e, bool forward)
 
static int dfs_edge_dest (struct graph_edge *e, bool forward)
 
static struct graph_edgefoll_in_subgraph (struct graph_edge *e, bool forward, bitmap subgraph, skip_edge_callback skip_edge_p)
 
static struct graph_edgedfs_fst_edge (struct graph *g, int v, bool forward, bitmap subgraph, skip_edge_callback skip_edge_p)
 
static struct graph_edgedfs_next_edge (struct graph_edge *e, bool forward, bitmap subgraph, skip_edge_callback skip_edge_p)
 
int graphds_dfs (struct graph *g, int *qs, int nq, vec< int > *qt, bool forward, bitmap subgraph, skip_edge_callback skip_edge_p)
 
int graphds_scc (struct graph *g, bitmap subgraph, skip_edge_callback skip_edge_p, vec< int > *scc_grouping)
 
void for_each_edge (struct graph *g, graphds_edge_callback callback, void *data)
 
void free_graph (struct graph *g)
 
static int tree_nca (int x, int y, int *parent, int *marks, int mark)
 
void graphds_domtree (struct graph *g, int entry, int *parent, int *son, int *brother)
 

Function Documentation

◆ add_edge()

◆ dfs_edge_dest()

static int dfs_edge_dest ( struct graph_edge * e,
bool forward )
inlinestatic
Helper function for graphds_dfs. Returns the destination vertex of E, in the direction given by FORWARD.

References graph_edge::dest, and graph_edge::src.

Referenced by foll_in_subgraph(), and graphds_dfs().

◆ dfs_edge_src()

static int dfs_edge_src ( struct graph_edge * e,
bool forward )
inlinestatic
Helper function for graphds_dfs. Returns the source vertex of E, in the direction given by FORWARD.

References graph_edge::dest, and graph_edge::src.

Referenced by graphds_dfs().

◆ dfs_fst_edge()

static struct graph_edge * dfs_fst_edge ( struct graph * g,
int v,
bool forward,
bitmap subgraph,
skip_edge_callback skip_edge_p )
inlinestatic
Helper function for graphds_dfs. Select the first edge from V in G, in the direction given by FORWARD, that belongs to SUBGRAPH. If SKIP_EDGE_P is not NULL, it points to a callback function. Edge E will be skipped if callback function returns true.

References foll_in_subgraph(), and g.

Referenced by graphds_dfs().

◆ dfs_next_edge()

static struct graph_edge * dfs_next_edge ( struct graph_edge * e,
bool forward,
bitmap subgraph,
skip_edge_callback skip_edge_p )
inlinestatic
Helper function for graphds_dfs. Returns the next edge after E, in the graph direction given by FORWARD, that belongs to SUBGRAPH. If SKIP_EDGE_P is not NULL, it points to a callback function. Edge E will be skipped if callback function returns true.

References foll_in_subgraph(), graph_edge::pred_next, and graph_edge::succ_next.

Referenced by graphds_dfs().

◆ dump_graph()

void dump_graph ( FILE * f,
struct graph * g )
Graph representation and manipulation functions. Copyright (C) 2007-2025 Free Software Foundation, Inc. This file is part of GCC. GCC is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 3, or (at your option) any later version. GCC is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GCC; see the file COPYING3. If not see <http://www.gnu.org/licenses/>.
Dumps graph G into F.

References graph_edge::data, graph_edge::dest, g, i, graph_edge::pred_next, graph_edge::src, and graph_edge::succ_next.

◆ foll_in_subgraph()

static struct graph_edge * foll_in_subgraph ( struct graph_edge * e,
bool forward,
bitmap subgraph,
skip_edge_callback skip_edge_p )
inlinestatic
Helper function for graphds_dfs. Returns the first edge after E (including E), in the graph direction given by FORWARD, that belongs to SUBGRAPH. If SKIP_EDGE_P is not NULL, it points to a callback function. Edge E will be skipped if callback function returns true.

References bitmap_bit_p, dfs_edge_dest(), graph_edge::pred_next, and graph_edge::succ_next.

Referenced by dfs_fst_edge(), and dfs_next_edge().

◆ for_each_edge()

void for_each_edge ( struct graph * g,
graphds_edge_callback callback,
void * data )
Runs CALLBACK for all edges in G. DATA is private data for CALLBACK.

References g, i, and graph_edge::succ_next.

Referenced by loop_distribution::break_alias_scc_partitions(), and loop_distribution::merge_dep_scc_partitions().

◆ free_graph()

◆ graphds_dfs()

int graphds_dfs ( struct graph * g,
int * qs,
int nq,
vec< int > * qt,
bool forward,
bitmap subgraph,
skip_edge_callback skip_edge_p )
Runs dfs search over vertices of G, from NQ vertices in queue QS. The vertices in postorder are stored into QT. If FORWARD is false, backward dfs is run. If SUBGRAPH is not NULL, it specifies the subgraph of G to run DFS on. Returns the number of the components of the graph (number of the restarts of DFS). If SKIP_EDGE_P is not NULL, it points to a callback function. Edge E will be skipped if callback function returns true.

References comp, dfs_edge_dest(), dfs_edge_src(), dfs_fst_edge(), dfs_next_edge(), EXECUTE_IF_SET_IN_BITMAP, free(), g, i, and tick.

Referenced by loop_distribution::build_rdg_partition_for_vertex(), vect_optimize_slp_pass::create_partitions(), graphds_domtree(), and graphds_scc().

◆ graphds_domtree()

void graphds_domtree ( struct graph * g,
int entry,
int * parent,
int * son,
int * brother )
Determines the dominance tree of G (stored in the PARENT, SON and BROTHER arrays), where the entry node is ENTRY.

References changed, free(), g, gcc_assert, graphds_dfs(), i, NULL, graph_edge::pred_next, graph_edge::src, tree_nca(), and vNULL.

Referenced by iterate_fix_dominators().

◆ graphds_scc()

int graphds_scc ( struct graph * g,
bitmap subgraph,
skip_edge_callback skip_edge_p,
vec< int > * scc_grouping )
Determines the strongly connected components of G, using the algorithm of Kosaraju -- first determine the postorder dfs numbering in reversed graph, then run the dfs on the original graph in the order given by decreasing numbers assigned by the previous pass. If SUBGRAPH is not NULL, it specifies the subgraph of G whose strongly connected components we want to determine. If SKIP_EDGE_P is not NULL, it points to a callback function. Edge E will be skipped if callback function returns true. If SCC_GROUPING is not null, the nodes will be added to it in the following order: - If SCC A is a direct or indirect predecessor of SCC B in the SCC dag, A's nodes come before B's nodes. - All of an SCC's nodes are listed consecutively, although the order of the nodes within an SCC is not really meaningful. After running this function, v->component is the number of the strongly connected component for each vertex of G. Returns the number of the sccs of G.

References comp, EXECUTE_IF_SET_IN_BITMAP, free(), g, gcc_assert, graphds_dfs(), i, queue, and vNULL.

Referenced by loop_distribution::break_alias_scc_partitions(), vect_optimize_slp_pass::create_partitions(), determine_dominators_for_sons(), mark_irreducible_loops(), loop_distribution::merge_dep_scc_partitions(), and prime_paths().

◆ identify_vertices()

void identify_vertices ( struct graph * g,
int v,
int u )
Moves all the edges incident with U to V.

References graph_edge::dest, g, NULL, graph_edge::pred_next, graph_edge::src, and graph_edge::succ_next.

Referenced by determine_dominators_for_sons().

◆ new_graph()

◆ tree_nca()

static int tree_nca ( int x,
int y,
int * parent,
int * marks,
int mark )
static
Returns the nearest common ancestor of X and Y in tree whose parent links are given by PARENT. MARKS is the array used to mark the vertices of the tree, and MARK is the number currently used as a mark.

References y.

Referenced by graphds_domtree().