5ef9273d29
This is the beginning of a series of patches where the goal is to turn the target ops vector into a class and all the target op function pointers into methods of this class. Currently, the target ops is a struct of function pointers. At the end of the series, it becomes a class with methods, and the existing low target definitions become subclasses. That is, we end up with the following class hierarchy: process_stratum_target ^ |-- linux-low |-- lynx-low |-- nto-low |-- win32-low process_stratum_target either defines the default behavior for the target ops or leaves them as pure virtual for the subclasses to override. The transformation is done by first introducing a helper class, called 'process_target', that is initially empty. An instance of this class is added to the end of the current target ops vector. This new field is called 'pt'. We will gradually carry target ops to the new class, one by one, whereas the invocation of the target op will be converted to a method call on 'pt'. For instance, target op 'attach' is currently invoked as (*the_target->attach) (args) After moving 'attach' as a method to 'process_target', it will be invoked as the_target->pt->attach (args) In this process, the concrete target vector definitions (e.g. linux-low, win32-low, nto-low, etc.) are turned into derived classes of 'process_target', so that they can either inherit the default behavior of the target ops or can override the method. We prefer to make this transition gradually rather than in a single giant patch, to yield bite-size patches. The goal is that after each patch gdbserver will still be buildable and testable. The general rule of thumb when converting a target op to a method is this: (1) If the function call is protected with a NULL-check with an obvious default behavior, simply implement that default behavior in the base class (e.g.: supports_non_stop). (2) If there is no NULL-check guard, the method becomes pure virtual, and the derived targets are required to implement the method (e.g.: attach). (3) If there is a NULL-check but no apparent default behavior, or if the NULL-check is utilized to populate a feature support packet, introduce a 'supports_XYZ' method (e.g.: pid_to_exec_file). The overall strategy is to preserve the existing behavior as much as possible. When we're done moving all the target ops into 'process_target', the target op vector will contain nothing but the field 'pt'. At that point, the auxiliary class 'process_target' will simply meld into 'process_stratum_target' and the method calls of the form 'the_target->pt->xyz' will be turned into 'the_target->xyz'. The "linux-low" target has been built and reg-tested on X86_64 Linux (Ubuntu). The "win32-low" target has been built (but not tested) via cross-compilation to a x86_64-w64-mingw32 target. The "lynx-low" and "nto-low" targets were neither built nor tested. gdbserver/ChangeLog: 2020-02-20 Tankut Baris Aktemur <tankut.baris.aktemur@intel.com> * target.h (class process_target): New class definition. (struct process_stratum_target) <pt>: New field with type 'process_target*'. * linux-low.h (class linux_process_target): Define as a derived class of 'process_target'. * linux-low.cc (linux_target_ops): Add a linux_process_target* as the 'pt' field. * lynx-low.h (class lynx_process_target): Define as a derived class of 'process_target'. * lynx-low.cc (lynx_target_ops): Add a lynx_process_target* as the 'pt' field. * nto-low.h (class nto_process_target): Define as a derived class of 'process_target'. * nto-low.cc (nto_target_ops): Add an nto_process_target* as the 'pt' field. * win32-low.h (class win32_process_target): Define as a derived class of 'process_target'. * win32-low.cc (win32_target_ops): Add a win32_process_target* as the 'pt' field.
131 lines
3.9 KiB
C++
131 lines
3.9 KiB
C++
/* Internal interfaces for the Win32 specific target code for gdbserver.
|
|
Copyright (C) 2007-2020 Free Software Foundation, Inc.
|
|
|
|
This file is part of GDB.
|
|
|
|
This program is free software; you can redistribute it and/or modify
|
|
it under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program is distributed in the hope that it will be useful,
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
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 GDBSERVER_WIN32_LOW_H
|
|
#define GDBSERVER_WIN32_LOW_H
|
|
|
|
#include <windows.h>
|
|
|
|
struct target_desc;
|
|
|
|
/* The inferior's target description. This is a global because the
|
|
Windows ports support neither bi-arch nor multi-process. */
|
|
extern const struct target_desc *win32_tdesc;
|
|
|
|
/* Thread information structure used to track extra information about
|
|
each thread. */
|
|
typedef struct win32_thread_info
|
|
{
|
|
/* The Win32 thread identifier. */
|
|
DWORD tid;
|
|
|
|
/* The handle to the thread. */
|
|
HANDLE h;
|
|
|
|
/* Thread Information Block address. */
|
|
CORE_ADDR thread_local_base;
|
|
|
|
/* Non zero if SuspendThread was called on this thread. */
|
|
int suspended;
|
|
|
|
#ifdef _WIN32_WCE
|
|
/* The context as retrieved right after suspending the thread. */
|
|
CONTEXT base_context;
|
|
#endif
|
|
|
|
/* The context of the thread, including any manipulations. */
|
|
CONTEXT context;
|
|
|
|
/* Whether debug registers changed since we last set CONTEXT back to
|
|
the thread. */
|
|
int debug_registers_changed;
|
|
} win32_thread_info;
|
|
|
|
struct win32_target_ops
|
|
{
|
|
/* Architecture-specific setup. */
|
|
void (*arch_setup) (void);
|
|
|
|
/* The number of target registers. */
|
|
int num_regs;
|
|
|
|
/* Perform initializations on startup. */
|
|
void (*initial_stuff) (void);
|
|
|
|
/* Fetch the context from the inferior. */
|
|
void (*get_thread_context) (win32_thread_info *th);
|
|
|
|
/* Called just before resuming the thread. */
|
|
void (*prepare_to_resume) (win32_thread_info *th);
|
|
|
|
/* Called when a thread was added. */
|
|
void (*thread_added) (win32_thread_info *th);
|
|
|
|
/* Fetch register from gdbserver regcache data. */
|
|
void (*fetch_inferior_register) (struct regcache *regcache,
|
|
win32_thread_info *th, int r);
|
|
|
|
/* Store a new register value into the thread context of TH. */
|
|
void (*store_inferior_register) (struct regcache *regcache,
|
|
win32_thread_info *th, int r);
|
|
|
|
void (*single_step) (win32_thread_info *th);
|
|
|
|
const unsigned char *breakpoint;
|
|
int breakpoint_len;
|
|
|
|
/* Breakpoint/Watchpoint related functions. See target.h for comments. */
|
|
int (*supports_z_point_type) (char z_type);
|
|
int (*insert_point) (enum raw_bkpt_type type, CORE_ADDR addr,
|
|
int size, struct raw_breakpoint *bp);
|
|
int (*remove_point) (enum raw_bkpt_type type, CORE_ADDR addr,
|
|
int size, struct raw_breakpoint *bp);
|
|
int (*stopped_by_watchpoint) (void);
|
|
CORE_ADDR (*stopped_data_address) (void);
|
|
};
|
|
|
|
extern struct win32_target_ops the_low_target;
|
|
|
|
/* Target ops definitions for a Win32 target. */
|
|
|
|
class win32_process_target : public process_target
|
|
{
|
|
public:
|
|
|
|
};
|
|
|
|
/* Retrieve the context for this thread, if not already retrieved. */
|
|
extern void win32_require_context (win32_thread_info *th);
|
|
|
|
/* Map the Windows error number in ERROR to a locale-dependent error
|
|
message string and return a pointer to it. Typically, the values
|
|
for ERROR come from GetLastError.
|
|
|
|
The string pointed to shall not be modified by the application,
|
|
but may be overwritten by a subsequent call to strwinerror
|
|
|
|
The strwinerror function does not change the current setting
|
|
of GetLastError. */
|
|
extern char * strwinerror (DWORD error);
|
|
|
|
/* in wincecompat.c */
|
|
|
|
extern void to_back_slashes (char *);
|
|
|
|
#endif /* GDBSERVER_WIN32_LOW_H */
|