2011-05-26 Pedro Alves <pedro@codesourcery.com>
[deliverable/binutils-gdb.git] / gdb / inferior.h
CommitLineData
c906108c
SS
1/* Variables that describe the inferior process running under GDB:
2 Where it is, why it stopped, and how to step it.
1bac305b 3
6aba47ca 4 Copyright (C) 1986, 1988, 1989, 1990, 1991, 1992, 1993, 1994, 1995, 1996,
7b6bb8da
JB
5 1998, 1999, 2000, 2001, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010,
6 2011 Free Software Foundation, Inc.
c906108c 7
c5aa993b 8 This file is part of GDB.
c906108c 9
c5aa993b
JM
10 This program is free software; you can redistribute it and/or modify
11 it under the terms of the GNU General Public License as published by
a9762ec7 12 the Free Software Foundation; either version 3 of the License, or
c5aa993b 13 (at your option) any later version.
c906108c 14
c5aa993b
JM
15 This program is distributed in the hope that it will be useful,
16 but WITHOUT ANY WARRANTY; without even the implied warranty of
17 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 GNU General Public License for more details.
c906108c 19
c5aa993b 20 You should have received a copy of the GNU General Public License
a9762ec7 21 along with this program. If not, see <http://www.gnu.org/licenses/>. */
c906108c
SS
22
23#if !defined (INFERIOR_H)
24#define INFERIOR_H 1
25
da3331ec
AC
26struct target_waitstatus;
27struct frame_info;
28struct ui_file;
29struct type;
67a2b77e 30struct gdbarch;
72cec141 31struct regcache;
b77209e0 32struct ui_out;
7e1789f5 33struct terminal_info;
67a2b77e 34
c906108c
SS
35/* For bpstat. */
36#include "breakpoint.h"
37
38/* For enum target_signal. */
39#include "target.h"
40
aa0cd9c1
AC
41/* For struct frame_id. */
42#include "frame.h"
43
6c95b8df
PA
44#include "progspace.h"
45
16c381f0
JK
46struct infcall_suspend_state;
47struct infcall_control_state;
7a292a7a 48
16c381f0
JK
49extern struct infcall_suspend_state *save_infcall_suspend_state (void);
50extern struct infcall_control_state *save_infcall_control_state (void);
c906108c 51
16c381f0
JK
52extern void restore_infcall_suspend_state (struct infcall_suspend_state *);
53extern void restore_infcall_control_state (struct infcall_control_state *);
b89667eb 54
16c381f0
JK
55extern struct cleanup *make_cleanup_restore_infcall_suspend_state
56 (struct infcall_suspend_state *);
57extern struct cleanup *make_cleanup_restore_infcall_control_state
58 (struct infcall_control_state *);
b89667eb 59
16c381f0
JK
60extern void discard_infcall_suspend_state (struct infcall_suspend_state *);
61extern void discard_infcall_control_state (struct infcall_control_state *);
7a292a7a 62
16c381f0
JK
63extern struct regcache *
64 get_infcall_suspend_state_regcache (struct infcall_suspend_state *);
b89667eb 65
ca6724c1
KB
66/* The -1 ptid, often used to indicate either an error condition
67 or a "don't care" condition, i.e, "run all threads." */
68extern ptid_t minus_one_ptid;
69
1777feb0 70/* The null or zero ptid, often used to indicate no process. */
ca6724c1
KB
71extern ptid_t null_ptid;
72
73/* Attempt to find and return an existing ptid with the given PID, LWP,
74 and TID components. If none exists, create a new one and return
75 that. */
76ptid_t ptid_build (int pid, long lwp, long tid);
77
1777feb0 78/* Find/Create a ptid from just a pid. */
ca6724c1
KB
79ptid_t pid_to_ptid (int pid);
80
1777feb0 81/* Fetch the pid (process id) component from a ptid. */
ca6724c1
KB
82int ptid_get_pid (ptid_t ptid);
83
1777feb0 84/* Fetch the lwp (lightweight process) component from a ptid. */
ca6724c1
KB
85long ptid_get_lwp (ptid_t ptid);
86
1777feb0 87/* Fetch the tid (thread id) component from a ptid. */
ca6724c1
KB
88long ptid_get_tid (ptid_t ptid);
89
1777feb0 90/* Compare two ptids to see if they are equal. */
ca6724c1
KB
91extern int ptid_equal (ptid_t p1, ptid_t p2);
92
252fbfc8
PA
93/* Return true if PTID represents a process id. */
94extern int ptid_is_pid (ptid_t ptid);
95
0723dbf5
PA
96/* Returns true if PTID matches filter FILTER. FILTER can be the wild
97 card MINUS_ONE_PTID (all ptid match it); can be a ptid representing
98 a process (ptid_is_pid returns true), in which case, all lwps and
99 threads of that given process match, lwps and threads of other
100 processes do not; or, it can represent a specific thread, in which
101 case, only that thread will match true. PTID must represent a
102 specific LWP or THREAD, it can never be a wild card. */
103
104extern int ptid_match (ptid_t ptid, ptid_t filter);
105
ce696e05
KB
106/* Save value of inferior_ptid so that it may be restored by
107 a later call to do_cleanups(). Returns the struct cleanup
108 pointer needed for later doing the cleanup. */
109extern struct cleanup * save_inferior_ptid (void);
110
a14ed312 111extern void set_sigint_trap (void);
c906108c 112
a14ed312 113extern void clear_sigint_trap (void);
c906108c 114
3cb3b8df 115/* Set/get file name for default use for standard in/out in the inferior. */
c906108c 116
3cb3b8df
BR
117extern void set_inferior_io_terminal (const char *terminal_name);
118extern const char *get_inferior_io_terminal (void);
c906108c 119
39f77062 120/* Collected pid, tid, etc. of the debugged inferior. When there's
1777feb0 121 no inferior, PIDGET (inferior_ptid) will be 0. */
c906108c 122
39f77062 123extern ptid_t inferior_ptid;
c906108c 124
43ff13b4
JM
125/* Are we simulating synchronous execution? This is used in async gdb
126 to implement the 'run', 'continue' etc commands, which will not
1777feb0 127 redisplay the prompt until the execution is actually over. */
43ff13b4
JM
128extern int sync_execution;
129
1777feb0 130/* Inferior environment. */
c906108c 131
a14ed312 132extern void clear_proceed_status (void);
c906108c 133
a14ed312 134extern void proceed (CORE_ADDR, enum target_signal, int);
c906108c 135
d4db2f36
PA
136extern int sched_multi;
137
5fbbeb29
CF
138/* When set, stop the 'step' command if we enter a function which has
139 no line number information. The normal behavior is that we step
140 over such function. */
141extern int step_stop_if_no_debug;
142
ad52ddc6
PA
143/* If set, the inferior should be controlled in non-stop mode. In
144 this mode, each thread is controlled independently. Execution
b021a221 145 commands apply only to the selected thread by default, and stop
ad52ddc6
PA
146 events stop only the thread that had the event -- the other threads
147 are kept running freely. */
148extern int non_stop;
149
6c95b8df
PA
150/* If set (default), when following a fork, GDB will detach from one
151 the fork branches, child or parent. Exactly which branch is
152 detached depends on 'set follow-fork-mode' setting. */
153extern int detach_fork;
154
a14ed312 155extern void generic_mourn_inferior (void);
c906108c 156
a790ad35
SC
157extern void terminal_save_ours (void);
158
a14ed312 159extern void terminal_ours (void);
c906108c 160
9898f801
UW
161extern CORE_ADDR unsigned_pointer_to_address (struct gdbarch *gdbarch,
162 struct type *type,
b60c417a 163 const gdb_byte *buf);
9898f801
UW
164extern void unsigned_address_to_pointer (struct gdbarch *gdbarch,
165 struct type *type, gdb_byte *buf,
ac2e2ef7 166 CORE_ADDR addr);
9898f801
UW
167extern CORE_ADDR signed_pointer_to_address (struct gdbarch *gdbarch,
168 struct type *type,
b60c417a 169 const gdb_byte *buf);
9898f801
UW
170extern void address_to_signed_pointer (struct gdbarch *gdbarch,
171 struct type *type, gdb_byte *buf,
ac2e2ef7 172 CORE_ADDR addr);
4478b372 173
e4c8541f 174extern void wait_for_inferior (void);
c906108c 175
24291992
PA
176extern void prepare_for_detach (void);
177
a14ed312 178extern void fetch_inferior_event (void *);
43ff13b4 179
a14ed312 180extern void init_wait_for_inferior (void);
c906108c 181
a14ed312 182extern void close_exec_file (void);
c906108c 183
a14ed312 184extern void reopen_exec_file (void);
c906108c
SS
185
186/* The `resume' routine should only be called in special circumstances.
187 Normally, use `proceed', which handles a lot of bookkeeping. */
188
a14ed312 189extern void resume (int, enum target_signal);
c906108c 190
09cee04b
PA
191extern ptid_t user_visible_resume_ptid (int step);
192
9da8c2a0
PA
193extern void insert_step_resume_breakpoint_at_sal (struct gdbarch *,
194 struct symtab_and_line ,
195 struct frame_id);
196
c906108c
SS
197/* From misc files */
198
0ab7a791
AC
199extern void default_print_registers_info (struct gdbarch *gdbarch,
200 struct ui_file *file,
201 struct frame_info *frame,
202 int regnum, int all);
666e11c5 203
a14ed312 204extern void child_terminal_info (char *, int);
c906108c 205
a14ed312 206extern void term_info (char *, int);
c906108c 207
a14ed312 208extern void terminal_ours_for_output (void);
c906108c 209
a14ed312 210extern void terminal_inferior (void);
c906108c 211
a14ed312 212extern void terminal_init_inferior (void);
c906108c 213
a14ed312 214extern void terminal_init_inferior_with_pgrp (int pgrp);
c906108c 215
c906108c
SS
216/* From fork-child.c */
217
136d6dae
VP
218extern int fork_inferior (char *, char *, char **,
219 void (*)(void),
220 void (*)(int), void (*)(void), char *);
c906108c
SS
221
222
a14ed312 223extern void startup_inferior (int);
c906108c 224
bd57a748 225extern char *construct_inferior_arguments (int, char **);
552c04a7 226
c906108c
SS
227/* From infrun.c */
228
628fe4e4
JK
229extern int debug_infrun;
230
231extern int stop_on_solib_events;
232
8621d6a9 233extern void start_remote (int from_tty);
c906108c 234
a14ed312 235extern void normal_stop (void);
c906108c 236
a14ed312 237extern int signal_stop_state (int);
c906108c 238
a14ed312 239extern int signal_print_state (int);
c906108c 240
a14ed312 241extern int signal_pass_state (int);
c906108c 242
a14ed312 243extern int signal_stop_update (int, int);
d4f3574e 244
a14ed312 245extern int signal_print_update (int, int);
d4f3574e 246
a14ed312 247extern int signal_pass_update (int, int);
d4f3574e 248
39f77062
KB
249extern void get_last_target_status(ptid_t *ptid,
250 struct target_waitstatus *status);
e02bc4cc 251
6604731b
DJ
252extern void follow_inferior_reset_breakpoints (void);
253
94cc34af
PA
254/* Throw an error indicating the current thread is running. */
255extern void error_is_running (void);
256
257/* Calls error_is_running if the current thread is running. */
258extern void ensure_not_running (void);
259
edb3359d
DJ
260void set_step_info (struct frame_info *frame, struct symtab_and_line sal);
261
c906108c
SS
262/* From infcmd.c */
263
281b533b
DJ
264extern void post_create_inferior (struct target_ops *, int);
265
a14ed312 266extern void attach_command (char *, int);
c906108c 267
a250df2e 268extern char *get_inferior_args (void);
07091751 269
3f81c18a 270extern void set_inferior_args (char *);
07091751 271
552c04a7
TT
272extern void set_inferior_args_vector (int, char **);
273
36dc181b
EZ
274extern void registers_info (char *, int);
275
276extern void nexti_command (char *, int);
277
278extern void stepi_command (char *, int);
279
77ebaa5a
VP
280extern void continue_1 (int all_threads);
281
36dc181b
EZ
282extern void continue_command (char *, int);
283
284extern void interrupt_target_command (char *args, int from_tty);
285
77ebaa5a
VP
286extern void interrupt_target_1 (int all_threads);
287
186c406b
TT
288extern void delete_longjmp_breakpoint_cleanup (void *arg);
289
6418d433
VP
290extern void detach_command (char *, int);
291
1941c569
PA
292extern void notice_new_inferior (ptid_t, int, int);
293
c906108c
SS
294/* Address at which inferior stopped. */
295
296extern CORE_ADDR stop_pc;
297
c906108c
SS
298/* Nonzero if stopped due to completion of a stack dummy routine. */
299
aa7d318d 300extern enum stop_stack_kind stop_stack_dummy;
c906108c
SS
301
302/* Nonzero if program stopped due to a random (unexpected) signal in
303 inferior process. */
304
305extern int stopped_by_random_signal;
306
a49f981f
MS
307/* STEP_OVER_ALL means step over all subroutine calls.
308 STEP_OVER_UNDEBUGGABLE means step over calls to undebuggable functions.
309 STEP_OVER_NONE means don't step over any subroutine calls. */
c906108c 310
5fbbeb29
CF
311enum step_over_calls_kind
312 {
313 STEP_OVER_NONE,
314 STEP_OVER_ALL,
a4acd088
CF
315 STEP_OVER_UNDEBUGGABLE
316 };
317
b0f4b84b
DJ
318/* Anything but NO_STOP_QUIETLY means we expect a trap and the caller
319 will handle it themselves. STOP_QUIETLY is used when running in
320 the shell before the child program has been exec'd and when running
321 through shared library loading. STOP_QUIETLY_REMOTE is used when
322 setting up a remote connection; it is like STOP_QUIETLY_NO_SIGSTOP
323 except that there is no need to hide a signal. */
c54cfec8 324
1777feb0 325/* It is also used after attach, due to attaching to a process. This
c54cfec8
EZ
326 is a bit trickier. When doing an attach, the kernel stops the
327 debuggee with a SIGSTOP. On newer GNU/Linux kernels (>= 2.5.61)
1777feb0 328 the handling of SIGSTOP for a ptraced process has changed. Earlier
c54cfec8
EZ
329 versions of the kernel would ignore these SIGSTOPs, while now
330 SIGSTOP is treated like any other signal, i.e. it is not muffled.
331
332 If the gdb user does a 'continue' after the 'attach', gdb passes
333 the global variable stop_signal (which stores the signal from the
334 attach, SIGSTOP) to the ptrace(PTRACE_CONT,...) call. This is
335 problematic, because the kernel doesn't ignore such SIGSTOP
1777feb0 336 now. I.e. it is reported back to gdb, which in turn presents it
c54cfec8
EZ
337 back to the user.
338
339 To avoid the problem, we use STOP_QUIETLY_NO_SIGSTOP, which allows
340 gdb to clear the value of stop_signal after the attach, so that it
341 is not passed back down to the kernel. */
342
343enum stop_kind
344 {
345 NO_STOP_QUIETLY = 0,
346 STOP_QUIETLY,
b0f4b84b 347 STOP_QUIETLY_REMOTE,
c54cfec8
EZ
348 STOP_QUIETLY_NO_SIGSTOP
349 };
c906108c 350
b2175913
MS
351/* Reverse execution. */
352enum exec_direction_kind
353 {
354 EXEC_FORWARD,
355 EXEC_REVERSE,
356 EXEC_ERROR
357 };
358
359extern enum exec_direction_kind execution_direction;
360
642fd101
DE
361/* Save register contents here when executing a "finish" command or are
362 about to pop a stack dummy frame, if-and-only-if proceed_to_finish is set.
c906108c
SS
363 Thus this contains the return value from the called function (assuming
364 values are returned in a register). */
365
72cec141 366extern struct regcache *stop_registers;
c906108c 367
237fc4c9
PA
368/* True if we are debugging displaced stepping. */
369extern int debug_displaced;
370
371/* Dump LEN bytes at BUF in hex to FILE, followed by a newline. */
372void displaced_step_dump_bytes (struct ui_file *file,
373 const gdb_byte *buf, size_t len);
374
9a1edae6 375struct displaced_step_closure *get_displaced_step_closure_by_addr (CORE_ADDR addr);
c906108c 376\f
faaf634c 377/* Possible values for gdbarch_call_dummy_location. */
c906108c 378#define ON_STACK 1
c906108c 379#define AT_ENTRY_POINT 4
9710e734 380#define AT_SYMBOL 5
c906108c 381
c906108c
SS
382/* If STARTUP_WITH_SHELL is set, GDB's "run"
383 will attempts to start up the debugee under a shell.
1777feb0 384 This is in order for argument-expansion to occur. E.g.,
c906108c
SS
385 (gdb) run *
386 The "*" gets expanded by the shell into a list of files.
387 While this is a nice feature, it turns out to interact badly
388 with some of the catch-fork/catch-exec features we have added.
389 In particular, if the shell does any fork/exec's before
390 the exec of the target program, that can confuse GDB.
391 To disable this feature, set STARTUP_WITH_SHELL to 0.
392 To enable this feature, set STARTUP_WITH_SHELL to 1.
393 The catch-exec traps expected during start-up will
394 be 1 if target is not started up with a shell, 2 if it is.
395 - RT
396 If you disable this, you need to decrement
1777feb0 397 START_INFERIOR_TRAPS_EXPECTED in tm.h. */
c906108c
SS
398#define STARTUP_WITH_SHELL 1
399#if !defined(START_INFERIOR_TRAPS_EXPECTED)
400#define START_INFERIOR_TRAPS_EXPECTED 2
401#endif
b77209e0
PA
402
403struct private_inferior;
404
16c381f0
JK
405/* Inferior process specific part of `struct infcall_control_state'.
406
407 Inferior thread counterpart is `struct thread_control_state'. */
408
409struct inferior_control_state
410{
411 /* See the definition of stop_kind above. */
412 enum stop_kind stop_soon;
413};
414
415/* Inferior process specific part of `struct infcall_suspend_state'.
416
417 Inferior thread counterpart is `struct thread_suspend_state'. */
418
419struct inferior_suspend_state
420{
421};
422
b77209e0
PA
423/* GDB represents the state of each program execution with an object
424 called an inferior. An inferior typically corresponds to a process
425 but is more general and applies also to targets that do not have a
426 notion of processes. Each run of an executable creates a new
427 inferior, as does each attachment to an existing process.
428 Inferiors have unique internal identifiers that are different from
429 target process ids. Each inferior may in turn have multiple
430 threads running in it. */
431
432struct inferior
433{
434 /* Pointer to next inferior in singly-linked list of inferiors. */
435 struct inferior *next;
436
437 /* Convenient handle (GDB inferior id). Unique across all
438 inferiors. */
439 int num;
440
441 /* Actual target inferior id, usually, a process id. This matches
442 the ptid_t.pid member of threads of this inferior. */
443 int pid;
444
16c381f0
JK
445 /* State of GDB control of inferior process execution.
446 See `struct inferior_control_state'. */
447 struct inferior_control_state control;
448
449 /* State of inferior process to restore after GDB is done with an inferior
450 call. See `struct inferior_suspend_state'. */
451 struct inferior_suspend_state suspend;
452
6c95b8df
PA
453 /* True if this was an auto-created inferior, e.g. created from
454 following a fork; false, if this inferior was manually added by
455 the user, and we should not attempt to prune it
456 automatically. */
457 int removable;
458
459 /* The address space bound to this inferior. */
460 struct address_space *aspace;
461
462 /* The program space bound to this inferior. */
463 struct program_space *pspace;
464
3f81c18a
VP
465 /* The arguments string to use when running. */
466 char *args;
467
468 /* The size of elements in argv. */
469 int argc;
470
471 /* The vector version of arguments. If ARGC is nonzero,
472 then we must compute ARGS from this (via the target).
473 This is always coming from main's argv and therefore
474 should never be freed. */
475 char **argv;
476
477 /* The name of terminal device to use for I/O. */
478 char *terminal;
479
480 /* Environment to use for running inferior,
481 in format described in environ.h. */
482 struct gdb_environ *environment;
483
181e7f93
PA
484 /* Nonzero if this child process was attached rather than
485 forked. */
486 int attach_flag;
487
6c95b8df
PA
488 /* If this inferior is a vfork child, then this is the pointer to
489 its vfork parent, if GDB is still attached to it. */
490 struct inferior *vfork_parent;
491
492 /* If this process is a vfork parent, this is the pointer to the
493 child. Since a vfork parent is left frozen by the kernel until
494 the child execs or exits, a process can only have one vfork child
495 at a given time. */
496 struct inferior *vfork_child;
497
498 /* True if this inferior should be detached when it's vfork sibling
499 exits or execs. */
500 int pending_detach;
501
502 /* True if this inferior is a vfork parent waiting for a vfork child
503 not under our control to be done with the shared memory region,
504 either by exiting or execing. */
505 int waiting_for_vfork_done;
506
24291992
PA
507 /* True if we're in the process of detaching from this inferior. */
508 int detaching;
509
e0ba6746
PA
510 /* What is left to do for an execution command after any thread of
511 this inferior stops. For continuations associated with a
512 specific thread, see `struct thread_info'. */
513 struct continuation *continuations;
514
b77209e0
PA
515 /* Private data used by the target vector implementation. */
516 struct private_inferior *private;
a96d9b2e
SDJ
517
518 /* We keep a count of the number of times the user has requested a
519 particular syscall to be tracked, and pass this information to the
520 target. This lets capable targets implement filtering directly. */
521
522 /* Number of times that "any" syscall is requested. */
523 int any_syscall_count;
524
525 /* Count of each system call. */
526 VEC(int) *syscalls_counts;
527
528 /* This counts all syscall catch requests, so we can readily determine
529 if any catching is necessary. */
530 int total_syscalls_count;
6c95b8df
PA
531
532 /* Per inferior data-pointers required by other GDB modules. */
533 void **data;
534 unsigned num_data;
b77209e0
PA
535};
536
6c95b8df
PA
537/* Keep a registry of per-inferior data-pointers required by other GDB
538 modules. */
539
540extern const struct inferior_data *register_inferior_data (void);
541extern const struct inferior_data *register_inferior_data_with_cleanup
542 (void (*cleanup) (struct inferior *, void *));
543extern void clear_inferior_data (struct inferior *inf);
544extern void set_inferior_data (struct inferior *inf,
545 const struct inferior_data *data, void *value);
546extern void *inferior_data (struct inferior *inf,
547 const struct inferior_data *data);
548
b77209e0
PA
549/* Create an empty inferior list, or empty the existing one. */
550extern void init_inferior_list (void);
551
552/* Add an inferior to the inferior list, print a message that a new
553 inferior is found, and return the pointer to the new inferior.
554 Caller may use this pointer to initialize the private inferior
555 data. */
556extern struct inferior *add_inferior (int pid);
557
558/* Same as add_inferior, but don't print new inferior notifications to
559 the CLI. */
560extern struct inferior *add_inferior_silent (int pid);
561
562/* Delete an existing inferior list entry, due to inferior exit. */
563extern void delete_inferior (int pid);
564
a79b8f6e
VP
565extern void delete_inferior_1 (struct inferior *todel, int silent);
566
b77209e0
PA
567/* Same as delete_inferior, but don't print new inferior notifications
568 to the CLI. */
569extern void delete_inferior_silent (int pid);
570
571/* Delete an existing inferior list entry, due to inferior detaching. */
572extern void detach_inferior (int pid);
573
6c95b8df
PA
574extern void exit_inferior (int pid);
575
576extern void exit_inferior_silent (int pid);
577
578extern void exit_inferior_num_silent (int num);
579
580extern void inferior_appeared (struct inferior *inf, int pid);
581
82f73884
PA
582/* Get rid of all inferiors. */
583extern void discard_all_inferiors (void);
584
b77209e0
PA
585/* Translate the integer inferior id (GDB's homegrown id, not the system's)
586 into a "pid" (which may be overloaded with extra inferior information). */
587extern int gdb_inferior_id_to_pid (int);
588
589/* Translate a target 'pid' into the integer inferior id (GDB's
590 homegrown id, not the system's). */
591extern int pid_to_gdb_inferior_id (int pid);
592
593/* Boolean test for an already-known pid. */
594extern int in_inferior_list (int pid);
595
596/* Boolean test for an already-known inferior id (GDB's homegrown id,
597 not the system's). */
2c0b251b 598extern int valid_gdb_inferior_id (int num);
b77209e0 599
6c95b8df 600/* Search function to lookup an inferior by target 'pid'. */
b77209e0
PA
601extern struct inferior *find_inferior_pid (int pid);
602
6c95b8df
PA
603/* Search function to lookup an inferior by GDB 'num'. */
604extern struct inferior *find_inferior_id (int num);
605
606/* Find an inferior bound to PSPACE. */
607extern struct inferior *
608 find_inferior_for_program_space (struct program_space *pspace);
609
b77209e0
PA
610/* Inferior iterator function.
611
612 Calls a callback function once for each inferior, so long as the
613 callback function returns false. If the callback function returns
614 true, the iteration will end and the current inferior will be
615 returned. This can be useful for implementing a search for a
616 inferior with arbitrary attributes, or for applying some operation
617 to every inferior.
618
619 It is safe to delete the iterated inferior from the callback. */
620extern struct inferior *iterate_over_inferiors (int (*) (struct inferior *,
621 void *),
622 void *);
623
b77209e0
PA
624/* Returns true if the inferior list is not empty. */
625extern int have_inferiors (void);
626
c35b1492
PA
627/* Returns true if there are any live inferiors in the inferior list
628 (not cores, not executables, real live processes). */
629extern int have_live_inferiors (void);
630
b77209e0
PA
631/* Return a pointer to the current inferior. It is an error to call
632 this if there is no current inferior. */
633extern struct inferior *current_inferior (void);
634
6c95b8df
PA
635extern void set_current_inferior (struct inferior *);
636
637extern struct cleanup *save_current_inferior (void);
638
639extern struct inferior *inferior_list;
640
641/* Prune away automatically added inferiors that aren't required
642 anymore. */
643extern void prune_inferiors (void);
644
645extern int number_of_inferiors (void);
646
a79b8f6e
VP
647extern struct inferior *add_inferior_with_spaces (void);
648
d914c394
SS
649extern void update_observer_mode (void);
650
c906108c 651#endif /* !defined (INFERIOR_H) */
This page took 1.263698 seconds and 4 git commands to generate.