xref: /netbsd-src/external/gpl3/gdb.old/dist/gdb/nat/linux-nat.h (revision 7c192b2a5e1093666e67801684f930ef49b3b363)
1 /* Code for native debugging support for GNU/Linux (LWP layer).
2 
3    Copyright (C) 2000-2015 Free Software Foundation, Inc.
4 
5    This file is part of GDB.
6 
7    This program is free software; you can redistribute it and/or modify
8    it under the terms of the GNU General Public License as published by
9    the Free Software Foundation; either version 3 of the License, or
10    (at your option) any later version.
11 
12    This program is distributed in the hope that it will be useful,
13    but WITHOUT ANY WARRANTY; without even the implied warranty of
14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
15    GNU General Public License for more details.
16 
17    You should have received a copy of the GNU General Public License
18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
19 
20 #ifndef LINUX_NAT_H
21 #define LINUX_NAT_H
22 
23 #include "target/waitstatus.h"
24 
25 struct lwp_info;
26 struct arch_lwp_info;
27 
28 /* Unlike other extended result codes, WSTOPSIG (status) on
29    PTRACE_O_TRACESYSGOOD syscall events doesn't return SIGTRAP, but
30    instead SIGTRAP with bit 7 set.  */
31 #define SYSCALL_SIGTRAP (SIGTRAP | 0x80)
32 
33 /* Return the ptid of the current lightweight process.  With NPTL
34    threads and LWPs map 1:1, so this is equivalent to returning the
35    ptid of the current thread.  This function must be provided by
36    the client. */
37 
38 extern ptid_t current_lwp_ptid (void);
39 
40 /* Function type for the CALLBACK argument of iterate_over_lwps.  */
41 typedef int (iterate_over_lwps_ftype) (struct lwp_info *lwp, void *arg);
42 
43 /* Iterate over all LWPs.  Calls CALLBACK with its second argument set
44    to DATA for every LWP in the list.  If CALLBACK returns nonzero for
45    a particular LWP, return a pointer to the structure describing that
46    LWP immediately.  Otherwise return NULL.  This function must be
47    provided by the client.  */
48 
49 extern struct lwp_info *iterate_over_lwps (ptid_t filter,
50 					   iterate_over_lwps_ftype callback,
51 					   void *data);
52 
53 /* Return the ptid of LWP.  */
54 
55 extern ptid_t ptid_of_lwp (struct lwp_info *lwp);
56 
57 /* Set the architecture-specific data of LWP.  This function must be
58    provided by the client. */
59 
60 extern void lwp_set_arch_private_info (struct lwp_info *lwp,
61 				       struct arch_lwp_info *info);
62 
63 /* Return the architecture-specific data of LWP.  This function must
64    be provided by the client. */
65 
66 extern struct arch_lwp_info *lwp_arch_private_info (struct lwp_info *lwp);
67 
68 /* Return nonzero if LWP is stopped, zero otherwise.  This function
69    must be provided by the client.  */
70 
71 extern int lwp_is_stopped (struct lwp_info *lwp);
72 
73 /* Return the reason the LWP last stopped.  This function must be
74    provided by the client.  */
75 
76 extern enum target_stop_reason lwp_stop_reason (struct lwp_info *lwp);
77 
78 /* Cause LWP to stop.  This function must be provided by the
79    client.  */
80 
81 extern void linux_stop_lwp (struct lwp_info *lwp);
82 
83 #endif /* LINUX_NAT_H */
84