<sys/ptrace.h>
Change-Id: Ib930c661c1e6de05b2e0d5fce4ffc1ae2269fc6a
This commit is contained in:
Ben Gras
291
sys/sys/ptrace.h
291
sys/sys/ptrace.h
@@ -1,58 +1,261 @@
|
||||
/* <sys/ptrace.h>
|
||||
* definitions for ptrace(2)
|
||||
/* $NetBSD: ptrace.h,v 1.44 2011/09/02 20:10:19 christos Exp $ */
|
||||
|
||||
/*-
|
||||
* Copyright (c) 1984, 1993
|
||||
* The Regents of the University of California. All rights reserved.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. Redistributions in binary form must reproduce the above copyright
|
||||
* notice, this list of conditions and the following disclaimer in the
|
||||
* documentation and/or other materials provided with the distribution.
|
||||
* 3. Neither the name of the University nor the names of its contributors
|
||||
* may be used to endorse or promote products derived from this software
|
||||
* without specific prior written permission.
|
||||
*
|
||||
* THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
|
||||
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
||||
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
||||
* ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
|
||||
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
||||
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
||||
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
||||
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
||||
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
||||
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
||||
* SUCH DAMAGE.
|
||||
*
|
||||
* @(#)ptrace.h 8.2 (Berkeley) 1/4/94
|
||||
*/
|
||||
|
||||
#ifndef _PTRACE_H
|
||||
#define _PTRACE_H
|
||||
#ifndef _SYS_PTRACE_H_
|
||||
#define _SYS_PTRACE_H_
|
||||
|
||||
/* Trace requests. */
|
||||
#define T_STOP -1 /* stop the process */
|
||||
#define T_OK 0 /* enable tracing by parent for this process */
|
||||
#define T_GETINS 1 /* return value from instruction space */
|
||||
#define T_GETDATA 2 /* return value from data space */
|
||||
#define T_GETUSER 3 /* return value from user process table */
|
||||
#define T_SETINS 4 /* set value from instruction space */
|
||||
#define T_SETDATA 5 /* set value from data space */
|
||||
#define T_SETUSER 6 /* set value in user process table */
|
||||
#define T_RESUME 7 /* resume execution */
|
||||
#define T_EXIT 8 /* exit */
|
||||
#define T_STEP 9 /* set trace bit */
|
||||
#define T_SYSCALL 10 /* trace system call */
|
||||
#define T_ATTACH 11 /* attach to a running process */
|
||||
#define T_DETACH 12 /* detach from a traced process */
|
||||
#define T_SETOPT 13 /* set trace options */
|
||||
#define T_GETRANGE 14 /* get range of values */
|
||||
#define T_SETRANGE 15 /* set range of values */
|
||||
#define PT_TRACE_ME 0 /* child declares it's being traced */
|
||||
#define PT_READ_I 1 /* read word in child's I space */
|
||||
#define PT_READ_D 2 /* read word in child's D space */
|
||||
#define PT_WRITE_I 4 /* write word in child's I space */
|
||||
#define PT_WRITE_D 5 /* write word in child's D space */
|
||||
#define PT_CONTINUE 7 /* continue the child */
|
||||
#define PT_KILL 8 /* kill the child process */
|
||||
#define PT_ATTACH 9 /* attach to running process */
|
||||
#define PT_DETACH 10 /* detach from running process */
|
||||
#define PT_IO 11 /* do I/O to/from the stopped process */
|
||||
#define PT_DUMPCORE 12 /* make child generate a core dump */
|
||||
#define PT_LWPINFO 13 /* get info about the LWP */
|
||||
#define PT_SYSCALL 14 /* stop on syscall entry/exit */
|
||||
#define PT_SYSCALLEMU 15 /* cancel syscall, tracer emulates it */
|
||||
#define PT_SET_EVENT_MASK 16 /* set the event mask, defined below */
|
||||
#define PT_GET_EVENT_MASK 17 /* get the event mask, defined below */
|
||||
#define PT_GET_PROCESS_STATE 18 /* get process state, defined below */
|
||||
|
||||
#define T_READB_INS 100 /* Read a byte from the text segment of an
|
||||
* untraced process (only for root)
|
||||
*/
|
||||
#define T_WRITEB_INS 101 /* Write a byte in the text segment of an
|
||||
* untraced process (only for root)
|
||||
*/
|
||||
#define PT_FIRSTMACH 32 /* for machine-specific requests */
|
||||
#include <machine/ptrace.h> /* machine-specific requests, if any */
|
||||
|
||||
/* Trace options. */
|
||||
#define TO_TRACEFORK 0x1 /* automatically attach to forked children */
|
||||
#define TO_ALTEXEC 0x2 /* send SIGSTOP on successful exec() */
|
||||
#define TO_NOEXEC 0x4 /* do not send signal on successful exec() */
|
||||
#define PT_STRINGS \
|
||||
/* 0 */ "PT_TRACE_ME", \
|
||||
/* 1 */ "PT_READ_I", \
|
||||
/* 2 */ "PT_READ_D", \
|
||||
/* 3 */ "*PT_INVALID_3*", \
|
||||
/* 4 */ "PT_WRITE_I", \
|
||||
/* 5 */ "PT_WRITE_D", \
|
||||
/* 6 */ "*PT_INVALID_6*", \
|
||||
/* 7 */ "PT_CONTINUE", \
|
||||
/* 8 */ "PT_KILL", \
|
||||
/* 9 */ "PT_ATTACH", \
|
||||
/* 10 */ "PT_DETACH", \
|
||||
/* 11 */ "PT_IO", \
|
||||
/* 12 */ "PT_DUMPCORE", \
|
||||
/* 13 */ "PT_LWPINFO", \
|
||||
/* 14 */ "PT_SYSCALL", \
|
||||
/* 15 */ "PT_SYSCALLEMU", \
|
||||
/* 16 */ "PT_SET_EVENT_MASK", \
|
||||
/* 17 */ "PT_GET_EVENT_MASK", \
|
||||
/* 18 */ "PT_GET_PROCESS_STATE",
|
||||
|
||||
/* Trace spaces. */
|
||||
#define TS_INS 0 /* text space */
|
||||
#define TS_DATA 1 /* data space */
|
||||
/* PT_{G,S}EVENT_MASK */
|
||||
typedef struct ptrace_event {
|
||||
int pe_set_event;
|
||||
} ptrace_event_t;
|
||||
|
||||
/* Trance range structure. */
|
||||
struct ptrace_range {
|
||||
int pr_space; /* space in traced process */
|
||||
long pr_addr; /* address in traced process */
|
||||
void *pr_ptr; /* buffer in caller process */
|
||||
size_t pr_size; /* size of range, in bytes */
|
||||
/* PT_GET_PROCESS_STATE */
|
||||
typedef struct ptrace_state {
|
||||
int pe_report_event;
|
||||
pid_t pe_other_pid;
|
||||
} ptrace_state_t;
|
||||
|
||||
#define PTRACE_FORK 0x0001 /* Report forks */
|
||||
|
||||
/*
|
||||
* Argument structure for PT_IO.
|
||||
*/
|
||||
struct ptrace_io_desc {
|
||||
int piod_op; /* I/O operation (see below) */
|
||||
void *piod_offs; /* child offset */
|
||||
void *piod_addr; /* parent offset */
|
||||
size_t piod_len; /* request length (in)/actual count (out) */
|
||||
};
|
||||
|
||||
/* Function Prototypes. */
|
||||
/* piod_op */
|
||||
#define PIOD_READ_D 1 /* read from D space */
|
||||
#define PIOD_WRITE_D 2 /* write to D spcae */
|
||||
#define PIOD_READ_I 3 /* read from I space */
|
||||
#define PIOD_WRITE_I 4 /* write to I space */
|
||||
|
||||
/*
|
||||
* Argument structure for PT_LWPINFO.
|
||||
*/
|
||||
struct ptrace_lwpinfo {
|
||||
lwpid_t pl_lwpid; /* LWP described */
|
||||
int pl_event; /* Event that stopped the LWP */
|
||||
/* Add fields at the end */
|
||||
};
|
||||
|
||||
#define PL_EVENT_NONE 0
|
||||
#define PL_EVENT_SIGNAL 1
|
||||
|
||||
#ifdef _KERNEL
|
||||
|
||||
#if defined(PT_GETREGS) || defined(PT_SETREGS)
|
||||
struct reg;
|
||||
#ifndef process_reg32
|
||||
#define process_reg32 struct reg
|
||||
#endif
|
||||
#ifndef process_reg64
|
||||
#define process_reg64 struct reg
|
||||
#endif
|
||||
#endif
|
||||
#if defined(PT_GETFPREGS) || defined(PT_SETFPREGS)
|
||||
struct fpreg;
|
||||
#ifndef process_fpreg32
|
||||
#define process_fpreg32 struct fpreg
|
||||
#endif
|
||||
#ifndef process_fpreg64
|
||||
#define process_fpreg64 struct fpreg
|
||||
#endif
|
||||
#endif
|
||||
|
||||
void ptrace_init(void);
|
||||
|
||||
int process_doregs(struct lwp *, struct lwp *, struct uio *);
|
||||
int process_validregs(struct lwp *);
|
||||
|
||||
int process_dofpregs(struct lwp *, struct lwp *, struct uio *);
|
||||
int process_validfpregs(struct lwp *);
|
||||
|
||||
int process_domem(struct lwp *, struct lwp *, struct uio *);
|
||||
|
||||
void process_stoptrace(void);
|
||||
|
||||
void proc_reparent(struct proc *, struct proc *);
|
||||
#ifdef PT_GETFPREGS
|
||||
#ifdef __HAVE_PROCESS_XFPREGS
|
||||
int process_read_xfpregs(struct lwp *, struct fpreg *, size_t *);
|
||||
#ifndef process_read_xfpregs32
|
||||
#define process_read_xfpregs32 process_read_xfpregs
|
||||
#endif
|
||||
#ifndef process_read_xfpregs64
|
||||
#define process_read_xfpregs64 process_read_xfpregs
|
||||
#endif
|
||||
#else
|
||||
int process_read_fpregs(struct lwp *, struct fpreg *);
|
||||
#ifndef process_read_fpregs32
|
||||
#define process_read_fpregs32 process_read_fpregs
|
||||
#endif
|
||||
#ifndef process_read_fpregs64
|
||||
#define process_read_fpregs64 process_read_fpregs
|
||||
#endif
|
||||
#endif
|
||||
#endif
|
||||
#ifdef PT_GETREGS
|
||||
int process_read_regs(struct lwp *, struct reg *);
|
||||
#ifndef process_read_regs32
|
||||
#define process_read_regs32 process_read_regs
|
||||
#endif
|
||||
#ifndef process_read_regs64
|
||||
#define process_read_regs64 process_read_regs
|
||||
#endif
|
||||
#endif
|
||||
int process_set_pc(struct lwp *, void *);
|
||||
int process_sstep(struct lwp *, int);
|
||||
#ifdef PT_SETFPREGS
|
||||
#ifdef __HAVE_PROCESS_XFPREGS
|
||||
int process_write_xfpregs(struct lwp *, const struct fpreg *, size_t);
|
||||
#else
|
||||
int process_write_fpregs(struct lwp *, const struct fpreg *);
|
||||
#endif
|
||||
#endif
|
||||
#ifdef PT_SETREGS
|
||||
int process_write_regs(struct lwp *, const struct reg *);
|
||||
#endif
|
||||
|
||||
#ifdef __HAVE_PROCFS_MACHDEP
|
||||
int ptrace_machdep_dorequest(struct lwp *, struct lwp *, int,
|
||||
void *, int);
|
||||
#endif
|
||||
|
||||
#ifndef FIX_SSTEP
|
||||
#define FIX_SSTEP(p)
|
||||
#endif
|
||||
|
||||
#else /* !_KERNEL */
|
||||
|
||||
#include <sys/cdefs.h>
|
||||
|
||||
__BEGIN_DECLS
|
||||
long ptrace(int _req, pid_t _pid, long _addr, long _data);
|
||||
int ptrace(int _request, pid_t _pid, void *_addr, int _data);
|
||||
__END_DECLS
|
||||
|
||||
#endif /* _PTRACE_H */
|
||||
#endif /* !_KERNEL */
|
||||
|
||||
#ifdef __minix
|
||||
/* Trace options. */
|
||||
#define TO_TRACEFORK 0x1 /* automatically attach to forked children */
|
||||
#define TO_ALTEXEC 0x2 /* send SIGSTOP on successful exec() */
|
||||
#define TO_NOEXEC 0x4 /* do not send signal on successful exec() */
|
||||
|
||||
/* Trace spaces. */
|
||||
#define TS_INS 0 /* text space */
|
||||
#define TS_DATA 1 /* data space */
|
||||
|
||||
/* Trance range structure. */
|
||||
struct ptrace_range {
|
||||
int pr_space; /* space in traced process */
|
||||
long pr_addr; /* address in traced process */
|
||||
void *pr_ptr; /* buffer in caller process */
|
||||
size_t pr_size; /* size of range, in bytes */
|
||||
};
|
||||
|
||||
/* Trace requests aliases for minix. */
|
||||
#define T_OK PT_TRACE_ME /* enable tracing by parent for this process */
|
||||
#define T_GETINS PT_READ_I /* return value from instruction space */
|
||||
#define T_GETDATA PT_READ_D /* return value from data space */
|
||||
#define T_SETINS PT_WRITE_I /* set value from instruction space */
|
||||
#define T_SETDATA PT_WRITE_D /* set value from data space */
|
||||
#define T_RESUME PT_CONTINUE /* resume execution */
|
||||
#define T_EXIT PT_KILL /* exit */
|
||||
#define T_SYSCALL PT_SYSCALL /* trace system call */
|
||||
#define T_ATTACH PT_ATTACH /* attach to a running process */
|
||||
#define T_DETACH PT_DETACH /* detach from a traced process */
|
||||
|
||||
/* Trace requests unique to minix */
|
||||
#define T_STOP -1 /* stop the process */
|
||||
#define T_READB_INS 100 /* Read a byte from the text segment of an
|
||||
* untraced process (only for root)
|
||||
*/
|
||||
#define T_WRITEB_INS 101 /* Write a byte in the text segment of an
|
||||
* untraced process (only for root)
|
||||
*/
|
||||
#define T_GETUSER 102 /* return value from user process table */
|
||||
#define T_SETUSER 103 /* set value in user process table */
|
||||
#define T_STEP 104 /* set trace bit */
|
||||
#define T_SETOPT 105 /* set trace options */
|
||||
#define T_GETRANGE 106 /* get range of values */
|
||||
#define T_SETRANGE 107 /* set range of values */
|
||||
|
||||
#endif
|
||||
|
||||
#endif /* !_SYS_PTRACE_H_ */
|
||||
|
||||
Reference in New Issue
Block a user