gdb/target-descriptions.h

   1 /* Target description support for GDB.
   2
   3    Copyright (C) 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
   4
   5    Contributed by CodeSourcery.
   6
   7    This file is part of GDB.
   8
   9    This program is free software; you can redistribute it and/or modify
  10    it under the terms of the GNU General Public License as published by
  11    the Free Software Foundation; either version 3 of the License, or
  12    (at your option) any later version.
  13
  14    This program is distributed in the hope that it will be useful,
  15    but WITHOUT ANY WARRANTY; without even the implied warranty of
  16    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17    GNU General Public License for more details.
  18
  19    You should have received a copy of the GNU General Public License
  20    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  21
  22 #ifndef TARGET_DESCRIPTIONS_H
  23 #define TARGET_DESCRIPTIONS_H 1
  24
  25 struct tdesc_feature;
  26 struct tdesc_arch_data;
  27 struct tdesc_type;
  28 struct tdesc_reg;
  29 struct target_desc;
  30 struct target_ops;
  31
  32 /* Fetch the current target's description, and switch the current
  33    architecture to one which incorporates that description.  */
  34
  35 void target_find_description (void);
  36
  37 /* Discard any description fetched from the current target, and switch
  38    the current architecture to one with no target description.  */
  39
  40 void target_clear_description (void);
  41
  42 /* Return the global current target description.  This should only be
  43    used by gdbarch initialization code; most access should be through
  44    an existing gdbarch.  */
  45
  46 const struct target_desc *target_current_description (void);
  47
  48 /* Record architecture-specific functions to call for pseudo-register
  49    support.  If tdesc_use_registers is called and gdbarch_num_pseudo_regs
  50    is greater than zero, then these should be called as well.
  51    They are equivalent to the gdbarch methods with similar names,
  52    except that they will only be called for pseudo registers.  */
  53
  54 void set_tdesc_pseudo_register_name
  55   (struct gdbarch *gdbarch, gdbarch_register_name_ftype *pseudo_name);
  56
  57 void set_tdesc_pseudo_register_type
  58   (struct gdbarch *gdbarch, gdbarch_register_type_ftype *pseudo_type);
  59
  60 void set_tdesc_pseudo_register_reggroup_p
  61   (struct gdbarch *gdbarch,
  62    gdbarch_register_reggroup_p_ftype *pseudo_reggroup_p);
  63
  64 /* Update GDBARCH to use the TARGET_DESC for registers.  TARGET_DESC
  65    may be GDBARCH's target description or (if GDBARCH does not have
  66    one which describes registers) another target description
  67    constructed by the gdbarch initialization routine.
  68
  69    Fixed register assignments are taken from EARLY_DATA, which is freed.
  70    All registers which have not been assigned fixed numbers are given
  71    numbers above the current value of gdbarch_num_regs.
  72    gdbarch_num_regs and various  register-related predicates are updated to
  73    refer to the target description.  This function should only be called from
  74    the architecture's gdbarch initialization routine, and only after
  75    successfully validating the required registers.  */
  76
  77 void tdesc_use_registers (struct gdbarch *gdbarch,
  78                           const struct target_desc *target_desc,
  79                           struct tdesc_arch_data *early_data);
  80
  81 /* Allocate initial data for validation of a target description during
  82    gdbarch initialization.  */
  83
  84 struct tdesc_arch_data *tdesc_data_alloc (void);
  85
  86 /* Clean up data allocated by tdesc_data_alloc.  This should only
  87    be called to discard the data; tdesc_use_registers takes ownership
  88    of its EARLY_DATA argument.  */
  89
  90 void tdesc_data_cleanup (void *data_untyped);
  91
  92 /* Search FEATURE for a register named NAME.  Record REGNO and the
  93    register in DATA; when tdesc_use_registers is called, REGNO will be
  94    assigned to the register.  1 is returned if the register was found,
  95    0 if it was not.  */
  96
  97 int tdesc_numbered_register (const struct tdesc_feature *feature,
  98                              struct tdesc_arch_data *data,
  99                              int regno, const char *name);
 100
 101 /* Search FEATURE for a register named NAME, but do not assign a fixed
 102    register number to it.  */
 103
 104 int tdesc_unnumbered_register (const struct tdesc_feature *feature,
 105                                const char *name);
 106
 107 /* Search FEATURE for a register named NAME, and return its size in
 108    bits.  The register must exist.  */
 109
 110 int tdesc_register_size (const struct tdesc_feature *feature,
 111                          const char *name);
 112
 113 /* Search FEATURE for a register with any of the names from NAMES
 114    (NULL-terminated).  Record REGNO and the register in DATA; when
 115    tdesc_use_registers is called, REGNO will be assigned to the
 116    register.  1 is returned if the register was found, 0 if it was
 117    not.  */
 118
 119 int tdesc_numbered_register_choices (const struct tdesc_feature *feature,
 120                                      struct tdesc_arch_data *data,
 121                                      int regno, const char *const names[]);
 122
 123
 124 /* Accessors for target descriptions.  */
 125
 126 /* Return the BFD architecture associated with this target
 127    description, or NULL if no architecture was specified.  */
 128
 129 const struct bfd_arch_info *tdesc_architecture
 130   (const struct target_desc *);
 131
 132 /* Return the OSABI associated with this target description, or
 133    GDB_OSABI_UNKNOWN if no osabi was specified.  */
 134
 135 enum gdb_osabi tdesc_osabi (const struct target_desc *);
 136
 137 /* Return non-zero if this target description is compatible
 138    with the given BFD architecture.  */
 139
 140 int tdesc_compatible_p (const struct target_desc *,
 141                         const struct bfd_arch_info *);
 142
 143 /* Return the string value of a property named KEY, or NULL if the
 144    property was not specified.  */
 145
 146 const char *tdesc_property (const struct target_desc *,
 147                             const char *key);
 148
 149 /* Return 1 if this target description describes any registers.  */
 150
 151 int tdesc_has_registers (const struct target_desc *);
 152
 153 /* Return the feature with the given name, if present, or NULL if
 154    the named feature is not found.  */
 155
 156 const struct tdesc_feature *tdesc_find_feature (const struct target_desc *,
 157                                                 const char *name);
 158
 159 /* Return the name of FEATURE.  */
 160
 161 const char *tdesc_feature_name (const struct tdesc_feature *feature);
 162
 163 /* Return the type associated with ID in the context of FEATURE, or
 164    NULL if none.  */
 165
 166 struct tdesc_type *tdesc_named_type (const struct tdesc_feature *feature,
 167                                      const char *id);
 168
 169 /* Return the name of register REGNO, from the target description or
 170    from an architecture-provided pseudo_register_name method.  */
 171
 172 const char *tdesc_register_name (struct gdbarch *gdbarch, int regno);
 173
 174 /* Return the type of register REGNO, from the target description or
 175    from an architecture-provided pseudo_register_type method.  */
 176
 177 struct type *tdesc_register_type (struct gdbarch *gdbarch, int regno);
 178
 179 /* Check whether REGNUM is a member of REGGROUP using the target
 180    description.  Return -1 if the target description does not
 181    specify a group.  */
 182
 183 int tdesc_register_in_reggroup_p (struct gdbarch *gdbarch, int regno,
 184                                   struct reggroup *reggroup);
 185
 186 /* Methods for constructing a target description.  */
 187
 188 struct target_desc *allocate_target_description (void);
 189 struct cleanup *make_cleanup_free_target_description (struct target_desc *);
 190 void set_tdesc_architecture (struct target_desc *,
 191                              const struct bfd_arch_info *);
 192 void set_tdesc_osabi (struct target_desc *, enum gdb_osabi osabi);
 193 void set_tdesc_property (struct target_desc *,
 194                          const char *key, const char *value);
 195 void tdesc_add_compatible (struct target_desc *,
 196                            const struct bfd_arch_info *);
 197
 198 struct tdesc_feature *tdesc_create_feature (struct target_desc *tdesc,
 199                                             const char *name);
 200 struct tdesc_type *tdesc_create_vector (struct tdesc_feature *feature,
 201                                         const char *name,
 202                                         struct tdesc_type *field_type,
 203                                         int count);
 204 struct tdesc_type *tdesc_create_union (struct tdesc_feature *feature,
 205                                        const char *name);
 206 void tdesc_add_field (struct tdesc_type *type, const char *field_name,
 207                       struct tdesc_type *field_type);
 208 void tdesc_create_reg (struct tdesc_feature *feature, const char *name,
 209                        int regnum, int save_restore, const char *group,
 210                        int bitsize, const char *type);
 211
 212 #endif /* TARGET_DESCRIPTIONS_H */