GDB (xrefs)

/tmp/gdb-8.1/gdb/gnu-nat.h
Go to the documentation of this file.
1 /* Common things used by the various *gnu-nat.c files
2 Copyright (C) 1995-2018 Free Software Foundation, Inc.
3
4 Written by Miles Bader <miles@gnu.ai.mit.edu>
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 __GNU_NAT_H__
20 #define __GNU_NAT_H__
21
22 #include <unistd.h>
23 #include <mach.h>
24
25 struct inf;
26
27 extern struct inf *gnu_current_inf;
28
29 /* Converts a GDB pid to a struct proc. */
30 struct proc *inf_tid_to_thread (struct inf *inf, int tid);
31
32 typedef void (inf_threads_ftype) (struct proc *thread, void *arg);
33
34 /* Call F for every thread in inferior INF, passing ARG as second parameter. */
35 void inf_threads (struct inf *inf, inf_threads_ftype *f, void *arg);
36
37 /* Makes sure that INF's thread list is synced with the actual process. */
38 int inf_update_procs (struct inf *inf);
39
40 /* A proc is either a thread, or the task (there can only be one task proc
41 because it always has the same TID, PROC_TID_TASK). */
42 struct proc
43 {
44 thread_t port; /* The task or thread port. */
45 int tid; /* The GDB pid (actually a thread id). */
46 int num; /* An id number for threads, to print. */
47
48 mach_port_t saved_exc_port; /* The task/thread's real exception port. */
49 mach_port_t exc_port; /* Our replacement, which for. */
50
51 int sc; /* Desired suspend count. */
52 int cur_sc; /* Implemented suspend count. */
53 int run_sc; /* Default sc when the program is running. */
54 int pause_sc; /* Default sc when gdb has control. */
55 int resume_sc; /* Sc resulting from the last resume. */
56 int detach_sc; /* SC to leave around when detaching
57 from program. */
58
59 thread_state_data_t state; /* Registers, &c. */
60 int state_valid:1; /* True if STATE is up to date. */
61 int state_changed:1;
62
63 int aborted:1; /* True if thread_abort has been called. */
64 int dead:1; /* We happen to know it's actually dead. */
65
66 /* Bit mask of registers fetched by gdb. This is used when we re-fetch
67 STATE after aborting the thread, to detect that gdb may have out-of-date
68 information. */
69 unsigned long fetched_regs;
70
71 struct inf *inf; /* Where we come from. */
72
73 struct proc *next;
74 };
75
76 /* The task has a thread entry with this TID. */
77 #define PROC_TID_TASK (-1)
78
79 #define proc_is_task(proc) ((proc)->tid == PROC_TID_TASK)
80 #define proc_is_thread(proc) ((proc)->tid != PROC_TID_TASK)
81
82 extern int __proc_pid (struct proc *proc);
83
84 /* Make sure that the state field in PROC is up to date, and return a
85 pointer to it, or 0 if something is wrong. If WILL_MODIFY is true,
86 makes sure that the thread is stopped and aborted first, and sets
87 the state_changed field in PROC to true. */
88 extern thread_state_t proc_get_state (struct proc *proc, int will_modify);
89
90 /* Return printable description of proc. */
91 extern char *proc_string (struct proc *proc);
92
93 #define proc_debug(_proc, msg, args...) \
94 do { struct proc *__proc = (_proc); \
95 debug ("{proc %d/%d %s}: " msg, \
96 __proc_pid (__proc), __proc->tid, \
97 host_address_to_string (__proc) , ##args); } while (0)
98
99 extern int gnu_debug_flag;
100
101 #define debug(msg, args...) \
102 do { if (gnu_debug_flag) \
103 fprintf_unfiltered (gdb_stdlog, "%s:%d: " msg "\r\n", \
104 __FILE__ , __LINE__ , ##args); } while (0)
105
106 /* Create a prototype generic GNU/Hurd target. The client can
107 override it with local methods. */
108 struct target_ops *gnu_target (void);
109
110 #endif /* __GNU_NAT_H__ */
proc::pause_sc
int pause_sc
Definition: gnu-nat.h:54
inf_update_procs
int inf_update_procs(struct inf *inf)
Definition: gnu-nat.c:1123
inf_threads_ftype
void() inf_threads_ftype(struct proc *thread, void *arg)
Definition: gnu-nat.h:32
selftests::ptid::tid
static constexpr ptid_t tid
Definition: ptid-selftests.c:43
proc::port
thread_t port
Definition: gnu-nat.h:44
proc::fetched_regs
unsigned long fetched_regs
Definition: gnu-nat.h:69
proc::cur_sc
int cur_sc
Definition: gnu-nat.h:52
proc::inf
struct inf * inf
Definition: gnu-nat.h:71
gnu_debug_flag
int gnu_debug_flag
Definition: gnu-nat.c:93
proc_get_state
thread_state_t proc_get_state(struct proc *proc, int will_modify)
Definition: gnu-nat.c:365
inf_tid_to_thread
struct proc * inf_tid_to_thread(struct inf *inf, int tid)
Definition: gnu-nat.c:967
proc
Definition: gnu-nat.h:42
proc::run_sc
int run_sc
Definition: gnu-nat.h:53
proc::tid
int tid
Definition: gnu-nat.h:45
target_ops
Definition: target.h:412
proc::state
thread_state_data_t state
Definition: gnu-nat.h:59
proc::resume_sc
int resume_sc
Definition: gnu-nat.h:55
proc::next
struct proc * next
Definition: gnu-nat.h:73
inf
Definition: gnu-nat.c:174
__proc_pid
int __proc_pid(struct proc *proc)
Definition: gnu-nat.c:253
proc::saved_exc_port
mach_port_t saved_exc_port
Definition: gnu-nat.h:48
gnu_current_inf
struct inf * gnu_current_inf
Definition: gnu-nat.c:1451
gnu_target
struct target_ops * gnu_target(void)
Definition: gnu-nat.c:2737
thread_t
pthread_t thread_t
Definition: glibc_thread_db.h:242
proc::exc_port
mach_port_t exc_port
Definition: gnu-nat.h:49
proc::num
int num
Definition: gnu-nat.h:46
proc_string
char * proc_string(struct proc *proc)
Definition: gnu-nat.c:2702
proc::state_changed
int state_changed
Definition: gnu-nat.h:61
inf_threads
void inf_threads(struct inf *inf, inf_threads_ftype *f, void *arg)
Definition: gnu-nat.c:996
proc::sc
int sc
Definition: gnu-nat.h:51
proc::aborted
int aborted
Definition: gnu-nat.h:63
proc::state_valid
int state_valid
Definition: gnu-nat.h:60
proc::detach_sc
int detach_sc
Definition: gnu-nat.h:56
proc::dead
int dead
Definition: gnu-nat.h:64