226 lines
6.4 KiB
C
226 lines
6.4 KiB
C
/* `ptrace' debugger support interface. Linux/ia64 version.
|
|
Copyright (C) 2001-2016 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
|
|
<http://www.gnu.org/licenses/>. */
|
|
|
|
#ifndef _SYS_PTRACE_H
|
|
#define _SYS_PTRACE_H 1
|
|
|
|
#include <features.h>
|
|
#include <sys/ucontext.h>
|
|
#include <bits/types.h>
|
|
|
|
__BEGIN_DECLS
|
|
|
|
/* Type of the REQUEST argument to `ptrace.' */
|
|
enum __ptrace_request
|
|
{
|
|
/* Indicate that the process making this request should be traced.
|
|
All signals received by this process can be intercepted by its
|
|
parent, and its parent can use the other `ptrace' requests. */
|
|
PTRACE_TRACEME = 0,
|
|
#define PT_TRACE_ME PTRACE_TRACEME
|
|
|
|
/* Return the word in the process's text space at address ADDR. */
|
|
PTRACE_PEEKTEXT = 1,
|
|
#define PT_READ_I PTRACE_PEEKTEXT
|
|
|
|
/* Return the word in the process's data space at address ADDR. */
|
|
PTRACE_PEEKDATA = 2,
|
|
#define PT_READ_D PTRACE_PEEKDATA
|
|
|
|
/* Return the word in the process's user area at offset ADDR. */
|
|
PTRACE_PEEKUSER = 3,
|
|
#define PT_READ_U PTRACE_PEEKUSER
|
|
|
|
/* Write the word DATA into the process's text space at address ADDR. */
|
|
PTRACE_POKETEXT = 4,
|
|
#define PT_WRITE_I PTRACE_POKETEXT
|
|
|
|
/* Write the word DATA into the process's data space at address ADDR. */
|
|
PTRACE_POKEDATA = 5,
|
|
#define PT_WRITE_D PTRACE_POKEDATA
|
|
|
|
/* Write the word DATA into the process's user area at offset ADDR. */
|
|
PTRACE_POKEUSER = 6,
|
|
#define PT_WRITE_U PTRACE_POKEUSER
|
|
|
|
/* Continue the process. */
|
|
PTRACE_CONT = 7,
|
|
#define PT_CONTINUE PTRACE_CONT
|
|
|
|
/* Kill the process. */
|
|
PTRACE_KILL = 8,
|
|
#define PT_KILL PTRACE_KILL
|
|
|
|
/* Single step the process.
|
|
This is not supported on all machines. */
|
|
PTRACE_SINGLESTEP = 9,
|
|
#define PT_STEP PTRACE_SINGLESTEP
|
|
|
|
/* Execute process until next taken branch. */
|
|
PTRACE_SINGLEBLOCK = 12,
|
|
#define PT_STEPBLOCK PTRACE_SINGLEBLOCK
|
|
|
|
/* Attach to a process that is already running. */
|
|
PTRACE_ATTACH = 16,
|
|
#define PT_ATTACH PTRACE_ATTACH
|
|
|
|
/* Detach from a process attached to with PTRACE_ATTACH. */
|
|
PTRACE_DETACH = 17,
|
|
#define PT_DETACH PTRACE_DETACH
|
|
|
|
/* Get all registers (pt_all_user_regs) in one shot */
|
|
PTRACE_GETREGS = 18,
|
|
#define PT_GETREGS PTRACE_GETREGS
|
|
|
|
/* Set all registers (pt_all_user_regs) in one shot */
|
|
PTRACE_SETREGS = 19,
|
|
#define PT_SETREGS PTRACE_SETREGS
|
|
|
|
/* Continue and stop at the next (return from) syscall. */
|
|
PTRACE_SYSCALL = 24,
|
|
#define PT_SYSCALL PTRACE_SYSCALL
|
|
|
|
/* Set ptrace filter options. */
|
|
PTRACE_SETOPTIONS = 0x4200,
|
|
#define PT_SETOPTIONS PTRACE_SETOPTIONS
|
|
|
|
/* Get last ptrace message. */
|
|
PTRACE_GETEVENTMSG = 0x4201,
|
|
#define PT_GETEVENTMSG PTRACE_GETEVENTMSG
|
|
|
|
/* Get siginfo for process. */
|
|
PTRACE_GETSIGINFO = 0x4202,
|
|
#define PT_GETSIGINFO PTRACE_GETSIGINFO
|
|
|
|
/* Set new siginfo for process. */
|
|
PTRACE_SETSIGINFO = 0x4203,
|
|
#define PT_SETSIGINFO PTRACE_SETSIGINFO
|
|
|
|
/* Get register content. */
|
|
PTRACE_GETREGSET = 0x4204,
|
|
#define PTRACE_GETREGSET PTRACE_GETREGSET
|
|
|
|
/* Set register content. */
|
|
PTRACE_SETREGSET = 0x4205,
|
|
#define PTRACE_SETREGSET PTRACE_SETREGSET
|
|
|
|
/* Like PTRACE_ATTACH, but do not force tracee to trap and do not affect
|
|
signal or group stop state. */
|
|
PTRACE_SEIZE = 0x4206,
|
|
#define PTRACE_SEIZE PTRACE_SEIZE
|
|
|
|
/* Trap seized tracee. */
|
|
PTRACE_INTERRUPT = 0x4207,
|
|
#define PTRACE_INTERRUPT PTRACE_INTERRUPT
|
|
|
|
/* Wait for next group event. */
|
|
PTRACE_LISTEN = 0x4208,
|
|
#define PTRACE_LISTEN PTRACE_LISTEN
|
|
|
|
PTRACE_PEEKSIGINFO = 0x4209,
|
|
#define PTRACE_PEEKSIGINFO PTRACE_PEEKSIGINFO
|
|
|
|
PTRACE_GETSIGMASK = 0x420a,
|
|
#define PTRACE_GETSIGMASK PTRACE_GETSIGMASK
|
|
|
|
PTRACE_SETSIGMASK = 0x420b,
|
|
#define PTRACE_SETSIGMASK PTRACE_SETSIGMASK
|
|
|
|
PTRACE_SECCOMP_GET_FILTER = 0x420c
|
|
#define PTRACE_SECCOMP_GET_FILTER PTRACE_SECCOMP_GET_FILTER
|
|
};
|
|
|
|
|
|
/* Flag for PTRACE_LISTEN. */
|
|
enum __ptrace_flags
|
|
{
|
|
PTRACE_SEIZE_DEVEL = 0x80000000
|
|
};
|
|
|
|
/* pt_all_user_regs is used for PTRACE_GETREGS/PTRACE_SETREGS. */
|
|
struct __pt_all_user_regs
|
|
{
|
|
unsigned long nat;
|
|
unsigned long cr_iip;
|
|
unsigned long cfm;
|
|
unsigned long cr_ipsr;
|
|
unsigned long pr;
|
|
|
|
unsigned long gr[32];
|
|
unsigned long br[8];
|
|
unsigned long ar[128];
|
|
struct __ia64_fpreg fr[128];
|
|
};
|
|
|
|
/* 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
|
|
};
|
|
|
|
/* Wait extended result codes for the above trace options. */
|
|
enum __ptrace_eventcodes
|
|
{
|
|
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
|
|
};
|
|
|
|
/* 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)
|
|
};
|
|
|
|
/* 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;
|
|
|
|
__END_DECLS
|
|
|
|
#endif /* _SYS_PTRACE_H */
|