xref: /xnu-10063.141.1/bsd/sys/ptrace.h (revision d8b80295118ef25ac3a784134bcf95cd8e88109f)
1*d8b80295SApple OSS Distributions /*
2*d8b80295SApple OSS Distributions  * Copyright (c) 2000-2005 Apple Computer, Inc. All rights reserved.
3*d8b80295SApple OSS Distributions  *
4*d8b80295SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_START@
5*d8b80295SApple OSS Distributions  *
6*d8b80295SApple OSS Distributions  * This file contains Original Code and/or Modifications of Original Code
7*d8b80295SApple OSS Distributions  * as defined in and that are subject to the Apple Public Source License
8*d8b80295SApple OSS Distributions  * Version 2.0 (the 'License'). You may not use this file except in
9*d8b80295SApple OSS Distributions  * compliance with the License. The rights granted to you under the License
10*d8b80295SApple OSS Distributions  * may not be used to create, or enable the creation or redistribution of,
11*d8b80295SApple OSS Distributions  * unlawful or unlicensed copies of an Apple operating system, or to
12*d8b80295SApple OSS Distributions  * circumvent, violate, or enable the circumvention or violation of, any
13*d8b80295SApple OSS Distributions  * terms of an Apple operating system software license agreement.
14*d8b80295SApple OSS Distributions  *
15*d8b80295SApple OSS Distributions  * Please obtain a copy of the License at
16*d8b80295SApple OSS Distributions  * http://www.opensource.apple.com/apsl/ and read it before using this file.
17*d8b80295SApple OSS Distributions  *
18*d8b80295SApple OSS Distributions  * The Original Code and all software distributed under the License are
19*d8b80295SApple OSS Distributions  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
20*d8b80295SApple OSS Distributions  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
21*d8b80295SApple OSS Distributions  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
22*d8b80295SApple OSS Distributions  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
23*d8b80295SApple OSS Distributions  * Please see the License for the specific language governing rights and
24*d8b80295SApple OSS Distributions  * limitations under the License.
25*d8b80295SApple OSS Distributions  *
26*d8b80295SApple OSS Distributions  * @APPLE_OSREFERENCE_LICENSE_HEADER_END@
27*d8b80295SApple OSS Distributions  */
28*d8b80295SApple OSS Distributions /* Copyright (c) 1995 NeXT Computer, Inc. All Rights Reserved */
29*d8b80295SApple OSS Distributions /*-
30*d8b80295SApple OSS Distributions  * Copyright (c) 1984, 1993
31*d8b80295SApple OSS Distributions  *	The Regents of the University of California.  All rights reserved.
32*d8b80295SApple OSS Distributions  *
33*d8b80295SApple OSS Distributions  * Redistribution and use in source and binary forms, with or without
34*d8b80295SApple OSS Distributions  * modification, are permitted provided that the following conditions
35*d8b80295SApple OSS Distributions  * are met:
36*d8b80295SApple OSS Distributions  * 1. Redistributions of source code must retain the above copyright
37*d8b80295SApple OSS Distributions  *    notice, this list of conditions and the following disclaimer.
38*d8b80295SApple OSS Distributions  * 2. Redistributions in binary form must reproduce the above copyright
39*d8b80295SApple OSS Distributions  *    notice, this list of conditions and the following disclaimer in the
40*d8b80295SApple OSS Distributions  *    documentation and/or other materials provided with the distribution.
41*d8b80295SApple OSS Distributions  * 3. All advertising materials mentioning features or use of this software
42*d8b80295SApple OSS Distributions  *    must display the following acknowledgement:
43*d8b80295SApple OSS Distributions  *	This product includes software developed by the University of
44*d8b80295SApple OSS Distributions  *	California, Berkeley and its contributors.
45*d8b80295SApple OSS Distributions  * 4. Neither the name of the University nor the names of its contributors
46*d8b80295SApple OSS Distributions  *    may be used to endorse or promote products derived from this software
47*d8b80295SApple OSS Distributions  *    without specific prior written permission.
48*d8b80295SApple OSS Distributions  *
49*d8b80295SApple OSS Distributions  * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
50*d8b80295SApple OSS Distributions  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
51*d8b80295SApple OSS Distributions  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
52*d8b80295SApple OSS Distributions  * ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
53*d8b80295SApple OSS Distributions  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
54*d8b80295SApple OSS Distributions  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
55*d8b80295SApple OSS Distributions  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
56*d8b80295SApple OSS Distributions  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
57*d8b80295SApple OSS Distributions  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
58*d8b80295SApple OSS Distributions  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
59*d8b80295SApple OSS Distributions  * SUCH DAMAGE.
60*d8b80295SApple OSS Distributions  *
61*d8b80295SApple OSS Distributions  *	@(#)ptrace.h	8.2 (Berkeley) 1/4/94
62*d8b80295SApple OSS Distributions  */
63*d8b80295SApple OSS Distributions 
64*d8b80295SApple OSS Distributions #ifndef _SYS_PTRACE_H_
65*d8b80295SApple OSS Distributions #define _SYS_PTRACE_H_
66*d8b80295SApple OSS Distributions 
67*d8b80295SApple OSS Distributions #include <sys/appleapiopts.h>
68*d8b80295SApple OSS Distributions #include <sys/cdefs.h>
69*d8b80295SApple OSS Distributions #include <sys/types.h>
70*d8b80295SApple OSS Distributions 
71*d8b80295SApple OSS Distributions enum {
72*d8b80295SApple OSS Distributions 	ePtAttachDeprecated __deprecated_enum_msg("PT_ATTACH is deprecated. See PT_ATTACHEXC") = 10
73*d8b80295SApple OSS Distributions };
74*d8b80295SApple OSS Distributions 
75*d8b80295SApple OSS Distributions 
76*d8b80295SApple OSS Distributions #define PT_TRACE_ME     0       /* child declares it's being traced */
77*d8b80295SApple OSS Distributions #define PT_READ_I       1       /* read word in child's I space */
78*d8b80295SApple OSS Distributions #define PT_READ_D       2       /* read word in child's D space */
79*d8b80295SApple OSS Distributions #define PT_READ_U       3       /* read word in child's user structure */
80*d8b80295SApple OSS Distributions #define PT_WRITE_I      4       /* write word in child's I space */
81*d8b80295SApple OSS Distributions #define PT_WRITE_D      5       /* write word in child's D space */
82*d8b80295SApple OSS Distributions #define PT_WRITE_U      6       /* write word in child's user structure */
83*d8b80295SApple OSS Distributions #define PT_CONTINUE     7       /* continue the child */
84*d8b80295SApple OSS Distributions #define PT_KILL         8       /* kill the child process */
85*d8b80295SApple OSS Distributions #define PT_STEP         9       /* single step the child */
86*d8b80295SApple OSS Distributions #define PT_ATTACH       ePtAttachDeprecated     /* trace some running process */
87*d8b80295SApple OSS Distributions #define PT_DETACH       11      /* stop tracing a process */
88*d8b80295SApple OSS Distributions #define PT_SIGEXC       12      /* signals as exceptions for current_proc */
89*d8b80295SApple OSS Distributions #define PT_THUPDATE     13      /* signal for thread# */
90*d8b80295SApple OSS Distributions #define PT_ATTACHEXC    14      /* attach to running process with signal exception */
91*d8b80295SApple OSS Distributions 
92*d8b80295SApple OSS Distributions #define PT_FORCEQUOTA   30      /* Enforce quota for root */
93*d8b80295SApple OSS Distributions #define PT_DENY_ATTACH  31
94*d8b80295SApple OSS Distributions 
95*d8b80295SApple OSS Distributions #define PT_FIRSTMACH    32      /* for machine-specific requests */
96*d8b80295SApple OSS Distributions 
97*d8b80295SApple OSS Distributions __BEGIN_DECLS
98*d8b80295SApple OSS Distributions 
99*d8b80295SApple OSS Distributions #ifndef KERNEL
100*d8b80295SApple OSS Distributions 
101*d8b80295SApple OSS Distributions int     ptrace(int _request, pid_t _pid, caddr_t _addr, int _data);
102*d8b80295SApple OSS Distributions 
103*d8b80295SApple OSS Distributions #endif /* !KERNEL */
104*d8b80295SApple OSS Distributions 
105*d8b80295SApple OSS Distributions __END_DECLS
106*d8b80295SApple OSS Distributions 
107*d8b80295SApple OSS Distributions #endif  /* !_SYS_PTRACE_H_ */
108