xref: /netbsd-src/external/gpl3/gdb.old/dist/gdb/inf-ptrace.h (revision 867d70fc718005c0918b8b8b2f9d7f2d52d0a0db)
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   const char *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 #endif
87