/* Common things used by the various *gnu-nat.c files Copyright (C) 1995-2024 Free Software Foundation, Inc. Written by Miles Bader 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 . */ #ifndef GDB_GNU_NAT_H #define GDB_GNU_NAT_H /* Work around conflict between Mach's 'thread_info' function, and GDB's 'thread_info' class. Make the former available as 'mach_thread_info'. */ #define thread_info mach_thread_info /* Mach headers are not yet ready for C++ compilation. */ extern "C" { #include } #undef thread_info /* Divert 'mach_thread_info' to the original Mach 'thread_info' function. */ extern __typeof__ (mach_thread_info) mach_thread_info asm ("thread_info"); #include #include "inf-child.h" struct inf; extern struct inf *gnu_current_inf; /* Converts a GDB pid to a struct proc. */ struct proc *inf_tid_to_thread (struct inf *inf, int tid); typedef void (inf_threads_ftype) (struct proc *thread, void *arg); /* Call F for every thread in inferior INF, passing ARG as second parameter. */ void inf_threads (struct inf *inf, inf_threads_ftype *f, void *arg); /* Makes sure that INF's thread list is synced with the actual process. */ int inf_update_procs (struct inf *inf); /* A proc is either a thread, or the task (there can only be one task proc because it always has the same TID, PROC_TID_TASK). */ struct proc { thread_t port; /* The task or thread port. */ int tid; /* The GDB pid (actually a thread id). */ int num; /* An id number for threads, to print. */ mach_port_t saved_exc_port; /* The task/thread's real exception port. */ mach_port_t exc_port; /* Our replacement, which for. */ int sc; /* Desired suspend count. */ int cur_sc; /* Implemented suspend count. */ int run_sc; /* Default sc when the program is running. */ int pause_sc; /* Default sc when gdb has control. */ int resume_sc; /* Sc resulting from the last resume. */ int detach_sc; /* SC to leave around when detaching from program. */ thread_state_data_t state; /* Registers, &c. */ int state_valid:1; /* True if STATE is up to date. */ int state_changed:1; int aborted:1; /* True if thread_abort has been called. */ int dead:1; /* We happen to know it's actually dead. */ /* Bit mask of registers fetched by gdb. This is used when we re-fetch STATE after aborting the thread, to detect that gdb may have out-of-date information. */ unsigned long fetched_regs; struct inf *inf; /* Where we come from. */ struct proc *next; }; /* The task has a thread entry with this TID. */ #define PROC_TID_TASK (-1) #define proc_is_task(proc) ((proc)->tid == PROC_TID_TASK) #define proc_is_thread(proc) ((proc)->tid != PROC_TID_TASK) extern int __proc_pid (struct proc *proc); /* Return printable description of proc. */ extern char *proc_string (struct proc *proc); #define proc_debug(_proc, msg, args...) \ do { struct proc *__proc = (_proc); \ debug ("{proc %d/%d %s}: " msg, \ __proc_pid (__proc), __proc->tid, \ host_address_to_string (__proc) , ##args); } while (0) extern bool gnu_debug_flag; #define debug(msg, args...) \ do { if (gnu_debug_flag) \ gdb_printf (gdb_stdlog, "%s:%d: " msg "\r\n", \ __FILE__ , __LINE__ , ##args); } while (0) /* A prototype generic GNU/Hurd target. The client can override it with local methods. */ struct gnu_nat_target : public inf_child_target { void attach (const char *, int) override; bool attach_no_wait () override { return true; } void detach (inferior *, int) override; void resume (ptid_t, int, enum gdb_signal) override; ptid_t wait (ptid_t, struct target_waitstatus *, target_wait_flags) override; enum target_xfer_status xfer_partial (enum target_object object, const char *annex, gdb_byte *readbuf, const gdb_byte *writebuf, ULONGEST offset, ULONGEST len, ULONGEST *xfered_len) override; int find_memory_regions (find_memory_region_ftype func, void *data) override; void kill () override; void create_inferior (const char *, const std::string &, char **, int) override; void mourn_inferior () override; bool thread_alive (ptid_t ptid) override; std::string pid_to_str (ptid_t) override; void stop (ptid_t) override; void inf_validate_procs (struct inf *inf); void inf_suspend (struct inf *inf); void inf_set_traced (struct inf *inf, int on); void steal_exc_port (struct proc *proc, mach_port_t name); /* Make sure that the state field in PROC is up to date, and return a pointer to it, or 0 if something is wrong. If WILL_MODIFY is true, makes sure that the thread is stopped and aborted first, and sets the state_changed field in PROC to true. */ thread_state_t proc_get_state (struct proc *proc, int will_modify); private: void inf_clear_wait (struct inf *inf); void inf_cleanup (struct inf *inf); void inf_startup (struct inf *inf, int pid); int inf_update_suspends (struct inf *inf); void inf_set_pid (struct inf *inf, pid_t pid); void inf_steal_exc_ports (struct inf *inf); void inf_validate_procinfo (struct inf *inf); void inf_validate_task_sc (struct inf *inf); void inf_restore_exc_ports (struct inf *inf); void inf_set_threads_resume_sc (struct inf *inf, struct proc *run_thread, int run_others); int inf_set_threads_resume_sc_for_signal_thread (struct inf *inf); void inf_resume (struct inf *inf); void inf_set_step_thread (struct inf *inf, struct proc *proc); void inf_detach (struct inf *inf); void inf_attach (struct inf *inf, int pid); void inf_signal (struct inf *inf, enum gdb_signal sig); void inf_continue (struct inf *inf); struct proc *make_proc (struct inf *inf, mach_port_t port, int tid); void proc_abort (struct proc *proc, int force); struct proc *_proc_free (struct proc *proc); int proc_update_sc (struct proc *proc); kern_return_t proc_get_exception_port (struct proc *proc, mach_port_t * port); kern_return_t proc_set_exception_port (struct proc *proc, mach_port_t port); mach_port_t _proc_get_exc_port (struct proc *proc); void proc_steal_exc_port (struct proc *proc, mach_port_t exc_port); void proc_restore_exc_port (struct proc *proc); int proc_trace (struct proc *proc, int set); }; /* The final/concrete instance. */ extern gnu_nat_target *gnu_target; #endif /* GDB_GNU_NAT_H */