Annotation of sys/sys/ptrace.h, Revision 1.1
1.1 ! nbrk 1: /* $OpenBSD: ptrace.h,v 1.10 2005/12/11 21:30:31 miod Exp $ */
! 2: /* $NetBSD: ptrace.h,v 1.21 1996/02/09 18:25:26 christos Exp $ */
! 3:
! 4: /*-
! 5: * Copyright (c) 1984, 1993
! 6: * The Regents of the University of California. All rights reserved.
! 7: *
! 8: * Redistribution and use in source and binary forms, with or without
! 9: * modification, are permitted provided that the following conditions
! 10: * are met:
! 11: * 1. Redistributions of source code must retain the above copyright
! 12: * notice, this list of conditions and the following disclaimer.
! 13: * 2. Redistributions in binary form must reproduce the above copyright
! 14: * notice, this list of conditions and the following disclaimer in the
! 15: * documentation and/or other materials provided with the distribution.
! 16: * 3. Neither the name of the University nor the names of its contributors
! 17: * may be used to endorse or promote products derived from this software
! 18: * without specific prior written permission.
! 19: *
! 20: * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
! 21: * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
! 22: * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
! 23: * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
! 24: * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
! 25: * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
! 26: * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
! 27: * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
! 28: * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
! 29: * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
! 30: * SUCH DAMAGE.
! 31: *
! 32: * @(#)ptrace.h 8.2 (Berkeley) 1/4/94
! 33: */
! 34:
! 35: #ifndef _SYS_PTRACE_H_
! 36: #define _SYS_PTRACE_H_
! 37:
! 38: #define PT_TRACE_ME 0 /* child declares it's being traced */
! 39: #define PT_READ_I 1 /* read word in child's I space */
! 40: #define PT_READ_D 2 /* read word in child's D space */
! 41: #define PT_WRITE_I 4 /* write word in child's I space */
! 42: #define PT_WRITE_D 5 /* write word in child's D space */
! 43: #define PT_CONTINUE 7 /* continue the child */
! 44: #define PT_KILL 8 /* kill the child process */
! 45: #define PT_ATTACH 9 /* attach to running process */
! 46: #define PT_DETACH 10 /* detach from running process */
! 47: #define PT_IO 11 /* do I/O to/from the stopped process. */
! 48:
! 49: struct ptrace_io_desc {
! 50: int piod_op; /* I/O operation */
! 51: void *piod_offs; /* child offset */
! 52: void *piod_addr; /* parent offset */
! 53: size_t piod_len; /* request length */
! 54: };
! 55:
! 56: /*
! 57: * Operations in piod_op.
! 58: */
! 59: #define PIOD_READ_D 1 /* Read from D space */
! 60: #define PIOD_WRITE_D 2 /* Write to D space */
! 61: #define PIOD_READ_I 3 /* Read from I space */
! 62: #define PIOD_WRITE_I 4 /* Write to I space */
! 63:
! 64: #define PT_SET_EVENT_MASK 12
! 65: #define PT_GET_EVENT_MASK 13
! 66:
! 67: typedef struct ptrace_event {
! 68: int pe_set_event;
! 69: } ptrace_event_t;
! 70:
! 71: #define PTRACE_FORK 0x0002 /* Report forks */
! 72:
! 73: #define PT_GET_PROCESS_STATE 14
! 74:
! 75: typedef struct ptrace_state {
! 76: int pe_report_event;
! 77: pid_t pe_other_pid;
! 78: } ptrace_state_t;
! 79:
! 80: #define PT_FIRSTMACH 32 /* for machine-specific requests */
! 81: #include <machine/ptrace.h> /* machine-specific requests, if any */
! 82:
! 83: #ifdef _KERNEL
! 84:
! 85: /*
! 86: * There is a bunch of PT_ requests that are machine dependent, but not
! 87: * optional. Check if they were defined by MD code here.
! 88: */
! 89: #if !defined(PT_GETREGS) || !defined(PT_SETREGS)
! 90: #error Machine dependent ptrace not complete.
! 91: #endif
! 92:
! 93: struct reg;
! 94: #if defined(PT_GETFPREGS) || defined(PT_SETFPREGS)
! 95: struct fpreg;
! 96: #endif
! 97:
! 98: void proc_reparent(struct proc *child, struct proc *newparent);
! 99: #ifdef PT_GETFPREGS
! 100: int process_read_fpregs(struct proc *p, struct fpreg *regs);
! 101: #endif
! 102: int process_read_regs(struct proc *p, struct reg *regs);
! 103: int process_set_pc(struct proc *p, caddr_t addr);
! 104: int process_sstep(struct proc *p, int sstep);
! 105: #ifdef PT_SETFPREGS
! 106: int process_write_fpregs(struct proc *p, struct fpreg *regs);
! 107: #endif
! 108: int process_write_regs(struct proc *p, struct reg *regs);
! 109: int process_checkioperm(struct proc *, struct proc *);
! 110: int process_domem(struct proc *, struct proc *, struct uio *, int);
! 111:
! 112: #ifndef FIX_SSTEP
! 113: #define FIX_SSTEP(p)
! 114: #endif
! 115:
! 116: #else /* !_KERNEL */
! 117:
! 118: #include <sys/cdefs.h>
! 119:
! 120: __BEGIN_DECLS
! 121: int ptrace(int _request, pid_t _pid, caddr_t _addr, int _data);
! 122: __END_DECLS
! 123:
! 124: #endif /* !_KERNEL */
! 125:
! 126: #endif /* !_SYS_PTRACE_H_ */
CVSweb