gcc/langhooks.h

   1 /* The lang_hooks data structure.
   2    Copyright 2001 Free Software Foundation, Inc.
   3
   4 This file is part of GNU CC.
   5
   6 GNU CC is free software; you can redistribute it and/or modify
   7 it under the terms of the GNU General Public License as published by
   8 the Free Software Foundation; either version 2, or (at your option)
   9 any later version.
  10
  11 GNU CC is distributed in the hope that it will be useful,
  12 but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 GNU General Public License for more details.
  15
  16 You should have received a copy of the GNU General Public License
  17 along with GNU CC; see the file COPYING.  If not, write to
  18 the Free Software Foundation, 59 Temple Place - Suite 330,
  19 Boston, MA 02111-1307, USA.  */
  20
  21 #ifndef GCC_LANG_HOOKS_H
  22 #define GCC_LANG_HOOKS_H
  23
  24 /* A print hook for print_tree ().  */
  25 typedef void (*lang_print_tree_hook) PARAMS ((FILE *, tree, int indent));
  26
  27 /* The following hooks are documented in langhooks.c.  Must not be
  28    NULL.  */
  29
  30 struct lang_hooks_for_tree_inlining
  31 {
  32   union tree_node *(*walk_subtrees) PARAMS ((union tree_node **, int *,
  33                                              union tree_node *(*)
  34                                              (union tree_node **,
  35                                               int *, void *),
  36                                              void *, void *));
  37   int (*cannot_inline_tree_fn) PARAMS ((union tree_node **));
  38   int (*disregard_inline_limits) PARAMS ((union tree_node *));
  39   union tree_node *(*add_pending_fn_decls) PARAMS ((void *,
  40                                                     union tree_node *));
  41   int (*tree_chain_matters_p) PARAMS ((union tree_node *));
  42   int (*auto_var_in_fn_p) PARAMS ((union tree_node *, union tree_node *));
  43   union tree_node *(*copy_res_decl_for_inlining) PARAMS ((union tree_node *,
  44                                                           union tree_node *,
  45                                                           union tree_node *,
  46                                                           void *, int *,
  47                                                           void *));
  48   int (*anon_aggr_type_p) PARAMS ((union tree_node *));
  49 };
  50
  51 /* Language-specific hooks.  See langhooks-def.h for defaults.  */
  52
  53 struct lang_hooks
  54 {
  55   /* String identifying the front end.  e.g. "GNU C++".  */
  56   const char *name;
  57
  58   /* sizeof (struct lang_identifier), so make_node () creates
  59      identifier nodes long enough for the language-specific slots.  */
  60   size_t identifier_size;
  61
  62   /* Called first, to initialize the front end.  */
  63   void (*init) PARAMS ((void));
  64
  65   /* Called last, as a finalizer.  */
  66   void (*finish) PARAMS ((void));
  67
  68   /* Called immediately after parsing to clear the binding stack.  */
  69   void (*clear_binding_stack) PARAMS ((void));
  70
  71   /* Called to initialize options, before any calls to decode_option.  */
  72   void (*init_options) PARAMS ((void));
  73
  74   /* Function called with an option vector as argument, to decode a
  75      single option (typically starting with -f or -W or +).  It should
  76      return the number of command-line arguments it uses if it handles
  77      the option, or 0 and not complain if it does not recognise the
  78      option.  If this function returns a negative number, then its
  79      absolute value is the number of command-line arguments used, but,
  80      in addition, no language-independent option processing should be
  81      done for this option.  */
  82   int (*decode_option) PARAMS ((int, char **));
  83
  84   /* Called when all command line options have been processed.  */
  85   void (*post_options) PARAMS ((void));
  86
  87   /* Called to obtain the alias set to be used for an expression or type.
  88      Returns -1 if the language does nothing special for it.  */
  89   HOST_WIDE_INT (*get_alias_set) PARAMS ((tree));
  90
  91   /* Nonzero if TYPE_READONLY and TREE_READONLY should always be honored.  */
  92   bool honor_readonly;
  93
  94   /* The front end can add its own statistics to -fmem-report with
  95      this hook.  It should output to stderr.  */
  96   void (*print_statistics) PARAMS ((void));
  97
  98   /* Called by print_tree when there is a tree of class 'x' that it
  99      doesn't know how to display.  */
 100   lang_print_tree_hook print_xnode;
 101
 102   /* Called to print language-dependent parts of a class 'd', class
 103      't', and IDENTIFIER_NODE nodes.  */
 104   lang_print_tree_hook print_decl;
 105   lang_print_tree_hook print_type;
 106   lang_print_tree_hook print_identifier;
 107
 108   /* Set yydebug for bison-based parsers, when -dy is given on the
 109      command line.  By default, if the parameter is non-zero, prints a
 110      warning that the front end does not use such a parser.  */
 111   void (*set_yydebug) PARAMS ((int));
 112
 113   struct lang_hooks_for_tree_inlining tree_inlining;
 114
 115   /* Whenever you add entries here, make sure you adjust langhooks.h
 116      and langhooks.c accordingly.  */
 117 };
 118
 119 /* Each front end provides its own.  */
 120 extern const struct lang_hooks lang_hooks;
 121
 122 #endif /* GCC_LANG_HOOKS_H */