gdb/gnu-nat.h - gdb

Data types defined

Macros defined

Source code

  1. /* Common things used by the various *gnu-nat.c files
  2.    Copyright (C) 1995-2015 Free Software Foundation, Inc.

  3.    Written by Miles Bader <miles@gnu.ai.mit.edu>

  4.    This program is free software; you can redistribute it and/or modify
  5.    it under the terms of the GNU General Public License as published by
  6.    the Free Software Foundation; either version 3 of the License, or
  7.    (at your option) any later version.

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

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

  14. #ifndef __GNU_NAT_H__
  15. #define __GNU_NAT_H__

  16. #include <unistd.h>
  17. #include <mach.h>

  18. struct inf;

  19. extern struct inf *gnu_current_inf;

  20. /* Converts a GDB pid to a struct proc.  */
  21. struct proc *inf_tid_to_thread (struct inf *inf, int tid);

  22. typedef void (inf_threads_ftype) (struct proc *thread, void *arg);

  23. /* Call F for every thread in inferior INF, passing ARG as second parameter.  */
  24. void inf_threads (struct inf *inf, inf_threads_ftype *f, void *arg);

  25. /* Makes sure that INF's thread list is synced with the actual process.  */
  26. int inf_update_procs (struct inf *inf);

  27. /* A proc is either a thread, or the task (there can only be one task proc
  28.    because it always has the same TID, PROC_TID_TASK).  */
  29. struct proc
  30.   {
  31.     thread_t port;                /* The task or thread port.  */
  32.     int tid;                        /* The GDB pid (actually a thread id).  */
  33.     int num;                        /* An id number for threads, to print.  */

  34.     mach_port_t saved_exc_port;        /* The task/thread's real exception port.  */
  35.     mach_port_t exc_port;        /* Our replacement, which for.  */

  36.     int sc;                        /* Desired suspend count.   */
  37.     int cur_sc;                        /* Implemented suspend count.  */
  38.     int run_sc;                        /* Default sc when the program is running.  */
  39.     int pause_sc;                /* Default sc when gdb has control.  */
  40.     int resume_sc;                /* Sc resulting from the last resume.  */
  41.     int detach_sc;                /* SC to leave around when detaching
  42.                                    from program.  */

  43.     thread_state_data_t state;        /* Registers, &c.  */
  44.     int state_valid:1;                /* True if STATE is up to date.  */
  45.     int state_changed:1;

  46.     int aborted:1;                /* True if thread_abort has been called.  */
  47.     int dead:1;                        /* We happen to know it's actually dead.  */

  48.     /* Bit mask of registers fetched by gdb.  This is used when we re-fetch
  49.        STATE after aborting the thread, to detect that gdb may have out-of-date
  50.        information.  */
  51.     unsigned long fetched_regs;

  52.     struct inf *inf;                /* Where we come from.  */

  53.     struct proc *next;
  54.   };

  55. /* The task has a thread entry with this TID.  */
  56. #define PROC_TID_TASK         (-1)

  57. #define proc_is_task(proc) ((proc)->tid == PROC_TID_TASK)
  58. #define proc_is_thread(proc) ((proc)->tid != PROC_TID_TASK)

  59. extern int __proc_pid (struct proc *proc);

  60. /* Make sure that the state field in PROC is up to date, and return a
  61.    pointer to it, or 0 if something is wrong.  If WILL_MODIFY is true,
  62.    makes sure that the thread is stopped and aborted first, and sets
  63.    the state_changed field in PROC to true.  */
  64. extern thread_state_t proc_get_state (struct proc *proc, int will_modify);

  65. /* Return printable description of proc.  */
  66. extern char *proc_string (struct proc *proc);

  67. #define proc_debug(_proc, msg, args...) \
  68.   do { struct proc *__proc = (_proc); \
  69.        debug ("{proc %d/%d %s}: " msg, \
  70.               __proc_pid (__proc), __proc->tid, \
  71.               host_address_to_string (__proc) , ##args); } while (0)

  72. extern int gnu_debug_flag;

  73. #define debug(msg, args...) \
  74. do { if (gnu_debug_flag) \
  75.         fprintf_unfiltered (gdb_stdlog, "%s:%d: " msg "\r\n", \
  76.                             __FILE__ , __LINE__ , ##args); } while (0)

  77. /* Create a prototype generic GNU/Hurd target.  The client can
  78.    override it with local methods.  */
  79. struct target_ops *gnu_target (void);

  80. #endif /* __GNU_NAT_H__ */