/* Register support routines for the remote server for GDB.
- Copyright (C) 2001, 2002, 2007, 2008 Free Software Foundation, Inc.
+ Copyright (C) 2001-2019 Free Software Foundation, Inc.
This file is part of GDB.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>. */
-#ifndef REGCACHE_H
-#define REGCACHE_H
+#ifndef GDBSERVER_REGCACHE_H
+#define GDBSERVER_REGCACHE_H
-struct inferior_list_entry;
+#include "common/common-regcache.h"
+
+struct thread_info;
+struct target_desc;
+
+/* The data for the register cache. Note that we have one per
+ inferior; this is primarily for simplicity, as the performance
+ benefit is minimal. */
+
+struct regcache : public reg_buffer_common
+{
+ /* The regcache's target description. */
+ const struct target_desc *tdesc = nullptr;
+
+ /* Whether the REGISTERS buffer's contents are valid. If false, we
+ haven't fetched the registers from the target yet. Not that this
+ register cache is _not_ pass-through, unlike GDB's. Note that
+ "valid" here is unrelated to whether the registers are available
+ in a traceframe. For that, check REGISTER_STATUS below. */
+ int registers_valid = 0;
+ int registers_owned = 0;
+ unsigned char *registers = nullptr;
+#ifndef IN_PROCESS_AGENT
+ /* One of REG_UNAVAILBLE or REG_VALID. */
+ unsigned char *register_status = nullptr;
+#endif
+
+ /* See common/common-regcache.h. */
+ enum register_status get_register_status (int regnum) const override;
+
+ /* See common/common-regcache.h. */
+ void raw_supply (int regnum, const void *buf) override;
+
+ /* See common/common-regcache.h. */
+ void raw_collect (int regnum, void *buf) const override;
+
+ /* See common/common-regcache.h. */
+ bool raw_compare (int regnum, const void *buf, int offset) const override;
+};
+
+struct regcache *init_register_cache (struct regcache *regcache,
+ const struct target_desc *tdesc,
+ unsigned char *regbuf);
+
+void regcache_cpy (struct regcache *dst, struct regcache *src);
/* Create a new register cache for INFERIOR. */
-void *new_register_cache (void);
+struct regcache *new_register_cache (const struct target_desc *tdesc);
+
+struct regcache *get_thread_regcache (struct thread_info *thread, int fetch);
/* Release all memory associated with the register cache for INFERIOR. */
-void free_register_cache (void *regcache);
+void free_register_cache (struct regcache *regcache);
+
+/* Invalidate cached registers for one thread. */
+
+void regcache_invalidate_thread (struct thread_info *);
+
+/* Invalidate cached registers for all threads of the given process. */
+
+void regcache_invalidate_pid (int pid);
-/* Invalidate cached registers for one or all threads. */
+/* Invalidate cached registers for all threads of the current
+ process. */
-void regcache_invalidate_one (struct inferior_list_entry *);
void regcache_invalidate (void);
+/* Invalidate and release the register cache of all threads of the
+ current process. */
+
+void regcache_release (void);
+
/* Convert all registers to a string in the currently specified remote
format. */
-void registers_to_string (char *buf);
+void registers_to_string (struct regcache *regcache, char *buf);
/* Convert a string to register values and fill our register cache. */
-void registers_from_string (char *buf);
+void registers_from_string (struct regcache *regcache, char *buf);
+
+/* For regcache_read_pc see common/common-regcache.h. */
+
+void regcache_write_pc (struct regcache *regcache, CORE_ADDR pc);
+
+int register_cache_size (const struct target_desc *tdesc);
-/* Return the size in bytes of a string-encoded register packet. */
+int register_size (const struct target_desc *tdesc, int n);
-int registers_length (void);
+int find_regno (const struct target_desc *tdesc, const char *name);
-/* Return a pointer to the description of register ``n''. */
+void supply_register (struct regcache *regcache, int n, const void *buf);
-struct reg *find_register_by_number (int n);
+void supply_register_zeroed (struct regcache *regcache, int n);
-int register_size (int n);
+void supply_register_by_name (struct regcache *regcache,
+ const char *name, const void *buf);
-int find_regno (const char *name);
+void supply_register_by_name_zeroed (struct regcache *regcache,
+ const char *name);
-extern const char **gdbserver_expedite_regs;
+void supply_regblock (struct regcache *regcache, const void *buf);
-void supply_register (int n, const void *buf);
+void collect_register (struct regcache *regcache, int n, void *buf);
-void supply_register_by_name (const char *name, const void *buf);
+void collect_register_as_string (struct regcache *regcache, int n, char *buf);
-void collect_register (int n, void *buf);
+void collect_register_by_name (struct regcache *regcache,
+ const char *name, void *buf);
-void collect_register_as_string (int n, char *buf);
+/* Read a raw register as an unsigned integer. Convenience wrapper
+ around regcache_raw_get_unsigned that takes a register name instead
+ of a register number. */
-void collect_register_by_name (const char *name, void *buf);
+ULONGEST regcache_raw_get_unsigned_by_name (struct regcache *regcache,
+ const char *name);
-#endif /* REGCACHE_H */
+#endif /* GDBSERVER_REGCACHE_H */
projects / thirdparty / binutils-gdb.git / blobdiff