]>
Commit | Line | Data |
---|---|---|
0c2768fc RS |
1 | /* Declarations for insn-output.c. These functions are defined in recog.c, |
2 | final.c, and varasm.c. | |
af841dbd | 3 | Copyright (C) 1987, 1991, 1994, 1997, 1998, |
ad616de1 | 4 | 1999, 2000, 2001, 2002, 2003, 2004, 2005 Free Software Foundation, Inc. |
0c2768fc | 5 | |
1322177d | 6 | This file is part of GCC. |
0c2768fc | 7 | |
1322177d LB |
8 | GCC is free software; you can redistribute it and/or modify it under |
9 | the terms of the GNU General Public License as published by the Free | |
10 | Software Foundation; either version 2, or (at your option) any later | |
11 | version. | |
0c2768fc | 12 | |
1322177d LB |
13 | GCC is distributed in the hope that it will be useful, but WITHOUT ANY |
14 | WARRANTY; without even the implied warranty of MERCHANTABILITY or | |
15 | FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
16 | for more details. | |
0c2768fc RS |
17 | |
18 | You should have received a copy of the GNU General Public License | |
1322177d | 19 | along with GCC; see the file COPYING. If not, write to the Free |
366ccddb KC |
20 | Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA |
21 | 02110-1301, USA. */ | |
0c2768fc | 22 | |
e91e4f6c KG |
23 | #ifndef GCC_OUTPUT_H |
24 | #define GCC_OUTPUT_H | |
25 | ||
9b1d8cd6 | 26 | /* Initialize data in final at the beginning of a compilation. */ |
0c20a65f | 27 | extern void init_final (const char *); |
9b1d8cd6 | 28 | |
9b1d8cd6 RK |
29 | /* Enable APP processing of subsequent output. |
30 | Used before the output from an `asm' statement. */ | |
0c20a65f | 31 | extern void app_enable (void); |
9b1d8cd6 RK |
32 | |
33 | /* Disable APP processing of subsequent output. | |
34 | Called from varasm.c before most kinds of output. */ | |
0c20a65f | 35 | extern void app_disable (void); |
9b1d8cd6 | 36 | |
a4f31c00 | 37 | /* Return the number of slots filled in the current |
9b1d8cd6 RK |
38 | delayed branch sequence (we don't count the insn needing the |
39 | delay slot). Zero if not in a delayed branch sequence. */ | |
0c20a65f | 40 | extern int dbr_sequence_length (void); |
9b1d8cd6 RK |
41 | |
42 | /* Indicate that branch shortening hasn't yet been done. */ | |
0c20a65f | 43 | extern void init_insn_lengths (void); |
9b1d8cd6 RK |
44 | |
45 | /* Obtain the current length of an insn. If branch shortening has been done, | |
46 | get its actual length. Otherwise, get its maximum length. */ | |
0c20a65f | 47 | extern int get_attr_length (rtx); |
9b1d8cd6 | 48 | |
070a7956 R |
49 | /* Obtain the current length of an insn. If branch shortening has been done, |
50 | get its actual length. Otherwise, get its minimum length. */ | |
51 | extern int get_attr_min_length (rtx); | |
52 | ||
9b1d8cd6 RK |
53 | /* Make a pass over all insns and compute their actual lengths by shortening |
54 | any branches of variable length if possible. */ | |
0c20a65f | 55 | extern void shorten_branches (rtx); |
9b1d8cd6 RK |
56 | |
57 | /* Output assembler code for the start of a function, | |
58 | and initialize some of the variables in this file | |
59 | for the new function. The label for the function and associated | |
60 | assembler pseudo-ops have already been output in | |
61 | `assemble_start_function'. */ | |
0c20a65f | 62 | extern void final_start_function (rtx, FILE *, int); |
9b1d8cd6 RK |
63 | |
64 | /* Output assembler code for the end of a function. | |
65 | For clarity, args are same as those of `final_start_function' | |
66 | even though not all of them are needed. */ | |
0c20a65f | 67 | extern void final_end_function (void); |
9b1d8cd6 RK |
68 | |
69 | /* Output assembler code for some insns: all or part of a function. */ | |
c9d691e9 | 70 | extern void final (rtx, FILE *, int); |
9b1d8cd6 | 71 | |
5cfc5f84 DJ |
72 | /* The final scan for one insn, INSN. Args are same as in `final', except |
73 | that INSN is the insn being scanned. Value returned is the next insn to | |
74 | be scanned. */ | |
c9d691e9 | 75 | extern rtx final_scan_insn (rtx, FILE *, int, int, int *); |
5cfc5f84 | 76 | |
9b1d8cd6 RK |
77 | /* Replace a SUBREG with a REG or a MEM, based on the thing it is a |
78 | subreg of. */ | |
0c20a65f | 79 | extern rtx alter_subreg (rtx *); |
9b1d8cd6 RK |
80 | |
81 | /* Report inconsistency between the assembler template and the operands. | |
82 | In an `asm', it's the user's fault; otherwise, the compiler's fault. */ | |
0c20a65f | 83 | extern void output_operand_lossage (const char *, ...) ATTRIBUTE_PRINTF_1; |
cf1c49cb | 84 | |
0c2768fc RS |
85 | /* Output a string of assembler code, substituting insn operands. |
86 | Defined in final.c. */ | |
0c20a65f | 87 | extern void output_asm_insn (const char *, rtx *); |
0c2768fc | 88 | |
487a6e06 KG |
89 | /* Compute a worst-case reference address of a branch so that it |
90 | can be safely used in the presence of aligned labels. | |
91 | Defined in final.c. */ | |
0c20a65f | 92 | extern int insn_current_reference_address (rtx); |
487a6e06 | 93 | |
3873d24b RH |
94 | /* Find the alignment associated with a CODE_LABEL. |
95 | Defined in final.c. */ | |
0c20a65f | 96 | extern int label_to_alignment (rtx); |
3873d24b | 97 | |
9b1d8cd6 | 98 | /* Output a LABEL_REF, or a bare CODE_LABEL, as an assembler symbol. */ |
0c20a65f | 99 | extern void output_asm_label (rtx); |
9b1d8cd6 RK |
100 | |
101 | /* Print a memory reference operand for address X | |
102 | using machine-dependent assembler syntax. */ | |
0c20a65f | 103 | extern void output_address (rtx); |
1428a6b3 | 104 | |
aaff8ce0 CH |
105 | /* Print an integer constant expression in assembler syntax. |
106 | Addition and subtraction are the only arithmetic | |
107 | that may appear in these expressions. */ | |
0c20a65f | 108 | extern void output_addr_const (FILE *, rtx); |
aaff8ce0 | 109 | |
9b1d8cd6 RK |
110 | /* Output a string of assembler code, substituting numbers, strings |
111 | and fixed syntactic prefixes. */ | |
3ae1d4c2 KG |
112 | #if GCC_VERSION >= 3004 |
113 | #define ATTRIBUTE_ASM_FPRINTF(m, n) __attribute__ ((__format__ (__asm_fprintf__, m, n))) ATTRIBUTE_NONNULL(m) | |
114 | /* This is a magic identifier which allows GCC to figure out the type | |
115 | of HOST_WIDE_INT for %wd specifier checks. You must issue this | |
116 | typedef before using the __asm_fprintf__ format attribute. */ | |
117 | typedef HOST_WIDE_INT __gcc_host_wide_int__; | |
118 | #else | |
119 | #define ATTRIBUTE_ASM_FPRINTF(m, n) ATTRIBUTE_NONNULL(m) | |
120 | #endif | |
121 | ||
0c20a65f AJ |
122 | extern void asm_fprintf (FILE *file, const char *p, ...) |
123 | ATTRIBUTE_ASM_FPRINTF(2, 3); | |
9b1d8cd6 RK |
124 | |
125 | /* Split up a CONST_DOUBLE or integer constant rtx into two rtx's for single | |
126 | words. */ | |
0c20a65f | 127 | extern void split_double (rtx, rtx *, rtx *); |
9b1d8cd6 RK |
128 | |
129 | /* Return nonzero if this function has no function calls. */ | |
0c20a65f | 130 | extern int leaf_function_p (void); |
9b1d8cd6 | 131 | |
09da1532 | 132 | /* Return 1 if branch is a forward branch. |
a4f31c00 AJ |
133 | Uses insn_shuid array, so it works only in the final pass. May be used by |
134 | output templates to add branch prediction hints, for example. */ | |
0c20a65f | 135 | extern int final_forward_branch_p (rtx); |
a4f31c00 | 136 | |
9b1d8cd6 RK |
137 | /* Return 1 if this function uses only the registers that can be |
138 | safely renumbered. */ | |
0c20a65f | 139 | extern int only_leaf_regs_used (void); |
9b1d8cd6 RK |
140 | |
141 | /* Scan IN_RTX and its subexpressions, and renumber all regs into those | |
142 | available in leaf functions. */ | |
0c20a65f | 143 | extern void leaf_renumber_regs_insn (rtx); |
a1493f9f | 144 | |
4bbf910e | 145 | /* Locate the proper template for the given insn-code. */ |
0c20a65f | 146 | extern const char *get_insn_template (int, rtx); |
4bbf910e | 147 | |
a1493f9f | 148 | /* Functions in flow.c */ |
0c20a65f | 149 | extern int regno_clobbered_at_setjmp (int); |
ed068cf5 RK |
150 | |
151 | /* Functions in varasm.c. */ | |
152 | ||
d6f4ec51 | 153 | /* Declare DECL to be a weak symbol. */ |
0c20a65f | 154 | extern void declare_weak (tree); |
45806a3f | 155 | /* Merge weak status. */ |
0c20a65f | 156 | extern void merge_weak (tree, tree); |
d6f4ec51 | 157 | |
50b2596f | 158 | /* Emit any pending weak declarations. */ |
0c20a65f | 159 | extern void weak_finish (void); |
50b2596f | 160 | |
ed068cf5 RK |
161 | /* Decode an `asm' spec for a declaration as a register name. |
162 | Return the register number, or -1 if nothing specified, | |
163 | or -2 if the ASMSPEC is not `cc' or `memory' and is not recognized, | |
164 | or -3 if ASMSPEC is `cc' and is not recognized, | |
165 | or -4 if ASMSPEC is `memory' and is not recognized. | |
166 | Accept an exact spelling or a decimal number. | |
167 | Prefixes such as % are optional. */ | |
0c20a65f | 168 | extern int decode_reg_name (const char *); |
ed068cf5 | 169 | |
ed068cf5 RK |
170 | /* Make the rtl for variable VAR be volatile. |
171 | Use this only for static variables. */ | |
0c20a65f | 172 | extern void make_var_volatile (tree); |
ed068cf5 | 173 | |
0c20a65f | 174 | extern void assemble_alias (tree, tree); |
d6f4ec51 | 175 | |
0c20a65f | 176 | extern void default_assemble_visibility (tree, int); |
47bd70b5 | 177 | |
ed068cf5 RK |
178 | /* Output a string of literal assembler code |
179 | for an `asm' keyword used between functions. */ | |
0c20a65f | 180 | extern void assemble_asm (tree); |
ed068cf5 | 181 | |
ed068cf5 RK |
182 | /* Output assembler code for the constant pool of a function and associated |
183 | with defining the name of the function. DECL describes the function. | |
184 | NAME is the function's name. For the constant pool, we use the current | |
185 | constant pool data. */ | |
0c20a65f | 186 | extern void assemble_start_function (tree, const char *); |
ed068cf5 RK |
187 | |
188 | /* Output assembler code associated with defining the size of the | |
189 | function. DECL describes the function. NAME is the function's name. */ | |
0c20a65f | 190 | extern void assemble_end_function (tree, const char *); |
ed068cf5 | 191 | |
ed068cf5 RK |
192 | /* Assemble everything that is needed for a variable or function declaration. |
193 | Not used for automatic variables, and not used for function definitions. | |
194 | Should not be called for variables of incomplete structure type. | |
195 | ||
196 | TOP_LEVEL is nonzero if this variable has file scope. | |
197 | AT_END is nonzero if this is the special handling, at end of compilation, | |
198 | to define things that have had only tentative definitions. | |
199 | DONT_OUTPUT_DATA if nonzero means don't actually output the | |
200 | initial value (that will be done by the caller). */ | |
0c20a65f | 201 | extern void assemble_variable (tree, int, int, int); |
ed068cf5 | 202 | |
88d03811 JH |
203 | /* Compute the alignment of variable specified by DECL. |
204 | DONT_OUTPUT_DATA is from assemble_variable. */ | |
205 | extern void align_variable (tree decl, bool dont_output_data); | |
206 | ||
2e226e66 | 207 | /* Queue for outputting something to declare an external symbol to the |
c47c29c8 L |
208 | assembler. (Most assemblers don't need this, so we normally output |
209 | nothing.) Do nothing if DECL is not external. */ | |
0c20a65f | 210 | extern void assemble_external (tree); |
ed068cf5 | 211 | |
d8d79d15 | 212 | /* Assemble code to leave SIZE bytes of zeros. */ |
0c20a65f | 213 | extern void assemble_zeros (unsigned HOST_WIDE_INT); |
d8d79d15 RE |
214 | |
215 | /* Assemble an alignment pseudo op for an ALIGN-bit boundary. */ | |
0c20a65f | 216 | extern void assemble_align (int); |
d8d79d15 RE |
217 | |
218 | /* Assemble a string constant with the specified C string as contents. */ | |
0c20a65f | 219 | extern void assemble_string (const char *, int); |
d8d79d15 | 220 | |
ed068cf5 | 221 | /* Similar, for calling a library function FUN. */ |
0c20a65f | 222 | extern void assemble_external_libcall (rtx); |
9b1d8cd6 | 223 | |
ed068cf5 | 224 | /* Assemble a label named NAME. */ |
0c20a65f | 225 | extern void assemble_label (const char *); |
ed068cf5 | 226 | |
57829bc4 MM |
227 | /* Output to FILE (an assembly file) a reference to NAME. If NAME |
228 | starts with a *, the rest of NAME is output verbatim. Otherwise | |
229 | NAME is transformed in a target-specific way (usually by the | |
230 | addition of an underscore). */ | |
231 | extern void assemble_name_raw (FILE *, const char *); | |
232 | ||
233 | /* Like assemble_name_raw, but should be used when NAME might refer to | |
234 | an entity that is also represented as a tree (like a function or | |
235 | variable). If NAME does refer to such an entity, that entity will | |
236 | be marked as referenced. */ | |
0c20a65f | 237 | extern void assemble_name (FILE *, const char *); |
ed068cf5 | 238 | |
301d03af RS |
239 | /* Return the assembler directive for creating a given kind of integer |
240 | object. SIZE is the number of bytes in the object and ALIGNED_P | |
241 | indicates whether it is known to be aligned. Return NULL if the | |
242 | assembly dialect has no such directive. | |
243 | ||
244 | The returned string should be printed at the start of a new line and | |
245 | be followed immediately by the object's initial value. */ | |
0c20a65f | 246 | extern const char *integer_asm_op (int, int); |
301d03af | 247 | |
301d03af RS |
248 | /* Use directive OP to assemble an integer object X. Print OP at the |
249 | start of the line, followed immediately by the value of X. */ | |
0c20a65f | 250 | extern void assemble_integer_with_op (const char *, rtx); |
301d03af RS |
251 | |
252 | /* The default implementation of the asm_out.integer target hook. */ | |
0c20a65f | 253 | extern bool default_assemble_integer (rtx, unsigned int, int); |
301d03af | 254 | |
c8af3574 RH |
255 | /* Assemble the integer constant X into an object of SIZE bytes. ALIGN is |
256 | the alignment of the integer in bits. Return 1 if we were able to output | |
0e61db61 NS |
257 | the constant, otherwise 0. If FORCE is nonzero the constant must |
258 | be outputable. */ | |
0c20a65f | 259 | extern bool assemble_integer (rtx, unsigned, unsigned, int); |
301d03af RS |
260 | |
261 | /* An interface to assemble_integer for the common case in which a value is | |
262 | fully aligned and must be printed. VALUE is the value of the integer | |
263 | object and SIZE is the number of bytes it contains. */ | |
264 | #define assemble_aligned_integer(SIZE, VALUE) \ | |
265 | assemble_integer (VALUE, SIZE, (SIZE) * BITS_PER_UNIT, 1) | |
ed068cf5 | 266 | |
e2500fed | 267 | #ifdef REAL_VALUE_TYPE_SIZE |
ed068cf5 | 268 | /* Assemble the floating-point constant D into an object of size MODE. */ |
0c20a65f | 269 | extern void assemble_real (REAL_VALUE_TYPE, enum machine_mode, unsigned); |
ed068cf5 | 270 | #endif |
ed068cf5 | 271 | |
ed068cf5 | 272 | /* Return the size of the constant pool. */ |
0c20a65f | 273 | extern int get_pool_size (void); |
ed068cf5 | 274 | |
36f0e0a6 | 275 | #ifdef HAVE_peephole |
0c20a65f | 276 | extern rtx peephole (rtx); |
36f0e0a6 KG |
277 | #endif |
278 | ||
1d3dbd99 | 279 | extern void output_shared_constant_pool (void); |
ed068cf5 | 280 | |
aacd3885 RS |
281 | extern void output_object_blocks (void); |
282 | ||
fe24d485 OH |
283 | /* Whether a constructor CTOR is a valid static constant initializer if all |
284 | its elements are. This used to be internal to initializer_constant_valid_p | |
285 | and has been exposed to let other functions like categorize_ctor_elements | |
286 | evaluate the property while walking a constructor for other purposes. */ | |
287 | ||
288 | extern bool constructor_static_from_elts_p (tree); | |
289 | ||
14a774a9 RK |
290 | /* Return nonzero if VALUE is a valid constant-valued expression |
291 | for use in initializing a static variable; one that can be an | |
292 | element of a "constant" initializer. | |
293 | ||
294 | Return null_pointer_node if the value is absolute; | |
295 | if it is relocatable, return the variable that determines the relocation. | |
296 | We assume that VALUE has been folded as much as possible; | |
297 | therefore, we do not need to check for such things as | |
298 | arithmetic-combinations of integers. */ | |
0c20a65f | 299 | extern tree initializer_constant_valid_p (tree, tree); |
14a774a9 | 300 | |
ed068cf5 RK |
301 | /* Output assembler code for constant EXP to FILE, with no label. |
302 | This includes the pseudo-op such as ".int" or ".byte", and a newline. | |
303 | Assumes output_addressed_constants has been done on EXP already. | |
304 | ||
305 | Generate exactly SIZE bytes of assembler data, padding at the end | |
c8af3574 RH |
306 | with zeros if necessary. SIZE must always be specified. |
307 | ||
308 | ALIGN is the alignment in bits that may be assumed for the data. */ | |
0c20a65f | 309 | extern void output_constant (tree, unsigned HOST_WIDE_INT, unsigned int); |
aaff8ce0 | 310 | |
0c2768fc RS |
311 | /* When outputting delayed branch sequences, this rtx holds the |
312 | sequence being output. It is null when no delayed branch | |
313 | sequence is being output, so it can be used as a test in the | |
314 | insn output code. | |
315 | ||
316 | This variable is defined in final.c. */ | |
317 | extern rtx final_sequence; | |
318 | ||
f4dc8d96 NB |
319 | /* The line number of the beginning of the current function. Various |
320 | md code needs this so that it can output relative linenumbers. */ | |
321 | ||
322 | #ifdef SDB_DEBUGGING_INFO /* Avoid undef sym in certain broken linkers. */ | |
323 | extern int sdb_begin_function_line; | |
324 | #endif | |
325 | ||
49ad7cfa | 326 | /* File in which assembler code is being written. */ |
0c2768fc | 327 | |
49ad7cfa BS |
328 | #ifdef BUFSIZ |
329 | extern FILE *asm_out_file; | |
330 | #endif | |
3b304f5b ZW |
331 | |
332 | /* The first global object in the file. */ | |
333 | extern const char *first_global_object_name; | |
334 | ||
335 | /* The first weak object in the file. */ | |
336 | extern const char *weak_global_object_name; | |
337 | ||
54ff41b7 JW |
338 | /* Nonzero if function being compiled doesn't contain any calls |
339 | (ignoring the prologue and epilogue). This is set prior to | |
340 | local register allocation and is valid for the remaining | |
2ba84f36 | 341 | compiler passes. */ |
54ff41b7 JW |
342 | |
343 | extern int current_function_is_leaf; | |
344 | ||
fdb8a883 JW |
345 | /* Nonzero if function being compiled doesn't modify the stack pointer |
346 | (ignoring the prologue and epilogue). This is only valid after | |
2ba84f36 | 347 | life_analysis has run. */ |
fdb8a883 JW |
348 | |
349 | extern int current_function_sp_is_unchanging; | |
350 | ||
54ff41b7 JW |
351 | /* Nonzero if the function being compiled is a leaf function which only |
352 | uses leaf registers. This is valid after reload (specifically after | |
353 | sched2) and is useful only if the port defines LEAF_REGISTERS. */ | |
354 | ||
355 | extern int current_function_uses_only_leaf_regs; | |
356 | ||
a86d864c RH |
357 | /* Default file in which to dump debug output. */ |
358 | ||
359 | #ifdef BUFSIZ | |
c263766c | 360 | extern FILE *dump_file; |
a86d864c RH |
361 | #endif |
362 | ||
afe48e06 | 363 | /* Nonnull if the insn currently being emitted was a COND_EXEC pattern. */ |
bcda12f4 | 364 | extern rtx current_insn_predicate; |
afe48e06 | 365 | |
b1a9f6a0 | 366 | /* Last insn processed by final_scan_insn. */ |
bcda12f4 | 367 | extern rtx current_output_insn; |
b1a9f6a0 | 368 | |
c8b94768 | 369 | /* Nonzero while outputting an `asm' with operands. |
0e61db61 | 370 | This means that inconsistencies are the user's fault, so don't die. |
c8b94768 RH |
371 | The precise value is the insn being output, to pass to error_for_asm. */ |
372 | extern rtx this_is_asm_operands; | |
373 | ||
f6db1481 RH |
374 | /* Carry information from ASM_DECLARE_OBJECT_NAME |
375 | to ASM_FINISH_DECLARE_OBJECT. */ | |
376 | extern int size_directive_output; | |
377 | extern tree last_assemble_variable_decl; | |
378 | ||
87c8b4be CT |
379 | extern bool first_function_block_is_cold; |
380 | ||
4e4d733e L |
381 | /* Decide whether DECL needs to be in a writable section. |
382 | RELOC is the same as for SELECT_SECTION. */ | |
0c20a65f AJ |
383 | extern bool decl_readonly_section (tree, int); |
384 | extern bool decl_readonly_section_1 (tree, int, int); | |
19283265 | 385 | |
b2218cc1 AO |
386 | /* This can be used to compute RELOC for the function above, when |
387 | given a constant expression. */ | |
388 | extern int compute_reloc_for_constant (tree); | |
389 | ||
19283265 | 390 | /* User label prefix in effect for this compilation. */ |
87e11268 | 391 | extern const char *user_label_prefix; |
98577d03 | 392 | |
08c148a8 | 393 | /* Default target function prologue and epilogue assembler output. */ |
0c20a65f | 394 | extern void default_function_pro_epilogue (FILE *, HOST_WIDE_INT); |
b4c25db2 NB |
395 | |
396 | /* Default target hook that outputs nothing to a stream. */ | |
0c20a65f | 397 | extern void no_asm_to_stream (FILE *); |
7c262518 | 398 | |
d55d8fc7 | 399 | /* Flags controlling properties of a section. */ |
201556f0 JJ |
400 | #define SECTION_ENTSIZE 0x000ff /* entity size in section */ |
401 | #define SECTION_CODE 0x00100 /* contains code */ | |
402 | #define SECTION_WRITE 0x00200 /* data is writable */ | |
403 | #define SECTION_DEBUG 0x00400 /* contains debug data */ | |
404 | #define SECTION_LINKONCE 0x00800 /* is linkonce */ | |
405 | #define SECTION_SMALL 0x01000 /* contains "small data" */ | |
406 | #define SECTION_BSS 0x02000 /* contains zeros only */ | |
407 | #define SECTION_FORGET 0x04000 /* forget that we've entered the section */ | |
408 | #define SECTION_MERGE 0x08000 /* contains mergeable data */ | |
409 | #define SECTION_STRINGS 0x10000 /* contains zero terminated strings without | |
410 | embedded zeros */ | |
10c45943 | 411 | #define SECTION_OVERRIDE 0x20000 /* allow override of default flags */ |
3d78f2e9 | 412 | #define SECTION_TLS 0x40000 /* contains thread-local storage */ |
6a0a6ac4 | 413 | #define SECTION_NOTYPE 0x80000 /* don't output @progbits */ |
d6b5193b | 414 | #define SECTION_DECLARED 0x100000 /* section has been used */ |
434aeebb RS |
415 | #define SECTION_STYLE_MASK 0x600000 /* bits used for SECTION_STYLE */ |
416 | #define SECTION_COMMON 0x800000 /* contains common data */ | |
417 | #define SECTION_MACH_DEP 0x1000000 /* subsequent bits reserved for target */ | |
418 | ||
419 | /* This SECTION_STYLE is used for unnamed sections that we can switch | |
420 | to using a special assembler directive. */ | |
421 | #define SECTION_UNNAMED 0x000000 | |
422 | ||
423 | /* This SECTION_STYLE is used for named sections that we can switch | |
424 | to using a general section directive. */ | |
425 | #define SECTION_NAMED 0x200000 | |
426 | ||
427 | /* This SECTION_STYLE is used for sections that we cannot switch to at | |
428 | all. The choice of section is implied by the directive that we use | |
429 | to declare the object. */ | |
430 | #define SECTION_NOSWITCH 0x400000 | |
7c262518 | 431 | |
7dcbf659 JH |
432 | /* A helper function for default_elf_select_section and |
433 | default_elf_unique_section. Categorizes the DECL. */ | |
434 | ||
435 | enum section_category | |
436 | { | |
437 | SECCAT_TEXT, | |
438 | ||
439 | SECCAT_RODATA, | |
440 | SECCAT_RODATA_MERGE_STR, | |
441 | SECCAT_RODATA_MERGE_STR_INIT, | |
442 | SECCAT_RODATA_MERGE_CONST, | |
443 | SECCAT_SRODATA, | |
444 | ||
445 | SECCAT_DATA, | |
446 | ||
447 | /* To optimize loading of shared programs, define following subsections | |
448 | of data section: | |
449 | _REL Contains data that has relocations, so they get grouped | |
450 | together and dynamic linker will visit fewer pages in memory. | |
451 | _RO Contains data that is otherwise read-only. This is useful | |
452 | with prelinking as most relocations won't be dynamically | |
453 | linked and thus stay read only. | |
454 | _LOCAL Marks data containing relocations only to local objects. | |
455 | These relocations will get fully resolved by prelinking. */ | |
456 | SECCAT_DATA_REL, | |
457 | SECCAT_DATA_REL_LOCAL, | |
458 | SECCAT_DATA_REL_RO, | |
459 | SECCAT_DATA_REL_RO_LOCAL, | |
460 | ||
461 | SECCAT_SDATA, | |
462 | SECCAT_TDATA, | |
463 | ||
464 | SECCAT_BSS, | |
465 | SECCAT_SBSS, | |
466 | SECCAT_TBSS | |
467 | }; | |
468 | ||
d6b5193b RS |
469 | /* Information that is provided by all instances of the section type. */ |
470 | struct section_common GTY(()) { | |
471 | /* The set of SECTION_* flags that apply to this section. */ | |
472 | unsigned int flags; | |
473 | }; | |
474 | ||
434aeebb | 475 | /* Information about a SECTION_NAMED section. */ |
d6b5193b RS |
476 | struct named_section GTY(()) { |
477 | struct section_common common; | |
478 | ||
479 | /* The name of the section. */ | |
480 | const char *name; | |
481 | ||
482 | /* If nonnull, the VAR_DECL or FUNCTION_DECL with which the | |
483 | section is associated. */ | |
484 | tree decl; | |
485 | }; | |
486 | ||
487 | /* A callback that writes the assembly code for switching to an unnamed | |
488 | section. The argument provides callback-specific data. */ | |
489 | typedef void (*unnamed_section_callback) (const void *); | |
490 | ||
434aeebb | 491 | /* Information about a SECTION_UNNAMED section. */ |
d6b5193b RS |
492 | struct unnamed_section GTY(()) { |
493 | struct section_common common; | |
494 | ||
495 | /* The callback used to switch to the section, and the data that | |
496 | should be passed to the callback. */ | |
497 | unnamed_section_callback GTY ((skip)) callback; | |
498 | const void *GTY ((skip)) data; | |
499 | ||
500 | /* The next entry in the chain of unnamed sections. */ | |
501 | section *next; | |
502 | }; | |
503 | ||
434aeebb RS |
504 | /* A callback that writes the assembly code for a decl in a |
505 | SECTION_NOSWITCH section. DECL is the decl that should be assembled | |
506 | and NAME is the name of its SYMBOL_REF. SIZE is the size of the decl | |
507 | in bytes and ROUNDED is that size rounded up to the next | |
508 | BIGGEST_ALIGNMENT / BITS_PER_UNIT boundary. | |
509 | ||
510 | Return true if the callback used DECL_ALIGN to set the object's | |
511 | alignment. A false return value implies that we are relying | |
512 | on the rounded size to align the decl. */ | |
513 | typedef bool (*noswitch_section_callback) (tree decl, const char *name, | |
514 | unsigned HOST_WIDE_INT size, | |
515 | unsigned HOST_WIDE_INT rounded); | |
516 | ||
517 | /* Information about a SECTION_NOSWITCH section. */ | |
518 | struct noswitch_section GTY(()) { | |
519 | struct section_common common; | |
520 | ||
521 | /* The callback used to assemble decls in this section. */ | |
522 | noswitch_section_callback GTY ((skip)) callback; | |
523 | }; | |
524 | ||
d6b5193b | 525 | /* Information about a section, which may be named or unnamed. */ |
434aeebb | 526 | union section GTY ((desc ("SECTION_STYLE (&(%h))"))) |
d6b5193b RS |
527 | { |
528 | struct section_common GTY ((skip)) common; | |
529 | struct named_section GTY ((tag ("SECTION_NAMED"))) named; | |
434aeebb RS |
530 | struct unnamed_section GTY ((tag ("SECTION_UNNAMED"))) unnamed; |
531 | struct noswitch_section GTY ((tag ("SECTION_NOSWITCH"))) noswitch; | |
d6b5193b RS |
532 | }; |
533 | ||
434aeebb RS |
534 | /* Return the style of section SECT. */ |
535 | #define SECTION_STYLE(SECT) ((SECT)->common.flags & SECTION_STYLE_MASK) | |
536 | ||
aacd3885 RS |
537 | struct object_block; |
538 | ||
d6b5193b RS |
539 | /* Special well-known sections. */ |
540 | extern GTY(()) section *text_section; | |
541 | extern GTY(()) section *data_section; | |
542 | extern GTY(()) section *readonly_data_section; | |
543 | extern GTY(()) section *sdata_section; | |
544 | extern GTY(()) section *ctors_section; | |
545 | extern GTY(()) section *dtors_section; | |
546 | extern GTY(()) section *bss_section; | |
547 | extern GTY(()) section *sbss_section; | |
d6b5193b RS |
548 | extern GTY(()) section *exception_section; |
549 | extern GTY(()) section *eh_frame_section; | |
434aeebb RS |
550 | extern GTY(()) section *tls_comm_section; |
551 | extern GTY(()) section *comm_section; | |
552 | extern GTY(()) section *lcomm_section; | |
553 | extern GTY(()) section *bss_noswitch_section; | |
d6b5193b RS |
554 | |
555 | extern GTY(()) section *in_section; | |
c543ca49 | 556 | extern GTY(()) bool in_cold_section_p; |
d6b5193b RS |
557 | |
558 | extern section *get_unnamed_section (unsigned int, void (*) (const void *), | |
559 | const void *); | |
560 | extern section *get_section (const char *, unsigned int, tree); | |
561 | extern section *get_named_section (tree, const char *, int); | |
aacd3885 RS |
562 | extern void place_block_symbol (rtx); |
563 | extern rtx get_section_anchor (struct object_block *, HOST_WIDE_INT, | |
564 | enum tls_model); | |
d6b5193b RS |
565 | extern section *mergeable_constant_section (enum machine_mode, |
566 | unsigned HOST_WIDE_INT, | |
567 | unsigned int); | |
568 | extern section *function_section (tree); | |
569 | extern section *unlikely_text_section (void); | |
570 | extern section *current_function_section (void); | |
571 | ||
572 | extern bool unlikely_text_section_p (section *); | |
573 | extern void switch_to_section (section *); | |
574 | extern void output_section_asm_op (const void *); | |
7dcbf659 | 575 | |
bcda12f4 SB |
576 | extern unsigned int default_section_type_flags (tree, const char *, int); |
577 | extern unsigned int default_section_type_flags_1 (tree, const char *, int, int); | |
0c20a65f | 578 | |
434aeebb | 579 | extern bool have_global_bss_p (void); |
c18a5b6c MM |
580 | extern void default_no_named_section (const char *, unsigned int, tree); |
581 | extern void default_elf_asm_named_section (const char *, unsigned int, tree); | |
7dcbf659 | 582 | extern enum section_category categorize_decl_for_section (tree, int, int); |
c18a5b6c MM |
583 | extern void default_coff_asm_named_section (const char *, unsigned int, tree); |
584 | extern void default_pe_asm_named_section (const char *, unsigned int, tree); | |
0c20a65f | 585 | |
bcda12f4 SB |
586 | extern void default_stabs_asm_out_destructor (rtx, int); |
587 | extern void default_named_section_asm_out_destructor (rtx, int); | |
588 | extern void default_dtor_section_asm_out_destructor (rtx, int); | |
589 | extern void default_stabs_asm_out_constructor (rtx, int); | |
590 | extern void default_named_section_asm_out_constructor (rtx, int); | |
591 | extern void default_ctor_section_asm_out_constructor (rtx, int); | |
0c20a65f | 592 | |
d6b5193b RS |
593 | extern section *default_select_section (tree, int, |
594 | unsigned HOST_WIDE_INT); | |
595 | extern section *default_elf_select_section (tree, int, | |
596 | unsigned HOST_WIDE_INT); | |
597 | extern section *default_elf_select_section_1 (tree, int, | |
598 | unsigned HOST_WIDE_INT, | |
599 | int); | |
0c20a65f AJ |
600 | extern void default_unique_section (tree, int); |
601 | extern void default_unique_section_1 (tree, int, int); | |
d6b5193b RS |
602 | extern section *default_function_rodata_section (tree); |
603 | extern section *default_no_function_rodata_section (tree); | |
604 | extern section *default_select_rtx_section (enum machine_mode, rtx, | |
0c20a65f | 605 | unsigned HOST_WIDE_INT); |
d6b5193b RS |
606 | extern section *default_elf_select_rtx_section (enum machine_mode, rtx, |
607 | unsigned HOST_WIDE_INT); | |
0c20a65f AJ |
608 | extern void default_encode_section_info (tree, rtx, int); |
609 | extern const char *default_strip_name_encoding (const char *); | |
aacd3885 RS |
610 | extern void default_asm_output_anchor (rtx); |
611 | extern bool default_use_anchors_for_symbol_p (rtx); | |
0c20a65f AJ |
612 | extern bool default_binds_local_p (tree); |
613 | extern bool default_binds_local_p_1 (tree, int); | |
614 | extern void default_globalize_label (FILE *, const char *); | |
eeab4d81 | 615 | extern void default_emit_unwind_label (FILE *, tree, int, int); |
083cad55 | 616 | extern void default_emit_except_table_label (FILE *); |
0c20a65f AJ |
617 | extern void default_internal_label (FILE *, const char *, unsigned long); |
618 | extern void default_file_start (void); | |
619 | extern void file_end_indicate_exec_stack (void); | |
620 | extern bool default_valid_pointer_mode (enum machine_mode); | |
772c5265 | 621 | |
c47c29c8 L |
622 | extern void default_elf_asm_output_external (FILE *file, tree, |
623 | const char *); | |
624 | extern int maybe_assemble_visibility (tree); | |
625 | ||
0c20a65f | 626 | extern int default_address_cost (rtx); |
e91e4f6c | 627 | |
93a27b7b ZW |
628 | /* dbxout helper functions */ |
629 | #if defined DBX_DEBUGGING_INFO || defined XCOFF_DEBUGGING_INFO | |
630 | ||
631 | extern void dbxout_int (int); | |
632 | extern void dbxout_stabd (int, int); | |
633 | extern void dbxout_begin_stabn (int); | |
634 | extern void dbxout_begin_stabn_sline (int); | |
635 | extern void dbxout_begin_empty_stabs (int); | |
636 | extern void dbxout_begin_simple_stabs (const char *, int); | |
637 | extern void dbxout_begin_simple_stabs_desc (const char *, int, int); | |
638 | ||
639 | extern void dbxout_stab_value_zero (void); | |
640 | extern void dbxout_stab_value_label (const char *); | |
641 | extern void dbxout_stab_value_label_diff (const char *, const char *); | |
642 | extern void dbxout_stab_value_internal_label (const char *, int *); | |
643 | extern void dbxout_stab_value_internal_label_diff (const char *, int *, | |
644 | const char *); | |
645 | ||
646 | #endif | |
647 | ||
e91e4f6c | 648 | #endif /* ! GCC_OUTPUT_H */ |