OSDN Git Service

2010-08-06 Thomas Koenig <tkoenig@gcc.gnu.org>
[pf3gnuchains/gcc-fork.git] / gcc / opts.h
index 7a51a0e..005a846 100644 (file)
@@ -1,5 +1,6 @@
 /* Command line option handling.
-   Copyright (C) 2002, 2003, 2004, 2005, 2007 Free Software Foundation, Inc.
+   Copyright (C) 2002, 2003, 2004, 2005, 2007, 2008, 2009, 2010
+   Free Software Foundation, Inc.
 
 This file is part of GCC.
 
@@ -43,6 +44,7 @@ struct cl_option
 {
   const char *opt_text;
   const char *help;
+  const char *missing_argument_error;
   unsigned short back_chain;
   unsigned char opt_len;
   int neg_index;
@@ -65,14 +67,13 @@ extern const unsigned int cl_options_count;
 extern const char *const lang_names[];
 extern const unsigned int cl_lang_count;
 
-#define CL_SAVE                        (1 << 17) /* Target-specific option for attribute.  */
-#define CL_PARAMS               (1 << 18) /* Fake entry.  Used to display --param info with --help.  */
-#define CL_WARNING             (1 << 19) /* Enables an (optional) warning message.  */
-#define CL_OPTIMIZATION                (1 << 20) /* Enables an (optional) optimization.  */
-#define CL_TARGET              (1 << 21) /* Target-specific option.  */
-#define CL_COMMON              (1 << 22) /* Language-independent.  */
+#define CL_PARAMS               (1 << 17) /* Fake entry.  Used to display --param info with --help.  */
+#define CL_WARNING             (1 << 18) /* Enables an (optional) warning message.  */
+#define CL_OPTIMIZATION                (1 << 19) /* Enables an (optional) optimization.  */
+#define CL_TARGET              (1 << 20) /* Target-specific option.  */
+#define CL_COMMON              (1 << 21) /* Language-independent.  */
 
-#define CL_MIN_OPTION_CLASS    CL_SAVE
+#define CL_MIN_OPTION_CLASS    CL_PARAMS
 #define CL_MAX_OPTION_CLASS    CL_COMMON
 
 /* From here on the bits describe attributes of the options.
@@ -80,6 +81,7 @@ extern const unsigned int cl_lang_count;
    This distinction is important because --help will not list options
    which only have these higher bits set.  */
 
+#define CL_SAVE                        (1 << 22) /* Target-specific option for attribute.  */
 #define CL_DISABLED            (1 << 23) /* Disabled in this configuration.  */
 #define CL_REPORT              (1 << 24) /* Report argument with -fverbose-asm  */
 #define CL_JOINED              (1 << 25) /* If takes joined argument.  */
@@ -89,6 +91,93 @@ extern const unsigned int cl_lang_count;
 #define CL_UINTEGER            (1 << 29) /* Argument is an integer >=0.  */
 #define CL_UNDOCUMENTED                (1 << 30) /* Do not output with --help.  */
 
+/* Possible ways in which a command-line option may be erroneous.
+   These do not include not being known at all; an option index of
+   OPT_SPECIAL_unknown is used for that.  */
+
+#define CL_ERR_DISABLED                (1 << 0) /* Disabled in this configuration.  */
+#define CL_ERR_MISSING_ARG     (1 << 1) /* Argument required but missing.  */
+#define CL_ERR_WRONG_LANG      (1 << 2) /* Option for wrong language.  */
+#define CL_ERR_UINT_ARG                (1 << 3) /* Bad unsigned integer argument.  */
+
+/* Structure describing the result of decoding an option.  */
+
+struct cl_decoded_option
+{
+  /* The index of this option, or an OPT_SPECIAL_* value for
+     non-options and unknown options.  */
+  size_t opt_index;
+
+  /* The string argument, or NULL if none.  For OPT_SPECIAL_* cases,
+     the option or non-option command-line argument.  */
+  const char *arg;
+
+  /* The original text of option plus arguments, with separate argv
+     elements concatenated into one string with spaces separating
+     them.  This is for such uses as diagnostics and
+     -frecord-gcc-switches.  */
+  const char *orig_option_with_args_text;
+
+  /* The canonical form of the option and its argument, for when it is
+     necessary to reconstruct argv elements (in particular, for
+     processing specs and passing options to subprocesses from the
+     driver).  */
+  const char *canonical_option[4];
+
+  /* The number of elements in the canonical form of the option and
+     arguments; always at least 1.  */
+  size_t canonical_option_num_elements;
+
+  /* For a boolean option, 1 for the true case and 0 for the "no-"
+     case.  For an unsigned integer option, the value of the
+     argument.  1 in all other cases.  */
+  int value;
+
+  /* Any flags describing errors detected in this option.  */
+  int errors;
+};
+
+/* Structure describing a single option-handling callback.  */
+
+struct cl_option_handler_func
+{
+  /* The function called to handle the option.  */
+  bool (*handler) (size_t opt_index, const char *arg, int value,
+                  unsigned int lang_mask, int kind,
+                  const struct cl_option_handlers *handlers);
+
+  /* The mask that must have some bit in common with the flags for the
+     option for this particular handler to be used.  */
+  unsigned int mask;
+};
+
+/* Structure describing the callbacks used in handling options.  */
+
+struct cl_option_handlers
+{
+  /* Callback for an unknown option to determine whether to give an
+     error for it, and possibly store information to diagnose the
+     option at a later point.  Return true if an error should be
+     given, false otherwise.  */
+  bool (*unknown_option_callback) (const char *opt);
+
+  /* Callback to handle, and possibly diagnose, an option for another
+     language.  */
+  void (*wrong_lang_callback) (const char *text,
+                              const struct cl_option *option,
+                              unsigned int lang_mask);
+
+  /* Callback to call after the successful handling of any option.  */
+  void (*post_handling_callback) (size_t opt_index, const char *arg,
+                                 int value, unsigned int mask);
+
+  /* The number of individual handlers.  */
+  size_t num_handlers;
+
+  /* The handlers themselves.  */
+  struct cl_option_handler_func handlers[3];
+};
+
 /* Input file names.  */
 
 extern const char **in_fnames;
@@ -98,12 +187,28 @@ extern const char **in_fnames;
 extern unsigned num_in_fnames;
 
 size_t find_opt (const char *input, int lang_mask);
+extern int integral_argument (const char *arg);
+extern void decode_cmdline_options_to_array (unsigned int argc,
+                                            const char **argv, 
+                                            unsigned int lang_mask,
+                                            struct cl_decoded_option **decoded_options,
+                                            unsigned int *decoded_options_count);
 extern void prune_options (int *argcp, char ***argvp);
-extern void decode_options (unsigned int argc, const char **argv);
+extern void decode_options (unsigned int argc, const char **argv,
+                           struct cl_decoded_option **decoded_options,
+                           unsigned int *decoded_options_count);
 extern int option_enabled (int opt_idx);
 extern bool get_option_state (int, struct cl_option_state *);
-
+extern void set_option (int opt_index, int value, const char *arg, int);
+bool handle_option (size_t opt_index, const char *arg, int value,
+                   unsigned int lang_mask, int kind,
+                   const struct cl_option_handlers *handlers);
+extern void read_cmdline_option (struct cl_decoded_option *decoded,
+                                unsigned int lang_mask,
+                                const struct cl_option_handlers *handlers);
+extern void register_warning_as_error_callback (void (*callback) (int));
 extern void enable_warning_as_error (const char *arg, int value,
-                                    unsigned int lang_mask);
+                                    unsigned int lang_mask,
+                                    const struct cl_option_handlers *handlers);
 extern void print_ignored_options (void);
 #endif