[deliverable/binutils-gdb.git] / gdb / gdbserver / inferiors.h

/* Inferior process information for the remote server for GDB.
   Copyright (C) 1993-2014 Free Software Foundation, Inc.

   This file is part of GDB.

   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
   the Free Software Foundation; either version 3 of the License, or
   (at your option) any later version.

   This program is distributed in the hope that it will be useful,
   but WITHOUT ANY WARRANTY; without even the implied warranty of
   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
   GNU General Public License for more details.

   You should have received a copy of the GNU General Public License
   along with this program.  If not, see <http://www.gnu.org/licenses/>.  */

#ifndef INFERIORS_H
#define INFERIORS_H

/* Generic information for tracking a list of ``inferiors'' - threads,
   processes, etc.  */
struct inferior_list
{
  struct inferior_list_entry *head;
  struct inferior_list_entry *tail;
};
struct inferior_list_entry
{
  ptid_t id;
  struct inferior_list_entry *next;
};

struct thread_info;
struct target_desc;
struct sym_cache;
struct breakpoint;
struct raw_breakpoint;
struct fast_tracepoint_jump;
struct process_info_private;

struct process_info
{
  /* This must appear first.
     The list iterator functions assume it.  */
  struct inferior_list_entry entry;

  /* Nonzero if this child process was attached rather than
     spawned.  */
  int attached;

  /* True if GDB asked us to detach from this process, but we remained
     attached anyway.  */
  int gdb_detached;

  /* The symbol cache.  */
  struct sym_cache *symbol_cache;

  /* The list of memory breakpoints.  */
  struct breakpoint *breakpoints;

  /* The list of raw memory breakpoints.  */
  struct raw_breakpoint *raw_breakpoints;

  /* The list of installed fast tracepoints.  */
  struct fast_tracepoint_jump *fast_tracepoint_jumps;

  const struct target_desc *tdesc;

  /* Private target data.  */
  struct process_info_private *private;
};

#define ptid_of(inf) ((inf)->entry.id)
#define pid_of(inf) ptid_get_pid ((inf)->entry.id)
#define lwpid_of(inf) ptid_get_lwp ((inf)->entry.id)

/* Return a pointer to the process that corresponds to the current
   thread (current_inferior).  It is an error to call this if there is
   no current thread selected.  */

struct process_info *current_process (void);
struct process_info *get_thread_process (struct thread_info *);

extern struct inferior_list all_processes;

void add_inferior_to_list (struct inferior_list *list,
			   struct inferior_list_entry *new_inferior);
void for_each_inferior (struct inferior_list *list,
			void (*action) (struct inferior_list_entry *));

void for_each_inferior_with_data
  (struct inferior_list *list,
   void (*action) (struct inferior_list_entry *, void *),
   void *data);

void clear_inferior_list (struct inferior_list *list);

int one_inferior_p (struct inferior_list *list);

/* Helper for ALL_INFERIORS_TYPE.  Gets the next element starting at
   CUR, if CUR is not NULL.  */
#define A_I_NEXT(type, list, cur)					\
  ((cur) != NULL							\
   ? (type *) ((struct inferior_list_entry *) cur)->next		\
   : NULL)

/* Iterate over all inferiors of type TYPE in LIST, open loop
   style.  */
#define ALL_INFERIORS_TYPE(type, list, cur, tmp)				\
  for ((cur) = (type *) (list)->head, (tmp) = A_I_NEXT (type, list, cur); \
       (cur) != NULL;							\
       (cur) = (tmp), (tmp) = A_I_NEXT (type, list, cur))

/* Iterate over all inferiors in LIST, open loop style.  */
#define ALL_INFERIORS(list, cur, tmp)				\
  ALL_INFERIORS_TYPE (struct inferior_list_entry, list, cur, tmp)

/* Iterate over all processes, open loop style.  */
#define ALL_PROCESSES(cur, tmp)					\
  ALL_INFERIORS_TYPE (struct process_info, &all_processes, cur, tmp)

extern struct thread_info *current_inferior;
void remove_inferior (struct inferior_list *list,
		      struct inferior_list_entry *entry);

struct inferior_list_entry *get_first_inferior (struct inferior_list *list);

struct process_info *add_process (int pid, int attached);
void remove_process (struct process_info *process);
struct process_info *find_process_pid (int pid);
int have_started_inferiors_p (void);
int have_attached_inferiors_p (void);

ptid_t thread_to_gdb_id (struct thread_info *);
ptid_t gdb_id_to_thread_id (ptid_t);

void clear_inferiors (void);
struct inferior_list_entry *find_inferior
     (struct inferior_list *,
      int (*func) (struct inferior_list_entry *,
		   void *),
      void *arg);
struct inferior_list_entry *find_inferior_id (struct inferior_list *list,
					      ptid_t id);

void *inferior_target_data (struct thread_info *);
void set_inferior_target_data (struct thread_info *, void *);
void *inferior_regcache_data (struct thread_info *);
void set_inferior_regcache_data (struct thread_info *, void *);

#endif /* INFERIORS_H */
Commit	Line	Data
270c6aea	1	/* Inferior process information for the remote server for GDB.
ecd75fc8	2	Copyright (C) 1993-2014 Free Software Foundation, Inc.
270c6aea PA	3
	4	This file is part of GDB.
	5
	6	This program is free software; you can redistribute it and/or modify
	7	it under the terms of the GNU General Public License as published by
	8	the Free Software Foundation; either version 3 of the License, or
	9	(at your option) any later version.
	10
	11	This program is distributed in the hope that it will be useful,
	12	but WITHOUT ANY WARRANTY; without even the implied warranty of
	13	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	14	GNU General Public License for more details.
	15
	16	You should have received a copy of the GNU General Public License
	17	along with this program. If not, see <http://www.gnu.org/licenses/>. */
	18
	19	#ifndef INFERIORS_H
	20	#define INFERIORS_H
	21
	22	/* Generic information for tracking a list of ``inferiors'' - threads,
	23	processes, etc. */
	24	struct inferior_list
	25	{
	26	struct inferior_list_entry *head;
	27	struct inferior_list_entry *tail;
	28	};
	29	struct inferior_list_entry
	30	{
	31	ptid_t id;
	32	struct inferior_list_entry *next;
	33	};
	34
	35	struct thread_info;
	36	struct target_desc;
	37	struct sym_cache;
	38	struct breakpoint;
	39	struct raw_breakpoint;
	40	struct fast_tracepoint_jump;
	41	struct process_info_private;
	42
	43	struct process_info
	44	{
80894984 DE	45	/* This must appear first.
	46	The list iterator functions assume it. */
	47	struct inferior_list_entry entry;
270c6aea PA	48
	49	/* Nonzero if this child process was attached rather than
	50	spawned. */
	51	int attached;
	52
	53	/* True if GDB asked us to detach from this process, but we remained
	54	attached anyway. */
	55	int gdb_detached;
	56
	57	/* The symbol cache. */
	58	struct sym_cache *symbol_cache;
	59
	60	/* The list of memory breakpoints. */
	61	struct breakpoint *breakpoints;
	62
	63	/* The list of raw memory breakpoints. */
	64	struct raw_breakpoint *raw_breakpoints;
	65
	66	/* The list of installed fast tracepoints. */
	67	struct fast_tracepoint_jump *fast_tracepoint_jumps;
	68
	69	const struct target_desc *tdesc;
	70
	71	/* Private target data. */
	72	struct process_info_private *private;
	73	};
	74
d86d4aaf DE	75	#define ptid_of(inf) ((inf)->entry.id)
	76	#define pid_of(inf) ptid_get_pid ((inf)->entry.id)
	77	#define lwpid_of(inf) ptid_get_lwp ((inf)->entry.id)
	78
270c6aea PA	79	/* Return a pointer to the process that corresponds to the current
	80	thread (current_inferior). It is an error to call this if there is
	81	no current thread selected. */
	82
	83	struct process_info *current_process (void);
	84	struct process_info get_thread_process (struct thread_info );
	85
	86	extern struct inferior_list all_processes;
	87
	88	void add_inferior_to_list (struct inferior_list *list,
	89	struct inferior_list_entry *new_inferior);
	90	void for_each_inferior (struct inferior_list *list,
	91	void (action) (struct inferior_list_entry ));
	92
649ebbca DE	93	void for_each_inferior_with_data
	94	(struct inferior_list *list,
	95	void (action) (struct inferior_list_entry , void *),
	96	void *data);
	97
	98	void clear_inferior_list (struct inferior_list *list);
	99
	100	int one_inferior_p (struct inferior_list *list);
	101
fa96cb38 PA	102	/* Helper for ALL_INFERIORS_TYPE. Gets the next element starting at
	103	CUR, if CUR is not NULL. */
	104	#define A_I_NEXT(type, list, cur) \
	105	((cur) != NULL \
	106	? (type ) ((struct inferior_list_entry ) cur)->next \
	107	: NULL)
	108
	109	/* Iterate over all inferiors of type TYPE in LIST, open loop
	110	style. */
	111	#define ALL_INFERIORS_TYPE(type, list, cur, tmp) \
	112	for ((cur) = (type *) (list)->head, (tmp) = A_I_NEXT (type, list, cur); \
	113	(cur) != NULL; \
	114	(cur) = (tmp), (tmp) = A_I_NEXT (type, list, cur))
	115
	116	/* Iterate over all inferiors in LIST, open loop style. */
	117	#define ALL_INFERIORS(list, cur, tmp) \
	118	ALL_INFERIORS_TYPE (struct inferior_list_entry, list, cur, tmp)
	119
	120	/* Iterate over all processes, open loop style. */
	121	#define ALL_PROCESSES(cur, tmp) \
	122	ALL_INFERIORS_TYPE (struct process_info, &all_processes, cur, tmp)
	123
270c6aea PA	124	extern struct thread_info *current_inferior;
	125	void remove_inferior (struct inferior_list *list,
	126	struct inferior_list_entry *entry);
	127
649ebbca DE	128	struct inferior_list_entry get_first_inferior (struct inferior_list list);
649ebbca DE	129
270c6aea PA	130	struct process_info *add_process (int pid, int attached);
	131	void remove_process (struct process_info *process);
	132	struct process_info *find_process_pid (int pid);
	133	int have_started_inferiors_p (void);
	134	int have_attached_inferiors_p (void);
	135
270c6aea PA	136	ptid_t thread_to_gdb_id (struct thread_info *);
	137	ptid_t gdb_id_to_thread_id (ptid_t);
	138
	139	void clear_inferiors (void);
	140	struct inferior_list_entry *find_inferior
	141	(struct inferior_list *,
	142	int (func) (struct inferior_list_entry ,
	143	void *),
	144	void *arg);
	145	struct inferior_list_entry find_inferior_id (struct inferior_list list,
	146	ptid_t id);
80894984	147
270c6aea PA	148	void inferior_target_data (struct thread_info );
	149	void set_inferior_target_data (struct thread_info , void );
	150	void inferior_regcache_data (struct thread_info );
	151	void set_inferior_regcache_data (struct thread_info , void );
	152
	153	#endif /* INFERIORS_H */