]>
Commit | Line | Data |
---|---|---|
91447636 | 1 | /* |
6d2010ae | 2 | * Copyright (c) 2000-2010 Apple Inc. All rights reserved. |
5d5c5d0d | 3 | * |
2d21ac55 | 4 | * @APPLE_OSREFERENCE_LICENSE_HEADER_START@ |
91447636 | 5 | * |
2d21ac55 A |
6 | * This file contains Original Code and/or Modifications of Original Code |
7 | * as defined in and that are subject to the Apple Public Source License | |
8 | * Version 2.0 (the 'License'). You may not use this file except in | |
9 | * compliance with the License. The rights granted to you under the License | |
10 | * may not be used to create, or enable the creation or redistribution of, | |
11 | * unlawful or unlicensed copies of an Apple operating system, or to | |
12 | * circumvent, violate, or enable the circumvention or violation of, any | |
13 | * terms of an Apple operating system software license agreement. | |
8f6c56a5 | 14 | * |
2d21ac55 A |
15 | * Please obtain a copy of the License at |
16 | * http://www.opensource.apple.com/apsl/ and read it before using this file. | |
17 | * | |
18 | * The Original Code and all software distributed under the License are | |
19 | * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER | |
8f6c56a5 A |
20 | * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, |
21 | * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, | |
2d21ac55 A |
22 | * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. |
23 | * Please see the License for the specific language governing rights and | |
24 | * limitations under the License. | |
8f6c56a5 | 25 | * |
2d21ac55 | 26 | * @APPLE_OSREFERENCE_LICENSE_HEADER_END@ |
91447636 A |
27 | */ |
28 | /* Copyright (c) 1995, 1997 Apple Computer, Inc. All Rights Reserved */ | |
29 | /*- | |
30 | * Copyright (c) 1986, 1989, 1991, 1993 | |
31 | * The Regents of the University of California. All rights reserved. | |
32 | * (c) UNIX System Laboratories, Inc. | |
33 | * All or some portions of this file are derived from material licensed | |
34 | * to the University of California by American Telephone and Telegraph | |
35 | * Co. or Unix System Laboratories, Inc. and are reproduced herein with | |
36 | * the permission of UNIX System Laboratories, Inc. | |
37 | * | |
38 | * Redistribution and use in source and binary forms, with or without | |
39 | * modification, are permitted provided that the following conditions | |
40 | * are met: | |
41 | * 1. Redistributions of source code must retain the above copyright | |
42 | * notice, this list of conditions and the following disclaimer. | |
43 | * 2. Redistributions in binary form must reproduce the above copyright | |
44 | * notice, this list of conditions and the following disclaimer in the | |
45 | * documentation and/or other materials provided with the distribution. | |
46 | * 3. All advertising materials mentioning features or use of this software | |
47 | * must display the following acknowledgement: | |
48 | * This product includes software developed by the University of | |
49 | * California, Berkeley and its contributors. | |
50 | * 4. Neither the name of the University nor the names of its contributors | |
51 | * may be used to endorse or promote products derived from this software | |
52 | * without specific prior written permission. | |
53 | * | |
54 | * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND | |
55 | * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
56 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
57 | * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
58 | * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
59 | * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
60 | * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
61 | * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
62 | * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
63 | * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
64 | * SUCH DAMAGE. | |
65 | * | |
66 | * @(#)proc_internal.h 8.15 (Berkeley) 5/19/95 | |
67 | */ | |
2d21ac55 A |
68 | /* |
69 | * NOTICE: This file was modified by SPARTA, Inc. in 2005 to introduce | |
70 | * support for mandatory and extensible security protections. This notice | |
71 | * is included in support of clause 2.2 (b) of the Apple Public License, | |
72 | * Version 2.0. | |
73 | */ | |
91447636 A |
74 | |
75 | #ifndef _SYS_PROC_INTERNAL_H_ | |
76 | #define _SYS_PROC_INTERNAL_H_ | |
77 | ||
2d21ac55 | 78 | #include <libkern/OSAtomic.h> |
91447636 A |
79 | #include <sys/proc.h> |
80 | __BEGIN_DECLS | |
81 | #include <kern/locks.h> | |
b0d623f7 A |
82 | #if PSYNCH |
83 | #include <kern/thread_call.h> | |
84 | #endif /* PSYNCH */ | |
91447636 A |
85 | __END_DECLS |
86 | ||
593a1d5f | 87 | #if DEBUG |
2d21ac55 | 88 | #define __PROC_INTERNAL_DEBUG 1 |
593a1d5f | 89 | #endif |
2d21ac55 A |
90 | |
91 | /* | |
92 | * The short form for various locks that protect fields in the data structures. | |
93 | * PL = Process Lock | |
94 | * PGL = Process Group Lock | |
95 | * PFDL = Process File Desc Lock | |
96 | * PSL = Process Spin Lock | |
97 | * PPL = Parent Process Lock (planed for later usage) | |
98 | * LL = List Lock | |
99 | * SL = Session Lock | |
100 | */ | |
101 | struct label; | |
102 | ||
103 | /* | |
104 | * Added by SPARTA, Inc. | |
105 | */ | |
106 | /* | |
107 | * Login context. | |
108 | */ | |
109 | struct lctx { | |
110 | LIST_ENTRY(lctx) lc_list; /* List of all login contexts. */ | |
111 | LIST_HEAD(, proc) lc_members; /* Pointer to lc members. */ | |
112 | int lc_mc; /* Member Count. */ | |
113 | pid_t lc_id; /* Login context ID. */ | |
114 | lck_mtx_t lc_mtx; /* Mutex to protect members */ | |
115 | ||
116 | struct label *lc_label; /* Login context MAC label. */ | |
117 | }; | |
118 | ||
91447636 A |
119 | /* |
120 | * One structure allocated per session. | |
121 | */ | |
122 | struct session { | |
2d21ac55 A |
123 | int s_count; /* Ref cnt; pgrps in session. (LL) */ |
124 | struct proc * s_leader; /* Session leader.(static) */ | |
125 | struct vnode * s_ttyvp; /* Vnode of controlling terminal.(SL) */ | |
126 | int s_ttyvid; /* Vnode id of the controlling terminal (SL) */ | |
b0d623f7 | 127 | struct tty * s_ttyp; /* Controlling terminal. (SL + ttyvp != NULL) */ |
2d21ac55 A |
128 | pid_t s_ttypgrpid; /* tty's pgrp id */ |
129 | pid_t s_sid; /* Session ID (static) */ | |
130 | char s_login[MAXLOGNAME]; /* Setlogin() name.(SL) */ | |
131 | int s_flags; /* Session flags (s_mlock) */ | |
132 | LIST_ENTRY(session) s_hash; /* Hash chain.(LL) */ | |
133 | lck_mtx_t s_mlock; /* mutex lock to protect session */ | |
134 | int s_listflags; | |
91447636 A |
135 | }; |
136 | ||
2d21ac55 A |
137 | #define SESSION_NULL (struct session *)0 |
138 | ||
b0d623f7 A |
139 | /* |
140 | * accessor for s_ttyp which treats it as invalid if s_ttyvp is not valid; | |
141 | * note that s_ttyp is not a reference in the session structre, so it can | |
142 | * become invalid out from under the session if the device is closed, without | |
143 | * this protection. We can't safely make it into a reference without reflexive | |
144 | * close notification of tty devices through cdevsw[]. | |
145 | * | |
146 | * NB: <sys/tty.h> is not in scope and there is not typedef type enforcement, | |
147 | * or '0' below would be 'TTY_NULL'. | |
148 | */ | |
149 | #define SESSION_TP(sp) (((sp)->s_ttyvp != 0) ? (sp)->s_ttyp : 0) | |
150 | ||
2d21ac55 A |
151 | /* |
152 | * Session flags; used to tunnel information to lower layers and line | |
153 | * disciplines, etc. | |
154 | */ | |
155 | #define S_DEFAULT 0x00000000 /* No flags set */ | |
156 | #define S_NOCTTY 0x00000001 /* Do not associate controlling tty */ | |
157 | ||
158 | ||
159 | #define S_LIST_TERM 1 /* marked for termination */ | |
160 | #define S_LIST_DEAD 2 /* already dead */ | |
91447636 A |
161 | /* |
162 | * One structure allocated per process group. | |
163 | */ | |
164 | struct pgrp { | |
2d21ac55 A |
165 | LIST_ENTRY(pgrp) pg_hash; /* Hash chain. (LL) */ |
166 | LIST_HEAD(, proc) pg_members; /* Pointer to pgrp members. (PGL) */ | |
167 | struct session * pg_session; /* Pointer to session. (LL ) */ | |
168 | pid_t pg_id; /* Pgrp id. (static) */ | |
169 | int pg_jobc; /* # procs qualifying pgrp for job control (PGL) */ | |
170 | int pg_membercnt; /* Number of processes in the pgrocess group (PGL) */ | |
171 | int pg_refcount; /* number of current iterators (LL) */ | |
172 | unsigned int pg_listflags; /* (LL) */ | |
173 | lck_mtx_t pg_mlock; /* mutex lock to protect pgrp */ | |
91447636 A |
174 | }; |
175 | ||
2d21ac55 A |
176 | #define PGRP_FLAG_TERMINATE 1 |
177 | #define PGRP_FLAG_WAITTERMINATE 2 | |
178 | #define PGRP_FLAG_DEAD 4 | |
179 | #define PGRP_FLAG_ITERABEGIN 8 | |
180 | #define PGRP_FLAG_ITERWAIT 0x10 | |
181 | ||
182 | #define PGRP_NULL (struct pgrp *)0 | |
91447636 A |
183 | struct proc; |
184 | ||
ff6e181a | 185 | #define PROC_NULL (struct proc *)0 |
91447636 | 186 | |
6d2010ae A |
187 | #define PROC_UPDATE_CREDS_ONPROC(p) { \ |
188 | p->p_uid = kauth_cred_getuid(p->p_ucred); \ | |
189 | p->p_gid = kauth_cred_getgid(p->p_ucred); \ | |
190 | p->p_ruid = kauth_cred_getruid(p->p_ucred); \ | |
191 | p->p_rgid = kauth_cred_getrgid(p->p_ucred); \ | |
192 | p->p_svuid = kauth_cred_getsvuid(p->p_ucred); \ | |
193 | p->p_svgid = kauth_cred_getsvgid(p->p_ucred); \ | |
194 | } | |
91447636 A |
195 | /* |
196 | * Description of a process. | |
197 | * | |
198 | * This structure contains the information needed to manage a thread of | |
199 | * control, known in UN*X as a process; it has references to substructures | |
200 | * containing descriptions of things that the process uses, but may share | |
201 | * with related processes. The process structure and the substructures | |
202 | * are always addressible except for those marked "(PROC ONLY)" below, | |
203 | * which might be addressible only on a processor on which the process | |
204 | * is running. | |
205 | */ | |
206 | struct proc { | |
2d21ac55 | 207 | LIST_ENTRY(proc) p_list; /* List of all processes. */ |
91447636 | 208 | |
2d21ac55 A |
209 | pid_t p_pid; /* Process identifier. (static)*/ |
210 | void * task; /* corresponding task (static)*/ | |
211 | struct proc * p_pptr; /* Pointer to parent process.(LL) */ | |
212 | pid_t p_ppid; /* process's parent pid number */ | |
213 | pid_t p_pgrpid; /* process group id of the process (LL)*/ | |
6d2010ae A |
214 | uid_t p_uid; |
215 | gid_t p_gid; | |
216 | uid_t p_ruid; | |
217 | gid_t p_rgid; | |
218 | uid_t p_svuid; | |
219 | gid_t p_svgid; | |
220 | uint64_t p_uniqueid; /* process uniqe ID */ | |
91447636 | 221 | |
2d21ac55 | 222 | lck_mtx_t p_mlock; /* mutex lock for proc */ |
91447636 | 223 | |
2d21ac55 A |
224 | char p_stat; /* S* process status. (PL)*/ |
225 | char p_shutdownstate; | |
226 | char p_kdebug; /* P_KDEBUG eq (CC)*/ | |
227 | char p_btrace; /* P_BTRACE eq (CC)*/ | |
91447636 | 228 | |
2d21ac55 A |
229 | LIST_ENTRY(proc) p_pglist; /* List of processes in pgrp.(PGL) */ |
230 | LIST_ENTRY(proc) p_sibling; /* List of sibling processes. (LL)*/ | |
231 | LIST_HEAD(, proc) p_children; /* Pointer to list of children. (LL)*/ | |
232 | TAILQ_HEAD( , uthread) p_uthlist; /* List of uthreads (PL) */ | |
91447636 | 233 | |
2d21ac55 A |
234 | LIST_ENTRY(proc) p_hash; /* Hash chain. (LL)*/ |
235 | TAILQ_HEAD( ,eventqelt) p_evlist; /* (PL) */ | |
91447636 | 236 | |
2d21ac55 | 237 | lck_mtx_t p_fdmlock; /* proc lock to protect fdesc */ |
91447636 | 238 | |
2d21ac55 A |
239 | /* substructures: */ |
240 | kauth_cred_t p_ucred; /* Process owner's identity. (PL) */ | |
241 | struct filedesc *p_fd; /* Ptr to open files structure. (PFDL) */ | |
242 | struct pstats *p_stats; /* Accounting/statistics (PL). */ | |
243 | struct plimit *p_limit; /* Process limits.(PL) */ | |
91447636 | 244 | |
2d21ac55 | 245 | struct sigacts *p_sigacts; /* Signal actions, state (PL) */ |
b0d623f7 | 246 | int p_siglist; /* signals captured back from threads */ |
2d21ac55 | 247 | lck_spin_t p_slock; /* spin lock for itimer/profil protection */ |
91447636 | 248 | |
2d21ac55 | 249 | #define p_rlimit p_limit->pl_rlimit |
91447636 | 250 | |
2d21ac55 A |
251 | struct plimit *p_olimit; /* old process limits - not inherited by child (PL) */ |
252 | unsigned int p_flag; /* P_* flags. (atomic bit ops) */ | |
253 | unsigned int p_lflag; /* local flags (PL) */ | |
254 | unsigned int p_listflag; /* list flags (LL) */ | |
255 | unsigned int p_ladvflag; /* local adv flags (atomic) */ | |
256 | int p_refcount; /* number of outstanding users(LL) */ | |
257 | int p_childrencnt; /* children holding ref on parent (LL) */ | |
258 | int p_parentref; /* children lookup ref on parent (LL) */ | |
259 | ||
260 | pid_t p_oppid; /* Save parent pid during ptrace. XXX */ | |
261 | u_int p_xstat; /* Exit status for wait; also stop signal. */ | |
262 | ||
263 | #ifdef _PROC_HAS_SCHEDINFO_ | |
264 | /* may need cleanup, not used */ | |
265 | u_int p_estcpu; /* Time averaged value of p_cpticks.(used by aio and proc_comapre) */ | |
266 | fixpt_t p_pctcpu; /* %cpu for this process during p_swtime (used by aio)*/ | |
267 | u_int p_slptime; /* used by proc_compare */ | |
268 | #endif /* _PROC_HAS_SCHEDINFO_ */ | |
269 | ||
270 | struct itimerval p_realtimer; /* Alarm timer. (PSL) */ | |
271 | struct timeval p_rtime; /* Real time.(PSL) */ | |
272 | struct itimerval p_vtimer_user; /* Virtual timers.(PSL) */ | |
273 | struct itimerval p_vtimer_prof; /* (PSL) */ | |
274 | ||
275 | struct timeval p_rlim_cpu; /* Remaining rlim cpu value.(PSL) */ | |
276 | int p_debugger; /* NU 1: can exec set-bit programs if suser */ | |
277 | boolean_t sigwait; /* indication to suspend (PL) */ | |
278 | void *sigwait_thread; /* 'thread' holding sigwait(PL) */ | |
279 | void *exit_thread; /* Which thread is exiting(PL) */ | |
280 | int p_vforkcnt; /* number of outstanding vforks(PL) */ | |
281 | void * p_vforkact; /* activation running this vfork proc)(static) */ | |
282 | int p_fpdrainwait; /* (PFDL) */ | |
283 | pid_t p_contproc; /* last PID to send us a SIGCONT (PL) */ | |
284 | ||
285 | /* Following fields are info from SIGCHLD (PL) */ | |
286 | pid_t si_pid; /* (PL) */ | |
287 | u_int si_status; /* (PL) */ | |
288 | u_int si_code; /* (PL) */ | |
289 | uid_t si_uid; /* (PL) */ | |
290 | ||
291 | void * vm_shm; /* (SYSV SHM Lock) for sysV shared memory */ | |
292 | ||
293 | #if CONFIG_DTRACE | |
294 | user_addr_t p_dtrace_argv; /* (write once, read only after that) */ | |
295 | user_addr_t p_dtrace_envp; /* (write once, read only after that) */ | |
296 | lck_mtx_t p_dtrace_sprlock; /* sun proc lock emulation */ | |
297 | int p_dtrace_probes; /* (PL) are there probes for this proc? */ | |
298 | u_int p_dtrace_count; /* (sprlock) number of DTrace tracepoints */ | |
6d2010ae | 299 | uint8_t p_dtrace_stop; /* indicates a DTrace-desired stop */ |
2d21ac55 A |
300 | struct dtrace_ptss_page* p_dtrace_ptss_pages; /* (sprlock) list of user ptss pages */ |
301 | struct dtrace_ptss_page_entry* p_dtrace_ptss_free_list; /* (atomic) list of individual ptss entries */ | |
302 | struct dtrace_helpers* p_dtrace_helpers; /* (dtrace_lock) DTrace per-proc private */ | |
303 | struct dof_ioctl_data* p_dtrace_lazy_dofs; /* (sprlock) unloaded dof_helper_t's */ | |
304 | #endif /* CONFIG_DTRACE */ | |
305 | ||
306 | /* XXXXXXXXXXXXX BCOPY'ed on fork XXXXXXXXXXXXXXXX */ | |
307 | /* The following fields are all copied upon creation in fork. */ | |
308 | #define p_startcopy p_argslen | |
91447636 | 309 | |
2d21ac55 A |
310 | u_int p_argslen; /* Length of process arguments. */ |
311 | int p_argc; /* saved argc for sysctl_procargs() */ | |
312 | user_addr_t user_stack; /* where user stack was allocated */ | |
91447636 | 313 | struct vnode *p_textvp; /* Vnode of executable. */ |
2d21ac55 | 314 | off_t p_textoff; /* offset in executable vnode */ |
91447636 | 315 | |
2d21ac55 A |
316 | sigset_t p_sigmask; /* DEPRECATED */ |
317 | sigset_t p_sigignore; /* Signals being ignored. (PL) */ | |
318 | sigset_t p_sigcatch; /* Signals being caught by user.(PL) */ | |
91447636 | 319 | |
2d21ac55 A |
320 | u_char p_priority; /* (NU) Process priority. */ |
321 | u_char p_resv0; /* (NU) User-priority based on p_cpu and p_nice. */ | |
322 | char p_nice; /* Process "nice" value.(PL) */ | |
323 | u_char p_resv1; /* (NU) User-priority based on p_cpu and p_nice. */ | |
91447636 | 324 | |
2d21ac55 A |
325 | #if CONFIG_MACF |
326 | int p_mac_enforce; /* MAC policy enforcement control */ | |
327 | #endif | |
91447636 | 328 | |
91447636 | 329 | char p_comm[MAXCOMLEN+1]; |
2d21ac55 | 330 | char p_name[(2*MAXCOMLEN)+1]; /* PL */ |
91447636 | 331 | |
2d21ac55 | 332 | struct pgrp *p_pgrp; /* Pointer to process group. (LL) */ |
6d2010ae | 333 | #if CONFIG_EMBEDDED |
2d21ac55 | 334 | int p_iopol_disk; /* disk I/O policy (PL) */ |
6d2010ae | 335 | #endif /* CONFIG_EMBEDDED */ |
2d21ac55 | 336 | uint32_t p_csflags; /* flags for codesign (PL) */ |
b0d623f7 A |
337 | uint32_t p_pcaction; /* action for process control on starvation */ |
338 | uint8_t p_uuid[16]; /* from LC_UUID load command */ | |
91447636 A |
339 | |
340 | /* End area that is copied on creation. */ | |
2d21ac55 | 341 | /* XXXXXXXXXXXXX End of BCOPY'ed on fork (AIOLOCK)XXXXXXXXXXXXXXXX */ |
b0d623f7 A |
342 | #define p_endcopy p_aio_total_count |
343 | int p_aio_total_count; /* all allocated AIO requests for this proc */ | |
344 | int p_aio_active_count; /* all unfinished AIO requests for this proc */ | |
345 | TAILQ_HEAD( , aio_workq_entry ) p_aio_activeq; /* active async IO requests */ | |
346 | TAILQ_HEAD( , aio_workq_entry ) p_aio_doneq; /* completed async IO requests */ | |
2d21ac55 A |
347 | |
348 | struct klist p_klist; /* knote list (PL ?)*/ | |
91447636 | 349 | |
2d21ac55 | 350 | struct rusage *p_ru; /* Exit information. (PL) */ |
6d2010ae | 351 | int p_sigwaitcnt; |
2d21ac55 A |
352 | thread_t p_signalholder; |
353 | thread_t p_transholder; | |
354 | ||
355 | /* DEPRECATE following field */ | |
356 | u_short p_acflag; /* Accounting flags. */ | |
357 | ||
358 | struct lctx *p_lctx; /* Pointer to login context. */ | |
359 | LIST_ENTRY(proc) p_lclist; /* List of processes in lctx. */ | |
360 | user_addr_t p_threadstart; /* pthread start fn */ | |
361 | user_addr_t p_wqthread; /* pthread workqueue fn */ | |
362 | int p_pthsize; /* pthread size */ | |
b0d623f7 | 363 | user_addr_t p_targconc; /* target concurrency ptr */ |
2d21ac55 A |
364 | void * p_wqptr; /* workq ptr */ |
365 | int p_wqsize; /* allocated size */ | |
b0d623f7 A |
366 | boolean_t p_wqiniting; /* semaphore to serialze wq_open */ |
367 | lck_spin_t p_wqlock; /* lock to protect work queue */ | |
2d21ac55 A |
368 | struct timeval p_start; /* starting time */ |
369 | void * p_rcall; | |
370 | int p_ractive; | |
593a1d5f | 371 | int p_idversion; /* version of process identity */ |
b0d623f7 | 372 | void * p_pthhash; /* pthread waitqueue hash */ |
2d21ac55 | 373 | #if DIAGNOSTIC |
91447636 A |
374 | unsigned int p_fdlock_pc[4]; |
375 | unsigned int p_fdunlock_pc[4]; | |
91447636 A |
376 | #if SIGNAL_DEBUG |
377 | unsigned int lockpc[8]; | |
378 | unsigned int unlockpc[8]; | |
379 | #endif /* SIGNAL_DEBUG */ | |
380 | #endif /* DIAGNOSTIC */ | |
b0d623f7 | 381 | uint64_t p_dispatchqueue_offset; |
91447636 A |
382 | }; |
383 | ||
2d21ac55 A |
384 | #define PGRPID_DEAD 0xdeaddead |
385 | ||
386 | /* p_listflag */ | |
387 | #define P_LIST_DRAIN 0x00000001 | |
388 | #define P_LIST_DRAINWAIT 0x00000002 | |
389 | #define P_LIST_DRAINED 0x00000004 | |
390 | #define P_LIST_DEAD 0x00000008 | |
391 | #define P_LIST_WAITING 0x00000010 | |
392 | #define P_LIST_EXITED 0x00000040 | |
393 | #define P_LIST_CHILDDRSTART 0x00000080 | |
394 | #define P_LIST_CHILDDRAINED 0x00000100 | |
395 | #define P_LIST_CHILDDRWAIT 0x00000200 | |
396 | #define P_LIST_CHILDLKWAIT 0x00000400 | |
397 | #define P_LIST_DEADPARENT 0x00000800 | |
398 | #define P_LIST_PARENTREFWAIT 0x00001000 | |
399 | #define P_LIST_INCREATE 0x00002000 | |
400 | /* 0x4000 & 0x8000 Not used */ | |
401 | #define P_LIST_INHASH 0x00010000 /* process is in hash */ | |
402 | #define P_LIST_INPGRP 0x00020000 /* process is in pgrp */ | |
403 | #define P_LIST_PGRPTRANS 0x00040000 /* pgrp is getting replaced */ | |
404 | #define P_LIST_PGRPTRWAIT 0x00080000 /* wait for pgrp replacement */ | |
b0d623f7 | 405 | #define P_LIST_EXITCOUNT 0x00100000 /* counted for process exit */ |
2d21ac55 | 406 | |
91447636 | 407 | |
b36670ce | 408 | /* local flags */ |
2d21ac55 A |
409 | #define P_LDELAYTERM 0x00000001 /* */ |
410 | #define P_LNOZOMB 0x00000002 /* */ | |
411 | #define P_LTERM 0x00000004 /* */ | |
412 | #define P_LEXIT 0x00000008 /* */ | |
413 | #define P_LPEXIT 0x00000010 | |
b0d623f7 | 414 | #define P_LTRANSCOMMIT 0x00000020 /* process is committed to trans */ |
2d21ac55 A |
415 | #define P_LINTRANSIT 0x00000040 /* process in exec or in creation */ |
416 | #define P_LTRANSWAIT 0x00000080 /* waiting for trans to complete */ | |
417 | #define P_LVFORK 0x00000100 /* */ | |
418 | #define P_LINVFORK 0x00000200 /* */ | |
419 | #define P_LTRACED 0x00000400 /* */ | |
420 | #define P_LSIGEXC 0x00000800 /* */ | |
421 | #define P_LNOATTACH 0x00001000 /* */ | |
422 | #define P_LPPWAIT 0x00002000 /* */ | |
423 | #define P_LKQWDRAIN 0x00004000 | |
424 | #define P_LKQWDRAINWAIT 0x00008000 | |
425 | #define P_LKQWDEAD 0x00010000 | |
426 | #define P_LLIMCHANGE 0x00020000 | |
427 | #define P_LLIMWAIT 0x00040000 | |
428 | #define P_LWAITED 0x00080000 | |
429 | #define P_LINSIGNAL 0x00100000 | |
6d2010ae | 430 | #define P_UNUSED 0x00200000 /* Unused */ |
2d21ac55 | 431 | #define P_LRAGE_VNODES 0x00400000 |
b0d623f7 | 432 | #define P_LREGISTER 0x00800000 /* thread start fns registered */ |
6d2010ae | 433 | #if CONFIG_EMBEDDED |
d1ecb069 | 434 | #define P_LBACKGROUND 0x01000000 |
6d2010ae A |
435 | #endif /* CONFIG_EMBEDDED */ |
436 | #define P_LVMRSRCOWNER 0x02000000 /* can handle the resource ownership of */ | |
b0d623f7 A |
437 | |
438 | /* Process control state for resource starvation */ | |
439 | #define P_PCTHROTTLE 1 | |
440 | #define P_PCSUSP 2 | |
441 | #define P_PCKILL 3 | |
442 | #define P_PCMAX 3 | |
443 | ||
444 | /* Process control action state on resrouce starvation */ | |
445 | #define PROC_ACTION_MASK 0xffff0000; | |
446 | #define PROC_CONTROL_STATE(p) (p->p_pcaction & P_PCMAX) | |
447 | #define PROC_ACTION_STATE(p) ((p->p_pcaction >> 16) & P_PCMAX) | |
448 | #define PROC_SETACTION_STATE(p) (p->p_pcaction = (PROC_CONTROL_STATE(p) | (PROC_CONTROL_STATE(p) << 16))) | |
449 | #define PROC_RESETACTION_STATE(p) (p->p_pcaction = PROC_CONTROL_STATE(p)) | |
b36670ce | 450 | |
6d2010ae | 451 | /* additional process flags */ |
b36670ce | 452 | #define P_LADVLOCK 0x01 |
91447636 | 453 | |
2d21ac55 A |
454 | /* defns for proc_iterate */ |
455 | #define PROC_ALLPROCLIST 1 /* walk the allproc list (procs not exited yet) */ | |
456 | #define PROC_ZOMBPROCLIST 2 /* walk the zombie list */ | |
457 | #define PROC_NOWAITTRANS 4 /* do not wait for transitions (checkdirs only) */ | |
458 | ||
459 | /* defns for pgrp_iterate */ | |
460 | #define PGRP_DROPREF 1 | |
461 | #define PGRP_BLOCKITERATE 2 | |
462 | ||
463 | /* return values of the proc iteration callback routine */ | |
464 | #define PROC_RETURNED 0 | |
465 | #define PROC_RETURNED_DONE 1 | |
466 | #define PROC_CLAIMED 2 | |
467 | #define PROC_CLAIMED_DONE 3 | |
468 | ||
b0d623f7 A |
469 | /* process creation arguments */ |
470 | #define PROC_CREATE_FORK 0 /* independent child (running) */ | |
471 | #define PROC_CREATE_SPAWN 1 /* independent child (suspended) */ | |
472 | #define PROC_CREATE_VFORK 2 /* child borrows context */ | |
473 | ||
2d21ac55 | 474 | |
91447636 A |
475 | /* LP64 version of extern_proc. all pointers |
476 | * grow when we're dealing with a 64-bit process. | |
477 | * WARNING - keep in sync with extern_proc | |
478 | * but use native alignment of 64-bit process. | |
479 | */ | |
480 | ||
481 | #ifdef KERNEL | |
482 | #include <sys/time.h> /* user_timeval, user_itimerval */ | |
483 | ||
b0d623f7 A |
484 | #pragma pack(4) |
485 | struct user32_extern_proc { | |
486 | union { | |
487 | struct { | |
488 | uint32_t __p_forw; /* Doubly-linked run/sleep queue. */ | |
489 | uint32_t __p_back; | |
490 | } p_st1; | |
491 | struct user32_timeval __p_starttime; /* process start time */ | |
492 | } p_un; | |
493 | uint32_t p_vmspace; /* Address space. */ | |
494 | uint32_t p_sigacts; /* Signal actions, state (PROC ONLY). */ | |
495 | int p_flag; /* P_* flags. */ | |
496 | char p_stat; /* S* process status. */ | |
497 | pid_t p_pid; /* Process identifier. */ | |
498 | pid_t p_oppid; /* Save parent pid during ptrace. XXX */ | |
499 | int p_dupfd; /* Sideways return value from fdopen. XXX */ | |
500 | /* Mach related */ | |
501 | uint32_t user_stack; /* where user stack was allocated */ | |
502 | uint32_t exit_thread; /* XXX Which thread is exiting? */ | |
503 | int p_debugger; /* allow to debug */ | |
504 | boolean_t sigwait; /* indication to suspend */ | |
505 | /* scheduling */ | |
506 | u_int p_estcpu; /* Time averaged value of p_cpticks. */ | |
507 | int p_cpticks; /* Ticks of cpu time. */ | |
508 | fixpt_t p_pctcpu; /* %cpu for this process during p_swtime */ | |
509 | uint32_t p_wchan; /* Sleep address. */ | |
510 | uint32_t p_wmesg; /* Reason for sleep. */ | |
511 | u_int p_swtime; /* Time swapped in or out. */ | |
512 | u_int p_slptime; /* Time since last blocked. */ | |
513 | struct user32_itimerval p_realtimer; /* Alarm timer. */ | |
514 | struct user32_timeval p_rtime; /* Real time. */ | |
515 | u_quad_t p_uticks; /* Statclock hits in user mode. */ | |
516 | u_quad_t p_sticks; /* Statclock hits in system mode. */ | |
517 | u_quad_t p_iticks; /* Statclock hits processing intr. */ | |
518 | int p_traceflag; /* Kernel trace points. */ | |
519 | uint32_t p_tracep; /* Trace to vnode. */ | |
520 | int p_siglist; /* DEPRECATED */ | |
521 | uint32_t p_textvp; /* Vnode of executable. */ | |
522 | int p_holdcnt; /* If non-zero, don't swap. */ | |
523 | sigset_t p_sigmask; /* DEPRECATED. */ | |
524 | sigset_t p_sigignore; /* Signals being ignored. */ | |
525 | sigset_t p_sigcatch; /* Signals being caught by user. */ | |
526 | u_char p_priority; /* Process priority. */ | |
527 | u_char p_usrpri; /* User-priority based on p_cpu and p_nice. */ | |
528 | char p_nice; /* Process "nice" value. */ | |
529 | char p_comm[MAXCOMLEN+1]; | |
530 | uint32_t p_pgrp; /* Pointer to process group. */ | |
531 | uint32_t p_addr; /* Kernel virtual addr of u-area (PROC ONLY). */ | |
532 | u_short p_xstat; /* Exit status for wait; also stop signal. */ | |
533 | u_short p_acflag; /* Accounting flags. */ | |
534 | uint32_t p_ru; /* Exit information. XXX */ | |
535 | }; | |
536 | #pragma pack() | |
537 | struct user64_extern_proc { | |
91447636 A |
538 | union { |
539 | struct { | |
540 | user_addr_t __p_forw; /* Doubly-linked run/sleep queue. */ | |
541 | user_addr_t __p_back; | |
542 | } p_st1; | |
b0d623f7 | 543 | struct user64_timeval __p_starttime; /* process start time */ |
91447636 A |
544 | } p_un; |
545 | user_addr_t p_vmspace; /* Address space. */ | |
546 | user_addr_t p_sigacts; /* Signal actions, state (PROC ONLY). */ | |
547 | int p_flag; /* P_* flags. */ | |
548 | char p_stat; /* S* process status. */ | |
549 | pid_t p_pid; /* Process identifier. */ | |
550 | pid_t p_oppid; /* Save parent pid during ptrace. XXX */ | |
551 | int p_dupfd; /* Sideways return value from fdopen. XXX */ | |
552 | /* Mach related */ | |
0c530ab8 | 553 | user_addr_t user_stack __attribute((aligned(8))); /* where user stack was allocated */ |
91447636 A |
554 | user_addr_t exit_thread; /* XXX Which thread is exiting? */ |
555 | int p_debugger; /* allow to debug */ | |
556 | boolean_t sigwait; /* indication to suspend */ | |
557 | /* scheduling */ | |
558 | u_int p_estcpu; /* Time averaged value of p_cpticks. */ | |
559 | int p_cpticks; /* Ticks of cpu time. */ | |
560 | fixpt_t p_pctcpu; /* %cpu for this process during p_swtime */ | |
0c530ab8 | 561 | user_addr_t p_wchan __attribute((aligned(8))); /* Sleep address. */ |
91447636 A |
562 | user_addr_t p_wmesg; /* Reason for sleep. */ |
563 | u_int p_swtime; /* Time swapped in or out. */ | |
564 | u_int p_slptime; /* Time since last blocked. */ | |
b0d623f7 A |
565 | struct user64_itimerval p_realtimer; /* Alarm timer. */ |
566 | struct user64_timeval p_rtime; /* Real time. */ | |
91447636 A |
567 | u_quad_t p_uticks; /* Statclock hits in user mode. */ |
568 | u_quad_t p_sticks; /* Statclock hits in system mode. */ | |
569 | u_quad_t p_iticks; /* Statclock hits processing intr. */ | |
570 | int p_traceflag; /* Kernel trace points. */ | |
0c530ab8 | 571 | user_addr_t p_tracep __attribute((aligned(8))); /* Trace to vnode. */ |
91447636 | 572 | int p_siglist; /* DEPRECATED */ |
0c530ab8 | 573 | user_addr_t p_textvp __attribute((aligned(8))); /* Vnode of executable. */ |
91447636 A |
574 | int p_holdcnt; /* If non-zero, don't swap. */ |
575 | sigset_t p_sigmask; /* DEPRECATED. */ | |
576 | sigset_t p_sigignore; /* Signals being ignored. */ | |
577 | sigset_t p_sigcatch; /* Signals being caught by user. */ | |
578 | u_char p_priority; /* Process priority. */ | |
579 | u_char p_usrpri; /* User-priority based on p_cpu and p_nice. */ | |
580 | char p_nice; /* Process "nice" value. */ | |
581 | char p_comm[MAXCOMLEN+1]; | |
0c530ab8 | 582 | user_addr_t p_pgrp __attribute((aligned(8))); /* Pointer to process group. */ |
91447636 A |
583 | user_addr_t p_addr; /* Kernel virtual addr of u-area (PROC ONLY). */ |
584 | u_short p_xstat; /* Exit status for wait; also stop signal. */ | |
585 | u_short p_acflag; /* Accounting flags. */ | |
0c530ab8 | 586 | user_addr_t p_ru __attribute((aligned(8))); /* Exit information. XXX */ |
91447636 | 587 | }; |
91447636 A |
588 | #endif /* KERNEL */ |
589 | ||
590 | /* | |
591 | * We use process IDs <= PID_MAX; PID_MAX + 1 must also fit in a pid_t, | |
592 | * as it is used to represent "no process group". | |
593 | */ | |
594 | extern int nprocs, maxproc; /* Current and max number of procs. */ | |
0c530ab8 | 595 | extern int maxprocperuid; /* Current number of procs per uid */ |
91447636 | 596 | __private_extern__ int hard_maxproc; /* hard limit */ |
b0d623f7 | 597 | extern unsigned int proc_shutdown_exitcount; |
91447636 | 598 | |
2d21ac55 A |
599 | #define PID_MAX 99999 |
600 | #define NO_PID 100000 | |
601 | extern lck_mtx_t * proc_list_mlock; | |
602 | extern lck_mtx_t * proc_klist_mlock; | |
603 | ||
b0d623f7 | 604 | #define BSD_SIMUL_EXECS 33 /* 32 , allow for rounding */ |
6d2010ae A |
605 | #define BSD_PAGEABLE_SIZE_PER_EXEC (NCARGS + PAGE_SIZE + PAGE_SIZE) /* page for apple vars, page for executable header */ |
606 | extern int execargs_cache_size; | |
607 | extern int execargs_free_count; | |
608 | extern vm_offset_t * execargs_cache; | |
b0d623f7 | 609 | |
2d21ac55 A |
610 | #define SESS_LEADER(p, sessp) ((sessp)->s_leader == (p)) |
611 | ||
612 | /* Lock and unlock a login context. */ | |
613 | #define LCTX_LOCK(lc) lck_mtx_lock(&(lc)->lc_mtx) | |
614 | #define LCTX_UNLOCK(lc) lck_mtx_unlock(&(lc)->lc_mtx) | |
615 | #define LCTX_LOCKED(lc) | |
616 | #define LCTX_LOCK_ASSERT(lc, type) | |
617 | #define ALLLCTX_LOCK lck_mtx_lock(&alllctx_lock) | |
618 | #define ALLLCTX_UNLOCK lck_mtx_unlock(&alllctx_lock) | |
619 | extern lck_mtx_t alllctx_lock; | |
620 | extern lck_grp_t * lctx_lck_grp; | |
621 | extern lck_grp_attr_t * lctx_lck_grp_attr; | |
622 | extern lck_attr_t * lctx_lck_attr; | |
91447636 A |
623 | |
624 | #define PIDHASH(pid) (&pidhashtbl[(pid) & pidhash]) | |
625 | extern LIST_HEAD(pidhashhead, proc) *pidhashtbl; | |
626 | extern u_long pidhash; | |
627 | ||
628 | #define PGRPHASH(pgid) (&pgrphashtbl[(pgid) & pgrphash]) | |
629 | extern LIST_HEAD(pgrphashhead, pgrp) *pgrphashtbl; | |
630 | extern u_long pgrphash; | |
2d21ac55 A |
631 | #define SESSHASH(sessid) (&sesshashtbl[(sessid) & sesshash]) |
632 | extern LIST_HEAD(sesshashhead, session) *sesshashtbl; | |
633 | extern u_long sesshash; | |
634 | ||
91447636 | 635 | extern lck_grp_t * proc_lck_grp; |
6d2010ae | 636 | #if CONFIG_FINE_LOCK_GROUPS |
b0d623f7 A |
637 | extern lck_grp_t * proc_mlock_grp; |
638 | extern lck_grp_t * proc_fdmlock_grp; | |
639 | extern lck_grp_t * proc_slock_grp; | |
6d2010ae | 640 | #endif |
91447636 A |
641 | extern lck_grp_attr_t * proc_lck_grp_attr; |
642 | extern lck_attr_t * proc_lck_attr; | |
643 | ||
644 | LIST_HEAD(proclist, proc); | |
645 | extern struct proclist allproc; /* List of all processes. */ | |
646 | extern struct proclist zombproc; /* List of zombie processes. */ | |
647 | extern struct proc *initproc; | |
2d21ac55 | 648 | extern void procinit(void) __attribute__((section("__TEXT, initcode"))); |
91447636 A |
649 | extern void proc_lock(struct proc *); |
650 | extern void proc_unlock(struct proc *); | |
2d21ac55 A |
651 | extern void proc_spinlock(struct proc *); |
652 | extern void proc_spinunlock(struct proc *); | |
653 | extern void proc_list_lock(void); | |
654 | extern void proc_list_unlock(void); | |
655 | extern void proc_klist_lock(void); | |
656 | extern void proc_klist_unlock(void); | |
91447636 | 657 | extern void proc_fdlock(struct proc *); |
2d21ac55 | 658 | extern void proc_fdlock_spin(struct proc *); |
91447636 | 659 | extern void proc_fdunlock(struct proc *); |
2d21ac55 A |
660 | extern void proc_fdlock_assert(proc_t p, int assertflags); |
661 | __private_extern__ int proc_core_name(const char *name, uid_t uid, pid_t pid, | |
662 | char *cr_name, size_t cr_name_len); | |
91447636 | 663 | extern int isinferior(struct proc *, struct proc *); |
91447636 | 664 | __private_extern__ struct proc *pzfind(pid_t); /* Find zombie by id. */ |
6d2010ae A |
665 | __private_extern__ struct proc *proc_find_zombref(pid_t); /* Find zombie by id. */ |
666 | __private_extern__ void proc_drop_zombref(struct proc * p); /* Find zombie by id. */ | |
667 | ||
2d21ac55 A |
668 | |
669 | extern struct lctx *lcfind(pid_t); /* Find a login context by id */ | |
670 | extern struct lctx *lccreate(void); /* Create a new login context */ | |
91447636 A |
671 | |
672 | extern int chgproccnt(uid_t uid, int diff); | |
2d21ac55 A |
673 | extern void enterlctx(struct proc *p, struct lctx *l, int create); |
674 | extern void pinsertchild(struct proc *parent, struct proc *child); | |
91447636 A |
675 | extern int enterpgrp(struct proc *p, pid_t pgid, int mksess); |
676 | extern void fixjobc(struct proc *p, struct pgrp *pgrp, int entering); | |
677 | extern int inferior(struct proc *p); | |
678 | extern int leavepgrp(struct proc *p); | |
2d21ac55 | 679 | extern void leavelctx(struct proc *p); |
91447636 A |
680 | extern void resetpriority(struct proc *); |
681 | extern void setrunnable(struct proc *); | |
682 | extern void setrunqueue(struct proc *); | |
683 | extern int sleep(void *chan, int pri); | |
684 | extern int tsleep0(void *chan, int pri, const char *wmesg, int timo, int (*continuation)(int)); | |
685 | extern int tsleep1(void *chan, int pri, const char *wmesg, u_int64_t abstime, int (*continuation)(int)); | |
686 | extern int msleep0(void *chan, lck_mtx_t *mtx, int pri, const char *wmesg, int timo, int (*continuation)(int)); | |
b0d623f7 | 687 | extern void vfork_return(struct proc *child, int32_t *retval, int rval); |
2d21ac55 | 688 | extern int exit1(struct proc *, int, int *); |
b0d623f7 | 689 | extern int fork1(proc_t, thread_t *, int); |
2d21ac55 A |
690 | extern void vfork_exit_internal(struct proc *p, int rv, int forced); |
691 | extern void proc_reparentlocked(struct proc *child, struct proc * newparent, int cansignal, int locked); | |
692 | extern int pgrp_iterate(struct pgrp * pgrp, int flags, int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg); | |
693 | extern int proc_iterate(int flags, int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg); | |
694 | extern int proc_rebootscan(int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg); | |
695 | extern int proc_childrenwalk(proc_t p, int (*callout)(proc_t , void *), void *arg); | |
696 | extern proc_t proc_findinternal(int pid, int funneled); | |
697 | extern void proc_refdrain(proc_t); | |
698 | extern void proc_childdrainlocked(proc_t); | |
699 | extern void proc_childdrainstart(proc_t); | |
700 | extern void proc_childdrainend(proc_t); | |
701 | extern void proc_checkdeadrefs(proc_t); | |
702 | struct proc *pfind_locked(pid_t); | |
703 | extern struct pgrp *pgfind(pid_t); | |
704 | extern void pg_rele(struct pgrp * pgrp); | |
705 | extern struct session * session_find_internal(pid_t sessid); | |
706 | extern struct pgrp * proc_pgrp(proc_t); | |
707 | extern struct pgrp * tty_pgrp(struct tty * tp); | |
708 | extern struct pgrp * pgfind_internal(pid_t); | |
709 | extern struct session * proc_session(proc_t); | |
710 | extern void pgrp_lock(struct pgrp * pgrp); | |
711 | extern void pgrp_unlock(struct pgrp * pgrp); | |
712 | extern void session_lock(struct session * sess); | |
713 | extern void session_unlock(struct session * sess); | |
714 | extern struct session * pgrp_session(struct pgrp * pgrp); | |
715 | extern void session_rele(struct session *sess); | |
716 | extern int isbackground(proc_t p, struct tty *tp); | |
717 | extern proc_t proc_parent(proc_t); | |
718 | extern proc_t proc_parentholdref(proc_t); | |
719 | extern int proc_parentdropref(proc_t, int); | |
720 | int itimerfix(struct timeval *tv); | |
721 | int itimerdecr(struct proc * p, struct itimerval *itp, int usec); | |
722 | void proc_signalstart(struct proc *, int locked); | |
723 | void proc_signalend(struct proc *, int locked); | |
b0d623f7 A |
724 | int proc_transstart(struct proc *, int locked); |
725 | void proc_transcommit(struct proc *, int locked); | |
2d21ac55 | 726 | void proc_transend(struct proc *, int locked); |
b0d623f7 | 727 | int proc_transwait(struct proc *, int locked); |
2d21ac55 | 728 | void proc_rele_locked(struct proc * p); |
6d2010ae | 729 | struct proc *proc_ref_locked(struct proc * p); |
2d21ac55 | 730 | void proc_knote(struct proc * p, long hint); |
b0d623f7 | 731 | void proc_knote_drain(struct proc *p); |
2d21ac55 A |
732 | void workqueue_init_lock(proc_t p); |
733 | void workqueue_destroy_lock(proc_t p); | |
b0d623f7 A |
734 | void proc_setregister(proc_t p); |
735 | void proc_resetregister(proc_t p); | |
736 | /* returns the first thread_t in the process, or NULL XXX for NFS, DO NOT USE */ | |
737 | thread_t proc_thread(proc_t); | |
738 | extern int proc_pendingsignals(proc_t, sigset_t); | |
739 | int proc_getpcontrol(int pid, int * pcontrolp); | |
740 | int proc_dopcontrol(proc_t p, void *unused_arg); | |
741 | int proc_resetpcontrol(int pid); | |
742 | #if PSYNCH | |
743 | void pth_proc_hashinit(proc_t); | |
744 | void pth_proc_hashdelete(proc_t); | |
745 | void pth_global_hashinit(void); | |
746 | extern thread_call_t psynch_thcall; | |
747 | void psynch_wq_cleanup(__unused void * param, __unused void * param1); | |
748 | extern lck_mtx_t * pthread_list_mlock; | |
749 | #endif /* PSYNCH */ | |
750 | struct uthread * current_uthread(void); | |
91447636 | 751 | #endif /* !_SYS_PROC_INTERNAL_H_ */ |