gdb/target-descriptions.h - gdb

Macros defined

Source code

  1. /* Target description support for GDB.

  3.    Copyright (C) 2006-2015 Free Software Foundation, Inc.

  5.    Contributed by CodeSourcery.

  7.    This file is part of GDB.

  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.

  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.

  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/>.  */

  22. #ifndef TARGET_DESCRIPTIONS_H
  23. ‌#define TARGET_DESCRIPTIONS_H 1

  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. struct target_desc;
  32. /* An inferior's target description info is stored in this opaque
  33.    object.  There's one such object per inferior.  */
  34. struct target_desc_info;
  35. struct inferior;

  37. /* Fetch the current inferior's description, and switch its current
  38.    architecture to one which incorporates that description.  */

  40. void target_find_description (void);

  42. /* Discard any description fetched from the target for the current
  43.    inferior, and switch the current architecture to one with no target
  44.    description.  */

  46. void target_clear_description (void);

  48. /* Return the current inferior's target description.  This should only
  49.    be used by gdbarch initialization code; most access should be
  50.    through an existing gdbarch.  */

  52. const struct target_desc *target_current_description (void);

  54. /* Copy inferior target description data.  Used for example when
  55.    handling (v)forks, where child's description is the same as the
  56.    parent's, since the child really is a copy of the parent.  */

  58. void copy_inferior_target_desc_info (struct inferior *destinf,
  59.                                      struct inferior *srcinf);

  61. /* Free a target_desc_info object.  */

  63. void target_desc_info_free (struct target_desc_info *tdesc_info);

  65. /* Returns true if INFO indicates the target description had been
  66.    supplied by the user.  */

  68. int target_desc_info_from_user_p (struct target_desc_info *info);

  70. /* Record architecture-specific functions to call for pseudo-register
  71.    support.  If tdesc_use_registers is called and gdbarch_num_pseudo_regs
  72.    is greater than zero, then these should be called as well.
  73.    They are equivalent to the gdbarch methods with similar names,
  74.    except that they will only be called for pseudo registers.  */

  76. void set_tdesc_pseudo_register_name
  77.   (struct gdbarch *gdbarch, gdbarch_register_name_ftype *pseudo_name);

  79. void set_tdesc_pseudo_register_type
  80.   (struct gdbarch *gdbarch, gdbarch_register_type_ftype *pseudo_type);

  82. void set_tdesc_pseudo_register_reggroup_p
  83.   (struct gdbarch *gdbarch,
  84.    gdbarch_register_reggroup_p_ftype *pseudo_reggroup_p);

  86. /* Update GDBARCH to use the TARGET_DESC for registers.  TARGET_DESC
  87.    may be GDBARCH's target description or (if GDBARCH does not have
  88.    one which describes registers) another target description
  89.    constructed by the gdbarch initialization routine.

  91.    Fixed register assignments are taken from EARLY_DATA, which is freed.
  92.    All registers which have not been assigned fixed numbers are given
  93.    numbers above the current value of gdbarch_num_regs.
  94.    gdbarch_num_regs and various  register-related predicates are updated to
  95.    refer to the target description.  This function should only be called from
  96.    the architecture's gdbarch initialization routine, and only after
  97.    successfully validating the required registers.  */

  99. void tdesc_use_registers (struct gdbarch *gdbarch,
  100.                           const struct target_desc *target_desc,
  101.                           struct tdesc_arch_data *early_data);

  103. /* Allocate initial data for validation of a target description during
  104.    gdbarch initialization.  */

  106. struct tdesc_arch_data *tdesc_data_alloc (void);

  108. /* Clean up data allocated by tdesc_data_alloc.  This should only
  109.    be called to discard the data; tdesc_use_registers takes ownership
  110.    of its EARLY_DATA argument.  */

  112. void tdesc_data_cleanup (void *data_untyped);

  114. /* Search FEATURE for a register named NAME.  Record REGNO and the
  115.    register in DATA; when tdesc_use_registers is called, REGNO will be
  116.    assigned to the register.  1 is returned if the register was found,
  117.    0 if it was not.  */

  119. int tdesc_numbered_register (const struct tdesc_feature *feature,
  120.                              struct tdesc_arch_data *data,
  121.                              int regno, const char *name);

  123. /* Search FEATURE for a register named NAME, but do not assign a fixed
  124.    register number to it.  */

  126. int tdesc_unnumbered_register (const struct tdesc_feature *feature,
  127.                                const char *name);

  129. /* Search FEATURE for a register named NAME, and return its size in
  130.    bits.  The register must exist.  */

  132. int tdesc_register_size (const struct tdesc_feature *feature,
  133.                          const char *name);

  135. /* Search FEATURE for a register with any of the names from NAMES
  136.    (NULL-terminated).  Record REGNO and the register in DATA; when
  137.    tdesc_use_registers is called, REGNO will be assigned to the
  138.    register.  1 is returned if the register was found, 0 if it was
  139.    not.  */

  141. int tdesc_numbered_register_choices (const struct tdesc_feature *feature,
  142.                                      struct tdesc_arch_data *data,
  143.                                      int regno, const char *const names[]);


  146. /* Accessors for target descriptions.  */

  148. /* Return the BFD architecture associated with this target
  149.    description, or NULL if no architecture was specified.  */

  151. const struct bfd_arch_info *tdesc_architecture
  152.   (const struct target_desc *);

  154. /* Return the OSABI associated with this target description, or
  155.    GDB_OSABI_UNKNOWN if no osabi was specified.  */

  157. enum gdb_osabi tdesc_osabi (const struct target_desc *);

  159. /* Return non-zero if this target description is compatible
  160.    with the given BFD architecture.  */

  162. int tdesc_compatible_p (const struct target_desc *,
  163.                         const struct bfd_arch_info *);

  165. /* Return the string value of a property named KEY, or NULL if the
  166.    property was not specified.  */

  168. const char *tdesc_property (const struct target_desc *,
  169.                             const char *key);

  171. /* Return 1 if this target description describes any registers.  */

  173. int tdesc_has_registers (const struct target_desc *);

  175. /* Return the feature with the given name, if present, or NULL if
  176.    the named feature is not found.  */

  178. const struct tdesc_feature *tdesc_find_feature (const struct target_desc *,
  179.                                                 const char *name);

  181. /* Return the name of FEATURE.  */

  183. const char *tdesc_feature_name (const struct tdesc_feature *feature);

  185. /* Return the type associated with ID in the context of FEATURE, or
  186.    NULL if none.  */

  188. struct tdesc_type *tdesc_named_type (const struct tdesc_feature *feature,
  189.                                      const char *id);

  191. /* Return the name of register REGNO, from the target description or
  192.    from an architecture-provided pseudo_register_name method.  */

  194. const char *tdesc_register_name (struct gdbarch *gdbarch, int regno);

  196. /* Return the type of register REGNO, from the target description or
  197.    from an architecture-provided pseudo_register_type method.  */

  199. struct type *tdesc_register_type (struct gdbarch *gdbarch, int regno);

  201. /* Return the type associated with ID, from the target description.  */

  203. struct type *tdesc_find_type (struct gdbarch *gdbarch, const char *id);

  205. /* Check whether REGNUM is a member of REGGROUP using the target
  206.    description.  Return -1 if the target description does not
  207.    specify a group.  */

  209. int tdesc_register_in_reggroup_p (struct gdbarch *gdbarch, int regno,
  210.                                   struct reggroup *reggroup);

  212. /* Methods for constructing a target description.  */

  214. struct target_desc *allocate_target_description (void);
  215. struct cleanup *make_cleanup_free_target_description (struct target_desc *);
  216. void set_tdesc_architecture (struct target_desc *,
  217.                              const struct bfd_arch_info *);
  218. void set_tdesc_osabi (struct target_desc *, enum gdb_osabi osabi);
  219. void set_tdesc_property (struct target_desc *,
  220.                          const char *key, const char *value);
  221. void tdesc_add_compatible (struct target_desc *,
  222.                            const struct bfd_arch_info *);

  224. struct tdesc_feature *tdesc_create_feature (struct target_desc *tdesc,
  225.                                             const char *name);
  226. struct tdesc_type *tdesc_create_vector (struct tdesc_feature *feature,
  227.                                         const char *name,
  228.                                         struct tdesc_type *field_type,
  229.                                         int count);
  230. struct tdesc_type *tdesc_create_struct (struct tdesc_feature *feature,
  231.                                         const char *name);
  232. void tdesc_set_struct_size (struct tdesc_type *type, LONGEST size);
  233. struct tdesc_type *tdesc_create_union (struct tdesc_feature *feature,
  234.                                        const char *name);
  235. struct tdesc_type *tdesc_create_flags (struct tdesc_feature *feature,
  236.                                        const char *name,
  237.                                        LONGEST size);
  238. void tdesc_add_field (struct tdesc_type *type, const char *field_name,
  239.                       struct tdesc_type *field_type);
  240. void tdesc_add_bitfield (struct tdesc_type *type, const char *field_name,
  241.                          int start, int end);
  242. void tdesc_add_flag (struct tdesc_type *type, int start,
  243.                      const char *flag_name);
  244. void tdesc_create_reg (struct tdesc_feature *feature, const char *name,
  245.                        int regnum, int save_restore, const char *group,
  246.                        int bitsize, const char *type);

  248. #endif /* TARGET_DESCRIPTIONS_H */