gcc/c-family/c-pragma.h

   1 /* Pragma related interfaces.
   2    Copyright (C) 1995, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005,
   3    2007, 2008, 2009, 2010  Free Software Foundation, Inc.
   4
   5 This file is part of GCC.
   6
   7 GCC is free software; you can redistribute it and/or modify it under
   8 the terms of the GNU General Public License as published by the Free
   9 Software Foundation; either version 3, or (at your option) any later
  10 version.
  11
  12 GCC is distributed in the hope that it will be useful, but WITHOUT ANY
  13 WARRANTY; without even the implied warranty of MERCHANTABILITY or
  14 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  15 for more details.
  16
  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/>.  */
  20
  21 #ifndef GCC_C_PRAGMA_H
  22 #define GCC_C_PRAGMA_H
  23
  24 #include "cpplib.h" /* For enum cpp_ttype.  */
  25
  26 /* Pragma identifiers built in to the front end parsers.  Identifiers
  27    for ancillary handlers will follow these.  */
  28 typedef enum pragma_kind {
  29   PRAGMA_NONE = 0,
  30
  31   PRAGMA_OMP_ATOMIC,
  32   PRAGMA_OMP_BARRIER,
  33   PRAGMA_OMP_CRITICAL,
  34   PRAGMA_OMP_FLUSH,
  35   PRAGMA_OMP_FOR,
  36   PRAGMA_OMP_MASTER,
  37   PRAGMA_OMP_ORDERED,
  38   PRAGMA_OMP_PARALLEL,
  39   PRAGMA_OMP_PARALLEL_FOR,
  40   PRAGMA_OMP_PARALLEL_SECTIONS,
  41   PRAGMA_OMP_SECTION,
  42   PRAGMA_OMP_SECTIONS,
  43   PRAGMA_OMP_SINGLE,
  44   PRAGMA_OMP_TASK,
  45   PRAGMA_OMP_TASKWAIT,
  46   PRAGMA_OMP_THREADPRIVATE,
  47
  48   PRAGMA_GCC_PCH_PREPROCESS,
  49
  50   PRAGMA_FIRST_EXTERNAL
  51 } pragma_kind;
  52
  53
  54 /* All clauses defined by OpenMP 2.5 and 3.0.
  55    Used internally by both C and C++ parsers.  */
  56 typedef enum pragma_omp_clause {
  57   PRAGMA_OMP_CLAUSE_NONE = 0,
  58
  59   PRAGMA_OMP_CLAUSE_COLLAPSE,
  60   PRAGMA_OMP_CLAUSE_COPYIN,
  61   PRAGMA_OMP_CLAUSE_COPYPRIVATE,
  62   PRAGMA_OMP_CLAUSE_DEFAULT,
  63   PRAGMA_OMP_CLAUSE_FIRSTPRIVATE,
  64   PRAGMA_OMP_CLAUSE_IF,
  65   PRAGMA_OMP_CLAUSE_LASTPRIVATE,
  66   PRAGMA_OMP_CLAUSE_NOWAIT,
  67   PRAGMA_OMP_CLAUSE_NUM_THREADS,
  68   PRAGMA_OMP_CLAUSE_ORDERED,
  69   PRAGMA_OMP_CLAUSE_PRIVATE,
  70   PRAGMA_OMP_CLAUSE_REDUCTION,
  71   PRAGMA_OMP_CLAUSE_SCHEDULE,
  72   PRAGMA_OMP_CLAUSE_SHARED,
  73   PRAGMA_OMP_CLAUSE_UNTIED
  74 } pragma_omp_clause;
  75
  76 extern struct cpp_reader* parse_in;
  77
  78 /* It's safe to always leave visibility pragma enabled as if
  79    visibility is not supported on the host OS platform the
  80    statements are ignored.  */
  81 extern void push_visibility (const char *, int);
  82 extern bool pop_visibility (int);
  83
  84 extern void init_pragma (void);
  85
  86 /* Front-end wrappers for pragma registration.  */
  87 typedef void (*pragma_handler_1arg)(struct cpp_reader *);
  88 /* A second pragma handler, which adds a void * argument allowing to pass extra
  89    data to the handler.  */
  90 typedef void (*pragma_handler_2arg)(struct cpp_reader *, void *);
  91
  92 /* This union allows to abstract the different handlers.  */
  93 union gen_pragma_handler {
  94   pragma_handler_1arg handler_1arg;
  95   pragma_handler_2arg handler_2arg;
  96 };
  97 /* Internally used to keep the data of the handler.  */
  98 struct internal_pragma_handler_d {
  99   union gen_pragma_handler handler;
 100   /* Permits to know if handler is a pragma_handler_1arg (extra_data is false)
 101      or a pragma_handler_2arg (extra_data is true).  */
 102   bool extra_data;
 103   /* A data field which can be used when extra_data is true.  */
 104   void * data;
 105 };
 106 typedef struct internal_pragma_handler_d internal_pragma_handler;
 107
 108 extern void c_register_pragma (const char *space, const char *name,
 109                                pragma_handler_1arg handler);
 110 extern void c_register_pragma_with_data (const char *space, const char *name,
 111                                          pragma_handler_2arg handler,
 112                                          void *data);
 113
 114 extern void c_register_pragma_with_expansion (const char *space,
 115                                               const char *name,
 116                                               pragma_handler_1arg handler);
 117 extern void c_register_pragma_with_expansion_and_data (const char *space,
 118                                                        const char *name,
 119                                                    pragma_handler_2arg handler,
 120                                                        void *data);
 121 extern void c_invoke_pragma_handler (unsigned int);
 122
 123 extern void maybe_apply_pragma_weak (tree);
 124 extern void maybe_apply_pending_pragma_weaks (void);
 125 extern tree maybe_apply_renaming_pragma (tree, tree);
 126 extern void add_to_renaming_pragma_list (tree, tree);
 127
 128 extern enum cpp_ttype pragma_lex (tree *);
 129
 130 /* Flags for use with c_lex_with_flags.  The values here were picked
 131    so that 0 means to translate and join strings.  */
 132 #define C_LEX_STRING_NO_TRANSLATE 1 /* Do not lex strings into
 133                                        execution character set.  */
 134 #define C_LEX_STRING_NO_JOIN      2 /* Do not concatenate strings
 135                                        nor translate them into execution
 136                                        character set.  */
 137
 138 /* This is not actually available to pragma parsers.  It's merely a
 139    convenient location to declare this function for c-lex, after
 140    having enum cpp_ttype declared.  */
 141 extern enum cpp_ttype c_lex_with_flags (tree *, location_t *, unsigned char *,
 142                                         int);
 143
 144 extern void c_pp_lookup_pragma (unsigned int, const char **, const char **);
 145
 146 #endif /* GCC_C_PRAGMA_H */