1 /* Register support routines for the remote server for GDB.
2 Copyright (C) 2001-2014 Free Software Foundation, Inc.
4 This file is part of GDB.
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.
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.
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/>. */
25 /* The register exists, it has a value, but we don't know what it is.
26 Used when inspecting traceframes. */
27 #define REG_UNAVAILABLE 0
29 /* We know the register's value (and we have it cached). */
32 /* The data for the register cache. Note that we have one per
33 inferior; this is primarily for simplicity, as the performance
34 benefit is minimal. */
38 /* The regcache's target description. */
39 const struct target_desc *tdesc;
41 /* Whether the REGISTERS buffer's contents are valid. If false, we
42 haven't fetched the registers from the target yet. Not that this
43 register cache is _not_ pass-through, unlike GDB's. Note that
44 "valid" here is unrelated to whether the registers are available
45 in a traceframe. For that, check REGISTER_STATUS below. */
48 unsigned char *registers;
49 #ifndef IN_PROCESS_AGENT
50 /* One of REG_UNAVAILBLE or REG_VALID. */
51 unsigned char *register_status;
55 struct regcache *init_register_cache (struct regcache *regcache,
56 const struct target_desc *tdesc,
57 unsigned char *regbuf);
59 void regcache_cpy (struct regcache *dst, struct regcache *src);
61 /* Create a new register cache for INFERIOR. */
63 struct regcache *new_register_cache (const struct target_desc *tdesc);
65 struct regcache *get_thread_regcache (struct thread_info *thread, int fetch);
67 /* Release all memory associated with the register cache for INFERIOR. */
69 void free_register_cache (struct regcache *regcache);
71 /* Invalidate cached registers for one thread. */
73 void regcache_invalidate_thread (struct thread_info *);
75 /* Invalidate cached registers for all threads of the current
78 void regcache_invalidate (void);
80 /* Invalidate and release the register cache of all threads of the
83 void regcache_release (void);
85 /* Convert all registers to a string in the currently specified remote
88 void registers_to_string (struct regcache *regcache, char *buf);
90 /* Convert a string to register values and fill our register cache. */
92 void registers_from_string (struct regcache *regcache, char *buf);
94 CORE_ADDR regcache_read_pc (struct regcache *regcache);
96 void regcache_write_pc (struct regcache *regcache, CORE_ADDR pc);
98 /* Return a pointer to the description of register ``n''. */
100 struct reg *find_register_by_number (const struct target_desc *tdesc, int n);
102 int register_cache_size (const struct target_desc *tdesc);
104 int register_size (const struct target_desc *tdesc, int n);
106 int find_regno (const struct target_desc *tdesc, const char *name);
108 void supply_register (struct regcache *regcache, int n, const void *buf);
110 void supply_register_zeroed (struct regcache *regcache, int n);
112 void supply_register_by_name (struct regcache *regcache,
113 const char *name, const void *buf);
115 void supply_regblock (struct regcache *regcache, const void *buf);
117 void collect_register (struct regcache *regcache, int n, void *buf);
119 void collect_register_as_string (struct regcache *regcache, int n, char *buf);
121 void collect_register_by_name (struct regcache *regcache,
122 const char *name, void *buf);
124 #endif /* REGCACHE_H */