gdb/inf-ptrace.h

   1 /* Low level child interface to ptrace.
   2
   3    Copyright (C) 2004-2019 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 #ifndef INF_PTRACE_H
  21 #define INF_PTRACE_H
  22
  23 #include "inf-child.h"
  24
  25 /* An abstract prototype ptrace target.  The client can override it
  26    with local methods.  */
  27
  28 struct inf_ptrace_target : public inf_child_target
  29 {
  30   ~inf_ptrace_target () override = 0;
  31
  32   void attach (const char *, int) override;
  33
  34   void detach (inferior *inf, int) override;
  35
  36   void resume (ptid_t, int, enum gdb_signal) override;
  37
  38   ptid_t wait (ptid_t, struct target_waitstatus *, int) override;
  39
  40   void files_info () override;
  41
  42   void kill () override;
  43
  44   void create_inferior (const char *, const std::string &,
  45                         char **, int) override;
  46 #ifdef PT_GET_PROCESS_STATE
  47   int follow_fork (int, int) override;
  48
  49   int insert_fork_catchpoint (int) override;
  50
  51   int remove_fork_catchpoint (int) override;
  52
  53   void post_startup_inferior (ptid_t) override;
  54
  55   void post_attach (int) override;
  56 #endif
  57
  58   void mourn_inferior () override;
  59
  60   bool thread_alive (ptid_t ptid) override;
  61
  62   std::string pid_to_str (ptid_t) override;
  63
  64   enum target_xfer_status xfer_partial (enum target_object object,
  65                                         const char *annex,
  66                                         gdb_byte *readbuf,
  67                                         const gdb_byte *writebuf,
  68                                         ULONGEST offset, ULONGEST len,
  69                                         ULONGEST *xfered_len) override;
  70
  71 #if defined (PT_IO) && defined (PIOD_READ_AUXV)
  72   int auxv_parse (gdb_byte **readptr,
  73                   gdb_byte *endptr, CORE_ADDR *typep, CORE_ADDR *valp) override;
  74 #endif
  75
  76 protected:
  77   /* Cleanup the inferior after a successful ptrace detach.  */
  78   void detach_success (inferior *inf);
  79 };
  80
  81 /* Return which PID to pass to ptrace in order to observe/control the
  82    tracee identified by PTID.  */
  83
  84 extern pid_t get_ptrace_pid (ptid_t);
  85
  86 /* Pointer to "inf_ptrace_me_fail_reason", which implements a function
  87    that can be called by "inf_ptrace_me" in order to obtain the reason
  88    for a ptrace failure.  ERR is the ERRNO value set by the failing
  89    ptrace call.
  90
  91    This pointer can be overriden by targets that want to personalize
  92    the error message printed when ptrace fails (see linux-nat.c, for
  93    example).  */
  94 extern std::string (*inf_ptrace_me_fail_reason) (int err);
  95
  96 #endif