gcc/config/elfos.h

   1 /* elfos.h  --  operating system specific defines to be used when
   2    targeting GCC for some generic ELF system
   3    Copyright (C) 1991, 1994, 1995, 1999, 2000, 2001, 2002, 2003, 2004,
   4    2007, 2009, 2010 Free Software Foundation, Inc.
   5    Based on svr4.h contributed by Ron Guilmette (rfg@netcom.com).
   6
   7 This file is part of GCC.
   8
   9 GCC is free software; you can redistribute it and/or modify
  10 it under the terms of the GNU General Public License as published by
  11 the Free Software Foundation; either version 3, or (at your option)
  12 any later version.
  13
  14 GCC is distributed in the hope that it will be useful,
  15 but WITHOUT ANY WARRANTY; without even the implied warranty of
  16 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17 GNU General Public License for more details.
  18
  19 Under Section 7 of GPL version 3, you are granted additional
  20 permissions described in the GCC Runtime Library Exception, version
  21 3.1, as published by the Free Software Foundation.
  22
  23 You should have received a copy of the GNU General Public License and
  24 a copy of the GCC Runtime Library Exception along with this program;
  25 see the files COPYING3 and COPYING.RUNTIME respectively.  If not, see
  26 <http://www.gnu.org/licenses/>.  */
  27
  28 #define TARGET_OBJFMT_CPP_BUILTINS()            \
  29   do                                            \
  30     {                                           \
  31         builtin_define ("__ELF__");             \
  32     }                                           \
  33   while (0)
  34
  35 /* Define a symbol indicating that we are using elfos.h.
  36    Some CPU specific configuration files use this.  */
  37 #define USING_ELFOS_H
  38
  39 /* The prefix to add to user-visible assembler symbols.
  40
  41    For ELF systems the convention is *not* to prepend a leading
  42    underscore onto user-level symbol names.  */
  43
  44 #undef  USER_LABEL_PREFIX
  45 #define USER_LABEL_PREFIX ""
  46
  47 /* The biggest alignment supported by ELF in bits. 32-bit ELF
  48    supports section alignment up to (0x80000000 * 8), while
  49    64-bit ELF supports (0x8000000000000000 * 8). If this macro
  50    is not defined, the default is the largest alignment supported
  51    by 32-bit ELF and representable on a 32-bit host. Use this
  52    macro to limit the alignment which can be specified using
  53    the `__attribute__ ((aligned (N)))' construct.  */
  54 #ifndef MAX_OFILE_ALIGNMENT
  55 #define MAX_OFILE_ALIGNMENT (((unsigned int) 1 << 28) * 8)
  56 #endif
  57
  58 /* Use periods rather than dollar signs in special g++ assembler names.  */
  59
  60 #define NO_DOLLAR_IN_LABEL
  61
  62 /* Writing `int' for a bit-field forces int alignment for the structure.  */
  63
  64 #ifndef PCC_BITFIELD_TYPE_MATTERS
  65 #define PCC_BITFIELD_TYPE_MATTERS 1
  66 #endif
  67
  68 /* All ELF targets can support DWARF-2.  */
  69
  70 #define DWARF2_DEBUGGING_INFO 1
  71
  72 /* The GNU tools operate better with dwarf2, and it is required by some
  73    psABI's.  Since we don't have any native tools to be compatible with,
  74    default to dwarf2.  */
  75
  76 #ifndef PREFERRED_DEBUGGING_TYPE
  77 #define PREFERRED_DEBUGGING_TYPE DWARF2_DEBUG
  78 #endif
  79
  80 /* All SVR4 targets use the ELF object file format.  */
  81 #define OBJECT_FORMAT_ELF
  82
  83
  84 /* Output #ident as a .ident.  */
  85
  86 #define ASM_OUTPUT_IDENT(FILE, NAME) \
  87   fprintf (FILE, "%s\"%s\"\n", IDENT_ASM_OP, NAME);
  88
  89 #define IDENT_ASM_OP "\t.ident\t"
  90
  91 #undef  SET_ASM_OP
  92 #define SET_ASM_OP      "\t.set\t"
  93
  94 /* Most svr4 assemblers want a .file directive at the beginning of
  95    their input file.  */
  96 #define TARGET_ASM_FILE_START_FILE_DIRECTIVE true
  97
  98 /* This is how to allocate empty space in some section.  The .zero
  99    pseudo-op is used for this on most svr4 assemblers.  */
 100
 101 #define SKIP_ASM_OP     "\t.zero\t"
 102
 103 #undef  ASM_OUTPUT_SKIP
 104 #define ASM_OUTPUT_SKIP(FILE, SIZE) \
 105    fprintf ((FILE), "%s"HOST_WIDE_INT_PRINT_UNSIGNED"\n",\
 106             SKIP_ASM_OP, (SIZE))
 107
 108 /* This is how to store into the string LABEL
 109    the symbol_ref name of an internal numbered label where
 110    PREFIX is the class of label and NUM is the number within the class.
 111    This is suitable for output with `assemble_name'.
 112
 113    For most svr4 systems, the convention is that any symbol which begins
 114    with a period is not put into the linker symbol table by the assembler.  */
 115
 116 #undef  ASM_GENERATE_INTERNAL_LABEL
 117 #define ASM_GENERATE_INTERNAL_LABEL(LABEL, PREFIX, NUM)         \
 118   do                                                            \
 119     {                                                           \
 120       char *__p;                                                \
 121       (LABEL)[0] = '*';                                         \
 122       (LABEL)[1] = '.';                                         \
 123       __p = stpcpy (&(LABEL)[2], PREFIX);                       \
 124       sprint_ul (__p, (unsigned long) (NUM));                   \
 125     }                                                           \
 126   while (0)
 127
 128 #undef TARGET_ASM_INTERNAL_LABEL
 129 #define TARGET_ASM_INTERNAL_LABEL default_elf_internal_label
 130
 131 /* Output the label which precedes a jumptable.  Note that for all svr4
 132    systems where we actually generate jumptables (which is to say every
 133    svr4 target except i386, where we use casesi instead) we put the jump-
 134    tables into the .rodata section and since other stuff could have been
 135    put into the .rodata section prior to any given jumptable, we have to
 136    make sure that the location counter for the .rodata section gets pro-
 137    perly re-aligned prior to the actual beginning of the jump table.  */
 138
 139 #undef ALIGN_ASM_OP
 140 #define ALIGN_ASM_OP "\t.align\t"
 141
 142 #ifndef ASM_OUTPUT_BEFORE_CASE_LABEL
 143 #define ASM_OUTPUT_BEFORE_CASE_LABEL(FILE, PREFIX, NUM, TABLE) \
 144   ASM_OUTPUT_ALIGN ((FILE), 2);
 145 #endif
 146
 147 #undef  ASM_OUTPUT_CASE_LABEL
 148 #define ASM_OUTPUT_CASE_LABEL(FILE, PREFIX, NUM, JUMPTABLE)             \
 149   do                                                                    \
 150     {                                                                   \
 151       ASM_OUTPUT_BEFORE_CASE_LABEL (FILE, PREFIX, NUM, JUMPTABLE)       \
 152         (*targetm.asm_out.internal_label) (FILE, PREFIX, NUM);                  \
 153     }                                                                   \
 154   while (0)
 155
 156 /* The standard SVR4 assembler seems to require that certain builtin
 157    library routines (e.g. .udiv) be explicitly declared as .globl
 158    in each assembly file where they are referenced.  */
 159
 160 #define ASM_OUTPUT_EXTERNAL_LIBCALL(FILE, FUN)  \
 161   (*targetm.asm_out.globalize_label) (FILE, XSTR (FUN, 0))
 162
 163 /* This says how to output assembler code to declare an
 164    uninitialized external linkage data object.  Under SVR4,
 165    the linker seems to want the alignment of data objects
 166    to depend on their types.  We do exactly that here.  */
 167
 168 #define COMMON_ASM_OP   "\t.comm\t"
 169
 170 #undef  ASM_OUTPUT_ALIGNED_COMMON
 171 #define ASM_OUTPUT_ALIGNED_COMMON(FILE, NAME, SIZE, ALIGN)              \
 172   do                                                                    \
 173     {                                                                   \
 174       fprintf ((FILE), "%s", COMMON_ASM_OP);                            \
 175       assemble_name ((FILE), (NAME));                                   \
 176       fprintf ((FILE), ","HOST_WIDE_INT_PRINT_UNSIGNED",%u\n",          \
 177                (SIZE), (ALIGN) / BITS_PER_UNIT);                        \
 178     }                                                                   \
 179   while (0)
 180
 181 /* This says how to output assembler code to declare an
 182    uninitialized internal linkage data object.  Under SVR4,
 183    the linker seems to want the alignment of data objects
 184    to depend on their types.  We do exactly that here.  */
 185
 186 #define LOCAL_ASM_OP    "\t.local\t"
 187
 188 #undef  ASM_OUTPUT_ALIGNED_LOCAL
 189 #define ASM_OUTPUT_ALIGNED_LOCAL(FILE, NAME, SIZE, ALIGN)       \
 190   do                                                            \
 191     {                                                           \
 192       fprintf ((FILE), "%s", LOCAL_ASM_OP);                     \
 193       assemble_name ((FILE), (NAME));                           \
 194       fprintf ((FILE), "\n");                                   \
 195       ASM_OUTPUT_ALIGNED_COMMON (FILE, NAME, SIZE, ALIGN);      \
 196     }                                                           \
 197   while (0)
 198
 199 /* This is the pseudo-op used to generate a contiguous sequence of byte
 200    values from a double-quoted string WITHOUT HAVING A TERMINATING NUL
 201    AUTOMATICALLY APPENDED.  This is the same for most svr4 assemblers.  */
 202
 203 #undef  ASCII_DATA_ASM_OP
 204 #define ASCII_DATA_ASM_OP       "\t.ascii\t"
 205
 206 /* Support a read-only data section.  */
 207 #define READONLY_DATA_SECTION_ASM_OP    "\t.section\t.rodata"
 208
 209 /* On svr4, we *do* have support for the .init and .fini sections, and we
 210    can put stuff in there to be executed before and after `main'.  We let
 211    crtstuff.c and other files know this by defining the following symbols.
 212    The definitions say how to change sections to the .init and .fini
 213    sections.  This is the same for all known svr4 assemblers.  */
 214
 215 #define INIT_SECTION_ASM_OP     "\t.section\t.init"
 216 #define FINI_SECTION_ASM_OP     "\t.section\t.fini"
 217
 218 /* Output assembly directive to move to the beginning of current section.  */
 219 #ifdef HAVE_GAS_SUBSECTION_ORDERING
 220 # define ASM_SECTION_START_OP   "\t.subsection\t-1"
 221 # define ASM_OUTPUT_SECTION_START(FILE) \
 222   fprintf ((FILE), "%s\n", ASM_SECTION_START_OP)
 223 #endif
 224
 225 #define MAKE_DECL_ONE_ONLY(DECL) (DECL_WEAK (DECL) = 1)
 226
 227 /* Switch into a generic section.  */
 228 #define TARGET_ASM_NAMED_SECTION  default_elf_asm_named_section
 229
 230 #undef  TARGET_ASM_SELECT_RTX_SECTION
 231 #define TARGET_ASM_SELECT_RTX_SECTION default_elf_select_rtx_section
 232 #undef  TARGET_ASM_SELECT_SECTION
 233 #define TARGET_ASM_SELECT_SECTION default_elf_select_section
 234 #undef  TARGET_HAVE_SWITCHABLE_BSS_SECTIONS
 235 #define TARGET_HAVE_SWITCHABLE_BSS_SECTIONS true
 236
 237 /* Define the strings used for the special svr4 .type and .size directives.
 238    These strings generally do not vary from one system running svr4 to
 239    another, but if a given system (e.g. m88k running svr) needs to use
 240    different pseudo-op names for these, they may be overridden in the
 241    file which includes this one.  */
 242
 243 #define TYPE_ASM_OP     "\t.type\t"
 244 #define SIZE_ASM_OP     "\t.size\t"
 245
 246 /* This is how we tell the assembler that a symbol is weak.  */
 247
 248 #define ASM_WEAKEN_LABEL(FILE, NAME)    \
 249   do                                    \
 250     {                                   \
 251       fputs ("\t.weak\t", (FILE));      \
 252       assemble_name ((FILE), (NAME));   \
 253       fputc ('\n', (FILE));             \
 254     }                                   \
 255   while (0)
 256
 257 /* The following macro defines the format used to output the second
 258    operand of the .type assembler directive.  Different svr4 assemblers
 259    expect various different forms for this operand.  The one given here
 260    is just a default.  You may need to override it in your machine-
 261    specific tm.h file (depending upon the particulars of your assembler).  */
 262
 263 #define TYPE_OPERAND_FMT        "@%s"
 264
 265 /* Write the extra assembler code needed to declare a function's result.
 266    Most svr4 assemblers don't require any special declaration of the
 267    result value, but there are exceptions.  */
 268
 269 #ifndef ASM_DECLARE_RESULT
 270 #define ASM_DECLARE_RESULT(FILE, RESULT)
 271 #endif
 272
 273 /* These macros generate the special .type and .size directives which
 274    are used to set the corresponding fields of the linker symbol table
 275    entries in an ELF object file under SVR4.  These macros also output
 276    the starting labels for the relevant functions/objects.  */
 277
 278 /* Write the extra assembler code needed to declare a function properly.
 279    Some svr4 assemblers need to also have something extra said about the
 280    function's return value.  We allow for that here.  */
 281
 282 #ifndef ASM_DECLARE_FUNCTION_NAME
 283 #define ASM_DECLARE_FUNCTION_NAME(FILE, NAME, DECL)             \
 284   do                                                            \
 285     {                                                           \
 286       ASM_OUTPUT_TYPE_DIRECTIVE (FILE, NAME, "function");       \
 287       ASM_DECLARE_RESULT (FILE, DECL_RESULT (DECL));            \
 288       ASM_OUTPUT_FUNCTION_LABEL (FILE, NAME, DECL);             \
 289     }                                                           \
 290   while (0)
 291 #endif
 292
 293 /* Write the extra assembler code needed to declare an object properly.  */
 294
 295 #ifdef HAVE_GAS_GNU_UNIQUE_OBJECT
 296 #define USE_GNU_UNIQUE_OBJECT 1
 297 #else
 298 #define USE_GNU_UNIQUE_OBJECT 0
 299 #endif
 300
 301 #define ASM_DECLARE_OBJECT_NAME(FILE, NAME, DECL)                       \
 302   do                                                                    \
 303     {                                                                   \
 304       HOST_WIDE_INT size;                                               \
 305                                                                         \
 306       /* For template static data member instantiations or              \
 307          inline fn local statics and their guard variables, use         \
 308          gnu_unique_object so that they will be combined even under     \
 309          RTLD_LOCAL.  Don't use gnu_unique_object for typeinfo,         \
 310          vtables and other read-only artificial decls.  */              \
 311       if (USE_GNU_UNIQUE_OBJECT && DECL_ONE_ONLY (DECL)                 \
 312           && (!DECL_ARTIFICIAL (DECL) || !TREE_READONLY (DECL)))        \
 313         ASM_OUTPUT_TYPE_DIRECTIVE (FILE, NAME, "gnu_unique_object");    \
 314       else                                                              \
 315         ASM_OUTPUT_TYPE_DIRECTIVE (FILE, NAME, "object");               \
 316                                                                         \
 317       size_directive_output = 0;                                        \
 318       if (!flag_inhibit_size_directive                                  \
 319           && (DECL) && DECL_SIZE (DECL))                                \
 320         {                                                               \
 321           size_directive_output = 1;                                    \
 322           size = int_size_in_bytes (TREE_TYPE (DECL));                  \
 323           ASM_OUTPUT_SIZE_DIRECTIVE (FILE, NAME, size);                 \
 324         }                                                               \
 325                                                                         \
 326       ASM_OUTPUT_LABEL (FILE, NAME);                                    \
 327     }                                                                   \
 328   while (0)
 329
 330 /* Output the size directive for a decl in rest_of_decl_compilation
 331    in the case where we did not do so before the initializer.
 332    Once we find the error_mark_node, we know that the value of
 333    size_directive_output was set
 334    by ASM_DECLARE_OBJECT_NAME when it was run for the same decl.  */
 335
 336 #undef ASM_FINISH_DECLARE_OBJECT
 337 #define ASM_FINISH_DECLARE_OBJECT(FILE, DECL, TOP_LEVEL, AT_END)\
 338   do                                                            \
 339     {                                                           \
 340       const char *name = XSTR (XEXP (DECL_RTL (DECL), 0), 0);   \
 341       HOST_WIDE_INT size;                                       \
 342                                                                 \
 343       if (!flag_inhibit_size_directive                          \
 344           && DECL_SIZE (DECL)                                   \
 345           && ! AT_END && TOP_LEVEL                              \
 346           && DECL_INITIAL (DECL) == error_mark_node             \
 347           && !size_directive_output)                            \
 348         {                                                       \
 349           size_directive_output = 1;                            \
 350           size = int_size_in_bytes (TREE_TYPE (DECL));          \
 351           ASM_OUTPUT_SIZE_DIRECTIVE (FILE, name, size);         \
 352         }                                                       \
 353     }                                                           \
 354   while (0)
 355
 356 /* This is how to declare the size of a function.  */
 357 #ifndef ASM_DECLARE_FUNCTION_SIZE
 358 #define ASM_DECLARE_FUNCTION_SIZE(FILE, FNAME, DECL)            \
 359   do                                                            \
 360     {                                                           \
 361       if (!flag_inhibit_size_directive)                         \
 362         ASM_OUTPUT_MEASURED_SIZE (FILE, FNAME);                 \
 363     }                                                           \
 364   while (0)
 365 #endif
 366
 367 /* A table of bytes codes used by the ASM_OUTPUT_ASCII and
 368    ASM_OUTPUT_LIMITED_STRING macros.  Each byte in the table
 369    corresponds to a particular byte value [0..255].  For any
 370    given byte value, if the value in the corresponding table
 371    position is zero, the given character can be output directly.
 372    If the table value is 1, the byte must be output as a \ooo
 373    octal escape.  If the tables value is anything else, then the
 374    byte value should be output as a \ followed by the value
 375    in the table.  Note that we can use standard UN*X escape
 376    sequences for many control characters, but we don't use
 377    \a to represent BEL because some svr4 assemblers (e.g. on
 378    the i386) don't know about that.  Also, we don't use \v
 379    since some versions of gas, such as 2.2 did not accept it.  */
 380
 381 #define ELF_ASCII_ESCAPES \
 382 "\1\1\1\1\1\1\1\1btn\1fr\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\
 383 \0\0\"\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\
 384 \0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\\\0\0\0\
 385 \0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\0\1\
 386 \1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\
 387 \1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\
 388 \1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\
 389 \1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1\1"
 390
 391 /* Some svr4 assemblers have a limit on the number of characters which
 392    can appear in the operand of a .string directive.  If your assembler
 393    has such a limitation, you should define STRING_LIMIT to reflect that
 394    limit.  Note that at least some svr4 assemblers have a limit on the
 395    actual number of bytes in the double-quoted string, and that they
 396    count each character in an escape sequence as one byte.  Thus, an
 397    escape sequence like \377 would count as four bytes.
 398
 399    If your target assembler doesn't support the .string directive, you
 400    should define this to zero.
 401 */
 402
 403 #define ELF_STRING_LIMIT        ((unsigned) 256)
 404
 405 /* The routine used to output NUL terminated strings.  We use a special
 406    version of this for most svr4 targets because doing so makes the
 407    generated assembly code more compact (and thus faster to assemble)
 408    as well as more readable, especially for targets like the i386
 409    (where the only alternative is to output character sequences as
 410    comma separated lists of numbers).  */
 411
 412 #define ASM_OUTPUT_LIMITED_STRING(FILE, STR)            \
 413   default_elf_asm_output_limited_string ((FILE), (STR))
 414
 415 /* The routine used to output sequences of byte values.  We use a special
 416    version of this for most svr4 targets because doing so makes the
 417    generated assembly code more compact (and thus faster to assemble)
 418    as well as more readable.  Note that if we find subparts of the
 419    character sequence which end with NUL (and which are shorter than
 420    STRING_LIMIT) we output those using ASM_OUTPUT_LIMITED_STRING.  */
 421
 422 #undef  ASM_OUTPUT_ASCII
 423 #define ASM_OUTPUT_ASCII(FILE, STR, LENGTH)                     \
 424   default_elf_asm_output_ascii ((FILE), (STR), (LENGTH));
 425
 426 /* Allow the use of the -frecord-gcc-switches switch via the
 427    elf_record_gcc_switches function defined in varasm.c.  */
 428 #undef  TARGET_ASM_RECORD_GCC_SWITCHES
 429 #define TARGET_ASM_RECORD_GCC_SWITCHES elf_record_gcc_switches
 430
 431 /* A C statement (sans semicolon) to output to the stdio stream STREAM
 432    any text necessary for declaring the name of an external symbol
 433    named NAME which is referenced in this compilation but not defined.
 434    It is needed to properly support non-default visibility.  */
 435
 436 #ifndef ASM_OUTPUT_EXTERNAL
 437 #define ASM_OUTPUT_EXTERNAL(FILE, DECL, NAME) \
 438   default_elf_asm_output_external (FILE, DECL, NAME)
 439 #endif