xref: /dragonfly/sys/sys/ptrace.h (revision c97dc9deabfb67222d4757fb056d6eef43bffcaf)
1 /*-
2  * Copyright (c) 1984, 1993
3  *        The Regents of the University of California.  All rights reserved.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions
7  * are met:
8  * 1. Redistributions of source code must retain the above copyright
9  *    notice, this list of conditions and the following disclaimer.
10  * 2. Redistributions in binary form must reproduce the above copyright
11  *    notice, this list of conditions and the following disclaimer in the
12  *    documentation and/or other materials provided with the distribution.
13  * 3. Neither the name of the University nor the names of its contributors
14  *    may be used to endorse or promote products derived from this software
15  *    without specific prior written permission.
16  *
17  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
18  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
19  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
20  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
21  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
22  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
23  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
24  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
25  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
26  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
27  * SUCH DAMAGE.
28  *
29  *        @(#)ptrace.h        8.2 (Berkeley) 1/4/94
30  * $FreeBSD: src/sys/sys/ptrace.h,v 1.10.2.2 2003/01/02 20:39:13 kan Exp $
31  */
32 
33 #ifndef   _SYS_PTRACE_H_
34 #define   _SYS_PTRACE_H_
35 
36 #ifndef _SYS_TYPES_H_
37 #include <sys/types.h>
38 #endif
39 
40 #define   PT_TRACE_ME         0         /* child declares it's being traced */
41 #define   PT_READ_I 1         /* read word in child's I space */
42 #define   PT_READ_D 2         /* read word in child's D space */
43 /* was    PT_READ_U 3          * read word in child's user structure */
44 #define   PT_WRITE_I          4         /* write word in child's I space */
45 #define   PT_WRITE_D          5         /* write word in child's D space */
46 /* was    PT_WRITE_U          6          * write word in child's user structure */
47 #define   PT_CONTINUE         7         /* continue the child */
48 #define   PT_KILL             8         /* kill the child process */
49 #define   PT_STEP             9         /* single step the child */
50 
51 #define   PT_ATTACH 10        /* trace some running process */
52 #define   PT_DETACH 11        /* stop tracing a process */
53 #define   PT_IO               12        /* do I/O to/from stopped process. */
54 
55 #define   PT_FIRSTMACH        32        /* for machine-specific requests */
56 
57 #ifndef _MACHINE_PTRACE_H_
58 #include <machine/ptrace.h>   /* machine-specific requests, if any */
59 #endif
60 
61 struct ptrace_io_desc {
62           int       piod_op;  /* I/O operation */
63           void      *piod_offs;         /* child offset */
64           void      *piod_addr;         /* parent offset */
65           size_t    piod_len; /* request length */
66 };
67 
68 /*
69  *  Operations in piod_op.
70  */
71 #define   PIOD_READ_D         1         /* Read from D space */
72 #define   PIOD_WRITE_D        2         /* Write to D space */
73 #define   PIOD_READ_I         3         /* Read from I space */
74 #define   PIOD_WRITE_I        4         /* Write to I space */
75 
76 #ifdef _KERNEL
77 
78 struct proc;
79 struct lwp;
80 
81 void      proc_reparent (struct proc *child, struct proc *newparent);
82 int       ptrace_set_pc (struct lwp *p, unsigned long addr);
83 int       ptrace_single_step (struct lwp *lp);
84 int       kern_ptrace (struct proc *p, int req, pid_t pid, void *addr,
85                     int data, int *res);
86 
87 #else /* !_KERNEL */
88 
89 #ifndef _SYS_CDEFS_H_
90 #include <sys/cdefs.h>
91 #endif
92 
93 __BEGIN_DECLS
94 int       ptrace (int, pid_t, caddr_t, int);
95 __END_DECLS
96 
97 #endif /* _KERNEL */
98 
99 #endif    /* !_SYS_PTRACE_H_ */
100