GDB (xrefs)
Loading...
Searching...
No Matches
/tmp/gdb-13.1/gdb/inf-ptrace.h
Go to the documentation of this file.
1/* Low level child interface to ptrace.
2
3 Copyright (C) 2004-2023 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 "gdbsupport/event-pipe.h"
24#include "inf-child.h"
25
26/* An abstract prototype ptrace target. The client can override it
27 with local methods. */
28
30{
31 ~inf_ptrace_target () override = 0;
32
33 void attach (const char *, int) override;
34
35 void detach (inferior *inf, int) override;
36
37 void close () override;
38
39 void resume (ptid_t, int, enum gdb_signal) override;
40
41 ptid_t wait (ptid_t, struct target_waitstatus *, target_wait_flags) override;
42
43 void files_info () override;
44
45 void kill () override;
46
47 void create_inferior (const char *, const std::string &,
48 char **, int) override;
49
50 void mourn_inferior () override;
51
52 bool thread_alive (ptid_t ptid) override;
53
54 std::string pid_to_str (ptid_t) override;
55
57 const char *annex,
58 gdb_byte *readbuf,
59 const gdb_byte *writebuf,
60 ULONGEST offset, ULONGEST len,
61 ULONGEST *xfered_len) override;
62
63 bool is_async_p () override
64 { return m_event_pipe.is_open (); }
65
66 int async_wait_fd () override
67 { return m_event_pipe.event_fd (); }
68
69 /* Helper routine used from SIGCHLD handlers to signal the async
70 event pipe. */
72 {
73 if (m_event_pipe.is_open ())
74 m_event_pipe.mark ();
75 }
76
77protected:
78 /* Helper routines for interacting with the async event pipe. */
80 { return m_event_pipe.open_pipe (); }
82 { m_event_pipe.close_pipe (); }
84 { m_event_pipe.flush (); }
86 { m_event_pipe.mark (); }
87
88 /* Cleanup the inferior after a successful ptrace detach. */
90
91 /* Some targets don't allow us to request notification of inferior events
92 such as fork and vfork immediately after the inferior is created.
93 (This is because of how gdb creates inferiors via invoking a shell to
94 do it. In such a scenario, if the shell init file has commands in it,
95 the shell will fork and exec for each of those commands, and we will
96 see each such fork event. Very bad.)
97
98 Such targets will supply an appropriate definition for this
99 function. */
100 virtual void post_startup_inferior (ptid_t ptid) = 0;
101
102private:
103 static event_pipe m_event_pipe;
104};
105
106#ifndef __NetBSD__
107/* Return which PID to pass to ptrace in order to observe/control the
108 tracee identified by PTID.
109
110 Unlike most other Operating Systems, NetBSD tracks both pid and lwp
111 and avoids this function. */
112
113extern pid_t get_ptrace_pid (ptid_t);
114#endif
115
116#endif
pid_t get_ptrace_pid(ptid_t)
Definition: inf-ptrace.c:238
void create_inferior(const char *, const std::string &, char **, int) override
Definition: inf-ptrace.c:75
virtual void post_startup_inferior(ptid_t ptid)=0
~inf_ptrace_target() override=0
Definition: inf-ptrace.c:54
void async_file_flush()
Definition: inf-ptrace.h:83
void async_file_mark()
Definition: inf-ptrace.h:85
void detach_success(inferior *inf)
Definition: inf-ptrace.c:208
void async_file_close()
Definition: inf-ptrace.h:81
int async_wait_fd() override
Definition: inf-ptrace.h:66
bool is_async_p() override
Definition: inf-ptrace.h:63
void resume(ptid_t, int, enum gdb_signal) override
Definition: inf-ptrace.c:256
void mourn_inferior() override
Definition: inf-ptrace.c:115
void files_info() override
Definition: inf-ptrace.c:519
bool thread_alive(ptid_t ptid) override
Definition: inf-ptrace.c:510
static event_pipe m_event_pipe
Definition: inf-ptrace.h:103
void attach(const char *, int) override
Definition: inf-ptrace.c:132
void kill() override
Definition: inf-ptrace.c:219
void detach(inferior *inf, int) override
Definition: inf-ptrace.c:183
bool async_file_open()
Definition: inf-ptrace.h:79
static void async_file_mark_if_open()
Definition: inf-ptrace.h:71
enum target_xfer_status xfer_partial(enum target_object object, const char *annex, gdb_byte *readbuf, const gdb_byte *writebuf, ULONGEST offset, ULONGEST len, ULONGEST *xfered_len) override
Definition: inf-ptrace.c:424
ptid_t wait(ptid_t, struct target_waitstatus *, target_wait_flags) override
Definition: inf-ptrace.c:294
void close() override
Definition: inf-ptrace.c:537
std::string pid_to_str(ptid_t) override
Definition: inf-ptrace.c:529
Definition: gnu-nat.c:154
target_xfer_status
Definition: target.h:214
target_object
Definition: target.h:138