X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=gdb%2Ftarget-descriptions.h;h=5f0a6637cf4552e1f347930adacd70476e1a3971;hb=973961bda3cdf79e4c0768a5a5fd4eb6ab4acad2;hp=2eba7e5ddad9402b5d9ea6551f93dca121c4ae91;hpb=0fb0cc7590113e9b459dfcc48dc71c9d419d9580;p=external%2Fbinutils.git diff --git a/gdb/target-descriptions.h b/gdb/target-descriptions.h index 2eba7e5..5f0a663 100644 --- a/gdb/target-descriptions.h +++ b/gdb/target-descriptions.h @@ -1,6 +1,6 @@ /* Target description support for GDB. - Copyright (C) 2006, 2007, 2008, 2009 Free Software Foundation, Inc. + Copyright (C) 2006-2019 Free Software Foundation, Inc. Contributed by CodeSourcery. @@ -21,30 +21,49 @@ #ifndef TARGET_DESCRIPTIONS_H #define TARGET_DESCRIPTIONS_H 1 +#include "gdbsupport/tdesc.h" +#include "gdbarch.h" -struct tdesc_feature; struct tdesc_arch_data; -struct tdesc_reg; -struct target_desc; struct target_ops; -struct type; +/* An inferior's target description info is stored in this opaque + object. There's one such object per inferior. */ +struct target_desc_info; +struct inferior; -/* Fetch the current target's description, and switch the current +/* Fetch the current inferior's description, and switch its current architecture to one which incorporates that description. */ void target_find_description (void); -/* Discard any description fetched from the current target, and switch - the current architecture to one with no target description. */ +/* Discard any description fetched from the target for the current + inferior, and switch the current architecture to one with no target + description. */ void target_clear_description (void); -/* Return the global current target description. This should only be - used by gdbarch initialization code; most access should be through - an existing gdbarch. */ +/* Return the current inferior's target description. This should only + be used by gdbarch initialization code; most access should be + through an existing gdbarch. */ const struct target_desc *target_current_description (void); +/* Copy inferior target description data. Used for example when + handling (v)forks, where child's description is the same as the + parent's, since the child really is a copy of the parent. */ + +void copy_inferior_target_desc_info (struct inferior *destinf, + struct inferior *srcinf); + +/* Free a target_desc_info object. */ + +void target_desc_info_free (struct target_desc_info *tdesc_info); + +/* Returns true if INFO indicates the target description had been + supplied by the user. */ + +int target_desc_info_from_user_p (struct target_desc_info *info); + /* Record architecture-specific functions to call for pseudo-register support. If tdesc_use_registers is called and gdbarch_num_pseudo_regs is greater than zero, then these should be called as well. @@ -98,11 +117,17 @@ int tdesc_numbered_register (const struct tdesc_feature *feature, struct tdesc_arch_data *data, int regno, const char *name); +/* Search FEATURE for a register named NAME, but do not assign a fixed + register number to it. */ + +int tdesc_unnumbered_register (const struct tdesc_feature *feature, + const char *name); + /* Search FEATURE for a register named NAME, and return its size in bits. The register must exist. */ -int tdesc_register_size (const struct tdesc_feature *feature, - const char *name); +int tdesc_register_bitsize (const struct tdesc_feature *feature, + const char *name); /* Search FEATURE for a register with any of the names from NAMES (NULL-terminated). Record REGNO and the register in DATA; when @@ -123,6 +148,17 @@ int tdesc_numbered_register_choices (const struct tdesc_feature *feature, const struct bfd_arch_info *tdesc_architecture (const struct target_desc *); +/* Return the OSABI associated with this target description, or + GDB_OSABI_UNKNOWN if no osabi was specified. */ + +enum gdb_osabi tdesc_osabi (const struct target_desc *); + +/* Return non-zero if this target description is compatible + with the given BFD architecture. */ + +int tdesc_compatible_p (const struct target_desc *, + const struct bfd_arch_info *); + /* Return the string value of a property named KEY, or NULL if the property was not specified. */ @@ -143,17 +179,20 @@ const struct tdesc_feature *tdesc_find_feature (const struct target_desc *, const char *tdesc_feature_name (const struct tdesc_feature *feature); -/* Return the type associated with ID in the context of FEATURE, or - NULL if none. */ - -struct type *tdesc_named_type (const struct tdesc_feature *feature, - const char *id); - /* Return the name of register REGNO, from the target description or from an architecture-provided pseudo_register_name method. */ const char *tdesc_register_name (struct gdbarch *gdbarch, int regno); +/* Return the type of register REGNO, from the target description or + from an architecture-provided pseudo_register_type method. */ + +struct type *tdesc_register_type (struct gdbarch *gdbarch, int regno); + +/* Return the type associated with ID, from the target description. */ + +struct type *tdesc_find_type (struct gdbarch *gdbarch, const char *id); + /* Check whether REGNUM is a member of REGGROUP using the target description. Return -1 if the target description does not specify a group. */ @@ -161,21 +200,38 @@ const char *tdesc_register_name (struct gdbarch *gdbarch, int regno); int tdesc_register_in_reggroup_p (struct gdbarch *gdbarch, int regno, struct reggroup *reggroup); + +/* A deleter adapter for a target desc. */ + +struct target_desc_deleter +{ + void operator() (struct target_desc *desc) const; +}; + +/* A unique pointer specialization that holds a target_desc. */ + +typedef std::unique_ptr target_desc_up; + /* Methods for constructing a target description. */ -struct target_desc *allocate_target_description (void); -struct cleanup *make_cleanup_free_target_description (struct target_desc *); void set_tdesc_architecture (struct target_desc *, const struct bfd_arch_info *); +void set_tdesc_osabi (struct target_desc *, enum gdb_osabi osabi); void set_tdesc_property (struct target_desc *, const char *key, const char *value); +void tdesc_add_compatible (struct target_desc *, + const struct bfd_arch_info *); + +#if GDB_SELF_TEST +namespace selftests { -struct tdesc_feature *tdesc_create_feature (struct target_desc *tdesc, - const char *name); -void tdesc_record_type (struct tdesc_feature *feature, struct type *type); +/* Record that XML_FILE should generate a target description that equals + TDESC, to be verified by the "maintenance check xml-descriptions" + command. This function takes ownership of TDESC. */ -void tdesc_create_reg (struct tdesc_feature *feature, const char *name, - int regnum, int save_restore, const char *group, - int bitsize, const char *type); +void record_xml_tdesc (const char *xml_file, + const struct target_desc *tdesc); +} +#endif #endif /* TARGET_DESCRIPTIONS_H */