]> git.saurik.com Git - apple/xnu.git/blame - bsd/sys/proc_internal.h
xnu-1699.32.7.tar.gz
[apple/xnu.git] / bsd / sys / proc_internal.h
CommitLineData
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*/
101struct label;
102
103/*
104 * Added by SPARTA, Inc.
105 */
106/*
107 * Login context.
108 */
109struct 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 */
122struct 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 */
164struct 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
183struct 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 */
206struct 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)
485struct 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()
537struct 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 */
594extern int nprocs, maxproc; /* Current and max number of procs. */
0c530ab8 595extern int maxprocperuid; /* Current number of procs per uid */
91447636 596__private_extern__ int hard_maxproc; /* hard limit */
b0d623f7 597extern unsigned int proc_shutdown_exitcount;
91447636 598
2d21ac55
A
599#define PID_MAX 99999
600#define NO_PID 100000
601extern lck_mtx_t * proc_list_mlock;
602extern 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 */
606extern int execargs_cache_size;
607extern int execargs_free_count;
608extern 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)
619extern lck_mtx_t alllctx_lock;
620extern lck_grp_t * lctx_lck_grp;
621extern lck_grp_attr_t * lctx_lck_grp_attr;
622extern lck_attr_t * lctx_lck_attr;
91447636
A
623
624#define PIDHASH(pid) (&pidhashtbl[(pid) & pidhash])
625extern LIST_HEAD(pidhashhead, proc) *pidhashtbl;
626extern u_long pidhash;
627
628#define PGRPHASH(pgid) (&pgrphashtbl[(pgid) & pgrphash])
629extern LIST_HEAD(pgrphashhead, pgrp) *pgrphashtbl;
630extern u_long pgrphash;
2d21ac55
A
631#define SESSHASH(sessid) (&sesshashtbl[(sessid) & sesshash])
632extern LIST_HEAD(sesshashhead, session) *sesshashtbl;
633extern u_long sesshash;
634
91447636 635extern lck_grp_t * proc_lck_grp;
6d2010ae 636#if CONFIG_FINE_LOCK_GROUPS
b0d623f7
A
637extern lck_grp_t * proc_mlock_grp;
638extern lck_grp_t * proc_fdmlock_grp;
639extern lck_grp_t * proc_slock_grp;
6d2010ae 640#endif
91447636
A
641extern lck_grp_attr_t * proc_lck_grp_attr;
642extern lck_attr_t * proc_lck_attr;
643
644LIST_HEAD(proclist, proc);
645extern struct proclist allproc; /* List of all processes. */
646extern struct proclist zombproc; /* List of zombie processes. */
647extern struct proc *initproc;
2d21ac55 648extern void procinit(void) __attribute__((section("__TEXT, initcode")));
91447636
A
649extern void proc_lock(struct proc *);
650extern void proc_unlock(struct proc *);
2d21ac55
A
651extern void proc_spinlock(struct proc *);
652extern void proc_spinunlock(struct proc *);
653extern void proc_list_lock(void);
654extern void proc_list_unlock(void);
655extern void proc_klist_lock(void);
656extern void proc_klist_unlock(void);
91447636 657extern void proc_fdlock(struct proc *);
2d21ac55 658extern void proc_fdlock_spin(struct proc *);
91447636 659extern void proc_fdunlock(struct proc *);
2d21ac55
A
660extern 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 663extern 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
669extern struct lctx *lcfind(pid_t); /* Find a login context by id */
670extern struct lctx *lccreate(void); /* Create a new login context */
91447636
A
671
672extern int chgproccnt(uid_t uid, int diff);
2d21ac55
A
673extern void enterlctx(struct proc *p, struct lctx *l, int create);
674extern void pinsertchild(struct proc *parent, struct proc *child);
91447636
A
675extern int enterpgrp(struct proc *p, pid_t pgid, int mksess);
676extern void fixjobc(struct proc *p, struct pgrp *pgrp, int entering);
677extern int inferior(struct proc *p);
678extern int leavepgrp(struct proc *p);
2d21ac55 679extern void leavelctx(struct proc *p);
91447636
A
680extern void resetpriority(struct proc *);
681extern void setrunnable(struct proc *);
682extern void setrunqueue(struct proc *);
683extern int sleep(void *chan, int pri);
684extern int tsleep0(void *chan, int pri, const char *wmesg, int timo, int (*continuation)(int));
685extern int tsleep1(void *chan, int pri, const char *wmesg, u_int64_t abstime, int (*continuation)(int));
686extern int msleep0(void *chan, lck_mtx_t *mtx, int pri, const char *wmesg, int timo, int (*continuation)(int));
b0d623f7 687extern void vfork_return(struct proc *child, int32_t *retval, int rval);
2d21ac55 688extern int exit1(struct proc *, int, int *);
b0d623f7 689extern int fork1(proc_t, thread_t *, int);
2d21ac55
A
690extern void vfork_exit_internal(struct proc *p, int rv, int forced);
691extern void proc_reparentlocked(struct proc *child, struct proc * newparent, int cansignal, int locked);
692extern int pgrp_iterate(struct pgrp * pgrp, int flags, int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg);
693extern int proc_iterate(int flags, int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg);
694extern int proc_rebootscan(int (*callout)(proc_t , void *), void *arg, int (*filterfn)(proc_t , void *), void *filterarg);
695extern int proc_childrenwalk(proc_t p, int (*callout)(proc_t , void *), void *arg);
696extern proc_t proc_findinternal(int pid, int funneled);
697extern void proc_refdrain(proc_t);
698extern void proc_childdrainlocked(proc_t);
699extern void proc_childdrainstart(proc_t);
700extern void proc_childdrainend(proc_t);
701extern void proc_checkdeadrefs(proc_t);
702struct proc *pfind_locked(pid_t);
703extern struct pgrp *pgfind(pid_t);
704extern void pg_rele(struct pgrp * pgrp);
705extern struct session * session_find_internal(pid_t sessid);
706extern struct pgrp * proc_pgrp(proc_t);
707extern struct pgrp * tty_pgrp(struct tty * tp);
708extern struct pgrp * pgfind_internal(pid_t);
709extern struct session * proc_session(proc_t);
710extern void pgrp_lock(struct pgrp * pgrp);
711extern void pgrp_unlock(struct pgrp * pgrp);
712extern void session_lock(struct session * sess);
713extern void session_unlock(struct session * sess);
714extern struct session * pgrp_session(struct pgrp * pgrp);
715extern void session_rele(struct session *sess);
716extern int isbackground(proc_t p, struct tty *tp);
717extern proc_t proc_parent(proc_t);
718extern proc_t proc_parentholdref(proc_t);
719extern int proc_parentdropref(proc_t, int);
720int itimerfix(struct timeval *tv);
721int itimerdecr(struct proc * p, struct itimerval *itp, int usec);
722void proc_signalstart(struct proc *, int locked);
723void proc_signalend(struct proc *, int locked);
b0d623f7
A
724int proc_transstart(struct proc *, int locked);
725void proc_transcommit(struct proc *, int locked);
2d21ac55 726void proc_transend(struct proc *, int locked);
b0d623f7 727int proc_transwait(struct proc *, int locked);
2d21ac55 728void proc_rele_locked(struct proc * p);
6d2010ae 729struct proc *proc_ref_locked(struct proc * p);
2d21ac55 730void proc_knote(struct proc * p, long hint);
b0d623f7 731void proc_knote_drain(struct proc *p);
2d21ac55
A
732void workqueue_init_lock(proc_t p);
733void workqueue_destroy_lock(proc_t p);
b0d623f7
A
734void proc_setregister(proc_t p);
735void proc_resetregister(proc_t p);
736/* returns the first thread_t in the process, or NULL XXX for NFS, DO NOT USE */
737thread_t proc_thread(proc_t);
738extern int proc_pendingsignals(proc_t, sigset_t);
739int proc_getpcontrol(int pid, int * pcontrolp);
740int proc_dopcontrol(proc_t p, void *unused_arg);
741int proc_resetpcontrol(int pid);
742#if PSYNCH
743void pth_proc_hashinit(proc_t);
744void pth_proc_hashdelete(proc_t);
745void pth_global_hashinit(void);
746extern thread_call_t psynch_thcall;
747void psynch_wq_cleanup(__unused void * param, __unused void * param1);
748extern lck_mtx_t * pthread_list_mlock;
749#endif /* PSYNCH */
750struct uthread * current_uthread(void);
91447636 751#endif /* !_SYS_PROC_INTERNAL_H_ */