* invoke.texi: Add more options to summary list.
[official-gcc.git] / gcc / defaults.h
blob452bdfe44cd32982fa98b4caf287b9eadabfa7c1
1 /* Definitions of various defaults for tm.h macros.
2 Copyright (C) 1992, 1996, 1997, 1998, 1999, 2000, 2001
3 Free Software Foundation, Inc.
4 Contributed by Ron Guilmette (rfg@monkeys.com)
6 This file is part of GNU CC.
8 GNU CC is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 2, or (at your option)
11 any later version.
13 GNU CC is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with GNU CC; see the file COPYING. If not, write to
20 the Free Software Foundation, 59 Temple Place - Suite 330,
21 Boston, MA 02111-1307, USA. */
23 #ifndef GCC_DEFAULTS_H
24 #define GCC_DEFAULTS_H
26 /* Store in OUTPUT a string (made with alloca) containing
27 an assembler-name for a local static variable or function named NAME.
28 LABELNO is an integer which is different for each call. */
30 #ifndef ASM_FORMAT_PRIVATE_NAME
31 #define ASM_FORMAT_PRIVATE_NAME(OUTPUT, NAME, LABELNO) \
32 do { \
33 int len = strlen (NAME); \
34 char *temp = (char *) alloca (len + 3); \
35 temp[0] = 'L'; \
36 strcpy (&temp[1], (NAME)); \
37 temp[len + 1] = '.'; \
38 temp[len + 2] = 0; \
39 (OUTPUT) = (char *) alloca (strlen (NAME) + 11); \
40 ASM_GENERATE_INTERNAL_LABEL (OUTPUT, temp, LABELNO); \
41 } while (0)
42 #endif
44 #ifndef ASM_STABD_OP
45 #define ASM_STABD_OP "\t.stabd\t"
46 #endif
48 /* This is how to output an element of a case-vector that is absolute.
49 Some targets don't use this, but we have to define it anyway. */
51 #ifndef ASM_OUTPUT_ADDR_VEC_ELT
52 #define ASM_OUTPUT_ADDR_VEC_ELT(FILE, VALUE) \
53 do { fprintf (FILE, "\t%s\t", ASM_LONG); \
54 ASM_OUTPUT_INTERNAL_LABEL (FILE, "L", (VALUE)); \
55 fputc ('\n', FILE); \
56 } while (0)
57 #endif
59 /* Provide default for ASM_OUTPUT_ALTERNATE_LABEL_NAME. */
60 #ifndef ASM_OUTPUT_ALTERNATE_LABEL_NAME
61 #define ASM_OUTPUT_ALTERNATE_LABEL_NAME(FILE,INSN) \
62 do { ASM_OUTPUT_LABEL(FILE,LABEL_ALTERNATE_NAME (INSN)); } while (0)
63 #endif
65 /* choose a reasonable default for ASM_OUTPUT_ASCII. */
67 #ifndef ASM_OUTPUT_ASCII
68 #define ASM_OUTPUT_ASCII(MYFILE, MYSTRING, MYLENGTH) \
69 do { \
70 FILE *_hide_asm_out_file = (MYFILE); \
71 const unsigned char *_hide_p = (const unsigned char *) (MYSTRING); \
72 int _hide_thissize = (MYLENGTH); \
73 { \
74 FILE *asm_out_file = _hide_asm_out_file; \
75 const unsigned char *p = _hide_p; \
76 int thissize = _hide_thissize; \
77 int i; \
78 fprintf (asm_out_file, "\t.ascii \""); \
80 for (i = 0; i < thissize; i++) \
81 { \
82 register int c = p[i]; \
83 if (c == '\"' || c == '\\') \
84 putc ('\\', asm_out_file); \
85 if (ISPRINT(c)) \
86 putc (c, asm_out_file); \
87 else \
88 { \
89 fprintf (asm_out_file, "\\%o", c); \
90 /* After an octal-escape, if a digit follows, \
91 terminate one string constant and start another. \
92 The Vax assembler fails to stop reading the escape \
93 after three digits, so this is the only way we \
94 can get it to parse the data properly. */ \
95 if (i < thissize - 1 && ISDIGIT(p[i + 1])) \
96 fprintf (asm_out_file, "\"\n\t.ascii \""); \
97 } \
98 } \
99 fprintf (asm_out_file, "\"\n"); \
102 while (0)
103 #endif
105 /* This is how we tell the assembler to equate two values. */
106 #ifdef SET_ASM_OP
107 #ifndef ASM_OUTPUT_DEF
108 #define ASM_OUTPUT_DEF(FILE,LABEL1,LABEL2) \
109 do { fprintf ((FILE), "%s", SET_ASM_OP); \
110 assemble_name (FILE, LABEL1); \
111 fprintf (FILE, ","); \
112 assemble_name (FILE, LABEL2); \
113 fprintf (FILE, "\n"); \
114 } while (0)
115 #endif
116 #endif
118 /* This is how to output a reference to a user-level label named NAME. */
120 #ifndef ASM_OUTPUT_LABELREF
121 #define ASM_OUTPUT_LABELREF(FILE,NAME) asm_fprintf ((FILE), "%U%s", (NAME))
122 #endif
124 /* Allow target to print debug info labels specially. This is useful for
125 VLIW targets, since debug info labels should go into the middle of
126 instruction bundles instead of breaking them. */
128 #ifndef ASM_OUTPUT_DEBUG_LABEL
129 #define ASM_OUTPUT_DEBUG_LABEL(FILE, PREFIX, NUM) \
130 ASM_OUTPUT_INTERNAL_LABEL (FILE, PREFIX, NUM)
131 #endif
133 /* This determines whether or not we support weak symbols. */
134 #ifndef SUPPORTS_WEAK
135 #ifdef ASM_WEAKEN_LABEL
136 #define SUPPORTS_WEAK 1
137 #else
138 #define SUPPORTS_WEAK 0
139 #endif
140 #endif
142 /* This determines whether or not we support link-once semantics. */
143 #ifndef SUPPORTS_ONE_ONLY
144 #ifdef MAKE_DECL_ONE_ONLY
145 #define SUPPORTS_ONE_ONLY 1
146 #else
147 #define SUPPORTS_ONE_ONLY 0
148 #endif
149 #endif
151 /* If the target supports weak symbols, define TARGET_ATTRIBUTE_WEAK to
152 provide a weak attribute. Else define it to nothing.
154 This would normally belong in ansidecl.h, but SUPPORTS_WEAK is
155 not available at that time.
157 Note, this is only for use by target files which we know are to be
158 compiled by GCC. */
159 #ifndef TARGET_ATTRIBUTE_WEAK
160 # if SUPPORTS_WEAK
161 # define TARGET_ATTRIBUTE_WEAK __attribute__ ((weak))
162 # else
163 # define TARGET_ATTRIBUTE_WEAK
164 # endif
165 #endif
167 /* If the target supports init_priority C++ attribute, give
168 SUPPORTS_INIT_PRIORITY a nonzero value. */
169 #ifndef SUPPORTS_INIT_PRIORITY
170 #define SUPPORTS_INIT_PRIORITY 1
171 #endif /* SUPPORTS_INIT_PRIORITY */
173 /* If duplicate library search directories can be removed from a
174 linker command without changing the linker's semantics, give this
175 symbol a nonzero. */
176 #ifndef LINK_ELIMINATE_DUPLICATE_LDIRECTORIES
177 #define LINK_ELIMINATE_DUPLICATE_LDIRECTORIES 0
178 #endif /* LINK_ELIMINATE_DUPLICATE_LDIRECTORIES */
180 /* If we have a definition of INCOMING_RETURN_ADDR_RTX, assume that
181 the rest of the DWARF 2 frame unwind support is also provided. */
182 #if !defined (DWARF2_UNWIND_INFO) && defined (INCOMING_RETURN_ADDR_RTX)
183 #define DWARF2_UNWIND_INFO 1
184 #endif
186 #if defined (DWARF2_UNWIND_INFO) && !defined (EH_FRAME_SECTION)
187 # if defined (EH_FRAME_SECTION_ASM_OP)
188 # define EH_FRAME_SECTION() eh_frame_section ()
189 # else
190 /* If we aren't using crtstuff to run ctors, don't use it for EH. */
191 # if defined (ASM_OUTPUT_SECTION_NAME) && defined (ASM_OUTPUT_CONSTRUCTOR)
192 # define EH_FRAME_SECTION_ASM_OP "\t.section\t.eh_frame,\"aw\""
193 # define EH_FRAME_SECTION() \
194 do { named_section (NULL_TREE, ".eh_frame", 0); } while (0)
195 # endif
196 # endif
197 #endif
199 /* If we have no definition for UNIQUE_SECTION, but do have the
200 ability to generate arbitrary sections, construct something
201 reasonable. */
202 #ifdef ASM_OUTPUT_SECTION_NAME
203 #ifndef UNIQUE_SECTION
204 #define UNIQUE_SECTION(DECL,RELOC) \
205 do { \
206 int len; \
207 const char *name; \
208 char *string; \
210 name = IDENTIFIER_POINTER (DECL_ASSEMBLER_NAME (DECL)); \
211 /* Strip off any encoding in name. */ \
212 STRIP_NAME_ENCODING (name, name); \
214 len = strlen (name) + 1; \
215 string = alloca (len + 1); \
216 sprintf (string, ".%s", name); \
218 DECL_SECTION_NAME (DECL) = build_string (len, string); \
219 } while (0)
220 #endif
221 #ifndef UNIQUE_SECTION_P
222 #define UNIQUE_SECTION_P(DECL) 0
223 #endif
224 #endif
226 /* By default, we generate a label at the beginning and end of the
227 text section, and compute the size of the text section by
228 subtracting the two. However, on some platforms that doesn't
229 work, and we use the section itself, rather than a label at the
230 beginning of it, to indicate the start of the section. On such
231 platforms, define this to zero. */
232 #ifndef DWARF2_GENERATE_TEXT_SECTION_LABEL
233 #define DWARF2_GENERATE_TEXT_SECTION_LABEL 1
234 #endif
236 /* Supply a default definition for PROMOTE_PROTOTYPES. */
237 #ifndef PROMOTE_PROTOTYPES
238 #define PROMOTE_PROTOTYPES 0
239 #endif
241 /* Number of hardware registers that go into the DWARF-2 unwind info.
242 If not defined, equals FIRST_PSEUDO_REGISTER */
244 #ifndef DWARF_FRAME_REGISTERS
245 #define DWARF_FRAME_REGISTERS FIRST_PSEUDO_REGISTER
246 #endif
248 /* Default sizes for base C types. If the sizes are different for
249 your target, you should override these values by defining the
250 appropriate symbols in your tm.h file. */
252 #ifndef CHAR_TYPE_SIZE
253 #define CHAR_TYPE_SIZE BITS_PER_UNIT
254 #endif
256 #ifndef SHORT_TYPE_SIZE
257 #define SHORT_TYPE_SIZE (BITS_PER_UNIT * MIN ((UNITS_PER_WORD + 1) / 2, 2))
258 #endif
260 #ifndef INT_TYPE_SIZE
261 #define INT_TYPE_SIZE BITS_PER_WORD
262 #endif
264 #ifndef LONG_TYPE_SIZE
265 #define LONG_TYPE_SIZE BITS_PER_WORD
266 #endif
268 #ifndef LONG_LONG_TYPE_SIZE
269 #define LONG_LONG_TYPE_SIZE (BITS_PER_WORD * 2)
270 #endif
272 #ifndef WCHAR_TYPE_SIZE
273 #define WCHAR_TYPE_SIZE INT_TYPE_SIZE
274 #endif
276 #ifndef WCHAR_UNSIGNED
277 #define WCHAR_UNSIGNED 0
278 #endif
280 #ifndef FLOAT_TYPE_SIZE
281 #define FLOAT_TYPE_SIZE BITS_PER_WORD
282 #endif
284 #ifndef DOUBLE_TYPE_SIZE
285 #define DOUBLE_TYPE_SIZE (BITS_PER_WORD * 2)
286 #endif
288 #ifndef LONG_DOUBLE_TYPE_SIZE
289 #define LONG_DOUBLE_TYPE_SIZE (BITS_PER_WORD * 2)
290 #endif
292 #ifndef BUILD_VA_LIST_TYPE
293 #define BUILD_VA_LIST_TYPE(X) ((X) = ptr_type_node)
294 #endif
296 #ifndef PIC_OFFSET_TABLE_REGNUM
297 #define PIC_OFFSET_TABLE_REGNUM INVALID_REGNUM
298 #endif
300 /* By default, the preprocessor should be invoked the same way in C++
301 as in C. */
302 #ifndef CPLUSPLUS_CPP_SPEC
303 #ifdef CPP_SPEC
304 #define CPLUSPLUS_CPP_SPEC CPP_SPEC
305 #endif
306 #endif
308 #ifndef ACCUMULATE_OUTGOING_ARGS
309 #define ACCUMULATE_OUTGOING_ARGS 0
310 #endif
312 /* Supply a default definition for PUSH_ARGS. */
313 #ifndef PUSH_ARGS
314 #ifdef PUSH_ROUNDING
315 #define PUSH_ARGS !ACCUMULATE_OUTGOING_ARGS
316 #else
317 #define PUSH_ARGS 0
318 #endif
319 #endif
321 /* Select a format to encode pointers in exception handling data. We
322 prefer those that result in fewer dynamic relocations. Assume no
323 special support here and encode direct references. */
324 #ifndef ASM_PREFERRED_EH_DATA_FORMAT
325 #define ASM_PREFERRED_EH_DATA_FORMAT(CODE,GLOBAL) DW_EH_PE_absptr
326 #endif
328 /* By default, the C++ compiler will use the lowest bit of the pointer
329 to function to indicate a pointer-to-member-function points to a
330 virtual member function. However, if FUNCTION_BOUNDARY indicates
331 function addresses aren't always even, the lowest bit of the delta
332 field will be used. */
333 #ifndef TARGET_PTRMEMFUNC_VBIT_LOCATION
334 #define TARGET_PTRMEMFUNC_VBIT_LOCATION \
335 (FUNCTION_BOUNDARY >= 2 * BITS_PER_UNIT \
336 ? ptrmemfunc_vbit_in_pfn : ptrmemfunc_vbit_in_delta)
337 #endif
339 /* True if it is possible to profile code that does not have a frame
340 pointer. */
342 #ifndef TARGET_ALLOWS_PROFILING_WITHOUT_FRAME_POINTER
343 #define TARGET_ALLOWS_PROFILING_WITHOUT_FRAME_POINTER true
344 #endif
346 #endif /* GCC_DEFAULTS_H */