df.h revision 117395
1/* Form lists of pseudo register references for autoinc optimization
2   for GNU compiler.  This is part of flow optimization.
3   Copyright (C) 1999, 2000, 2001 Free Software Foundation, Inc.
4   Contributed by Michael P. Hayes (m.hayes@elec.canterbury.ac.nz)
5
6This file is part of GCC.
7
8GCC is free software; you can redistribute it and/or modify it under
9the terms of the GNU General Public License as published by the Free
10Software Foundation; either version 2, or (at your option) any later
11version.
12
13GCC is distributed in the hope that it will be useful, but WITHOUT ANY
14WARRANTY; without even the implied warranty of MERCHANTABILITY or
15FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
16for more details.
17
18You should have received a copy of the GNU General Public License
19along with GCC; see the file COPYING.  If not, write to the Free
20Software Foundation, 59 Temple Place - Suite 330, Boston, MA
2102111-1307, USA.  */
22
23#define DF_RD		 1	/* Reaching definitions.  */
24#define DF_RU		 2	/* Reaching uses.  */
25#define DF_LR		 4	/* Live registers.  */
26#define DF_DU_CHAIN	 8	/* Def-use chain.  */
27#define DF_UD_CHAIN     16	/* Use-def chain.  */
28#define DF_REG_INFO	32	/* Register info.  */
29#define DF_RD_CHAIN	64	/* Reg-def chain.  */
30#define DF_RU_CHAIN    128	/* Reg-use chain.  */
31#define DF_ALL	       255
32#define DF_HARD_REGS  1024
33#define DF_EQUIV_NOTES 2048	/* Mark uses present in EQUIV/EQUAL notes.  */
34
35enum df_ref_type {DF_REF_REG_DEF, DF_REF_REG_USE, DF_REF_REG_MEM_LOAD,
36		  DF_REF_REG_MEM_STORE};
37
38#define DF_REF_TYPE_NAMES {"def", "use", "mem load", "mem store"}
39
40/* ???> Perhaps all these data structures should be made private
41   to enforce the interface.  */
42
43
44/* Link on a def-use or use-def chain.  */
45struct df_link
46{
47  struct df_link *next;
48  struct ref *ref;
49};
50
51enum df_ref_flags
52  {
53    DF_REF_READ_WRITE = 1,
54
55    /* This flag is set on register references itself representing a or
56       being inside a subreg on machines which have CLASS_CANNOT_CHANGE_MODE
57       and where the mode change of that subreg expression is invalid for
58       this class.  Note, that this flag can also be set on df_refs
59       representing the REG itself (i.e. one might not see the subreg
60       anyore).  Also note, that this flag is set also for hardreg refs.
61       I.e. you must check yourself if it's a pseudo.  */
62    DF_REF_MODE_CHANGE = 2
63  };
64
65/* Define a register reference structure.  */
66struct ref
67{
68  rtx reg;			/* The register referenced.  */
69  rtx insn;			/* Insn containing ref.  */
70  rtx *loc;			/* Loc is the location of the reg.  */
71  struct df_link *chain;	/* Head of def-use or use-def chain.  */
72  enum df_ref_type type;	/* Type of ref.  */
73  unsigned int id;		/* Ref index.  */
74  enum df_ref_flags flags;	/* Various flags.  */
75};
76
77
78/* One of these structures is allocated for every insn.  */
79struct insn_info
80{
81  struct df_link *defs;		/* Head of insn-def chain.  */
82  struct df_link *uses;		/* Head of insn-use chain.  */
83  /* ???? The following luid field should be considerd private so that
84     we can change it on the fly to accommodate new insns?  */
85  int luid;			/* Logical UID.  */
86#if 0
87  rtx insn;			/* Backpointer to the insn.  */
88#endif
89};
90
91
92/* One of these structures is allocated for every reg.  */
93struct reg_info
94{
95  struct df_link *defs;		/* Head of reg-def chain.  */
96  struct df_link *uses;		/* Head of reg-use chain.  */
97  int lifetime;
98  int n_defs;
99  int n_uses;
100};
101
102
103/* One of these structures is allocated for every basic block.  */
104struct bb_info
105{
106  /* Reaching def bitmaps have def_id elements.  */
107  bitmap rd_kill;
108  bitmap rd_gen;
109  bitmap rd_in;
110  bitmap rd_out;
111  /* Reaching use bitmaps have use_id elements.  */
112  bitmap ru_kill;
113  bitmap ru_gen;
114  bitmap ru_in;
115  bitmap ru_out;
116  /* Live variable bitmaps have n_regs elements.  */
117  bitmap lr_def;
118  bitmap lr_use;
119  bitmap lr_in;
120  bitmap lr_out;
121  int rd_valid;
122  int ru_valid;
123  int lr_valid;
124};
125
126
127struct df
128{
129  int flags;			/* Indicates what's recorded.  */
130  struct bb_info *bbs;		/* Basic block table.  */
131  struct ref **defs;		/* Def table, indexed by def_id.  */
132  struct ref **uses;		/* Use table, indexed by use_id.  */
133  struct ref **reg_def_last;	/* Indexed by regno.  */
134  struct reg_info *regs;	/* Regs table, index by regno.  */
135  unsigned int reg_size;	/* Size of regs table.  */
136  struct insn_info *insns;	/* Insn table, indexed by insn UID.  */
137  unsigned int insn_size;	/* Size of insn table.  */
138  unsigned int def_id;		/* Next def ID.  */
139  unsigned int def_size;	/* Size of def table.  */
140  unsigned int n_defs;		/* Size of def bitmaps.  */
141  unsigned int use_id;		/* Next use ID.  */
142  unsigned int use_size;	/* Size of use table.  */
143  unsigned int n_uses;		/* Size of use bitmaps.  */
144  unsigned int n_bbs;		/* Number of basic blocks.  */
145  unsigned int n_regs;		/* Number of regs.  */
146  unsigned int def_id_save;	/* Saved next def ID.  */
147  unsigned int use_id_save;	/* Saved next use ID.  */
148  bitmap insns_modified;	/* Insns that (may) have changed.  */
149  bitmap bbs_modified;		/* Blocks that (may) have changed.  */
150  bitmap all_blocks;		/* All blocks in CFG.  */
151  /* The sbitmap vector of dominators or NULL if not computed.
152     Ideally, this should be a pointer to a CFG object.  */
153  sbitmap *dom;
154  int * dfs_order; /* DFS order -> block number */
155  int * rc_order; /* reverse completion order -> block number */
156  int * rts_order; /* reverse top sort order -> block number */
157  int * inverse_rc_map; /* block number -> reverse completion order */
158  int * inverse_dfs_map; /* block number -> DFS order */
159  int * inverse_rts_map; /* block number -> reverse top-sort order */
160};
161
162
163struct df_map
164{
165  rtx old;
166  rtx new;
167};
168
169
170#define DF_BB_INFO(REFS, BB) (&REFS->bbs[(BB)->index])
171
172
173/* Macros to access the elements within the ref structure.  */
174#define DF_REF_REAL_REG(REF) (GET_CODE ((REF)->reg) == SUBREG \
175				? SUBREG_REG ((REF)->reg) : ((REF)->reg))
176#define DF_REF_REGNO(REF) REGNO (DF_REF_REAL_REG (REF))
177#define DF_REF_REAL_LOC(REF) (GET_CODE ((REF)->reg) == SUBREG \
178			        ? &SUBREG_REG ((REF)->reg) : ((REF)->loc))
179#ifdef OLD_DF_INTERFACE
180#define DF_REF_REG(REF) DF_REF_REAL_REG(REF)
181#define DF_REF_LOC(REF) DF_REF_REAL_LOC(REF)
182#else
183#define DF_REF_REG(REF) ((REF)->reg)
184#define DF_REF_LOC(REF) ((REF)->loc)
185#endif
186#define DF_REF_BB(REF) (BLOCK_FOR_INSN ((REF)->insn))
187#define DF_REF_BBNO(REF) (BLOCK_FOR_INSN ((REF)->insn)->index)
188#define DF_REF_INSN(REF) ((REF)->insn)
189#define DF_REF_INSN_UID(REF) (INSN_UID ((REF)->insn))
190#define DF_REF_TYPE(REF) ((REF)->type)
191#define DF_REF_CHAIN(REF) ((REF)->chain)
192#define DF_REF_ID(REF) ((REF)->id)
193#define DF_REF_FLAGS(REF) ((REF)->flags)
194
195/* Macros to determine the reference type.  */
196
197#define DF_REF_REG_DEF_P(REF) (DF_REF_TYPE (REF) == DF_REF_REG_DEF)
198#define DF_REF_REG_USE_P(REF) ((REF) && ! DF_REF_REG_DEF_P (REF))
199#define DF_REF_REG_MEM_STORE_P(REF) (DF_REF_TYPE (REF) == DF_REF_REG_MEM_STORE)
200#define DF_REF_REG_MEM_LOAD_P(REF) (DF_REF_TYPE (REF) == DF_REF_REG_MEM_LOAD)
201#define DF_REF_REG_MEM_P(REF) (DF_REF_REG_MEM_STORE_P (REF) \
202                            || DF_REF_REG_MEM_LOAD_P (REF))
203
204
205/* Macros to access the elements within the reg_info structure table.  */
206
207#define DF_REGNO_FIRST_DEF(DF, REGNUM) \
208((DF)->regs[REGNUM].defs ? (DF)->regs[REGNUM].defs->ref : 0)
209#define DF_REGNO_LAST_USE(DF, REGNUM) \
210((DF)->regs[REGNUM].uses ? (DF)->regs[REGNUM].uses->ref : 0)
211
212#define DF_REGNO_FIRST_BB(DF, REGNUM) \
213(DF_REGNO_FIRST_DEF (DF, REGNUM) \
214? DF_REF_BB (DF_REGNO_FIRST_DEF (DF, REGNUM)) : 0)
215#define DF_REGNO_LAST_BB(DF, REGNUM) \
216(DF_REGNO_LAST_USE (DF, REGNUM) \
217? DF_REF_BB (DF_REGNO_LAST_USE (DF, REGNUM)) : 0)
218
219
220/* Macros to access the elements within the insn_info structure table.  */
221
222#define DF_INSN_LUID(DF, INSN) ((DF)->insns[INSN_UID (INSN)].luid)
223#define DF_INSN_DEFS(DF, INSN) ((DF)->insns[INSN_UID (INSN)].defs)
224#define DF_INSN_USES(DF, INSN) ((DF)->insns[INSN_UID (INSN)].uses)
225
226
227/* Functions to build and analyse dataflow information.  */
228
229extern struct df *df_init PARAMS ((void));
230
231extern int df_analyse PARAMS ((struct df *, bitmap, int));
232
233extern void df_finish PARAMS ((struct df *));
234
235extern void df_dump PARAMS ((struct df *, int, FILE *));
236
237/* Functions to modify insns.  */
238
239extern void df_insn_modify PARAMS ((struct df *, basic_block, rtx));
240
241extern rtx df_insn_delete PARAMS ((struct df *, basic_block, rtx));
242
243extern rtx df_pattern_emit_before PARAMS ((struct df *, rtx,
244					   basic_block, rtx));
245
246extern rtx df_jump_pattern_emit_after PARAMS ((struct df *, rtx,
247					       basic_block, rtx));
248
249extern rtx df_pattern_emit_after PARAMS ((struct df *, rtx,
250					   basic_block, rtx));
251
252extern rtx df_insn_move_before PARAMS ((struct df *, basic_block, rtx,
253					basic_block, rtx));
254
255extern int df_reg_replace PARAMS ((struct df *, bitmap, rtx, rtx));
256
257extern int df_ref_reg_replace PARAMS ((struct df *, struct ref *, rtx, rtx));
258
259extern int df_ref_remove PARAMS ((struct df *, struct ref *));
260
261extern int df_insn_reg_replace PARAMS ((struct df *, basic_block,
262					rtx, rtx, rtx));
263
264extern int df_insn_mem_replace PARAMS ((struct df *, basic_block,
265					rtx, rtx, rtx));
266
267extern struct ref *df_bb_def_use_swap PARAMS ((struct df *, basic_block,
268					       rtx, rtx, unsigned int));
269
270
271/* Functions to query dataflow information.  */
272
273extern basic_block df_regno_bb PARAMS((struct df *, unsigned int));
274
275extern int df_reg_lifetime PARAMS ((struct df *, rtx));
276
277extern int df_reg_global_p PARAMS ((struct df *, rtx));
278
279extern int df_insn_regno_def_p PARAMS ((struct df *,
280					basic_block, rtx, unsigned int));
281
282extern int df_insn_dominates_all_uses_p PARAMS ((struct df *,
283						 basic_block, rtx));
284
285extern int df_insn_dominates_uses_p PARAMS ((struct df *, basic_block,
286					     rtx, bitmap));
287
288extern int df_bb_reg_live_start_p PARAMS ((struct df *, basic_block, rtx));
289
290extern int df_bb_reg_live_end_p PARAMS ((struct df *, basic_block, rtx));
291
292extern int df_bb_regs_lives_compare PARAMS ((struct df *, basic_block,
293					     rtx, rtx));
294
295extern rtx df_bb_single_def_use_insn_find PARAMS((struct df *, basic_block,
296						  rtx, rtx));
297
298
299/* Functions for debugging from GDB.  */
300
301extern void debug_df_insn PARAMS ((rtx));
302
303extern void debug_df_regno PARAMS ((unsigned int));
304
305extern void debug_df_reg PARAMS ((rtx));
306
307extern void debug_df_defno PARAMS ((unsigned int));
308
309extern void debug_df_useno PARAMS ((unsigned int));
310
311extern void debug_df_ref PARAMS ((struct ref *));
312
313extern void debug_df_chain PARAMS ((struct df_link *));
314extern void df_insn_debug PARAMS ((struct df *, rtx, FILE *));
315extern void df_insn_debug_regno PARAMS ((struct df *, rtx, FILE *));
316/* Meet over any path (UNION) or meet over all paths (INTERSECTION) */
317enum df_confluence_op
318  {
319    UNION,
320    INTERSECTION
321  };
322/* Dataflow direction */
323enum df_flow_dir
324  {
325    FORWARD,
326    BACKWARD
327  };
328
329typedef void (*transfer_function_sbitmap) PARAMS ((int, int *, sbitmap, sbitmap,
330					   sbitmap, sbitmap, void *));
331typedef void (*transfer_function_bitmap) PARAMS ((int, int *, bitmap, bitmap,
332					  bitmap, bitmap, void *));
333
334extern void iterative_dataflow_sbitmap PARAMS ((sbitmap *, sbitmap *,
335						sbitmap *, sbitmap *,
336						bitmap, enum df_flow_dir,
337						enum df_confluence_op,
338						transfer_function_sbitmap,
339						int *, void *));
340extern void iterative_dataflow_bitmap PARAMS ((bitmap *, bitmap *, bitmap *,
341					       bitmap *, bitmap,
342					       enum df_flow_dir,
343					       enum df_confluence_op,
344					       transfer_function_bitmap,
345					       int *, void *));
346