/* Multi-process/thread control defs for GDB, the GNU debugger.
|
/* Multi-process/thread control defs for GDB, the GNU debugger.
|
Copyright (C) 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1997, 1998, 1999,
|
Copyright (C) 1987, 1988, 1989, 1990, 1991, 1992, 1993, 1997, 1998, 1999,
|
2000, 2007, 2008 Free Software Foundation, Inc.
|
2000, 2007, 2008 Free Software Foundation, Inc.
|
Contributed by Lynx Real-Time Systems, Inc. Los Gatos, CA.
|
Contributed by Lynx Real-Time Systems, Inc. Los Gatos, CA.
|
|
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
This program is free software; you can redistribute it and/or modify
|
it under the terms of the GNU General Public License as published by
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 3 of the License, or
|
the Free Software Foundation; either version 3 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
along with this program. If not, see <http://www.gnu.org/licenses/>. */
|
|
|
#ifndef GDBTHREAD_H
|
#ifndef GDBTHREAD_H
|
#define GDBTHREAD_H
|
#define GDBTHREAD_H
|
|
|
struct breakpoint;
|
struct breakpoint;
|
struct frame_id;
|
struct frame_id;
|
struct symtab;
|
struct symtab;
|
|
|
/* For bpstat */
|
/* For bpstat */
|
#include "breakpoint.h"
|
#include "breakpoint.h"
|
|
|
/* For struct frame_id. */
|
/* For struct frame_id. */
|
#include "frame.h"
|
#include "frame.h"
|
|
|
struct thread_info
|
struct thread_info
|
{
|
{
|
struct thread_info *next;
|
struct thread_info *next;
|
ptid_t ptid; /* "Actual process id";
|
ptid_t ptid; /* "Actual process id";
|
In fact, this may be overloaded with
|
In fact, this may be overloaded with
|
kernel thread id, etc. */
|
kernel thread id, etc. */
|
int num; /* Convenient handle (GDB thread id) */
|
int num; /* Convenient handle (GDB thread id) */
|
/* State from wait_for_inferior */
|
/* State from wait_for_inferior */
|
CORE_ADDR prev_pc;
|
CORE_ADDR prev_pc;
|
struct breakpoint *step_resume_breakpoint;
|
struct breakpoint *step_resume_breakpoint;
|
CORE_ADDR step_range_start;
|
CORE_ADDR step_range_start;
|
CORE_ADDR step_range_end;
|
CORE_ADDR step_range_end;
|
struct frame_id step_frame_id;
|
struct frame_id step_frame_id;
|
int current_line;
|
int current_line;
|
struct symtab *current_symtab;
|
struct symtab *current_symtab;
|
int trap_expected;
|
int trap_expected;
|
int handling_longjmp;
|
int handling_longjmp;
|
int stepping_over_breakpoint;
|
int stepping_over_breakpoint;
|
|
|
/* This is set TRUE when a catchpoint of a shared library event
|
/* This is set TRUE when a catchpoint of a shared library event
|
triggers. Since we don't wish to leave the inferior in the
|
triggers. Since we don't wish to leave the inferior in the
|
solib hook when we report the event, we step the inferior
|
solib hook when we report the event, we step the inferior
|
back to user code before stopping and reporting the event. */
|
back to user code before stopping and reporting the event. */
|
int stepping_through_solib_after_catch;
|
int stepping_through_solib_after_catch;
|
|
|
/* When stepping_through_solib_after_catch is TRUE, this is a
|
/* When stepping_through_solib_after_catch is TRUE, this is a
|
list of the catchpoints that should be reported as triggering
|
list of the catchpoints that should be reported as triggering
|
when we finally do stop stepping. */
|
when we finally do stop stepping. */
|
bpstat stepping_through_solib_catchpoints;
|
bpstat stepping_through_solib_catchpoints;
|
|
|
/* Private data used by the target vector implementation. */
|
/* Private data used by the target vector implementation. */
|
struct private_thread_info *private;
|
struct private_thread_info *private;
|
};
|
};
|
|
|
/* Create an empty thread list, or empty the existing one. */
|
/* Create an empty thread list, or empty the existing one. */
|
extern void init_thread_list (void);
|
extern void init_thread_list (void);
|
|
|
/* Add a thread to the thread list, print a message
|
/* Add a thread to the thread list, print a message
|
that a new thread is found, and return the pointer to
|
that a new thread is found, and return the pointer to
|
the new thread. Caller my use this pointer to
|
the new thread. Caller my use this pointer to
|
initialize the private thread data. */
|
initialize the private thread data. */
|
extern struct thread_info *add_thread (ptid_t ptid);
|
extern struct thread_info *add_thread (ptid_t ptid);
|
|
|
/* Same as add_thread, but does not print a message
|
/* Same as add_thread, but does not print a message
|
about new thread. */
|
about new thread. */
|
extern struct thread_info *add_thread_silent (ptid_t ptid);
|
extern struct thread_info *add_thread_silent (ptid_t ptid);
|
|
|
/* Delete an existing thread list entry. */
|
/* Delete an existing thread list entry. */
|
extern void delete_thread (ptid_t);
|
extern void delete_thread (ptid_t);
|
|
|
/* Delete a step_resume_breakpoint from the thread database. */
|
/* Delete a step_resume_breakpoint from the thread database. */
|
extern void delete_step_resume_breakpoint (void *);
|
extern void delete_step_resume_breakpoint (void *);
|
|
|
/* Translate the integer thread id (GDB's homegrown id, not the system's)
|
/* Translate the integer thread id (GDB's homegrown id, not the system's)
|
into a "pid" (which may be overloaded with extra thread information). */
|
into a "pid" (which may be overloaded with extra thread information). */
|
extern ptid_t thread_id_to_pid (int);
|
extern ptid_t thread_id_to_pid (int);
|
|
|
/* Translate a 'pid' (which may be overloaded with extra thread information)
|
/* Translate a 'pid' (which may be overloaded with extra thread information)
|
into the integer thread id (GDB's homegrown id, not the system's). */
|
into the integer thread id (GDB's homegrown id, not the system's). */
|
extern int pid_to_thread_id (ptid_t ptid);
|
extern int pid_to_thread_id (ptid_t ptid);
|
|
|
/* Boolean test for an already-known pid (which may be overloaded with
|
/* Boolean test for an already-known pid (which may be overloaded with
|
extra thread information). */
|
extra thread information). */
|
extern int in_thread_list (ptid_t ptid);
|
extern int in_thread_list (ptid_t ptid);
|
|
|
/* Boolean test for an already-known thread id (GDB's homegrown id,
|
/* Boolean test for an already-known thread id (GDB's homegrown id,
|
not the system's). */
|
not the system's). */
|
extern int valid_thread_id (int thread);
|
extern int valid_thread_id (int thread);
|
|
|
/* Search function to lookup a thread by 'pid'. */
|
/* Search function to lookup a thread by 'pid'. */
|
extern struct thread_info *find_thread_pid (ptid_t ptid);
|
extern struct thread_info *find_thread_pid (ptid_t ptid);
|
|
|
/* Iterator function to call a user-provided callback function
|
/* Iterator function to call a user-provided callback function
|
once for each known thread. */
|
once for each known thread. */
|
typedef int (*thread_callback_func) (struct thread_info *, void *);
|
typedef int (*thread_callback_func) (struct thread_info *, void *);
|
extern struct thread_info *iterate_over_threads (thread_callback_func, void *);
|
extern struct thread_info *iterate_over_threads (thread_callback_func, void *);
|
|
|
/* infrun context switch: save the debugger state for the given thread. */
|
/* infrun context switch: save the debugger state for the given thread. */
|
extern void save_infrun_state (ptid_t ptid,
|
extern void save_infrun_state (ptid_t ptid,
|
CORE_ADDR prev_pc,
|
CORE_ADDR prev_pc,
|
int trap_expected,
|
int trap_expected,
|
struct breakpoint *step_resume_breakpoint,
|
struct breakpoint *step_resume_breakpoint,
|
CORE_ADDR step_range_start,
|
CORE_ADDR step_range_start,
|
CORE_ADDR step_range_end,
|
CORE_ADDR step_range_end,
|
const struct frame_id *step_frame_id,
|
const struct frame_id *step_frame_id,
|
int handling_longjmp,
|
int handling_longjmp,
|
int another_trap,
|
int another_trap,
|
int stepping_through_solib_after_catch,
|
int stepping_through_solib_after_catch,
|
bpstat stepping_through_solib_catchpoints,
|
bpstat stepping_through_solib_catchpoints,
|
int current_line,
|
int current_line,
|
struct symtab *current_symtab);
|
struct symtab *current_symtab);
|
|
|
/* infrun context switch: load the debugger state previously saved
|
/* infrun context switch: load the debugger state previously saved
|
for the given thread. */
|
for the given thread. */
|
extern void load_infrun_state (ptid_t ptid,
|
extern void load_infrun_state (ptid_t ptid,
|
CORE_ADDR *prev_pc,
|
CORE_ADDR *prev_pc,
|
int *trap_expected,
|
int *trap_expected,
|
struct breakpoint **step_resume_breakpoint,
|
struct breakpoint **step_resume_breakpoint,
|
CORE_ADDR *step_range_start,
|
CORE_ADDR *step_range_start,
|
CORE_ADDR *step_range_end,
|
CORE_ADDR *step_range_end,
|
struct frame_id *step_frame_id,
|
struct frame_id *step_frame_id,
|
int *handling_longjmp,
|
int *handling_longjmp,
|
int *another_trap,
|
int *another_trap,
|
int *stepping_through_solib_affter_catch,
|
int *stepping_through_solib_affter_catch,
|
bpstat *stepping_through_solib_catchpoints,
|
bpstat *stepping_through_solib_catchpoints,
|
int *current_line,
|
int *current_line,
|
struct symtab **current_symtab);
|
struct symtab **current_symtab);
|
|
|
/* Switch from one thread to another. */
|
/* Switch from one thread to another. */
|
extern void switch_to_thread (ptid_t ptid);
|
extern void switch_to_thread (ptid_t ptid);
|
|
|
/* Commands with a prefix of `thread'. */
|
/* Commands with a prefix of `thread'. */
|
extern struct cmd_list_element *thread_cmd_list;
|
extern struct cmd_list_element *thread_cmd_list;
|
|
|
/* Print notices on thread events (attach, detach, etc.), set with
|
/* Print notices on thread events (attach, detach, etc.), set with
|
`set print thread-events'. */
|
`set print thread-events'. */
|
extern int print_thread_events;
|
extern int print_thread_events;
|
|
|
#endif /* GDBTHREAD_H */
|
#endif /* GDBTHREAD_H */
|
|
|
