1 /* Default language-specific hooks.
2 Copyright (C) 2001-2020 Free Software Foundation, Inc.
3 Contributed by Alexandre Oliva <aoliva@redhat.com>
5 This file is part of GCC.
7 GCC is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 3, or (at your option)
12 GCC is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GCC; see the file COPYING3. If not see
19 <http://www.gnu.org/licenses/>. */
23 #include "coretypes.h"
28 #include "stringpool.h"
29 #include "diagnostic.h"
34 #include "langhooks.h"
35 #include "tree-diagnostic.h"
38 #include "stor-layout.h"
40 /* Do nothing; in many cases the default hook. */
47 /* Do nothing (tree). */
50 lhd_do_nothing_t (tree ARG_UNUSED (t))
54 /* Pass through (tree). */
56 lhd_pass_through_t (tree t)
61 /* Do nothing (int, int, int). Return NULL_TREE. */
64 lhd_do_nothing_iii_return_null_tree (int ARG_UNUSED (i),
71 /* Do nothing (function). */
74 lhd_do_nothing_f (struct function * ARG_UNUSED (f))
78 /* Do nothing (return NULL_TREE). */
81 lhd_return_null_tree (tree ARG_UNUSED (t))
86 /* Do nothing (return NULL_TREE). */
89 lhd_return_null_const_tree (const_tree ARG_UNUSED (t))
94 /* The default post options hook. */
97 lhd_post_options (const char ** ARG_UNUSED (pfilename))
99 /* Excess precision other than "fast" requires front-end
101 flag_excess_precision = EXCESS_PRECISION_FAST;
105 /* Called from by print-tree.c. */
108 lhd_print_tree_nothing (FILE * ARG_UNUSED (file),
109 tree ARG_UNUSED (node),
110 int ARG_UNUSED (indent))
114 /* Called from check_global_declaration. */
117 lhd_warn_unused_global_decl (const_tree decl)
119 /* This is what used to exist in check_global_declaration. Probably
120 not many of these actually apply to non-C languages. */
122 if (TREE_CODE (decl) == FUNCTION_DECL && DECL_DECLARED_INLINE_P (decl))
124 if (VAR_P (decl) && TREE_READONLY (decl))
126 if (DECL_IN_SYSTEM_HEADER (decl))
132 /* Set the DECL_ASSEMBLER_NAME for DECL. */
134 lhd_set_decl_assembler_name (tree decl)
138 /* set_decl_assembler_name may be called on TYPE_DECL to record ODR
139 name for C++ types. By default types have no ODR names. */
140 if (TREE_CODE (decl) == TYPE_DECL)
143 /* The language-independent code should never use the
144 DECL_ASSEMBLER_NAME for lots of DECLs. Only FUNCTION_DECLs and
145 VAR_DECLs for variables with static storage duration need a real
146 DECL_ASSEMBLER_NAME. */
147 gcc_assert (TREE_CODE (decl) == FUNCTION_DECL
149 && (TREE_STATIC (decl)
150 || DECL_EXTERNAL (decl)
151 || TREE_PUBLIC (decl))));
153 /* By default, assume the name to use in assembly code is the same
154 as that used in the source language. (That's correct for C, and
155 GCC used to set DECL_ASSEMBLER_NAME to the same value as
156 DECL_NAME in build_decl, so this choice provides backwards
157 compatibility with existing front-ends. This assumption is wrapped
158 in a target hook, to allow for target-specific modification of the
161 Can't use just the variable's own name for a variable whose scope
162 is less than the whole compilation. Concatenate a distinguishing
165 if (TREE_PUBLIC (decl) || DECL_FILE_SCOPE_P (decl))
166 id = targetm.mangle_decl_assembler_name (decl, DECL_NAME (decl));
169 const char *name = IDENTIFIER_POINTER (DECL_NAME (decl));
170 static unsigned long num;
173 ASM_FORMAT_PRIVATE_NAME (label, name, num++);
174 id = get_identifier (label);
177 SET_DECL_ASSEMBLER_NAME (decl, id);
180 /* Forcibly overwrite the DECL_ASSEMBLER_NAME for DECL to NAME. */
182 lhd_overwrite_decl_assembler_name (tree decl, tree name)
184 DECL_ASSEMBLER_NAME_RAW (decl) = name;
187 /* Type promotion for variable arguments. */
189 lhd_type_promotes_to (tree ARG_UNUSED (type))
194 /* Registration of machine- or os-specific builtin types. */
196 lhd_register_builtin_type (tree ARG_UNUSED (type),
197 const char * ARG_UNUSED (name))
201 /* Invalid use of an incomplete type. */
203 lhd_incomplete_type_error (location_t ARG_UNUSED (loc),
204 const_tree ARG_UNUSED (value), const_tree type)
206 gcc_assert (TREE_CODE (type) == ERROR_MARK);
210 /* Provide a default routine for alias sets that always returns -1. This
211 is used by languages that don't need to do anything special. */
214 lhd_get_alias_set (tree ARG_UNUSED (t))
219 /* This is the default decl_printable_name function. */
222 lhd_decl_printable_name (tree decl, int ARG_UNUSED (verbosity))
224 gcc_assert (decl && DECL_NAME (decl));
225 return IDENTIFIER_POINTER (DECL_NAME (decl));
228 /* This is the default dwarf_name function. */
231 lhd_dwarf_name (tree t, int verbosity)
233 gcc_assert (DECL_P (t));
235 return lang_hooks.decl_printable_name (t, verbosity);
238 /* This compares two types for equivalence ("compatible" in C-based languages).
239 This routine should only return 1 if it is sure. It should not be used
240 in contexts where erroneously returning 0 causes problems. */
243 lhd_types_compatible_p (tree x, tree y)
245 return TYPE_MAIN_VARIANT (x) == TYPE_MAIN_VARIANT (y);
248 /* lang_hooks.tree_dump.dump_tree: Dump language-specific parts of tree
249 nodes. Returns nonzero if it does not want the usual dumping of the
253 lhd_tree_dump_dump_tree (void *di ATTRIBUTE_UNUSED, tree t ATTRIBUTE_UNUSED)
258 /* lang_hooks.tree_dump.type_qual: Determine type qualifiers in a
259 language-specific way. */
262 lhd_tree_dump_type_quals (const_tree t)
264 return TYPE_QUALS (t);
267 /* lang_hooks.gimplify_expr re-writes *EXPR_P into GIMPLE form. */
270 lhd_gimplify_expr (tree *expr_p ATTRIBUTE_UNUSED,
271 gimple_seq *pre_p ATTRIBUTE_UNUSED,
272 gimple_seq *post_p ATTRIBUTE_UNUSED)
277 /* lang_hooks.tree_size: Determine the size of a tree with code C,
278 which is a language-specific tree code in category tcc_constant,
279 tcc_exceptional or tcc_type. The default expects never to be called. */
281 lhd_tree_size (enum tree_code c ATTRIBUTE_UNUSED)
286 /* Return true if decl, which is a function decl, may be called by a
290 lhd_decl_ok_for_sibcall (const_tree decl ATTRIBUTE_UNUSED)
295 /* Generic global declaration processing. This is meant to be called
296 by the front-ends at the end of parsing. C/C++ do their own thing,
297 but other front-ends may call this. */
300 global_decl_processing (void)
302 tree globals, decl, *vec;
305 timevar_stop (TV_PHASE_PARSING);
306 timevar_start (TV_PHASE_DEFERRED);
307 /* Really define vars that have had only a tentative definition.
308 Really output inline functions that must actually be callable
309 and have not been output so far. */
311 globals = lang_hooks.decls.getdecls ();
312 len = list_length (globals);
313 vec = XNEWVEC (tree, len);
315 /* Process the decls in reverse order--earliest first.
316 Put them into VEC from back to front, then take out from front. */
318 for (i = 0, decl = globals; i < len; i++, decl = DECL_CHAIN (decl))
319 vec[len - i - 1] = decl;
321 wrapup_global_declarations (vec, len);
322 timevar_stop (TV_PHASE_DEFERRED);
324 timevar_start (TV_PHASE_PARSING);
328 /* Called to perform language-specific initialization of CTX. */
330 lhd_initialize_diagnostics (diagnostic_context *ctx ATTRIBUTE_UNUSED)
334 /* Called to register dumps. */
336 lhd_register_dumps (gcc::dump_manager *)
340 /* Called to perform language-specific options initialization. */
342 lhd_init_options (unsigned int decoded_options_count ATTRIBUTE_UNUSED,
343 struct cl_decoded_option *decoded_options ATTRIBUTE_UNUSED)
347 /* By default, always complain about options for the wrong language. */
349 lhd_complain_wrong_lang_p (const struct cl_option *option ATTRIBUTE_UNUSED)
354 /* By default, no language-specific options are valid. */
356 lhd_handle_option (size_t code ATTRIBUTE_UNUSED,
357 const char *arg ATTRIBUTE_UNUSED,
358 HOST_WIDE_INT value ATTRIBUTE_UNUSED,
359 int kind ATTRIBUTE_UNUSED,
360 location_t loc ATTRIBUTE_UNUSED,
361 const struct cl_option_handlers *handlers ATTRIBUTE_UNUSED)
366 /* The default function to print out name of current function that caused
369 lhd_print_error_function (diagnostic_context *context, const char *file,
370 diagnostic_info *diagnostic)
372 if (diagnostic_last_function_changed (context, diagnostic))
374 char *old_prefix = pp_take_prefix (context->printer);
375 tree abstract_origin = diagnostic_abstract_origin (diagnostic);
376 char *new_prefix = (file && abstract_origin == NULL)
377 ? file_name_as_prefix (context, file) : NULL;
379 pp_set_prefix (context->printer, new_prefix);
381 if (current_function_decl == NULL)
382 pp_printf (context->printer, _("At top level:"));
389 ao = BLOCK_ABSTRACT_ORIGIN (abstract_origin);
390 gcc_assert (TREE_CODE (ao) == FUNCTION_DECL);
394 fndecl = current_function_decl;
396 if (TREE_CODE (TREE_TYPE (fndecl)) == METHOD_TYPE)
398 (context->printer, _("In member function %qs"),
399 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
402 (context->printer, _("In function %qs"),
403 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
405 while (abstract_origin)
408 tree block = abstract_origin;
410 locus = &BLOCK_SOURCE_LOCATION (block);
412 block = BLOCK_SUPERCONTEXT (block);
413 while (block && TREE_CODE (block) == BLOCK
414 && BLOCK_ABSTRACT_ORIGIN (block))
416 ao = BLOCK_ABSTRACT_ORIGIN (block);
417 if (TREE_CODE (ao) == FUNCTION_DECL)
422 else if (TREE_CODE (ao) != BLOCK)
425 block = BLOCK_SUPERCONTEXT (block);
428 abstract_origin = block;
431 while (block && TREE_CODE (block) == BLOCK)
432 block = BLOCK_SUPERCONTEXT (block);
434 if (block && TREE_CODE (block) == FUNCTION_DECL)
436 abstract_origin = NULL;
440 expanded_location s = expand_location (*locus);
441 pp_comma (context->printer);
442 pp_newline (context->printer);
445 if (context->show_column)
446 pp_printf (context->printer,
447 _(" inlined from %qs at %r%s:%d:%d%R"),
448 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)),
449 "locus", s.file, s.line, s.column);
451 pp_printf (context->printer,
452 _(" inlined from %qs at %r%s:%d%R"),
453 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)),
454 "locus", s.file, s.line);
458 pp_printf (context->printer, _(" inlined from %qs"),
459 identifier_to_locale (lang_hooks.decl_printable_name (fndecl, 2)));
462 pp_colon (context->printer);
465 diagnostic_set_last_function (context, diagnostic);
466 pp_newline_and_flush (context->printer);
467 context->printer->prefix = old_prefix;
468 free ((char*) new_prefix);
473 lhd_make_node (enum tree_code code)
475 return make_node (code);
478 /* Default implementation of LANG_HOOKS_SIMULATE_ENUM_DECL. Assume a
479 simple int-based enumerator (which is all the hook can be used for
480 at present) and push each decl individually without any decoration.
482 This definition is suitable for LTO and is generic enough that it
483 might be reusable elsewhere. */
485 lhd_simulate_enum_decl (location_t loc, const char *name,
486 vec<string_int_pair> values)
488 tree enumtype = lang_hooks.types.make_type (ENUMERAL_TYPE);
489 tree enumdecl = build_decl (loc, TYPE_DECL, get_identifier (name), enumtype);
490 TYPE_STUB_DECL (enumtype) = enumdecl;
492 tree value_chain = NULL_TREE;
493 string_int_pair *value;
495 FOR_EACH_VEC_ELT (values, i, value)
497 tree value_decl = build_decl (loc, CONST_DECL,
498 get_identifier (value->first), enumtype);
499 DECL_INITIAL (value_decl) = build_int_cst (integer_type_node,
501 lang_hooks.decls.pushdecl (value_decl);
502 value_chain = tree_cons (value_decl, DECL_INITIAL (value_decl),
506 TYPE_MIN_VALUE (enumtype) = TYPE_MIN_VALUE (integer_type_node);
507 TYPE_MAX_VALUE (enumtype) = TYPE_MAX_VALUE (integer_type_node);
508 SET_TYPE_ALIGN (enumtype, TYPE_ALIGN (integer_type_node));
509 TYPE_PRECISION (enumtype) = TYPE_PRECISION (integer_type_node);
510 layout_type (enumtype);
511 lang_hooks.decls.pushdecl (enumdecl);
516 /* Default implementation of LANG_HOOKS_TYPE_FOR_SIZE.
517 Return an integer type with PRECISION bits of precision,
518 that is unsigned if UNSIGNEDP is nonzero, otherwise signed. */
521 lhd_type_for_size (unsigned precision, int unsignedp)
525 if (precision == TYPE_PRECISION (integer_type_node))
526 return unsignedp ? unsigned_type_node : integer_type_node;
528 if (precision == TYPE_PRECISION (signed_char_type_node))
529 return unsignedp ? unsigned_char_type_node : signed_char_type_node;
531 if (precision == TYPE_PRECISION (short_integer_type_node))
532 return unsignedp ? short_unsigned_type_node : short_integer_type_node;
534 if (precision == TYPE_PRECISION (long_integer_type_node))
535 return unsignedp ? long_unsigned_type_node : long_integer_type_node;
537 if (precision == TYPE_PRECISION (long_long_integer_type_node))
539 ? long_long_unsigned_type_node
540 : long_long_integer_type_node;
542 for (i = 0; i < NUM_INT_N_ENTS; i ++)
543 if (int_n_enabled_p[i]
544 && precision == int_n_data[i].bitsize)
545 return (unsignedp ? int_n_trees[i].unsigned_type
546 : int_n_trees[i].signed_type);
548 if (precision <= TYPE_PRECISION (intQI_type_node))
549 return unsignedp ? unsigned_intQI_type_node : intQI_type_node;
551 if (precision <= TYPE_PRECISION (intHI_type_node))
552 return unsignedp ? unsigned_intHI_type_node : intHI_type_node;
554 if (precision <= TYPE_PRECISION (intSI_type_node))
555 return unsignedp ? unsigned_intSI_type_node : intSI_type_node;
557 if (precision <= TYPE_PRECISION (intDI_type_node))
558 return unsignedp ? unsigned_intDI_type_node : intDI_type_node;
560 if (precision <= TYPE_PRECISION (intTI_type_node))
561 return unsignedp ? unsigned_intTI_type_node : intTI_type_node;
567 lhd_to_target_charset (HOST_WIDE_INT c)
573 lhd_expr_to_decl (tree expr, bool *tc ATTRIBUTE_UNUSED, bool *se ATTRIBUTE_UNUSED)
578 /* Return sharing kind if OpenMP sharing attribute of DECL is
579 predetermined, OMP_CLAUSE_DEFAULT_UNSPECIFIED otherwise. */
581 enum omp_clause_default_kind
582 lhd_omp_predetermined_sharing (tree decl ATTRIBUTE_UNUSED)
584 if (DECL_ARTIFICIAL (decl))
585 return OMP_CLAUSE_DEFAULT_SHARED;
586 return OMP_CLAUSE_DEFAULT_UNSPECIFIED;
589 /* Generate code to copy SRC to DST. */
592 lhd_omp_assignment (tree clause ATTRIBUTE_UNUSED, tree dst, tree src)
594 return build2 (MODIFY_EXPR, TREE_TYPE (dst), dst, src);
597 /* Finalize clause C. */
600 lhd_omp_finish_clause (tree, gimple_seq *)
604 /* Return true if DECL is a scalar variable (for the purpose of
605 implicit firstprivatization). */
608 lhd_omp_scalar_p (tree decl)
610 tree type = TREE_TYPE (decl);
611 if (TREE_CODE (type) == REFERENCE_TYPE)
612 type = TREE_TYPE (type);
613 if (TREE_CODE (type) == COMPLEX_TYPE)
614 type = TREE_TYPE (type);
615 if (INTEGRAL_TYPE_P (type)
616 || SCALAR_FLOAT_TYPE_P (type)
617 || TREE_CODE (type) == POINTER_TYPE)
622 /* Register language specific type size variables as potentially OpenMP
623 firstprivate variables. */
626 lhd_omp_firstprivatize_type_sizes (struct gimplify_omp_ctx *c ATTRIBUTE_UNUSED,
627 tree t ATTRIBUTE_UNUSED)
631 /* Return true if TYPE is an OpenMP mappable type. */
634 lhd_omp_mappable_type (tree type)
636 /* Mappable type has to be complete. */
637 if (type == error_mark_node || !COMPLETE_TYPE_P (type))
642 /* Common function for add_builtin_function, add_builtin_function_ext_scope
643 and simulate_builtin_function_decl. */
646 build_builtin_function (location_t location, const char *name, tree type,
647 int function_code, enum built_in_class cl,
648 const char *library_name, tree attrs)
650 tree id = get_identifier (name);
651 tree decl = build_decl (location, FUNCTION_DECL, id, type);
653 TREE_PUBLIC (decl) = 1;
654 DECL_EXTERNAL (decl) = 1;
656 set_decl_built_in_function (decl, cl, function_code);
660 tree libname = get_identifier (library_name);
662 libname = targetm.mangle_decl_assembler_name (decl, libname);
663 SET_DECL_ASSEMBLER_NAME (decl, libname);
666 /* Possibly apply some default attributes to this built-in function. */
668 decl_attributes (&decl, attrs, ATTR_FLAG_BUILT_IN);
670 decl_attributes (&decl, NULL_TREE, 0);
675 /* Create a builtin function. */
678 add_builtin_function (const char *name,
681 enum built_in_class cl,
682 const char *library_name,
685 tree decl = build_builtin_function (BUILTINS_LOCATION, name, type,
686 function_code, cl, library_name, attrs);
687 return lang_hooks.builtin_function (decl);
690 /* Like add_builtin_function, but make sure the scope is the external scope.
691 This is used to delay putting in back end builtin functions until the ISA
692 that defines the builtin is declared via function specific target options,
693 which can save memory for machines like the x86_64 that have multiple ISAs.
694 If this points to the same function as builtin_function, the backend must
695 add all of the builtins at program initialization time. */
698 add_builtin_function_ext_scope (const char *name,
701 enum built_in_class cl,
702 const char *library_name,
705 tree decl = build_builtin_function (BUILTINS_LOCATION, name, type,
706 function_code, cl, library_name, attrs);
707 return lang_hooks.builtin_function_ext_scope (decl);
710 /* Simulate a declaration of a target-specific built-in function at
711 location LOCATION, as though it had been declared directly in the
712 source language. NAME is the name of the function, TYPE is its function
713 type, FUNCTION_CODE is the target-specific function code, LIBRARY_NAME
714 is the name of the underlying library function (NULL if none) and
715 ATTRS is a list of function attributes.
717 Return the decl of the declared function. */
720 simulate_builtin_function_decl (location_t location, const char *name,
721 tree type, int function_code,
722 const char *library_name, tree attrs)
724 tree decl = build_builtin_function (location, name, type,
725 function_code, BUILT_IN_MD,
726 library_name, attrs);
727 tree new_decl = lang_hooks.simulate_builtin_function_decl (decl);
729 /* Give the front end a chance to create a new decl if necessary,
730 but if the front end discards the decl in favour of a conflicting
731 (erroneous) previous definition, return the decl that we tried but
732 failed to add. This allows the caller to process the returned decl
733 normally, even though the source code won't be able to use it. */
734 if (TREE_CODE (new_decl) == FUNCTION_DECL
735 && fndecl_built_in_p (new_decl, function_code, BUILT_IN_MD))
742 lhd_builtin_function (tree decl)
744 lang_hooks.decls.pushdecl (decl);
748 /* Create a builtin type. */
751 add_builtin_type (const char *name, tree type)
753 tree id = get_identifier (name);
754 tree decl = build_decl (BUILTINS_LOCATION, TYPE_DECL, id, type);
755 return lang_hooks.decls.pushdecl (decl);
760 /* Used to save and restore any previously active section. */
761 static section *saved_section;
764 /* Begin a new LTO output section named NAME. This default implementation
765 saves the old section and emits assembly code to switch to the new
769 lhd_begin_section (const char *name)
773 /* Save the old section so we can restore it in lto_end_asm_section. */
774 gcc_assert (!saved_section);
775 saved_section = in_section;
777 saved_section = text_section;
779 /* Create a new section and switch to it. */
780 section = get_section (name, SECTION_DEBUG | SECTION_EXCLUDE, NULL);
781 switch_to_section (section);
785 /* Write DATA of length LEN to the current LTO output section. This default
786 implementation just calls assemble_string. */
789 lhd_append_data (const void *data, size_t len, void *)
793 timevar_push (TV_IPA_LTO_OUTPUT);
794 assemble_string ((const char *)data, len);
795 timevar_pop (TV_IPA_LTO_OUTPUT);
800 /* Finish the current LTO output section. This default implementation emits
801 assembly code to switch to any section previously saved by
802 lhd_begin_section. */
805 lhd_end_section (void)
809 switch_to_section (saved_section);
810 saved_section = NULL;
814 /* Default implementation of enum_underlying_base_type using type_for_size. */
817 lhd_enum_underlying_base_type (const_tree enum_type)
819 return lang_hooks.types.type_for_size (TYPE_PRECISION (enum_type),
820 TYPE_UNSIGNED (enum_type));
823 /* Default implementation of LANG_HOOKS_GET_SUBSTRING_LOCATION. */
826 lhd_get_substring_location (const substring_loc &, location_t *)
828 return "unimplemented";
831 /* Default implementation of LANG_HOOKS_DECL_DWARF_ATTRIBUTE. Don't add
835 lhd_decl_dwarf_attribute (const_tree, int)
840 /* Default implementation of LANG_HOOKS_TYPE_DWARF_ATTRIBUTE. Don't add
844 lhd_type_dwarf_attribute (const_tree, int)
849 /* Default implementation of LANG_HOOKS_UNIT_SIZE_WITHOUT_REUSABLE_PADDING.
850 Just return TYPE_SIZE_UNIT unadjusted. */
853 lhd_unit_size_without_reusable_padding (tree t)
855 return TYPE_SIZE_UNIT (t);
858 /* Returns true if the current lang_hooks represents the GNU C frontend. */
863 return (strncmp (lang_hooks.name, "GNU C", 5) == 0
864 && (lang_hooks.name[5] == '\0' || ISDIGIT (lang_hooks.name[5])));
867 /* Returns true if the current lang_hooks represents the GNU C++ frontend. */
872 return strncmp (lang_hooks.name, "GNU C++", 7) == 0;
875 /* Returns true if the current lang_hooks represents the GNU Fortran frontend. */
878 lang_GNU_Fortran (void)
880 return strncmp (lang_hooks.name, "GNU Fortran", 11) == 0;
883 /* Returns true if the current lang_hooks represents the GNU Objective-C
889 return strncmp (lang_hooks.name, "GNU Objective-C", 15) == 0;