docs: Fix 2 typos
[official-gcc.git] / gcc / gengenrtl.cc
blobc9ba471ac20df974ec0d8b105af6fab5ba9f422d
1 /* Generate code to allocate RTL structures.
2 Copyright (C) 1997-2024 Free Software Foundation, Inc.
4 This file is part of GCC.
6 GCC is free software; you can redistribute it and/or modify it under
7 the terms of the GNU General Public License as published by the Free
8 Software Foundation; either version 3, or (at your option) any later
9 version.
11 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
12 WARRANTY; without even the implied warranty of MERCHANTABILITY or
13 FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
14 for more details.
16 You should have received a copy of the GNU General Public License
17 along with GCC; see the file COPYING3. If not see
18 <http://www.gnu.org/licenses/>. */
21 #include "bconfig.h"
22 #include "system.h"
24 struct rtx_definition
26 const char *const enumname, *const name, *const format;
29 /* rtl.def needs CONST_DOUBLE_FORMAT, but we don't care what
30 CONST_DOUBLE_FORMAT is because we're not going to be generating
31 anything for CONST_DOUBLE anyway. */
32 #define CONST_DOUBLE_FORMAT ""
34 #define DEF_RTL_EXPR(ENUM, NAME, FORMAT, CLASS) { #ENUM, NAME, FORMAT },
36 static const struct rtx_definition defs[] =
38 #include "rtl.def" /* rtl expressions are documented here */
40 #define NUM_RTX_CODE ARRAY_SIZE (defs)
42 static const char *formats[NUM_RTX_CODE];
44 /* Decode a format letter into a C type string. */
46 static const char *
47 type_from_format (int c)
49 switch (c)
51 case 'i':
52 return "int ";
54 case 'w':
55 return "HOST_WIDE_INT ";
57 case 'p':
58 return "poly_uint16 ";
60 case 's':
61 return "const char *";
63 case 'e': case 'u':
64 return "rtx ";
66 case 'E':
67 return "rtvec ";
68 case 't':
69 return "tree ";
70 case 'B':
71 return "basic_block ";
72 default:
73 gcc_unreachable ();
77 /* Decode a format letter into the proper accessor function. */
79 static const char *
80 accessor_from_format (int c)
82 switch (c)
84 case 'i':
85 return "XINT";
87 case 'w':
88 return "XWINT";
90 case 's':
91 return "XSTR";
93 case 'e': case 'u':
94 return "XEXP";
96 case 'E':
97 return "XVEC";
99 case 't':
100 return "XTREE";
102 case 'B':
103 return "XBBDEF";
105 default:
106 gcc_unreachable ();
110 /* Return nonzero if we should ignore FMT, an RTL format, when making
111 the list of formats we write routines to create. */
113 static int
114 special_format (const char *fmt)
116 return (strchr (fmt, '*') != 0
117 || strchr (fmt, 'V') != 0
118 || strchr (fmt, 'S') != 0
119 || strchr (fmt, 'n') != 0
120 || strchr (fmt, 'r') != 0);
123 /* Return true if CODE always has VOIDmode. */
125 static inline bool
126 always_void_p (int idx)
128 return strcmp (defs[idx].enumname, "SET") == 0;
131 /* Return nonzero if the RTL code given by index IDX is one that we should
132 generate a gen_rtx_raw_FOO macro for, not gen_rtx_FOO (because gen_rtx_FOO
133 is a wrapper in emit-rtl.cc). */
135 static int
136 special_rtx (int idx)
138 return (strcmp (defs[idx].enumname, "EXPR_LIST") == 0
139 || strcmp (defs[idx].enumname, "INSN_LIST") == 0
140 || strcmp (defs[idx].enumname, "INSN") == 0
141 || strcmp (defs[idx].enumname, "CONST_INT") == 0
142 || strcmp (defs[idx].enumname, "REG") == 0
143 || strcmp (defs[idx].enumname, "SUBREG") == 0
144 || strcmp (defs[idx].enumname, "MEM") == 0
145 || strcmp (defs[idx].enumname, "PC") == 0
146 || strcmp (defs[idx].enumname, "RETURN") == 0
147 || strcmp (defs[idx].enumname, "SIMPLE_RETURN") == 0
148 || strcmp (defs[idx].enumname, "CONST_VECTOR") == 0);
151 /* Return nonzero if the RTL code given by index IDX is one that we should
152 generate no macro for at all (because gen_rtx_FOO is never used or
153 cannot have the obvious interface). */
155 static int
156 excluded_rtx (int idx)
158 return (strcmp (defs[idx].enumname, "VAR_LOCATION") == 0
159 || strcmp (defs[idx].enumname, "CONST_DOUBLE") == 0
160 || strcmp (defs[idx].enumname, "CONST_WIDE_INT") == 0
161 || strcmp (defs[idx].enumname, "CONST_POLY_INT") == 0
162 || strcmp (defs[idx].enumname, "CONST_FIXED") == 0);
165 /* Place a list of all format specifiers we use into the array FORMAT. */
167 static void
168 find_formats (void)
170 unsigned int i;
172 for (i = 0; i < NUM_RTX_CODE; i++)
174 const char **f;
176 if (special_format (defs[i].format))
177 continue;
179 for (f = formats; *f; f++)
180 if (! strcmp (*f, defs[i].format))
181 break;
183 if (*f == 0)
184 *f = defs[i].format;
189 /* Generate macros to generate RTL of code IDX using the functions we
190 write. */
192 static void
193 genmacro (int idx)
195 const char *p;
196 const char *sep = "";
197 int i;
199 /* We write a macro that defines gen_rtx_RTLCODE to be an equivalent to
200 gen_rtx_fmt_FORMAT where FORMAT is the RTX_FORMAT of RTLCODE. */
202 if (excluded_rtx (idx))
203 /* Don't define a macro for this code. */
204 return;
206 bool has_mode_p = !always_void_p (idx);
207 printf ("#define gen_rtx_%s%s(",
208 special_rtx (idx) ? "raw_" : "", defs[idx].enumname);
209 if (has_mode_p)
211 printf ("MODE");
212 sep = ", ";
215 for (p = defs[idx].format, i = 0; *p != 0; p++)
216 if (*p != '0')
218 printf ("%sARG%d", sep, i++);
219 sep = ", ";
222 printf (") \\\n gen_rtx_fmt_%s (%s, %s",
223 defs[idx].format, defs[idx].enumname,
224 has_mode_p ? "(MODE)" : "VOIDmode");
226 for (p = defs[idx].format, i = 0; *p != 0; p++)
227 if (*p != '0')
228 printf (", (ARG%d)", i++);
230 puts (")");
233 /* Generate the code for functions to generate RTL whose format is FORMAT. */
235 static void
236 gendef (const char *format)
238 const char *p;
239 int i, j;
241 /* Write the definition of the init function name and the types
242 of the arguments. */
244 puts ("static inline rtx");
245 printf ("init_rtx_fmt_%s (rtx rt, machine_mode mode", format);
246 for (p = format, i = 0; *p != 0; p++)
247 if (*p != '0')
248 printf (",\n\t%sarg%d", type_from_format (*p), i++);
249 puts (")");
251 /* Now write out the body of the init function itself. */
252 puts ("{");
253 puts (" PUT_MODE_RAW (rt, mode);");
255 for (p = format, i = j = 0; *p ; ++p, ++i)
256 if (*p == '0')
257 printf (" X0EXP (rt, %d) = NULL_RTX;\n", i);
258 else if (*p == 'p')
259 printf (" SUBREG_BYTE (rt) = arg%d;\n", j++);
260 else
261 printf (" %s (rt, %d) = arg%d;\n", accessor_from_format (*p), i, j++);
263 puts (" return rt;\n}\n");
265 /* Write the definition of the gen function name and the types
266 of the arguments. */
268 puts ("static inline rtx");
269 printf ("gen_rtx_fmt_%s_stat (RTX_CODE code, machine_mode mode", format);
270 for (p = format, i = 0; *p != 0; p++)
271 if (*p != '0')
272 printf (",\n\t%sarg%d", type_from_format (*p), i++);
273 puts (" MEM_STAT_DECL)");
275 /* Now write out the body of the function itself, which allocates
276 the memory and initializes it. */
277 puts ("{");
278 puts (" rtx rt;\n");
280 puts (" rt = rtx_alloc (code PASS_MEM_STAT);");
281 printf (" return init_rtx_fmt_%s (rt, mode", format);
282 for (p = format, i = 0; *p != 0; p++)
283 if (*p != '0')
284 printf (", arg%d", i++);
285 puts (");\n}\n");
287 /* Write the definition of gen macro. */
289 printf ("#define gen_rtx_fmt_%s(c, m", format);
290 for (p = format, i = 0; *p != 0; p++)
291 if (*p != '0')
292 printf (", arg%d", i++);
293 printf (") \\\n gen_rtx_fmt_%s_stat ((c), (m)", format);
294 for (p = format, i = 0; *p != 0; p++)
295 if (*p != '0')
296 printf (", (arg%d)", i++);
297 printf (" MEM_STAT_INFO)\n\n");
299 /* Write the definition of alloca macro. */
301 printf ("#define alloca_rtx_fmt_%s(c, m", format);
302 for (p = format, i = 0; *p != 0; p++)
303 if (*p != '0')
304 printf (", arg%d", i++);
305 printf (") \\\n init_rtx_fmt_%s (rtx_alloca ((c)), (m)", format);
306 for (p = format, i = 0; *p != 0; p++)
307 if (*p != '0')
308 printf (", (arg%d)", i++);
309 printf (")\n\n");
312 /* Generate the documentation header for files we write. */
314 static void
315 genlegend (void)
317 puts ("/* Generated automatically by gengenrtl from rtl.def. */\n");
320 /* Generate the text of the header file we make, genrtl.h. */
322 static void
323 genheader (void)
325 unsigned int i;
326 const char **fmt;
328 puts ("#ifndef GCC_GENRTL_H");
329 puts ("#define GCC_GENRTL_H\n");
330 puts ("#include \"statistics.h\"\n");
332 for (fmt = formats; *fmt; ++fmt)
333 gendef (*fmt);
335 putchar ('\n');
337 for (i = 0; i < NUM_RTX_CODE; i++)
338 if (! special_format (defs[i].format))
339 genmacro (i);
341 puts ("\n#endif /* GCC_GENRTL_H */");
344 /* This is the main program. */
347 main (void)
349 find_formats ();
350 genlegend ();
352 genheader ();
354 if (ferror (stdout) || fflush (stdout) || fclose (stdout))
355 return FATAL_EXIT_CODE;
357 return SUCCESS_EXIT_CODE;