gdb/gdbserver/linux-low.h

   1 /* Internal interfaces for the GNU/Linux specific target code for gdbserver.
   2    Copyright (C) 2002, 2004, 2005, 2007, 2008, 2009, 2010
   3    Free Software Foundation, Inc.
   4
   5    This file is part of GDB.
   6
   7    This program is free software; you can redistribute it and/or modify
   8    it under the terms of the GNU General Public License as published by
   9    the Free Software Foundation; either version 3 of the License, or
  10    (at your option) any later version.
  11
  12    This program is distributed in the hope that it will be useful,
  13    but WITHOUT ANY WARRANTY; without even the implied warranty of
  14    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  15    GNU General Public License for more details.
  16
  17    You should have received a copy of the GNU General Public License
  18    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
  19
  20 #ifdef HAVE_THREAD_DB_H
  21 #include <thread_db.h>
  22 #endif
  23
  24 #include "gdb_proc_service.h"
  25
  26 #ifdef HAVE_LINUX_REGSETS
  27 typedef void (*regset_fill_func) (struct regcache *, void *);
  28 typedef void (*regset_store_func) (struct regcache *, const void *);
  29 enum regset_type {
  30   GENERAL_REGS,
  31   FP_REGS,
  32   EXTENDED_REGS,
  33 };
  34
  35 struct regset_info
  36 {
  37   int get_request, set_request;
  38   int size;
  39   enum regset_type type;
  40   regset_fill_func fill_function;
  41   regset_store_func store_function;
  42 };
  43 extern struct regset_info target_regsets[];
  44 #endif
  45
  46 struct siginfo;
  47
  48 struct process_info_private
  49 {
  50   /* Arch-specific additions.  */
  51   struct arch_process_info *arch_private;
  52
  53   /* libthread_db-specific additions.  Not NULL if this process has loaded
  54      thread_db, and it is active.  */
  55   struct thread_db *thread_db;
  56 };
  57
  58 struct lwp_info;
  59
  60 struct linux_target_ops
  61 {
  62   /* Architecture-specific setup.  */
  63   void (*arch_setup) (void);
  64
  65   int num_regs;
  66   int *regmap;
  67   int (*cannot_fetch_register) (int);
  68
  69   /* Returns 0 if we can store the register, 1 if we can not
  70      store the register, and 2 if failure to store the register
  71      is acceptable.  */
  72   int (*cannot_store_register) (int);
  73   CORE_ADDR (*get_pc) (struct regcache *regcache);
  74   void (*set_pc) (struct regcache *regcache, CORE_ADDR newpc);
  75   const unsigned char *breakpoint;
  76   int breakpoint_len;
  77   CORE_ADDR (*breakpoint_reinsert_addr) (void);
  78
  79   int decr_pc_after_break;
  80   int (*breakpoint_at) (CORE_ADDR pc);
  81
  82   /* Breakpoint and watchpoint related functions.  See target.h for
  83      comments.  */
  84   int (*insert_point) (char type, CORE_ADDR addr, int len);
  85   int (*remove_point) (char type, CORE_ADDR addr, int len);
  86   int (*stopped_by_watchpoint) (void);
  87   CORE_ADDR (*stopped_data_address) (void);
  88
  89   /* Hooks to reformat register data for PEEKUSR/POKEUSR (in particular
  90      for registers smaller than an xfer unit).  */
  91   void (*collect_ptrace_register) (struct regcache *regcache,
  92                                    int regno, char *buf);
  93   void (*supply_ptrace_register) (struct regcache *regcache,
  94                                   int regno, const char *buf);
  95
  96   /* Hook to convert from target format to ptrace format and back.
  97      Returns true if any conversion was done; false otherwise.
  98      If DIRECTION is 1, then copy from INF to NATIVE.
  99      If DIRECTION is 0, copy from NATIVE to INF.  */
 100   int (*siginfo_fixup) (struct siginfo *native, void *inf, int direction);
 101
 102   /* Hook to call when a new process is created or attached to.
 103      If extra per-process architecture-specific data is needed,
 104      allocate it here.  */
 105   struct arch_process_info * (*new_process) (void);
 106
 107   /* Hook to call when a new thread is detected.
 108      If extra per-thread architecture-specific data is needed,
 109      allocate it here.  */
 110   struct arch_lwp_info * (*new_thread) (void);
 111
 112   /* Hook to call prior to resuming a thread.  */
 113   void (*prepare_to_resume) (struct lwp_info *);
 114 };
 115
 116 extern struct linux_target_ops the_low_target;
 117
 118 #define ptid_of(proc) ((proc)->head.id)
 119 #define pid_of(proc) ptid_get_pid ((proc)->head.id)
 120 #define lwpid_of(proc) ptid_get_lwp ((proc)->head.id)
 121
 122 #define get_lwp(inf) ((struct lwp_info *)(inf))
 123 #define get_thread_lwp(thr) (get_lwp (inferior_target_data (thr)))
 124 #define get_lwp_thread(proc) ((struct thread_info *)                    \
 125                               find_inferior_id (&all_threads,           \
 126                                                 get_lwp (proc)->head.id))
 127
 128 struct lwp_info
 129 {
 130   struct inferior_list_entry head;
 131
 132   /* If this flag is set, the next SIGSTOP will be ignored (the
 133      process will be immediately resumed).  This means that either we
 134      sent the SIGSTOP to it ourselves and got some other pending event
 135      (so the SIGSTOP is still pending), or that we stopped the
 136      inferior implicitly via PTRACE_ATTACH and have not waited for it
 137      yet.  */
 138   int stop_expected;
 139
 140   /* True if this thread was suspended (with vCont;t).  */
 141   int suspended;
 142
 143   /* If this flag is set, the lwp is known to be stopped right now (stop
 144      event already received in a wait()).  */
 145   int stopped;
 146
 147   /* If this flag is set, the lwp is known to be dead already (exit
 148      event already received in a wait(), and is cached in
 149      status_pending).  */
 150   int dead;
 151
 152   /* When stopped is set, the last wait status recorded for this lwp.  */
 153   int last_status;
 154
 155   /* If this flag is set, STATUS_PENDING is a waitstatus that has not yet
 156      been reported.  */
 157   int status_pending_p;
 158   int status_pending;
 159
 160   /* If this flag is set, the pending status is a (GDB-placed) breakpoint.  */
 161   int pending_is_breakpoint;
 162   CORE_ADDR pending_stop_pc;
 163
 164   /* STOPPED_BY_WATCHPOINT is non-zero if this LWP stopped with a data
 165      watchpoint trap.  */
 166   int stopped_by_watchpoint;
 167
 168   /* On architectures where it is possible to know the data address of
 169      a triggered watchpoint, STOPPED_DATA_ADDRESS is non-zero, and
 170      contains such data address.  Only valid if STOPPED_BY_WATCHPOINT
 171      is true.  */
 172   CORE_ADDR stopped_data_address;
 173
 174   /* If this is non-zero, it is a breakpoint to be reinserted at our next
 175      stop (SIGTRAP stops only).  */
 176   CORE_ADDR bp_reinsert;
 177
 178   /* If this flag is set, the last continue operation on this process
 179      was a single-step.  */
 180   int stepping;
 181
 182   /* If this flag is set, we need to set the event request flags the
 183      next time we see this LWP stop.  */
 184   int must_set_ptrace_flags;
 185
 186   /* If this is non-zero, it points to a chain of signals which need to
 187      be delivered to this process.  */
 188   struct pending_signals *pending_signals;
 189
 190   /* A link used when resuming.  It is initialized from the resume request,
 191      and then processed and cleared in linux_resume_one_lwp.  */
 192
 193   struct thread_resume *resume;
 194
 195   int thread_known;
 196 #ifdef HAVE_THREAD_DB_H
 197   /* The thread handle, used for e.g. TLS access.  Only valid if
 198      THREAD_KNOWN is set.  */
 199   td_thrhandle_t th;
 200 #endif
 201
 202   /* Arch-specific additions.  */
 203   struct arch_lwp_info *arch_private;
 204 };
 205
 206 extern struct inferior_list all_lwps;
 207
 208 char *linux_child_pid_to_exec_file (int pid);
 209 int elf_64_file_p (const char *file);
 210
 211 void linux_attach_lwp (unsigned long pid);
 212 struct lwp_info *find_lwp_pid (ptid_t ptid);
 213
 214 /* From thread-db.c  */
 215 int thread_db_init (int use_events);
 216 void thread_db_free (struct process_info *, int detaching);
 217 int thread_db_handle_monitor_command (char *);
 218 int thread_db_get_tls_address (struct thread_info *thread, CORE_ADDR offset,
 219                                CORE_ADDR load_module, CORE_ADDR *address);