2000-08-02 15:15:00 +00:00
|
|
|
/* `ptrace' debugger support interface. Linux version.
|
|
|
|
|
Copyright (C) 2000 Free Software Foundation, Inc.
|
|
|
|
|
Contributed by Denis Joseph Barrow (djbarrow@de.ibm.com).
|
|
|
|
|
This file is part of the GNU C Library.
|
|
|
|
|
|
|
|
|
|
The GNU C Library is free software; you can redistribute it and/or
|
2001-07-06 04:58:11 +00:00
|
|
|
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.
|
2000-08-02 15:15:00 +00:00
|
|
|
|
|
|
|
|
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
|
2001-07-06 04:58:11 +00:00
|
|
|
Lesser General Public License for more details.
|
2000-08-02 15:15:00 +00:00
|
|
|
|
2001-07-06 04:58:11 +00:00
|
|
|
You should have received a copy of the GNU Lesser General Public
|
|
|
|
|
License along with the GNU C Library; if not, write to the Free
|
|
|
|
|
Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
|
|
|
|
|
02111-1307 USA. */
|
2000-08-02 15:15:00 +00:00
|
|
|
|
|
|
|
|
#ifndef _SYS_PTRACE_H
|
|
|
|
|
#define _SYS_PTRACE_H 1
|
|
|
|
|
|
|
|
|
|
#include <features.h>
|
|
|
|
|
|
|
|
|
|
__BEGIN_DECLS
|
|
|
|
|
#ifdef _LINUX_PTRACE_H
|
|
|
|
|
/* Kludge to stop stuff gdb & strace compiles from getting upset
|
|
|
|
|
*/
|
|
|
|
|
#undef PTRACE_TRACEME
|
|
|
|
|
#undef PTRACE_PEEKTEXT
|
|
|
|
|
#undef PTRACE_PEEKDATA
|
|
|
|
|
#undef PTRACE_PEEKUSR
|
|
|
|
|
#undef PTRACE_POKETEXT
|
|
|
|
|
#undef PTRACE_POKEDATA
|
|
|
|
|
#undef PTRACE_POKEUSR
|
|
|
|
|
#undef PTRACE_CONT
|
|
|
|
|
#undef PTRACE_KILL
|
|
|
|
|
#undef PTRACE_SINGLESTEP
|
|
|
|
|
|
|
|
|
|
#undef PTRACE_ATTACH
|
|
|
|
|
#undef PTRACE_DETACH
|
|
|
|
|
|
|
|
|
|
#undef PTRACE_SYSCALL
|
|
|
|
|
#endif
|
|
|
|
|
/* 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
|
|
|
|
|
|
|
|
|
|
/* Get all general purpose registers used by a processes.
|
|
|
|
|
This is not supported on all machines. */
|
|
|
|
|
PTRACE_GETREGS = 12,
|
|
|
|
|
#define PT_GETREGS PTRACE_GETREGS
|
|
|
|
|
|
|
|
|
|
/* Set all general purpose registers used by a processes.
|
|
|
|
|
This is not supported on all machines. */
|
|
|
|
|
PTRACE_SETREGS = 13,
|
|
|
|
|
#define PT_SETREGS PTRACE_SETREGS
|
|
|
|
|
|
|
|
|
|
/* Get all floating point registers used by a processes.
|
|
|
|
|
This is not supported on all machines. */
|
|
|
|
|
PTRACE_GETFPREGS = 14,
|
|
|
|
|
#define PT_GETFPREGS PTRACE_GETFPREGS
|
|
|
|
|
|
|
|
|
|
/* Set all floating point registers used by a processes.
|
|
|
|
|
This is not supported on all machines. */
|
|
|
|
|
PTRACE_SETFPREGS = 15,
|
|
|
|
|
#define PT_SETFPREGS PTRACE_SETFPREGS
|
|
|
|
|
|
|
|
|
|
/* 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
|
|
|
|
|
|
|
|
|
|
/* Continue and stop at the next (return from) syscall. */
|
|
|
|
|
PTRACE_SYSCALL = 24
|
|
|
|
|
#define PT_SYSCALL PTRACE_SYSCALL
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/* 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, ...);
|
|
|
|
|
|
|
|
|
|
__END_DECLS
|
|
|
|
|
|
|
|
|
|
#endif /* _SYS_PTRACE_H */
|
