Home | History | Annotate | Line # | Download | only in gdbserver 
      1 /* Target description definitions for remote server for GDB.
      2    Copyright (C) 2012-2024 Free Software Foundation, Inc.
      3 
      4    This file is part of GDB.
      5 
      6    This program is free software; you can redistribute it and/or modify
      7    it under the terms of the GNU General Public License as published by
      8    the Free Software Foundation; either version 3 of the License, or
      9    (at your option) any later version.
     10 
     11    This program is distributed in the hope that it will be useful,
     12    but WITHOUT ANY WARRANTY; without even the implied warranty of
     13    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     14    GNU General Public License for more details.
     15 
     16    You should have received a copy of the GNU General Public License
     17    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
     18 
     19 #ifndef GDBSERVER_TDESC_H
     20 #define GDBSERVER_TDESC_H
     21 
     22 #include "gdbsupport/tdesc.h"
     23 
     24 #include "regdef.h"
     25 #include <vector>
     26 
     27 /* A target description.  Inherit from tdesc_feature so that target_desc
     28    can be used as tdesc_feature.  */
     29 
     30 struct target_desc final : tdesc_element
     31 {
     32   /* A vector of elements of register definitions that
     33      describe the inferior's register set.  */
     34   std::vector<struct gdb::reg> reg_defs;
     35 
     36   /* The register cache size, in bytes.  */
     37   int registers_size;
     38 
     39   /* XML features in this target description.  */
     40   std::vector<tdesc_feature_up> features;
     41 
     42 #ifndef IN_PROCESS_AGENT
     43   /* A vector of register names.  These are the "expedite" registers:
     44      registers whose values are sent along with stop replies.  */
     45   std::vector<std::string> expedite_regs;
     46 
     47   /* Defines what to return when looking for the "target.xml" file in
     48      response to qXfer:features:read.  Its contents can either be
     49      verbatim XML code (prefixed with a '@') or else the name of the
     50      actual XML file to be used in place of "target.xml".
     51 
     52      If NULL then its content will be generated by parsing the target
     53      description into xml.  */
     54   mutable const char *xmltarget = NULL;
     55 
     56   /* The value of <architecture> element in the XML, replying GDB.  */
     57   const char *arch = NULL;
     58 
     59   /* The value of <osabi> element in the XML, replying GDB.  */
     60   const char *osabi = NULL;
     61 
     62 public:
     63   target_desc ()
     64     : registers_size (0)
     65   {}
     66 
     67   ~target_desc ();
     68 
     69   bool operator== (const target_desc &other) const;
     70 
     71   bool operator!= (const target_desc &other) const
     72   {
     73     return !(*this == other);
     74   }
     75 #endif
     76 
     77   void accept (tdesc_element_visitor &v) const override;
     78 };
     79 
     80 /* Copy target description SRC to DEST.  */
     81 
     82 void copy_target_description (struct target_desc *dest,
     83 			      const struct target_desc *src);
     84 
     85 /* Initialize TDESC, and then set its expedite_regs field to
     86    EXPEDITE_REGS.  */
     87 
     88 void init_target_desc (struct target_desc *tdesc,
     89 		       const char **expedite_regs);
     90 
     91 /* Return the current inferior's target description.  Never returns
     92    NULL.  */
     93 
     94 const struct target_desc *current_target_desc (void);
     95 
     96 /* Return true if TDESC contains the feature described by string FEATURE.
     97    Return false otherwise.  */
     98 bool tdesc_contains_feature (const target_desc *tdesc,
     99 			     const std::string &feature);
    100 
    101 #endif /* GDBSERVER_TDESC_H */
    102