GDB (xrefs)
waitstatus.h
Go to the documentation of this file.
1 /* Target waitstatus definitions and prototypes.
2 
3  Copyright (C) 1990-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 WAITSTATUS_H
21 #define WAITSTATUS_H
22 
23 #include "gdb_signals.h"
24 
25 /* Stuff for target_wait. */
26 
27 /* Generally, what has the program done? */
29 {
30  /* The program has exited. The exit status is in value.integer. */
32 
33  /* The program has stopped with a signal. Which signal is in
34  value.sig. */
36 
37  /* The program has terminated with a signal. Which signal is in
38  value.sig. */
40 
41  /* The program is letting us know that it dynamically loaded
42  something (e.g. it called load(2) on AIX). */
44 
45  /* The program has forked. A "related" process' PTID is in
46  value.related_pid. I.e., if the child forks, value.related_pid
47  is the parent's ID. */
49 
50  /* The program has vforked. A "related" process's PTID is in
51  value.related_pid. */
53 
54  /* The program has exec'ed a new executable file. The new file's
55  pathname is pointed to by value.execd_pathname. */
57 
58  /* The program had previously vforked, and now the child is done
59  with the shared memory region, because it exec'ed or exited.
60  Note that the event is reported to the vfork parent. This is
61  only used if GDB did not stay attached to the vfork child,
62  otherwise, a TARGET_WAITKIND_EXECD or
63  TARGET_WAITKIND_EXIT|SIGNALLED event associated with the child
64  has the same effect. */
66 
67  /* The program has entered or returned from a system call. On
68  HP-UX, this is used in the hardware watchpoint implementation.
69  The syscall's unique integer ID number is in
70  value.syscall_id. */
73 
74  /* Nothing happened, but we stopped anyway. This perhaps should
75  be handled within target_wait, but I'm not sure target_wait
76  should be resuming the inferior. */
78 
79  /* An event has occured, but we should wait again.
80  Remote_async_wait() returns this when there is an event
81  on the inferior, but the rest of the world is not interested in
82  it. The inferior has not stopped, but has just sent some output
83  to the console, for instance. In this case, we want to go back
84  to the event loop and wait there for another event from the
85  inferior, rather than being stuck in the remote_async_wait()
86  function. This way the event loop is responsive to other events,
87  like for instance the user typing. */
89 
90  /* The target has run out of history information,
91  and cannot run backward any further. */
93 
94  /* There are no resumed children left in the program. */
96 };
97 
99 {
101 
102  /* Additional information about the event. */
103  union
104  {
105  /* Exit status */
106  int integer;
107  /* Signal number */
108  enum gdb_signal sig;
109  /* Forked child pid */
111  /* execd pathname */
113  /* Syscall number */
115  } value;
116 };
117 
118 /* Extended reasons that can explain why a target/thread stopped for a
119  trap signal. */
120 
122 {
123  /* Either not stopped, or stopped for a reason that doesn't require
124  special tracking. */
126 
127  /* Stopped by a software breakpoint. */
129 
130  /* Stopped by a hardware breakpoint. */
132 
133  /* Stopped by a watchpoint. */
135 
136  /* Stopped by a single step finishing. */
138 };
139 
140 /* Prototypes */
141 
142 /* Return a pretty printed form of target_waitstatus.
143  Space for the result is malloc'd, caller must free. */
144 extern char *target_waitstatus_to_string (const struct target_waitstatus *);
145 
146 #endif /* WAITSTATUS_H */
char * target_waitstatus_to_string(const struct target_waitstatus *)
Definition: waitstatus.c:27
Definition: ptid.h:35
enum gdb_signal sig
Definition: waitstatus.h:108
union target_waitstatus::@161 value
char * execd_pathname
Definition: waitstatus.h:112
target_waitkind
Definition: waitstatus.h:28
enum target_waitkind kind
Definition: waitstatus.h:100
target_stop_reason
Definition: waitstatus.h:121