123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193 |
- /* Common things used by the various *gnu-nat.c files
- Copyright (C) 1995-2022 Free Software Foundation, Inc.
- Written by Miles Bader <miles@gnu.ai.mit.edu>
- 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 GNU_NAT_H
- #define GNU_NAT_H
- #include "defs.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 <mach.h>
- }
- #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 <unistd.h>
- #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 /* GNU_NAT_H */
|