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 after options parsing, to initialize the front end.  The
  63      main input filename is passed, which may be NULL; the front end
  64      should return the original filename (e.g. foo.i -> foo.c).  */
  65   const char * (*init) PARAMS ((const char *));
  66
  67   /* Called last, as a finalizer.  */
  68   void (*finish) PARAMS ((void));
  69
  70   /* Called immediately after parsing to clear the binding stack.  */
  71   void (*clear_binding_stack) PARAMS ((void));
  72
  73   /* Called to initialize options, before any calls to decode_option.  */
  74   void (*init_options) PARAMS ((void));
  75
  76   /* Function called with an option vector as argument, to decode a
  77      single option (typically starting with -f or -W or +).  It should
  78      return the number of command-line arguments it uses if it handles
  79      the option, or 0 and not complain if it does not recognise the
  80      option.  If this function returns a negative number, then its
  81      absolute value is the number of command-line arguments used, but,
  82      in addition, no language-independent option processing should be
  83      done for this option.  */
  84   int (*decode_option) PARAMS ((int, char **));
  85
  86   /* Called when all command line options have been parsed.  */
  87   void (*post_options) PARAMS ((void));
  88
  89   /* Called to obtain the alias set to be used for an expression or type.
  90      Returns -1 if the language does nothing special for it.  */
  91   HOST_WIDE_INT (*get_alias_set) PARAMS ((tree));
  92
  93   /* Nonzero if TYPE_READONLY and TREE_READONLY should always be honored.  */
  94   bool honor_readonly;
  95
  96   /* The front end can add its own statistics to -fmem-report with
  97      this hook.  It should output to stderr.  */
  98   void (*print_statistics) PARAMS ((void));
  99
 100   /* Called by print_tree when there is a tree of class 'x' that it
 101      doesn't know how to display.  */
 102   lang_print_tree_hook print_xnode;
 103
 104   /* Called to print language-dependent parts of a class 'd', class
 105      't', and IDENTIFIER_NODE nodes.  */
 106   lang_print_tree_hook print_decl;
 107   lang_print_tree_hook print_type;
 108   lang_print_tree_hook print_identifier;
 109
 110   /* Set yydebug for bison-based parsers, when -dy is given on the
 111      command line.  By default, if the parameter is non-zero, prints a
 112      warning that the front end does not use such a parser.  */
 113   void (*set_yydebug) PARAMS ((int));
 114
 115   struct lang_hooks_for_tree_inlining tree_inlining;
 116
 117   /* Whenever you add entries here, make sure you adjust langhooks.h
 118      and langhooks.c accordingly.  */
 119 };
 120
 121 /* Each front end provides its own.  */
 122 extern const struct lang_hooks lang_hooks;
 123
 124 #endif /* GCC_LANG_HOOKS_H */