| /* `ptrace' debugger support interface. Linux version, |
| not architecture-specific. |
| Copyright (C) 1996-2021 Free Software Foundation, Inc. |
| |
| This file is part of the GNU C Library. |
| |
| The GNU C Library is free software; you can redistribute it and/or |
| modify it under the terms of the GNU Lesser General Public |
| License as published by the Free Software Foundation; either |
| version 2.1 of the License, or (at your option) any later version. |
| |
| The GNU C Library is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU |
| Lesser General Public License for more details. |
| |
| You should have received a copy of the GNU Lesser General Public |
| License along with the GNU C Library; if not, see |
| <https://www.gnu.org/licenses/>. */ |
| |
| #ifndef _SYS_PTRACE_H |
| # error "Never use <bits/ptrace-shared.h> directly; include <sys/ptrace.h> instead." |
| #endif |
| |
| /* Options set using PTRACE_SETOPTIONS. */ |
| enum __ptrace_setoptions |
| { |
| PTRACE_O_TRACESYSGOOD = 0x00000001, |
| PTRACE_O_TRACEFORK = 0x00000002, |
| PTRACE_O_TRACEVFORK = 0x00000004, |
| PTRACE_O_TRACECLONE = 0x00000008, |
| PTRACE_O_TRACEEXEC = 0x00000010, |
| PTRACE_O_TRACEVFORKDONE = 0x00000020, |
| PTRACE_O_TRACEEXIT = 0x00000040, |
| PTRACE_O_TRACESECCOMP = 0x00000080, |
| PTRACE_O_EXITKILL = 0x00100000, |
| PTRACE_O_SUSPEND_SECCOMP = 0x00200000, |
| PTRACE_O_MASK = 0x003000ff |
| }; |
| |
| enum __ptrace_eventcodes |
| { |
| /* Wait extended result codes for the above trace options. */ |
| PTRACE_EVENT_FORK = 1, |
| PTRACE_EVENT_VFORK = 2, |
| PTRACE_EVENT_CLONE = 3, |
| PTRACE_EVENT_EXEC = 4, |
| PTRACE_EVENT_VFORK_DONE = 5, |
| PTRACE_EVENT_EXIT = 6, |
| PTRACE_EVENT_SECCOMP = 7, |
| /* Extended result codes enabled by means other than options. */ |
| PTRACE_EVENT_STOP = 128 |
| }; |
| |
| /* Type of stop for PTRACE_GET_SYSCALL_INFO. */ |
| enum __ptrace_get_syscall_info_op |
| { |
| PTRACE_SYSCALL_INFO_NONE = 0, |
| PTRACE_SYSCALL_INFO_ENTRY = 1, |
| PTRACE_SYSCALL_INFO_EXIT = 2, |
| PTRACE_SYSCALL_INFO_SECCOMP = 3 |
| }; |
| |
| /* Arguments for PTRACE_PEEKSIGINFO. */ |
| struct __ptrace_peeksiginfo_args |
| { |
| __uint64_t off; /* From which siginfo to start. */ |
| __uint32_t flags; /* Flags for peeksiginfo. */ |
| __int32_t nr; /* How many siginfos to take. */ |
| }; |
| |
| enum __ptrace_peeksiginfo_flags |
| { |
| /* Read signals from a shared (process wide) queue. */ |
| PTRACE_PEEKSIGINFO_SHARED = (1 << 0) |
| }; |
| |
| /* Argument and results of PTRACE_SECCOMP_GET_METADATA. */ |
| struct __ptrace_seccomp_metadata |
| { |
| __uint64_t filter_off; /* Input: which filter. */ |
| __uint64_t flags; /* Output: filter's flags. */ |
| }; |
| |
| /* Results of PTRACE_GET_SYSCALL_INFO. */ |
| struct __ptrace_syscall_info |
| { |
| __uint8_t op; /* One of the enum |
| __ptrace_get_syscall_info_op |
| values. */ |
| __uint32_t arch __attribute__ ((__aligned__ (4))); /* AUDIT_ARCH_* |
| value. */ |
| __uint64_t instruction_pointer; /* Instruction pointer. */ |
| __uint64_t stack_pointer; /* Stack pointer. */ |
| union |
| { |
| /* System call number and arguments, for |
| PTRACE_SYSCALL_INFO_ENTRY. */ |
| struct |
| { |
| __uint64_t nr; |
| __uint64_t args[6]; |
| } entry; |
| /* System call return value and error flag, for |
| PTRACE_SYSCALL_INFO_EXIT. */ |
| struct |
| { |
| __int64_t rval; |
| __uint8_t is_error; |
| } exit; |
| /* System call number, arguments and SECCOMP_RET_DATA portion of |
| SECCOMP_RET_TRACE return value, for |
| PTRACE_SYSCALL_INFO_SECCOMP. */ |
| struct |
| { |
| __uint64_t nr; |
| __uint64_t args[6]; |
| __uint32_t ret_data; |
| } seccomp; |
| }; |
| }; |
| |
| /* Perform process tracing functions. REQUEST is one of the values |
| above, and determines the action to be taken. |
| For all requests except PTRACE_TRACEME, PID specifies the process to be |
| traced. |
| |
| PID and the other arguments described above for the various requests should |
| appear (those that are used for the particular request) as: |
| pid_t PID, void *ADDR, int DATA, void *ADDR2 |
| after REQUEST. */ |
| extern long int ptrace (enum __ptrace_request __request, ...) __THROW; |