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   /* When this is true, we shall not try to resume this thread, even
 141      if last_resume_kind isn't resume_stop.  */
 142   int suspended;
 143
 144   /* If this flag is set, the lwp is known to be stopped right now (stop
 145      event already received in a wait()).  */
 146   int stopped;
 147
 148   /* If this flag is set, the lwp is known to be dead already (exit
 149      event already received in a wait(), and is cached in
 150      status_pending).  */
 151   int dead;
 152
 153   /* When stopped is set, the last wait status recorded for this lwp.  */
 154   int last_status;
 155
 156   /* When stopped is set, this is where the lwp stopped, with
 157      decr_pc_after_break already accounted for.  */
 158   CORE_ADDR stop_pc;
 159
 160   /* If this flag is set, STATUS_PENDING is a waitstatus that has not yet
 161      been reported.  */
 162   int status_pending_p;
 163   int status_pending;
 164
 165   /* STOPPED_BY_WATCHPOINT is non-zero if this LWP stopped with a data
 166      watchpoint trap.  */
 167   int stopped_by_watchpoint;
 168
 169   /* On architectures where it is possible to know the data address of
 170      a triggered watchpoint, STOPPED_DATA_ADDRESS is non-zero, and
 171      contains such data address.  Only valid if STOPPED_BY_WATCHPOINT
 172      is true.  */
 173   CORE_ADDR stopped_data_address;
 174
 175   /* If this is non-zero, it is a breakpoint to be reinserted at our next
 176      stop (SIGTRAP stops only).  */
 177   CORE_ADDR bp_reinsert;
 178
 179   /* If this flag is set, the last continue operation at the ptrace
 180      level on this process was a single-step.  */
 181   int stepping;
 182
 183   /* If this flag is set, we need to set the event request flags the
 184      next time we see this LWP stop.  */
 185   int must_set_ptrace_flags;
 186
 187   /* If this is non-zero, it points to a chain of signals which need to
 188      be delivered to this process.  */
 189   struct pending_signals *pending_signals;
 190
 191   /* A link used when resuming.  It is initialized from the resume request,
 192      and then processed and cleared in linux_resume_one_lwp.  */
 193   struct thread_resume *resume;
 194
 195   /* The last resume GDB requested on this thread.  */
 196   enum resume_kind last_resume_kind;
 197
 198   /* True if the LWP was seen stop at an internal breakpoint and needs
 199      stepping over later when it is resumed.  */
 200   int need_step_over;
 201
 202   int thread_known;
 203 #ifdef HAVE_THREAD_DB_H
 204   /* The thread handle, used for e.g. TLS access.  Only valid if
 205      THREAD_KNOWN is set.  */
 206   td_thrhandle_t th;
 207 #endif
 208
 209   /* Arch-specific additions.  */
 210   struct arch_lwp_info *arch_private;
 211 };
 212
 213 extern struct inferior_list all_lwps;
 214
 215 char *linux_child_pid_to_exec_file (int pid);
 216 int elf_64_file_p (const char *file);
 217
 218 void linux_attach_lwp (unsigned long pid);
 219 struct lwp_info *find_lwp_pid (ptid_t ptid);
 220
 221 /* From thread-db.c  */
 222 int thread_db_init (int use_events);
 223 void thread_db_free (struct process_info *, int detaching);
 224 int thread_db_handle_monitor_command (char *);
 225 int thread_db_get_tls_address (struct thread_info *thread, CORE_ADDR offset,
 226                                CORE_ADDR load_module, CORE_ADDR *address);