GDB (xrefs)
Loading...
Searching...
No Matches
inferior.h
Go to the documentation of this file.
1/* Variables that describe the inferior process running under GDB:
2 Where it is, why it stopped, and how to step it.
3
4 Copyright (C) 1986-2023 Free Software Foundation, Inc.
5
6 This file is part of GDB.
7
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.
12
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.
17
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/>. */
20
21#if !defined (INFERIOR_H)
22#define INFERIOR_H 1
23
24#include <exception>
25#include <list>
26
28class frame_info_ptr;
29struct ui_file;
30struct type;
31struct gdbarch;
32struct regcache;
33struct ui_out;
34struct terminal_info;
35struct target_desc_info;
36struct inferior;
37struct thread_info;
38
39/* For bpstat. */
40#include "breakpoint.h"
41
42/* For enum gdb_signal. */
43#include "target.h"
44
45/* For struct frame_id. */
46#include "frame.h"
47
48/* For gdb_environ. */
49#include "gdbsupport/environ.h"
50
51#include "progspace.h"
52#include "registry.h"
53
54#include "symfile-add-flags.h"
55#include "gdbsupport/refcounted-object.h"
56#include "gdbsupport/forward-scope-exit.h"
57#include "gdbsupport/gdb_unique_ptr.h"
58#include "gdbsupport/intrusive_list.h"
59
60#include "gdbsupport/common-inferior.h"
61#include "gdbthread.h"
62
64#include "displaced-stepping.h"
65
66#include <unordered_map>
67
70
73
74/* A deleter for infcall_suspend_state that calls
75 restore_infcall_suspend_state. */
77{
78 void operator() (struct infcall_suspend_state *state) const
79 {
80 try
81 {
83 }
84 catch (const gdb_exception_error &e)
85 {
86 /* If we are restoring the inferior state due to an exception,
87 some error message will be printed. So, only warn the user
88 when we cannot restore during normal execution. */
89 bool unwinding;
90#if __cpp_lib_uncaught_exceptions
91 unwinding = std::uncaught_exceptions () > 0;
92#else
93 unwinding = std::uncaught_exception ();
94#endif
95 if (!unwinding)
96 warning (_("Failed to restore inferior state: %s"), e.what ());
97 }
98 }
99};
100
101/* A unique_ptr specialization for infcall_suspend_state. */
102typedef std::unique_ptr<infcall_suspend_state, infcall_suspend_state_deleter>
104
106
107/* A deleter for infcall_control_state that calls
108 restore_infcall_control_state. */
110{
111 void operator() (struct infcall_control_state *state) const
112 {
114 }
115};
116
117/* A unique_ptr specialization for infcall_control_state. */
118typedef std::unique_ptr<infcall_control_state, infcall_control_state_deleter>
120
122
125
128
129extern void set_sigint_trap (void);
130
131extern void clear_sigint_trap (void);
132
133/* Collected pid, tid, etc. of the debugged inferior. When there's
134 no inferior, inferior_ptid.pid () will be 0. */
135
136extern ptid_t inferior_ptid;
137
138extern void generic_mourn_inferior (void);
139
140extern CORE_ADDR unsigned_pointer_to_address (struct gdbarch *gdbarch,
141 struct type *type,
142 const gdb_byte *buf);
143extern void unsigned_address_to_pointer (struct gdbarch *gdbarch,
144 struct type *type, gdb_byte *buf,
145 CORE_ADDR addr);
146extern CORE_ADDR signed_pointer_to_address (struct gdbarch *gdbarch,
147 struct type *type,
148 const gdb_byte *buf);
149extern void address_to_signed_pointer (struct gdbarch *gdbarch,
150 struct type *type, gdb_byte *buf,
151 CORE_ADDR addr);
152
153extern void reopen_exec_file (void);
154
155/* From misc files */
156
157extern void default_print_registers_info (struct gdbarch *gdbarch,
158 struct ui_file *file,
159 frame_info_ptr frame,
160 int regnum, int all);
161
162/* Default implementation of gdbarch_print_float_info. Print
163 the values of all floating point registers. */
164
165extern void default_print_float_info (struct gdbarch *gdbarch,
166 struct ui_file *file,
167 frame_info_ptr frame,
168 const char *args);
169
170/* Try to determine whether TTY is GDB's input terminal. Returns
171 TRIBOOL_UNKNOWN if we can't tell. */
172
173extern tribool is_gdb_terminal (const char *tty);
174
175/* Helper for sharing_input_terminal. Try to determine whether pid
176 PID is using the same TTY for input as GDB is. Returns
177 TRIBOOL_UNKNOWN if we can't tell. */
178
179extern tribool sharing_input_terminal (int pid);
180
181/* The type of the function that is called when SIGINT is handled. */
182
183typedef void c_c_handler_ftype (int);
184
185/* Install a new SIGINT handler in a host-dependent way. The previous
186 handler is returned. It is fine to pass SIG_IGN for FN, but not
187 SIG_DFL. */
188
190
191extern void child_terminal_info (struct target_ops *self, const char *, int);
192
193extern void child_terminal_ours (struct target_ops *self);
194
195extern void child_terminal_ours_for_output (struct target_ops *self);
196
197extern void child_terminal_inferior (struct target_ops *self);
198
199extern void child_terminal_save_inferior (struct target_ops *self);
200
201extern void child_terminal_init (struct target_ops *self);
202
203extern void child_pass_ctrlc (struct target_ops *self);
204
205extern void child_interrupt (struct target_ops *self);
206
207/* From fork-child.c */
208
209/* Helper function to call STARTUP_INFERIOR with PID and NUM_TRAPS.
210 This function already calls set_executing. Return the ptid_t from
211 STARTUP_INFERIOR. */
212extern ptid_t gdb_startup_inferior (pid_t pid, int num_traps);
213
214/* From infcmd.c */
215
216/* Initial inferior setup. Determines the exec file is not yet known,
217 takes any necessary post-attaching actions, fetches the target
218 description and syncs the shared library list. */
219
220extern void setup_inferior (int from_tty);
221
222extern void post_create_inferior (int from_tty);
223
224extern void attach_command (const char *, int);
225
226extern void registers_info (const char *, int);
227
228extern void continue_1 (int all_threads);
229
230extern void interrupt_target_1 (bool all_threads);
231
233 = FORWARD_SCOPE_EXIT (delete_longjmp_breakpoint);
234
235extern void detach_command (const char *, int);
236
237extern void notice_new_inferior (struct thread_info *, bool, int);
238
239/* Return the value of the result of a function at the end of a 'finish'
240 command/BP. If the result's value cannot be retrieved, return NULL.
241
242 FUNC_SYMBOL is the symbol of the function being returned from. FUNCTION is
243 a value containing the address of the function. */
244
245extern struct value *get_return_value (struct symbol *func_symbol,
246 struct value *function);
247
248/* Prepare for execution command. TARGET is the target that will run
249 the command. BACKGROUND determines whether this is a foreground
250 (synchronous) or background (asynchronous) command. */
251
252extern void prepare_execution_command (struct target_ops *target,
253 int background);
254
255/* Nonzero if stopped due to completion of a stack dummy routine. */
256
258
259/* Nonzero if program stopped due to a random (unexpected) signal in
260 inferior process. */
261
262extern int stopped_by_random_signal;
263
264/* Print notices on inferior events (attach, detach, etc.), set with
265 `set print inferior-events'. */
266extern bool print_inferior_events;
267
268/* Anything but NO_STOP_QUIETLY means we expect a trap and the caller
269 will handle it themselves. STOP_QUIETLY is used when running in
270 the shell before the child program has been exec'd and when running
271 through shared library loading. STOP_QUIETLY_REMOTE is used when
272 setting up a remote connection; it is like STOP_QUIETLY_NO_SIGSTOP
273 except that there is no need to hide a signal. */
274
275/* STOP_QUIETLY_NO_SIGSTOP is used to handle a tricky situation with attach.
276 When doing an attach, the kernel stops the debuggee with a SIGSTOP.
277 On newer GNU/Linux kernels (>= 2.5.61) the handling of SIGSTOP for
278 a ptraced process has changed. Earlier versions of the kernel
279 would ignore these SIGSTOPs, while now SIGSTOP is treated like any
280 other signal, i.e. it is not muffled.
281
282 If the gdb user does a 'continue' after the 'attach', gdb passes
283 the global variable stop_signal (which stores the signal from the
284 attach, SIGSTOP) to the ptrace(PTRACE_CONT,...) call. This is
285 problematic, because the kernel doesn't ignore such SIGSTOP
286 now. I.e. it is reported back to gdb, which in turn presents it
287 back to the user.
288
289 To avoid the problem, we use STOP_QUIETLY_NO_SIGSTOP, which allows
290 gdb to clear the value of stop_signal after the attach, so that it
291 is not passed back down to the kernel. */
299 };
300
301
302
303/* Base class for target-specific inferior data. */
305struct private_inferior
307 virtual ~private_inferior () = 0;
308};
309
310/* Inferior process specific part of `struct infcall_control_state'.
311
312 Inferior thread counterpart is `struct thread_control_state'. */
319 }
321 explicit inferior_control_state (enum stop_kind when)
322 : stop_soon (when)
323 {
324 }
325
326 /* See the definition of stop_kind above. */
327 enum stop_kind stop_soon;
328};
329
330/* Return a pointer to the current inferior. */
331extern inferior *current_inferior ();
332
333extern void set_current_inferior (inferior *);
334
335/* Switch inferior (and program space) to INF, and switch to no thread
336 selected. */
338
339/* Ensure INF is the current inferior.
340
341 If the current inferior was changed, return an RAII object that will
342 restore the original current context. */
343extern gdb::optional<scoped_restore_current_thread> maybe_switch_inferior
344 (inferior *inf);
345
346/* Info about an inferior's target description. There's one of these
347 for each inferior. */
349struct target_desc_info
350{
351 /* Returns true if this target description information has been supplied by
352 the user. */
353 bool from_user_p ()
354 { return !this->filename.empty (); }
355
356 /* A flag indicating that a description has already been fetched
357 from the target, so it should not be queried again. */
358 bool fetched = false;
359
360 /* The description fetched from the target, or NULL if the target
361 did not supply any description. Only valid when
362 FETCHED is set. Only the description initialization
363 code should access this; normally, the description should be
364 accessed through the gdbarch object. */
365 const struct target_desc *tdesc = nullptr;
366
367 /* If not empty, the filename to read a target description from, as set by
368 "set tdesc filename ...".
369
370 If empty, there is not filename specified by the user. */
371 std::string filename;
372};
373
374/* GDB represents the state of each program execution with an object
375 called an inferior. An inferior typically corresponds to a process
376 but is more general and applies also to targets that do not have a
377 notion of processes. Each run of an executable creates a new
378 inferior, as does each attachment to an existing process.
379 Inferiors have unique internal identifiers that are different from
380 target process ids. Each inferior may in turn have multiple
381 threads running in it.
382
383 Inferiors are intrusively refcounted objects. Unlike thread
384 objects, being the user-selected inferior is considered a strong
385 reference and is thus accounted for in the inferior object's
386 refcount (see set_current_inferior). When GDB needs to remember
387 the selected inferior to later restore it, GDB temporarily bumps
388 the inferior object's refcount, to prevent something deleting the
389 inferior object before reverting back (e.g., due to a
390 "remove-inferiors" command (see
391 scoped_restore_current_inferior). All other inferior
392 references are considered weak references. Inferiors are always
393 listed exactly once in the inferior list, so placing an inferior in
394 the inferior list is an implicit, not counted strong reference. */
396class inferior : public refcounted_object,
397 public intrusive_list_node<inferior>
398{
399public:
400 explicit inferior (int pid);
401 ~inferior ();
402
403 /* Returns true if we can delete this inferior. */
404 bool deletable () const { return refcount () == 0; }
405
406 /* Push T in this inferior's target stack. */
407 void push_target (struct target_ops *t)
408 { m_target_stack.push (t); }
409
410 /* An overload that deletes the target on failure. */
411 void push_target (target_ops_up &&t)
412 {
413 m_target_stack.push (t.get ());
414 t.release ();
415 }
416
417 /* Unpush T from this inferior's target stack. */
418 int unpush_target (struct target_ops *t);
419
420 /* Returns true if T is pushed in this inferior's target stack. */
421 bool target_is_pushed (const target_ops *t) const
422 { return m_target_stack.is_pushed (t); }
423
424 /* Find the target beneath T in this inferior's target stack. */
426 { return m_target_stack.find_beneath (t); }
427
428 /* Return the target at the top of this inferior's target stack. */
430 { return m_target_stack.top (); }
431
432 /* Unpush all targets except the dummy target from m_target_stack. As
433 targets are removed from m_target_stack their reference count is
434 decremented, which may cause a target to close. */
435 void pop_all_targets ()
437
438 /* Unpush all targets above STRATUM from m_target_stack. As targets are
439 removed from m_target_stack their reference count is decremented,
440 which may cause a target to close. */
441 void pop_all_targets_above (enum strata stratum);
442
443 /* Unpush all targets at and above STRATUM from m_target_stack. As
444 targets are removed from m_target_stack their reference count is
445 decremented, which may cause a target to close. */
446 void pop_all_targets_at_and_above (enum strata stratum);
447
448 /* Return the target at process_stratum level in this inferior's
449 target stack. */
452
453 /* Return the target at STRATUM in this inferior's target stack. */
454 target_ops *target_at (enum strata stratum)
455 { return m_target_stack.at (stratum); }
457 bool has_execution ()
458 { return target_has_execution (this); }
459
460 /* This inferior's thread list, sorted by creation order. */
461 intrusive_list<thread_info> thread_list;
462
463 /* A map of ptid_t to thread_info*, for average O(1) ptid_t lookup.
464 Exited threads do not appear in the map. */
465 std::unordered_map<ptid_t, thread_info *> ptid_thread_map;
466
467 /* Returns a range adapter covering the inferior's threads,
468 including exited threads. Used like this:
469
470 for (thread_info *thr : inf->threads ())
471 { .... }
474 { return inf_threads_range (this->thread_list.begin ()); }
475
476 /* Returns a range adapter covering the inferior's non-exited
477 threads. Used like this:
478
479 for (thread_info *thr : inf->non_exited_threads ())
480 { .... }
483 { return inf_non_exited_threads_range (this->thread_list.begin ()); }
484
485 /* Like inferior::threads(), but returns a range adapter that can be
486 used with range-for, safely. I.e., it is safe to delete the
487 currently-iterated thread, like this:
488
489 for (thread_info *t : inf->threads_safe ())
490 if (some_condition ())
491 delete f;
494 { return safe_inf_threads_range (this->thread_list.begin ()); }
495
496 /* Find (non-exited) thread PTID of this inferior. */
497 thread_info *find_thread (ptid_t ptid);
498
499 /* Delete all threads in the thread list, silently. */
500 void clear_thread_list ();
501
502 /* Continuations-related methods. A continuation is an std::function
503 to be called to finish the execution of a command when running
504 GDB asynchronously. A continuation is executed after any thread
505 of this inferior stops. Continuations are used by the attach
506 command and the remote target when a new inferior is detected. */
507 void add_continuation (std::function<void ()> &&cont);
508 void do_all_continuations ();
509
510 /* Set/get file name for default use for standard in/out in the inferior.
511
512 On Unix systems, we try to make TERMINAL_NAME the inferior's controlling
513 terminal.
514
515 If TERMINAL_NAME is the empty string, then the inferior inherits GDB's
516 terminal (or GDBserver's if spawning a remote process). */
517 void set_tty (std::string terminal_name);
518 const std::string &tty ();
519
520 /* Set the argument string to use when running this inferior.
521
522 An empty string can be used to represent "no arguments". */
523 void set_args (std::string args)
524 {
525 m_args = std::move (args);
526 };
527
528 /* Set the argument string from some strings. */
529 void set_args (gdb::array_view<char * const> args);
530
531 /* Get the argument string to use when running this inferior.
532
533 No arguments is represented by an empty string. */
534 const std::string &args () const
535 {
536 return m_args;
537 }
538
539 /* Set the inferior current working directory.
540
541 If CWD is empty, unset the directory. */
542 void set_cwd (std::string cwd)
543 {
544 m_cwd = std::move (cwd);
545 }
546
547 /* Get the inferior current working directory.
548
549 Return an empty string if the current working directory is not
550 specified. */
551 const std::string &cwd () const
552 {
553 return m_cwd;
554 }
555
556 /* Convenient handle (GDB inferior id). Unique across all
557 inferiors. */
558 int num = 0;
559
560 /* Actual target inferior id, usually, a process id. This matches
561 the ptid_t.pid member of threads of this inferior. */
562 int pid = 0;
563 /* True if the PID was actually faked by GDB. */
564 bool fake_pid_p = false;
565
566 /* The highest thread number this inferior ever had. */
567 int highest_thread_num = 0;
568
569 /* State of GDB control of inferior process execution.
570 See `struct inferior_control_state'. */
572
573 /* True if this was an auto-created inferior, e.g. created from
574 following a fork; false, if this inferior was manually added by
575 the user, and we should not attempt to prune it
576 automatically. */
577 bool removable = false;
578
579 /* The address space bound to this inferior. */
580 struct address_space *aspace = NULL;
581
582 /* The program space bound to this inferior. */
583 struct program_space *pspace = NULL;
584
585 /* The terminal state as set by the last target_terminal::terminal_*
586 call. */
588
589 /* Environment to use for running inferior,
590 in format described in environ.h. */
591 gdb_environ environment;
592
593 /* True if this child process was attached rather than forked. */
594 bool attach_flag = false;
595
596 /* If this inferior is a vfork child, then this is the pointer to
597 its vfork parent, if GDB is still attached to it. */
598 inferior *vfork_parent = NULL;
599
600 /* If this process is a vfork parent, this is the pointer to the
601 child. Since a vfork parent is left frozen by the kernel until
602 the child execs or exits, a process can only have one vfork child
603 at a given time. */
604 inferior *vfork_child = NULL;
605
606 /* True if this inferior should be detached when it's vfork sibling
607 exits or execs. */
608 bool pending_detach = false;
609
610 /* If non-nullptr, points to a thread that called vfork and is now waiting
611 for a vfork child not under our control to be done with the shared memory
612 region, either by exiting or execing. */
614
615 /* True if we're in the process of detaching from this inferior. */
616 bool detaching = false;
617
618 /* True if setup_inferior wasn't called for this inferior yet.
619 Until that is done, we must not access inferior memory or
620 registers, as we haven't determined the target
621 architecture/description. */
622 bool needs_setup = false;
623
624 /* True if the inferior is starting up (inside startup_inferior),
625 and we're nursing it along (through the shell) until it is ready
626 to execute its first instruction. Until that is done, we must
627 not access inferior memory or registers, as we haven't determined
628 the target architecture/description. */
629 bool starting_up = false;
630
631 /* True when we are reading the library list of the inferior during an
632 attach or handling a fork child. */
633 bool in_initial_library_scan = false;
634
635 /* Private data used by the process_stratum target. */
636 std::unique_ptr<private_inferior> priv;
637
638 /* HAS_EXIT_CODE is true if the inferior exited with an exit code.
639 In this case, the EXIT_CODE field is also valid. */
640 bool has_exit_code = false;
641 LONGEST exit_code = 0;
642
643 /* Default flags to pass to the symbol reading functions. These are
644 used whenever a new objfile is created. */
645 symfile_add_flags symfile_flags = 0;
646
647 /* Info about an inferior's target description (if it's fetched; the
648 user supplied description's filename, if any; etc.). */
650
651 /* The architecture associated with the inferior through the
652 connection to the target.
653
654 The architecture vector provides some information that is really
655 a property of the inferior, accessed through a particular target:
656 ptrace operations; the layout of certain RSP packets; the
657 solib_ops vector; etc. To differentiate architecture accesses to
658 per-inferior/target properties from
659 per-thread/per-frame/per-objfile properties, accesses to
660 per-inferior/target properties should be made through
661 this gdbarch. */
662 struct gdbarch *gdbarch = NULL;
663
664 /* Data related to displaced stepping. */
666
667 /* Per inferior data-pointers required by other GDB modules. */
669
670private:
671
672 /* Unpush TARGET and assert that it worked. */
673 void unpush_target_and_assert (struct target_ops *target);
674
675 /* The inferior's target stack. */
677
678 /* The name of terminal device to use for I/O. */
679 std::string m_terminal;
680
681 /* The list of continuations. */
682 std::list<std::function<void ()>> m_continuations;
683
684 /* The arguments string to use when running. */
685 std::string m_args;
686
687 /* The current working directory that will be used when starting
688 this inferior. */
689 std::string m_cwd;
690};
691
692/* Add an inferior to the inferior list, print a message that a new
693 inferior is found, and return the pointer to the new inferior.
694 Caller may use this pointer to initialize the private inferior
695 data. */
696extern struct inferior *add_inferior (int pid);
697
698/* Same as add_inferior, but don't print new inferior notifications to
699 the CLI. */
700extern struct inferior *add_inferior_silent (int pid);
701
702extern void delete_inferior (struct inferior *todel);
703
704/* Delete an existing inferior list entry, due to inferior detaching. */
705extern void detach_inferior (inferior *inf);
706
707/* Notify observers and interpreters that INF has gone away. Reset the INF
708 object back to an default, empty, state. Clear register and frame
709 caches. */
710extern void exit_inferior (inferior *inf);
711
712extern void inferior_appeared (struct inferior *inf, int pid);
713
714/* Search function to lookup an inferior of TARG by target 'pid'. */
716 int pid);
717
718/* Search function to lookup an inferior of TARG whose pid is equal to
719 'ptid.pid'. */
721 ptid_t ptid);
722
723/* Search function to lookup an inferior by GDB 'num'. */
724extern struct inferior *find_inferior_id (int num);
725
726/* Find an inferior bound to PSPACE, giving preference to the current
727 inferior. */
728extern struct inferior *
730
731/* Returns true if the inferior list is not empty. */
732extern int have_inferiors (void);
733
734/* Returns the number of live inferiors running on PROC_TARGET (real
735 live processes with execution). */
736extern int number_of_live_inferiors (process_stratum_target *proc_target);
737
738/* Returns true if there are any live inferiors in the inferior list
739 (not cores, not executables, real live processes). */
740extern int have_live_inferiors (void);
741
742/* Save/restore the current inferior. */
758};
759
760/* When reading memory from an inferior, the global inferior_ptid must
761 also be set. This class arranges to save and restore the necessary
762 state for reading or writing memory, but without invalidating the
763 frame cache. */
766{
767public:
768
769 /* Save the current globals and switch to the given inferior and the
770 inferior's program space. inferior_ptid is set to point to the
771 inferior's process id (and not to any particular thread). */
774 {
777 inferior_ptid = ptid_t (inf->pid);
778 }
781
782private:
786 scoped_restore_tmpl<ptid_t> m_save_ptid;
787};
788
789
790/* Traverse all inferiors. */
791
792extern intrusive_list<inferior> inferior_list;
793
794/* Pull in the internals of the inferiors ranges and iterators. Must
795 be done after struct inferior is defined. */
796#include "inferior-iter.h"
797
798/* Return a range that can be used to walk over all inferiors
799 inferiors, with range-for, safely. I.e., it is safe to delete the
800 currently-iterated inferior. When combined with range-for, this
801 allow convenient patterns like this:
802
803 for (inferior *inf : all_inferiors_safe ())
804 if (some_condition ())
805 delete inf;
806*/
807
812}
813
814/* Returns a range representing all inferiors, suitable to use with
815 range-for, like this:
816
817 for (inferior *inf : all_inferiors ())
818 [...]
819*/
820
822all_inferiors (process_stratum_target *proc_target = nullptr)
823{
824 return all_inferiors_range (proc_target, inferior_list);
825}
826
827/* Return a range that can be used to walk over all inferiors with PID
828 not zero, with range-for. */
829
834}
835
836/* Prune away automatically added inferiors that aren't required
837 anymore. */
838extern void prune_inferiors (void);
839
840extern int number_of_inferiors (void);
841
842extern struct inferior *add_inferior_with_spaces (void);
843
844/* Print the current selected inferior. */
845extern void print_selected_inferior (struct ui_out *uiout);
846
847/* Switch to inferior NEW_INF, a new inferior, and unless
848 NO_CONNECTION is true, push the process_stratum_target of ORG_INF
849 to NEW_INF. */
850
852 (inferior *new_inf, bool no_connection, inferior *org_inf);
853
854/* Return true if ID is a valid global inferior number. */
855
856inline bool
858{
859 for (inferior *inf : all_inferiors ())
860 if (inf->num == id)
861 return true;
862 return false;
863}
864
865#endif /* !defined (INFERIOR_H) */
int regnum
void delete_longjmp_breakpoint(int thread)
stop_stack_kind
target_ops * top_target()
Definition inferior.h:428
inferior_control_state control
Definition inferior.h:570
std::string m_cwd
Definition inferior.h:688
std::string m_terminal
Definition inferior.h:678
target_desc_info tdesc_info
Definition inferior.h:648
int pid
Definition inferior.h:561
registry< inferior > registry_fields
Definition inferior.h:667
void pop_all_targets()
Definition inferior.h:434
void pop_all_targets_above(enum strata stratum)
Definition inferior.c:129
inferior * vfork_parent
Definition inferior.h:597
thread_info * find_thread(ptid_t ptid)
Definition inferior.c:238
int unpush_target(struct target_ops *t)
Definition inferior.c:96
void set_args(std::string args)
Definition inferior.h:522
target_terminal_state terminal_state
Definition inferior.h:586
void unpush_target_and_assert(struct target_ops *target)
Definition inferior.c:117
void do_all_continuations()
Definition inferior.c:183
bool fake_pid_p
Definition inferior.h:563
gdb_environ environment
Definition inferior.h:590
const std::string & cwd() const
Definition inferior.h:550
bool has_exit_code
Definition inferior.h:639
symfile_add_flags symfile_flags
Definition inferior.h:644
bool pending_detach
Definition inferior.h:607
bool starting_up
Definition inferior.h:628
displaced_step_inferior_state displaced_step_state
Definition inferior.h:664
std::unique_ptr< private_inferior > priv
Definition inferior.h:635
std::unordered_map< ptid_t, thread_info * > ptid_thread_map
Definition inferior.h:464
target_stack m_target_stack
Definition inferior.h:675
bool has_execution()
Definition inferior.h:456
safe_inf_threads_range threads_safe()
Definition inferior.h:492
void push_target(struct target_ops *t)
Definition inferior.h:406
bool deletable() const
Definition inferior.h:403
int highest_thread_num
Definition inferior.h:566
struct process_stratum_target * process_target()
Definition inferior.h:449
bool needs_setup
Definition inferior.h:621
thread_info * thread_waiting_for_vfork_done
Definition inferior.h:612
void clear_thread_list()
Definition inferior.c:250
const std::string & args() const
Definition inferior.h:533
void add_continuation(std::function< void()> &&cont)
Definition inferior.c:177
bool removable
Definition inferior.h:576
struct address_space * aspace
Definition inferior.h:579
bool detaching
Definition inferior.h:615
void pop_all_targets_at_and_above(enum strata stratum)
Definition inferior.c:144
LONGEST exit_code
Definition inferior.h:640
std::string m_args
Definition inferior.h:684
const std::string & tty()
Definition inferior.c:163
inf_non_exited_threads_range non_exited_threads()
Definition inferior.h:481
~inferior()
Definition inferior.c:71
target_ops * find_target_beneath(const target_ops *t)
Definition inferior.h:424
void set_tty(std::string terminal_name)
Definition inferior.c:157
inferior * vfork_child
Definition inferior.h:603
bool attach_flag
Definition inferior.h:593
inf_threads_range threads()
Definition inferior.h:472
bool target_is_pushed(const target_ops *t) const
Definition inferior.h:420
intrusive_list< thread_info > thread_list
Definition inferior.h:460
bool in_initial_library_scan
Definition inferior.h:632
std::list< std::function< void()> > m_continuations
Definition inferior.h:681
void set_cwd(std::string cwd)
Definition inferior.h:541
inferior(int pid)
Definition inferior.c:85
int num
Definition inferior.h:557
struct program_space * pspace
Definition inferior.h:582
target_ops * target_at(enum strata stratum)
Definition inferior.h:453
scoped_restore_current_inferior_for_memory(inferior *inf)
Definition inferior.h:771
DISABLE_COPY_AND_ASSIGN(scoped_restore_current_inferior_for_memory)
scoped_restore_current_inferior m_save_inferior
Definition inferior.h:783
scoped_restore_tmpl< ptid_t > m_save_ptid
Definition inferior.h:785
scoped_restore_current_program_space m_save_progspace
Definition inferior.h:784
DISABLE_COPY_AND_ASSIGN(scoped_restore_current_inferior)
void push(target_ops *t)
Definition target.c:1197
target_ops * top() const
Definition target.h:1400
bool is_pushed(const target_ops *t) const
Definition target.h:1393
target_ops * at(strata stratum) const
Definition target.h:1397
target_ops * find_beneath(const target_ops *t) const
Definition target.c:3599
all_matching_threads_range all_threads(process_stratum_target *proc_target=nullptr, ptid_t filter_ptid=minus_one_ptid)
Definition gdbthread.h:742
mach_port_t mach_port_t name mach_port_t mach_port_t name kern_return_t int int rusage_t pid_t pid
Definition gnu-nat.c:1791
iterator_range< all_inferiors_safe_iterator > all_inferiors_safe_range
iterator_range< all_inferiors_iterator > all_inferiors_range
iterator_range< all_non_exited_inferiors_iterator > all_non_exited_inferiors_range
void discard_infcall_suspend_state(struct infcall_suspend_state *)
Definition infrun.c:9641
CORE_ADDR unsigned_pointer_to_address(struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf)
Definition findvar.c:307
void inferior_appeared(struct inferior *inf, int pid)
Definition inferior.c:363
void continue_1(int all_threads)
Definition infcmd.c:601
void restore_infcall_control_state(struct infcall_control_state *)
Definition infrun.c:9706
struct inferior * add_inferior_silent(int pid)
Definition inferior.c:203
struct inferior * add_inferior_with_spaces(void)
Definition inferior.c:832
void print_selected_inferior(struct ui_out *uiout)
Definition inferior.c:508
void address_to_signed_pointer(struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr)
Definition findvar.c:336
void attach_command(const char *, int)
Definition infcmd.c:2653
void prepare_execution_command(struct target_ops *target, int background)
Definition infcmd.c:335
void exit_inferior(inferior *inf)
Definition inferior.c:307
all_inferiors_safe_range all_inferiors_safe()
Definition inferior.h:808
tribool is_gdb_terminal(const char *tty)
Definition inflow.c:218
bool valid_global_inferior_id(int id)
Definition inferior.h:856
void set_sigint_trap(void)
Definition inflow.c:866
std::unique_ptr< infcall_control_state, infcall_control_state_deleter > infcall_control_state_up
Definition inferior.h:119
void restore_infcall_suspend_state(struct infcall_suspend_state *)
Definition infrun.c:9630
void reopen_exec_file(void)
Definition corefile.c:106
infcall_suspend_state_up save_infcall_suspend_state()
Definition infrun.c:9609
all_inferiors_range all_inferiors(process_stratum_target *proc_target=nullptr)
Definition inferior.h:821
ptid_t inferior_ptid
Definition infcmd.c:74
void child_terminal_ours(struct target_ops *self)
Definition inflow.c:403
struct inferior * find_inferior_ptid(process_stratum_target *targ, ptid_t ptid)
Definition inferior.c:406
void detach_command(const char *, int)
Definition infcmd.c:2840
void discard_infcall_control_state(struct infcall_control_state *)
Definition infrun.c:9738
struct inferior * find_inferior_pid(process_stratum_target *targ, int pid)
Definition inferior.c:389
void child_terminal_init(struct target_ops *self)
Definition inflow.c:182
void child_terminal_info(struct target_ops *self, const char *, int)
Definition inflow.c:660
infcall_control_state_up save_infcall_control_state()
Definition infrun.c:9675
ptid_t gdb_startup_inferior(pid_t pid, int num_traps)
Definition fork-child.c:124
CORE_ADDR signed_pointer_to_address(struct gdbarch *gdbarch, struct type *type, const gdb_byte *buf)
Definition findvar.c:316
int number_of_inferiors(void)
Definition inferior.c:487
stop_kind
Definition inferior.h:293
@ NO_STOP_QUIETLY
Definition inferior.h:294
@ STOP_QUIETLY_REMOTE
Definition inferior.h:296
@ STOP_QUIETLY_NO_SIGSTOP
Definition inferior.h:297
@ STOP_QUIETLY
Definition inferior.h:295
void registers_info(const char *, int)
Definition infcmd.c:2328
gdb::optional< scoped_restore_current_thread > maybe_switch_inferior(inferior *inf)
Definition inferior.c:722
void child_pass_ctrlc(struct target_ops *self)
Definition inflow.c:539
bool print_inferior_events
Definition inferior.c:47
void set_current_inferior(inferior *)
Definition inferior.c:61
int have_inferiors(void)
Definition inferior.c:429
void child_terminal_ours_for_output(struct target_ops *self)
Definition inflow.c:389
readonly_detached_regcache * get_infcall_suspend_state_regcache(struct infcall_suspend_state *)
Definition infrun.c:9647
void detach_inferior(inferior *inf)
Definition inferior.c:340
void interrupt_target_1(bool all_threads)
Definition infcmd.c:2933
int have_live_inferiors(void)
Definition inferior.c:462
void switch_to_inferior_and_push_target(inferior *new_inf, bool no_connection, inferior *org_inf)
Definition inferior.c:861
void c_c_handler_ftype(int)
Definition inferior.h:183
void child_interrupt(struct target_ops *self)
Definition inflow.c:505
void generic_mourn_inferior(void)
Definition target.c:3661
inferior * current_inferior()
Definition inferior.c:55
struct value * get_return_value(struct symbol *func_symbol, struct value *function)
Definition infcmd.c:1467
void notice_new_inferior(struct thread_info *, bool, int)
Definition infcmd.c:2788
int stopped_by_random_signal
Definition infcmd.c:83
void child_terminal_inferior(struct target_ops *self)
Definition inflow.c:300
FORWARD_SCOPE_EXIT(delete_longjmp_breakpoint) delete_longjmp_breakpoint_cleanup
Definition inferior.h:232
struct inferior * add_inferior(int pid)
Definition inferior.c:218
struct inferior * find_inferior_for_program_space(struct program_space *pspace)
Definition inferior.c:414
void switch_to_inferior_no_thread(inferior *inf)
Definition inferior.c:712
void setup_inferior(int from_tty)
Definition infcmd.c:2538
void child_terminal_save_inferior(struct target_ops *self)
Definition inflow.c:412
enum stop_stack_kind stop_stack_dummy
Definition infcmd.c:78
std::unique_ptr< infcall_suspend_state, infcall_suspend_state_deleter > infcall_suspend_state_up
Definition inferior.h:103
void default_print_float_info(struct gdbarch *gdbarch, struct ui_file *file, frame_info_ptr frame, const char *args)
Definition infcmd.c:2984
void post_create_inferior(int from_tty)
Definition infcmd.c:232
void prune_inferiors(void)
Definition inferior.c:471
void clear_sigint_trap(void)
Definition inflow.c:881
c_c_handler_ftype * install_sigint_handler(c_c_handler_ftype *fn)
Definition mingw-hdep.c:425
intrusive_list< inferior > inferior_list
Definition inferior.c:43
int number_of_live_inferiors(process_stratum_target *proc_target)
Definition inferior.c:442
all_non_exited_inferiors_range all_non_exited_inferiors(process_stratum_target *proc_target=nullptr)
Definition inferior.h:830
void default_print_registers_info(struct gdbarch *gdbarch, struct ui_file *file, frame_info_ptr frame, int regnum, int all)
Definition infcmd.c:2285
tribool sharing_input_terminal(int pid)
Definition mingw-hdep.c:379
struct inferior * find_inferior_id(int num)
Definition inferior.c:379
void unsigned_address_to_pointer(struct gdbarch *gdbarch, struct type *type, gdb_byte *buf, CORE_ADDR addr)
Definition findvar.c:327
void delete_inferior(struct inferior *todel)
Definition inferior.c:273
@ all
void set_current_program_space(struct program_space *pspace)
Definition progspace.c:243
Definition gnu-nat.c:153
pid_t pid
Definition gnu-nat.c:165
void operator()(struct infcall_control_state *state) const
Definition inferior.h:111
void operator()(struct infcall_suspend_state *state) const
Definition inferior.h:78
enum stop_kind stop_soon
Definition inferior.h:326
virtual ~private_inferior()=0
bool from_user_p()
Definition inferior.h:352
const struct target_desc * tdesc
Definition inferior.h:364
std::string filename
Definition inferior.h:370
Definition value.h:130
target_terminal_state
Definition target.h:134
bool target_has_execution(inferior *inf)
Definition target.c:201
strata
Definition target.h:94
@ process_stratum
Definition target.h:97
@ dummy_stratum
Definition target.h:95
std::unique_ptr< target_ops, target_ops_deleter > target_ops_up
Definition target.h:1347
iterator_range< safe_inf_threads_iterator > safe_inf_threads_range
iterator_range< inf_non_exited_threads_iterator > inf_non_exited_threads_range
iterator_range< inf_threads_iterator > inf_threads_range