gdbserver/inferiors.h

   1 /* Inferior process information for the remote server for GDB.
   2    Copyright (C) 1993-2020 Free Software Foundation, Inc.
   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 GDBSERVER_INFERIORS_H
  20 #define GDBSERVER_INFERIORS_H
  21
  22 #include "gdbsupport/gdb_vecs.h"
  23 #include <list>
  24
  25 struct thread_info;
  26 struct regcache;
  27 struct target_desc;
  28 struct sym_cache;
  29 struct breakpoint;
  30 struct raw_breakpoint;
  31 struct fast_tracepoint_jump;
  32 struct process_info_private;
  33
  34 struct process_info
  35 {
  36   process_info (int pid_, int attached_)
  37   : pid (pid_), attached (attached_)
  38   {}
  39
  40   /* This process' pid.  */
  41   int pid;
  42
  43   /* Nonzero if this child process was attached rather than
  44      spawned.  */
  45   int attached;
  46
  47   /* True if GDB asked us to detach from this process, but we remained
  48      attached anyway.  */
  49   int gdb_detached = 0;
  50
  51   /* The symbol cache.  */
  52   struct sym_cache *symbol_cache = NULL;
  53
  54   /* The list of memory breakpoints.  */
  55   struct breakpoint *breakpoints = NULL;
  56
  57   /* The list of raw memory breakpoints.  */
  58   struct raw_breakpoint *raw_breakpoints = NULL;
  59
  60   /* The list of installed fast tracepoints.  */
  61   struct fast_tracepoint_jump *fast_tracepoint_jumps = NULL;
  62
  63   /* The list of syscalls to report, or just a single element, ANY_SYSCALL,
  64      for unfiltered syscall reporting.  */
  65   std::vector<int> syscalls_to_catch;
  66
  67   const struct target_desc *tdesc = NULL;
  68
  69   /* Private target data.  */
  70   struct process_info_private *priv = NULL;
  71 };
  72
  73 /* Get the pid of PROC.  */
  74
  75 static inline int
  76 pid_of (const process_info *proc)
  77 {
  78   return proc->pid;
  79 }
  80
  81 /* Return a pointer to the process that corresponds to the current
  82    thread (current_thread).  It is an error to call this if there is
  83    no current thread selected.  */
  84
  85 struct process_info *current_process (void);
  86 struct process_info *get_thread_process (const struct thread_info *);
  87
  88 extern std::list<process_info *> all_processes;
  89
  90 /* Invoke FUNC for each process.  */
  91
  92 template <typename Func>
  93 static void
  94 for_each_process (Func func)
  95 {
  96   std::list<process_info *>::iterator next, cur = all_processes.begin ();
  97
  98   while (cur != all_processes.end ())
  99     {
 100       next = cur;
 101       next++;
 102       func (*cur);
 103       cur = next;
 104     }
 105 }
 106
 107 /* Find the first process for which FUNC returns true.  Return NULL if no
 108    process satisfying FUNC is found.  */
 109
 110 template <typename Func>
 111 static process_info *
 112 find_process (Func func)
 113 {
 114   std::list<process_info *>::iterator next, cur = all_processes.begin ();
 115
 116   while (cur != all_processes.end ())
 117     {
 118       next = cur;
 119       next++;
 120
 121       if (func (*cur))
 122         return *cur;
 123
 124       cur = next;
 125     }
 126
 127   return NULL;
 128 }
 129
 130 extern struct thread_info *current_thread;
 131
 132 /* Return the first process in the processes list.  */
 133 struct process_info *get_first_process (void);
 134
 135 struct process_info *add_process (int pid, int attached);
 136 void remove_process (struct process_info *process);
 137 struct process_info *find_process_pid (int pid);
 138 int have_started_inferiors_p (void);
 139 int have_attached_inferiors_p (void);
 140
 141 /* Switch to a thread of PROC.  */
 142 void switch_to_process (process_info *proc);
 143
 144 void clear_inferiors (void);
 145
 146 void *thread_target_data (struct thread_info *);
 147 struct regcache *thread_regcache_data (struct thread_info *);
 148 void set_thread_regcache_data (struct thread_info *, struct regcache *);
 149
 150 #endif /* GDBSERVER_INFERIORS_H */