GDBserver
linux-nat.h
Go to the documentation of this file.
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 */
int( iterate_over_lwps_ftype)(struct lwp_info *lwp, void *arg)
Definition: linux-nat.h:41
Definition: ptid.h:35
struct lwp_info * iterate_over_lwps(ptid_t filter, iterate_over_lwps_ftype callback, void *data)
Definition: linux-low.c:1599
ptid_t current_lwp_ptid(void)
Definition: linux-low.c:6814
enum target_stop_reason lwp_stop_reason(struct lwp_info *lwp)
Definition: linux-low.c:180
int lwp_is_stopped(struct lwp_info *lwp)
Definition: linux-low.c:172
struct arch_lwp_info * lwp_arch_private_info(struct lwp_info *lwp)
Definition: linux-low.c:164
void linux_stop_lwp(struct lwp_info *lwp)
Definition: linux-low.c:3467
void lwp_set_arch_private_info(struct lwp_info *lwp, struct arch_lwp_info *info)
Definition: linux-low.c:155
ptid_t ptid_of_lwp(struct lwp_info *lwp)
Definition: linux-low.c:147