1 /* Internal interfaces for the Win32 specific target code for gdbserver. 2 Copyright (C) 2007-2021 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_WIN32_LOW_H 20 #define GDBSERVER_WIN32_LOW_H 21 22 #include <windows.h> 23 #include "nat/windows-nat.h" 24 25 struct target_desc; 26 27 /* The inferior's target description. This is a global because the 28 Windows ports support neither bi-arch nor multi-process. */ 29 extern const struct target_desc *win32_tdesc; 30 #ifdef __x86_64__ 31 extern const struct target_desc *wow64_win32_tdesc; 32 33 typedef BOOL (WINAPI *winapi_Wow64GetThreadContext) (HANDLE, PWOW64_CONTEXT); 34 extern winapi_Wow64GetThreadContext win32_Wow64GetThreadContext; 35 #endif 36 37 struct win32_target_ops 38 { 39 /* Architecture-specific setup. */ 40 void (*arch_setup) (void); 41 42 /* The number of target registers. */ 43 int (*num_regs) (void); 44 45 /* Perform initializations on startup. */ 46 void (*initial_stuff) (void); 47 48 /* Fetch the context from the inferior. */ 49 void (*get_thread_context) (windows_nat::windows_thread_info *th); 50 51 /* Called just before resuming the thread. */ 52 void (*prepare_to_resume) (windows_nat::windows_thread_info *th); 53 54 /* Called when a thread was added. */ 55 void (*thread_added) (windows_nat::windows_thread_info *th); 56 57 /* Fetch register from gdbserver regcache data. */ 58 void (*fetch_inferior_register) (struct regcache *regcache, 59 windows_nat::windows_thread_info *th, 60 int r); 61 62 /* Store a new register value into the thread context of TH. */ 63 void (*store_inferior_register) (struct regcache *regcache, 64 windows_nat::windows_thread_info *th, 65 int r); 66 67 void (*single_step) (windows_nat::windows_thread_info *th); 68 69 const unsigned char *breakpoint; 70 int breakpoint_len; 71 72 /* Amount by which to decrement the PC after a breakpoint is 73 hit. */ 74 int decr_pc_after_break; 75 76 /* Get the PC register from REGCACHE. */ 77 CORE_ADDR (*get_pc) (struct regcache *regcache); 78 /* Set the PC register in REGCACHE. */ 79 void (*set_pc) (struct regcache *regcache, CORE_ADDR newpc); 80 81 /* Breakpoint/Watchpoint related functions. See target.h for comments. */ 82 int (*supports_z_point_type) (char z_type); 83 int (*insert_point) (enum raw_bkpt_type type, CORE_ADDR addr, 84 int size, struct raw_breakpoint *bp); 85 int (*remove_point) (enum raw_bkpt_type type, CORE_ADDR addr, 86 int size, struct raw_breakpoint *bp); 87 int (*stopped_by_watchpoint) (void); 88 CORE_ADDR (*stopped_data_address) (void); 89 }; 90 91 extern struct win32_target_ops the_low_target; 92 93 /* Target ops definitions for a Win32 target. */ 94 95 class win32_process_target : public process_stratum_target 96 { 97 public: 98 99 int create_inferior (const char *program, 100 const std::vector<char *> &program_args) override; 101 102 int attach (unsigned long pid) override; 103 104 int kill (process_info *proc) override; 105 106 int detach (process_info *proc) override; 107 108 void mourn (process_info *proc) override; 109 110 void join (int pid) override; 111 112 bool thread_alive (ptid_t pid) override; 113 114 void resume (thread_resume *resume_info, size_t n) override; 115 116 ptid_t wait (ptid_t ptid, target_waitstatus *status, 117 target_wait_flags options) override; 118 119 void fetch_registers (regcache *regcache, int regno) override; 120 121 void store_registers (regcache *regcache, int regno) override; 122 123 int read_memory (CORE_ADDR memaddr, unsigned char *myaddr, 124 int len) override; 125 126 int write_memory (CORE_ADDR memaddr, const unsigned char *myaddr, 127 int len) override; 128 129 void request_interrupt () override; 130 131 bool supports_z_point_type (char z_type) override; 132 133 int insert_point (enum raw_bkpt_type type, CORE_ADDR addr, 134 int size, raw_breakpoint *bp) override; 135 136 int remove_point (enum raw_bkpt_type type, CORE_ADDR addr, 137 int size, raw_breakpoint *bp) override; 138 139 bool supports_hardware_single_step () override; 140 141 bool stopped_by_watchpoint () override; 142 143 CORE_ADDR stopped_data_address () override; 144 145 bool supports_qxfer_siginfo () override; 146 147 int qxfer_siginfo (const char *annex, unsigned char *readbuf, 148 unsigned const char *writebuf, 149 CORE_ADDR offset, int len) override; 150 151 bool supports_get_tib_address () override; 152 153 int get_tib_address (ptid_t ptid, CORE_ADDR *addr) override; 154 155 const gdb_byte *sw_breakpoint_from_kind (int kind, int *size) override; 156 157 CORE_ADDR read_pc (regcache *regcache) override; 158 159 void write_pc (regcache *regcache, CORE_ADDR pc) override; 160 161 bool stopped_by_sw_breakpoint () override; 162 163 bool supports_stopped_by_sw_breakpoint () override; 164 }; 165 166 /* Retrieve the context for this thread, if not already retrieved. */ 167 extern void win32_require_context (windows_nat::windows_thread_info *th); 168 169 /* Map the Windows error number in ERROR to a locale-dependent error 170 message string and return a pointer to it. Typically, the values 171 for ERROR come from GetLastError. 172 173 The string pointed to shall not be modified by the application, 174 but may be overwritten by a subsequent call to strwinerror 175 176 The strwinerror function does not change the current setting 177 of GetLastError. */ 178 extern char * strwinerror (DWORD error); 179 180 #endif /* GDBSERVER_WIN32_LOW_H */ 181