1 /* Native debugging support for GNU/Linux (LWP layer).
3 Copyright (C) 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009
4 Free Software Foundation, Inc.
6 This file is part of GDB.
8 This program is free software; you can redistribute it and/or modify
9 it under the terms of the GNU General Public License as published by
10 the Free Software Foundation; either version 3 of the License, or
11 (at your option) any later version.
13 This program is distributed in the hope that it will be useful,
14 but WITHOUT ANY WARRANTY; without even the implied warranty of
15 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 GNU General Public License for more details.
18 You should have received a copy of the GNU General Public License
19 along with this program. If not, see <http://www.gnu.org/licenses/>. */
25 /* Structure describing an LWP. This is public only for the purposes
26 of ALL_LWPS; target-specific code should generally not access it
31 /* The process id of the LWP. This is a combination of the LWP id
32 and overall process id. */
35 /* Non-zero if this LWP is cloned. In this context "cloned" means
36 that the LWP is reporting to its parent using a signal other than
40 /* Non-zero if we sent this LWP a SIGSTOP (but the LWP didn't report
44 /* Non-zero if this LWP is stopped. */
47 /* Non-zero if this LWP will be/has been resumed. Note that an LWP
48 can be marked both as stopped and resumed at the same time. This
49 happens if we try to resume an LWP that has a wait status
50 pending. We shouldn't let the LWP run until that wait status has
51 been processed, but we should not report that wait status if GDB
52 didn't try to let the LWP run. */
55 /* If non-zero, a pending wait status. */
58 /* Non-zero if we were stepping this LWP. */
61 /* Non-zero si_signo if this LWP stopped with a trap. si_addr may
62 be the address of a hardware watchpoint. */
63 struct siginfo siginfo
;
65 /* STOPPED_BY_WATCHPOINT is non-zero if this LWP stopped with a data
67 int stopped_by_watchpoint
;
69 /* On architectures where it is possible to know the data address of
70 a triggered watchpoint, STOPPED_DATA_ADDRESS_P is non-zero, and
71 STOPPED_DATA_ADDRESS contains such data address. Otherwise,
72 STOPPED_DATA_ADDRESS_P is false, and STOPPED_DATA_ADDRESS is
73 undefined. Only valid if STOPPED_BY_WATCHPOINT is true. */
74 int stopped_data_address_p
;
75 CORE_ADDR stopped_data_address
;
77 /* Non-zero if we expect a duplicated SIGINT. */
80 /* If WAITSTATUS->KIND != TARGET_WAITKIND_SPURIOUS, the waitstatus
81 for this LWP's last event. This may correspond to STATUS above,
82 or to a local variable in lin_lwp_wait. */
83 struct target_waitstatus waitstatus
;
85 /* Signal wether we are in a SYSCALL_ENTRY or
86 in a SYSCALL_RETURN event.
88 - TARGET_WAITKIND_SYSCALL_ENTRY
89 - TARGET_WAITKIND_SYSCALL_RETURN */
92 /* Next LWP in list. */
93 struct lwp_info
*next
;
96 /* The global list of LWPs, for ALL_LWPS. Unlike the threads list,
97 there is always at least one LWP on the list while the GNU/Linux
98 native target is active. */
99 extern struct lwp_info
*lwp_list
;
101 /* Iterate over the PTID each active thread (light-weight process). There
102 must be at least one. */
103 #define ALL_LWPS(LP, PTID) \
104 for ((LP) = lwp_list, (PTID) = (LP)->ptid; \
106 (LP) = (LP)->next, (PTID) = (LP) ? (LP)->ptid : (PTID))
108 #define GET_LWP(ptid) ptid_get_lwp (ptid)
109 #define GET_PID(ptid) ptid_get_pid (ptid)
110 #define is_lwp(ptid) (GET_LWP (ptid) != 0)
111 #define BUILD_LWP(lwp, pid) ptid_build (pid, lwp, 0)
113 /* Attempt to initialize libthread_db. */
114 void check_for_thread_db (void);
116 int thread_db_attach_lwp (ptid_t ptid
);
118 /* Find process PID's pending signal set from /proc/pid/status. */
119 void linux_proc_pending_signals (int pid
, sigset_t
*pending
, sigset_t
*blocked
, sigset_t
*ignored
);
121 /* Return the TGID of LWPID from /proc/pid/status. Returns -1 if not
123 extern int linux_proc_get_tgid (int lwpid
);
125 /* linux-nat functions for handling fork events. */
126 extern void linux_enable_event_reporting (ptid_t ptid
);
128 extern int lin_lwp_attach_lwp (ptid_t ptid
);
130 /* Iterator function for lin-lwp's lwp list. */
131 struct lwp_info
*iterate_over_lwps (ptid_t filter
,
132 int (*callback
) (struct lwp_info
*,
136 /* Create a prototype generic GNU/Linux target. The client can
137 override it with local methods. */
138 struct target_ops
* linux_target (void);
140 /* Create a generic GNU/Linux target using traditional
141 ptrace register access. */
143 linux_trad_target (CORE_ADDR (*register_u_offset
)(struct gdbarch
*, int, int));
145 /* Register the customized GNU/Linux target. This should be used
146 instead of calling add_target directly. */
147 void linux_nat_add_target (struct target_ops
*);
149 /* Register a method to call whenever a new thread is attached. */
150 void linux_nat_set_new_thread (struct target_ops
*, void (*) (ptid_t
));
152 /* Register a method that converts a siginfo object between the layout
153 that ptrace returns, and the layout in the architecture of the
155 void linux_nat_set_siginfo_fixup (struct target_ops
*,
156 int (*) (struct siginfo
*,
160 /* Update linux-nat internal state when changing from one fork
162 void linux_nat_switch_fork (ptid_t new_ptid
);
164 /* Return the saved siginfo associated with PTID. */
165 struct siginfo
*linux_nat_get_siginfo (ptid_t ptid
);