proc.h revision 2712:f74a135872bc
1/*
2 * CDDL HEADER START
3 *
4 * The contents of this file are subject to the terms of the
5 * Common Development and Distribution License (the "License").
6 * You may not use this file except in compliance with the License.
7 *
8 * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
9 * or http://www.opensolaris.org/os/licensing.
10 * See the License for the specific language governing permissions
11 * and limitations under the License.
12 *
13 * When distributing Covered Code, include this CDDL HEADER in each
14 * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
15 * If applicable, add the following below this CDDL HEADER, with the
16 * fields enclosed by brackets "[]" replaced with your own identifying
17 * information: Portions Copyright [yyyy] [name of copyright owner]
18 *
19 * CDDL HEADER END
20 */
21
22/*
23 * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
24 * Use is subject to license terms.
25 */
26
27/*	Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T	*/
28/*	  All Rights Reserved  	*/
29
30
31#ifndef _SYS_PROC_H
32#define	_SYS_PROC_H
33
34#pragma ident	"%Z%%M%	%I%	%E% SMI"
35
36#include <sys/time.h>
37
38#include <sys/thread.h>
39#include <sys/cred.h>
40#include <sys/user.h>
41#include <sys/watchpoint.h>
42#include <sys/timer.h>
43#if defined(__x86)
44#include <sys/tss.h>
45#include <sys/segments.h>
46#endif
47#include <sys/utrap.h>
48#include <sys/model.h>
49#include <sys/refstr.h>
50#include <sys/avl.h>
51#include <sys/rctl.h>
52#include <sys/list.h>
53#include <sys/avl.h>
54#include <sys/door_impl.h>
55
56#ifdef	__cplusplus
57extern "C" {
58#endif
59
60/*
61 * Profile arguments.
62 */
63struct prof {
64	void		*pr_base;	/* buffer base */
65	uintptr_t	pr_off;		/* pc offset */
66	size_t		pr_size;	/* buffer size */
67	uint32_t	pr_scale;	/* pc scaling */
68	long		pr_samples;	/* sample count */
69};
70
71/* hash function for the lwpid hash table, p->p_tidhash[] */
72#define	TIDHASH(p, tid)	((tid) & ((p)->p_tidhash_sz - 1))
73
74/*
75 * An lwp directory entry.
76 * If le_thread != NULL, this is an active lwp.
77 * If le_thread == NULL, this is an unreaped zombie lwp.
78 */
79typedef struct lwpent {
80	kthread_t	*le_thread;	/* the active lwp, NULL if zombie */
81	id_t		le_lwpid;	/* its lwpid (t->t_tid) */
82	uint16_t	le_waiters;	/* total number of lwp_wait()ers */
83	uint16_t	le_dwaiters;	/* number that are daemons */
84	clock_t		le_start;	/* start time of this lwp */
85	struct vnode	*le_trace;	/* pointer to /proc lwp vnode */
86} lwpent_t;
87
88typedef struct pctxop {
89	void	(*save_op)(void *);	/* function to invoke to save ctx */
90	void	(*restore_op)(void *);	/* function to invoke to restore ctx */
91	void	(*fork_op)(void *, void *); /* invoke to fork context */
92	void	(*exit_op)(void *);	/* invoked during process exit */
93	void	(*free_op)(void *, int); /* function which frees the context */
94	void	*arg;			/* argument to above functions */
95	struct pctxop *next;		/* next pcontext ops */
96} pctxop_t;
97
98/*
99 * Elements of the lwp directory, p->p_lwpdir[].
100 *
101 * We allocate lwp directory entries separately from lwp directory
102 * elements because the lwp directory must be allocated as an array.
103 * The number of lwps can grow quite large and we want to keep the
104 * size of the kmem_alloc()d directory as small as possible.
105 *
106 * If ld_entry == NULL, the entry is free and is on the free list,
107 * p->p_lwpfree, linked through ld_next.  If ld_entry != NULL, the
108 * entry is used and ld_next is the thread-id hash link pointer.
109 */
110typedef struct lwpdir {
111	struct lwpdir	*ld_next;	/* hash chain or free list */
112	struct lwpent	*ld_entry;	/* lwp directory entry */
113} lwpdir_t;
114
115struct pool;
116struct task;
117struct zone;
118struct brand;
119struct corectl_path;
120struct corectl_content;
121
122/*
123 * One structure allocated per active process.  It contains all
124 * data needed about the process while the process may be swapped
125 * out.  Other per-process data (user.h) is also inside the proc structure.
126 * Lightweight-process data (lwp.h) and the kernel stack may be swapped out.
127 */
128typedef struct	proc {
129	/*
130	 * Fields requiring no explicit locking
131	 */
132	struct	vnode *p_exec;		/* pointer to a.out vnode */
133	struct	as *p_as;		/* process address space pointer */
134	struct	plock *p_lockp;		/* ptr to proc struct's mutex lock */
135	kmutex_t p_crlock;		/* lock for p_cred */
136	struct	cred	*p_cred;	/* process credentials */
137	/*
138	 * Fields protected by pidlock
139	 */
140	int	p_swapcnt;		/* number of swapped out lwps */
141	char	p_stat;			/* status of process */
142	char	p_wcode;		/* current wait code */
143	ushort_t p_pidflag;		/* flags protected only by pidlock */
144	int 	p_wdata;		/* current wait return value */
145	pid_t	p_ppid;			/* process id of parent */
146	struct	proc	*p_link;	/* forward link */
147	struct	proc	*p_parent;	/* ptr to parent process */
148	struct	proc	*p_child;	/* ptr to first child process */
149	struct	proc	*p_sibling;	/* ptr to next sibling proc on chain */
150	struct	proc	*p_psibling;	/* ptr to prev sibling proc on chain */
151	struct	proc	*p_sibling_ns;	/* prt to siblings with new state */
152	struct	proc	*p_child_ns;	/* prt to children with new state */
153	struct	proc 	*p_next;	/* active chain link next */
154	struct	proc 	*p_prev;	/* active chain link prev */
155	struct	proc 	*p_nextofkin;	/* gets accounting info at exit */
156	struct	proc 	*p_orphan;
157	struct	proc 	*p_nextorph;
158	struct	proc	*p_pglink;	/* process group hash chain link next */
159	struct	proc	*p_ppglink;	/* process group hash chain link prev */
160	struct	sess	*p_sessp;	/* session information */
161	struct	pid 	*p_pidp;	/* process ID info */
162	struct	pid 	*p_pgidp;	/* process group ID info */
163	/*
164	 * Fields protected by p_lock
165	 */
166	kcondvar_t p_cv;		/* proc struct's condition variable */
167	kcondvar_t p_flag_cv;
168	kcondvar_t p_lwpexit;		/* waiting for some lwp to exit */
169	kcondvar_t p_holdlwps;		/* process is waiting for its lwps */
170					/* to to be held.  */
171	uint_t	p_proc_flag;		/* /proc-related flags */
172	uint_t	p_flag;			/* protected while set. */
173					/* flags defined below */
174	clock_t	p_utime;		/* user time, this process */
175	clock_t	p_stime;		/* system time, this process */
176	clock_t	p_cutime;		/* sum of children's user time */
177	clock_t	p_cstime;		/* sum of children's system time */
178	avl_tree_t *p_segacct;		/* System V shared segment list */
179	avl_tree_t *p_semacct;		/* System V semaphore undo list */
180	caddr_t	p_bssbase;		/* base addr of last bss below heap */
181	caddr_t	p_brkbase;		/* base addr of heap */
182	size_t	p_brksize;		/* heap size in bytes */
183	uint_t	p_brkpageszc;		/* preferred heap max page size code */
184	/*
185	 * Per process signal stuff.
186	 */
187	k_sigset_t p_sig;		/* signals pending to this process */
188	k_sigset_t p_extsig;		/* signals sent from another contract */
189	k_sigset_t p_ignore;		/* ignore when generated */
190	k_sigset_t p_siginfo;		/* gets signal info with signal */
191	struct sigqueue *p_sigqueue;	/* queued siginfo structures */
192	struct sigqhdr *p_sigqhdr;	/* hdr to sigqueue structure pool */
193	struct sigqhdr *p_signhdr;	/* hdr to signotify structure pool */
194	uchar_t	p_stopsig;		/* jobcontrol stop signal */
195
196	/*
197	 * Special per-process flag when set will fix misaligned memory
198	 * references.
199	 */
200	char    p_fixalignment;
201
202	/*
203	 * Per process lwp and kernel thread stuff
204	 */
205	id_t	p_lwpid;		/* most recently allocated lwpid */
206	int 	p_lwpcnt;		/* number of lwps in this process */
207	int	p_lwprcnt;		/* number of not stopped lwps */
208	int	p_lwpdaemon;		/* number of TP_DAEMON lwps */
209	int	p_lwpwait;		/* number of lwps in lwp_wait() */
210	int	p_lwpdwait;		/* number of daemons in lwp_wait() */
211	int	p_zombcnt;		/* number of zombie lwps */
212	kthread_t *p_tlist;		/* circular list of threads */
213	lwpdir_t *p_lwpdir;		/* thread (lwp) directory */
214	lwpdir_t *p_lwpfree;		/* p_lwpdir free list */
215	lwpdir_t **p_tidhash;		/* tid (lwpid) lookup hash table */
216	uint_t	p_lwpdir_sz;		/* number of p_lwpdir[] entries */
217	uint_t	p_tidhash_sz;		/* number of p_tidhash[] entries */
218	uint64_t p_lgrpset;		/* unprotected hint of set of lgrps */
219					/* on which process has threads */
220	uintptr_t p_lgrpres1;		/* reserved for lgrp migration */
221	uintptr_t p_lgrpres2;		/* reserved for lgrp migration */
222	/*
223	 * /proc (process filesystem) debugger interface stuff.
224	 */
225	k_sigset_t p_sigmask;		/* mask of traced signals (/proc) */
226	k_fltset_t p_fltmask;		/* mask of traced faults (/proc) */
227	struct vnode *p_trace;		/* pointer to primary /proc vnode */
228	struct vnode *p_plist;		/* list of /proc vnodes for process */
229	kthread_t *p_agenttp;		/* thread ptr for /proc agent lwp */
230	avl_tree_t p_warea;		/* list of watched areas */
231	avl_tree_t p_wpage;		/* remembered watched pages (vfork) */
232	watched_page_t *p_wprot;	/* pages that need to have prot set */
233	int	p_mapcnt;		/* number of active pr_mappage()s */
234	kmutex_t p_maplock;		/* lock for pr_mappage() */
235	struct	proc  *p_rlink;		/* linked list for server */
236	kcondvar_t p_srwchan_cv;
237	size_t	p_stksize;		/* process stack size in bytes */
238	uint_t	p_stkpageszc;		/* preferred stack max page size code */
239
240	/*
241	 * Microstate accounting, resource usage, and real-time profiling
242	 */
243	hrtime_t p_mstart;		/* hi-res process start time */
244	hrtime_t p_mterm;		/* hi-res process termination time */
245	hrtime_t p_mlreal;		/* elapsed time sum over defunct lwps */
246	hrtime_t p_acct[NMSTATES];	/* microstate sum over defunct lwps */
247	hrtime_t p_cacct[NMSTATES];	/* microstate sum over child procs */
248	struct lrusage p_ru;		/* lrusage sum over defunct lwps */
249	struct lrusage p_cru;		/* lrusage sum over child procs */
250	struct itimerval p_rprof_timer; /* ITIMER_REALPROF interval timer */
251	uintptr_t p_rprof_cyclic;	/* ITIMER_REALPROF cyclic */
252	uint_t	p_defunct;		/* number of defunct lwps */
253	/*
254	 * profiling. A lock is used in the event of multiple lwp's
255	 * using the same profiling base/size.
256	 */
257	kmutex_t p_pflock;		/* protects user profile arguments */
258	struct prof p_prof;		/* profile arguments */
259
260	/*
261	 * The user structure
262	 */
263	struct user p_user;		/* (see sys/user.h) */
264
265	/*
266	 * Doors.
267	 */
268	door_pool_t		p_server_threads; /* common thread pool */
269	struct door_node	*p_door_list;	/* active doors */
270	struct door_node	*p_unref_list;
271	kcondvar_t		p_unref_cv;
272	char			p_unref_thread;	/* unref thread created */
273
274	/*
275	 * Kernel probes
276	 */
277	uchar_t			p_tnf_flags;
278
279	/*
280	 * C2 Security  (C2_AUDIT)
281	 */
282	struct p_audit_data	*p_audit_data; /* per process audit structure */
283
284	pctxop_t	*p_pctx;
285
286#if defined(__x86)
287	/*
288	 * LDT support.
289	 */
290	kmutex_t	p_ldtlock;	/* protects the following fields */
291	user_desc_t	*p_ldt;		/* Pointer to private LDT */
292	system_desc_t	p_ldt_desc;	/* segment descriptor for private LDT */
293	ushort_t	p_ldtlimit;	/* highest selector used */
294#endif
295	size_t p_swrss;			/* resident set size before last swap */
296	struct aio	*p_aio;		/* pointer to async I/O struct */
297	struct itimer	**p_itimer;	/* interval timers */
298	timeout_id_t	p_alarmid;	/* alarm's timeout id */
299	caddr_t		p_usrstack;	/* top of the process stack */
300	uint_t		p_stkprot;	/* stack memory protection */
301	uint_t		p_datprot;	/* data memory protection */
302	model_t		p_model;	/* data model determined at exec time */
303	struct lwpchan_data *p_lcp;	/* lwpchan cache */
304	kmutex_t	p_lcp_lock;	/* protects assignments to p_lcp */
305	utrap_handler_t	*p_utraps;	/* pointer to user trap handlers */
306	struct corectl_path	*p_corefile;	/* pattern for core file */
307	struct task	*p_task;	/* our containing task */
308	struct proc	*p_taskprev;	/* ptr to previous process in task */
309	struct proc	*p_tasknext;	/* ptr to next process in task */
310	kmutex_t	p_sc_lock;	/* protects p_pagep */
311	struct sc_page_ctl *p_pagep;	/* list of process's shared pages */
312	struct rctl_set	*p_rctls;	/* resource controls for this process */
313	rlim64_t	p_stk_ctl;	/* currently enforced stack size */
314	rlim64_t	p_fsz_ctl;	/* currently enforced file size */
315	rlim64_t	p_vmem_ctl;	/* currently enforced addr-space size */
316	rlim64_t	p_fno_ctl;	/* currently enforced file-desc limit */
317	pid_t		p_ancpid;	/* ancestor pid, used by exacct */
318	struct itimerval p_realitimer;	/* real interval timer */
319	timeout_id_t	p_itimerid;	/* real interval timer's timeout id */
320	struct corectl_content *p_content;	/* content of core file */
321
322	avl_tree_t	p_ct_held;	/* held contracts */
323	struct ct_equeue **p_ct_equeue;	/* process-type event queues */
324
325	struct cont_process *p_ct_process; /* process contract */
326	list_node_t	p_ct_member;	/* process contract membership */
327	sigqueue_t	*p_killsqp;	/* sigqueue pointer for SIGKILL */
328
329	int		p_dtrace_probes; /* are there probes for this proc? */
330	uint64_t	p_dtrace_count;	/* number of DTrace tracepoints */
331					/* (protected by P_PR_LOCK) */
332	void		*p_dtrace_helpers; /* DTrace helpers, if any */
333	struct pool	*p_pool;	/* pointer to containing pool */
334	kcondvar_t	p_poolcv;	/* synchronization with pools */
335	uint_t		p_poolcnt;	/* # threads inside pool barrier */
336	uint_t		p_poolflag;	/* pool-related flags (see below) */
337	uintptr_t	p_portcnt;	/* event ports counter */
338	struct zone	*p_zone;	/* zone in which process lives */
339	struct vnode	*p_execdir;	/* directory that p_exec came from */
340	struct brand	*p_brand;	/* process's brand  */
341	void		*p_brand_data;	/* per-process brand state */
342
343	/* additional lock to protect p_sessp (but not its contents) */
344	kmutex_t p_splock;
345} proc_t;
346
347#define	PROC_T				/* headers relying on proc_t are OK */
348
349#ifdef _KERNEL
350
351/* active process chain */
352
353extern proc_t *practive;
354
355/* Well known processes */
356
357extern proc_t *proc_sched;		/* memory scheduler */
358extern proc_t *proc_init;		/* init */
359extern proc_t *proc_pageout;		/* pageout daemon */
360extern proc_t *proc_fsflush;		/* filesystem sync-er */
361
362#endif /* _KERNEL */
363
364/*
365 * Stuff to keep track of the number of processes each uid has.
366 * It is tracked on a per-zone basis; that is, if users in different
367 * zones have the same uid, they are tracked separately.
368 *
369 * A structure is allocated when a new <uid,zoneid> pair shows up
370 * There is a hash to find each structure.
371 */
372struct	upcount	{
373	struct	upcount	*up_next;
374	uid_t		up_uid;
375	zoneid_t	up_zoneid;
376	uint_t		up_count;
377};
378
379/* process ID info */
380
381struct pid {
382	unsigned int pid_prinactive :1;
383	unsigned int pid_pgorphaned :1;
384	unsigned int pid_padding :6;	/* used to be pid_ref, now an int */
385	unsigned int pid_prslot :24;
386	pid_t pid_id;
387	struct proc *pid_pglink;
388	struct proc *pid_pgtail;
389	struct pid *pid_link;
390	uint_t pid_ref;
391};
392
393#define	p_pgrp p_pgidp->pid_id
394#define	p_pid  p_pidp->pid_id
395#define	p_slot p_pidp->pid_prslot
396#define	p_detached p_pgidp->pid_pgorphaned
397
398#define	PID_HOLD(pidp)	ASSERT(MUTEX_HELD(&pidlock)); \
399			++(pidp)->pid_ref;
400#define	PID_RELE(pidp)	ASSERT(MUTEX_HELD(&pidlock)); \
401			(pidp)->pid_ref > 1 ? \
402				--(pidp)->pid_ref : pid_rele(pidp);
403
404/*
405 * Structure containing persistent process lock.  The structure and
406 * macro allow "mutex_enter(&p->p_lock)" to continue working.
407 */
408struct plock {
409	kmutex_t pl_lock;
410};
411#define	p_lock	p_lockp->pl_lock
412
413#ifdef _KERNEL
414extern proc_t p0;		/* process 0 */
415extern struct plock p0lock;	/* p0's plock */
416extern struct pid pid0;		/* p0's pid */
417
418/* pid_allocate() flags */
419#define	PID_ALLOC_PROC	0x0001	/* assign a /proc slot as well */
420
421#endif /* _KERNEL */
422
423/* stat codes */
424
425#define	SSLEEP	1		/* awaiting an event */
426#define	SRUN	2		/* running */
427#define	SZOMB	3		/* process terminated but not waited for */
428#define	SSTOP	4		/* process stopped by debugger */
429#define	SIDL	5		/* intermediate state in process creation */
430#define	SONPROC	6		/* process is being run on a processor */
431
432/* p_pidflag codes */
433#define	CLDPEND	0x0001		/* have yet to post a SIGCLD to the parent */
434#define	CLDCONT	0x0002		/* child has notified parent of CLD_CONTINUED */
435
436/* p_proc_flag codes -- these flags are mostly private to /proc */
437#define	P_PR_TRACE	0x0001	/* signal, fault or syscall tracing via /proc */
438#define	P_PR_PTRACE	0x0002	/* ptrace() compatibility mode */
439#define	P_PR_FORK	0x0004	/* child inherits tracing flags */
440#define	P_PR_LOCK	0x0008	/* process locked by /proc */
441#define	P_PR_ASYNC	0x0010	/* asynchronous stopping via /proc */
442#define	P_PR_EXEC	0x0020	/* process is in exec() */
443#define	P_PR_BPTADJ	0x0040	/* adjust pc on breakpoint trap */
444#define	P_PR_RUNLCL	0x0080	/* set process running on last /proc close */
445#define	P_PR_KILLCL	0x0100	/* kill process on last /proc close */
446
447/*
448 * p_flag codes
449 *
450 * note that two of these flags, SMSACCT and SSYS, are exported to /proc's
451 * psinfo_t.p_flag field.  Historically, all were, but since they are
452 * implementation dependant, we only export the ones people have come to
453 * rely upon.  Hence, the bit positions of SSYS and SMSACCT should not be
454 * altered.
455 */
456#define	SSYS	   0x00000001	/* system (resident) process */
457#define	SEXITING   0x00000002	/* process is exiting */
458#define	SITBUSY	   0x00000004	/* setitimer(ITIMER_REAL) in progress */
459#define	SFORKING   0x00000008	/* tells called functions that we're forking */
460#define	SWATCHOK   0x00000010	/* proc in acceptable state for watchpoints */
461#define	SKILLED    0x00000100	/* SIGKILL has been posted to the process */
462#define	SSCONT	   0x00000200	/* SIGCONT has been posted to the process */
463#define	SZONETOP   0x00000400	/* process has no valid PPID in its zone */
464#define	SEXTKILLED 0x00000800	/* SKILLED is from another contract */
465#define	SUGID	   0x00002000	/* process was result of set[ug]id exec */
466#define	SEXECED	   0x00004000	/* this process has execed */
467#define	SJCTL	   0x00010000	/* SIGCLD sent when children stop/continue */
468#define	SNOWAIT    0x00020000	/* children never become zombies */
469#define	SVFORK	   0x00040000	/* child of vfork that has not yet exec'd */
470#define	SVFWAIT	   0x00080000	/* parent of vfork waiting for child to exec */
471#define	SEXITLWPS  0x00100000	/* have lwps exit within the process */
472#define	SHOLDFORK  0x00200000	/* hold lwps where they're cloneable */
473#define	SHOLDFORK1 0x00800000	/* hold lwps in place (not cloning) */
474#define	SCOREDUMP  0x01000000	/* process is dumping core */
475#define	SMSACCT    0x02000000	/* process is keeping micro-state accounting */
476#define	SLWPWRAP   0x04000000	/* process has wrapped its lwp ids */
477#define	SAUTOLPG   0x08000000	/* kernel controls page sizes */
478#define	SNOCD	   0x10000000	/* new creds from VSxID, do not coredump */
479#define	SHOLDWATCH 0x20000000	/* hold lwps for watchpoint operation */
480#define	SMSFORK	   0x40000000	/* child inherits micro-state accounting */
481#define	SDOCORE	   0x80000000	/* process will attempt to dump core */
482
483/*
484 * p_poolflag codes
485 *
486 * These flags are used to synchronize with the pool subsystem to allow
487 * re-binding of processes to new pools.
488 */
489#define	PBWAIT		0x0001	/* process should wait outside fork/exec/exit */
490#define	PEXITED		0x0002	/* process exited and about to become zombie */
491
492/* Macro to convert proc pointer to a user block pointer */
493#define	PTOU(p)		(&(p)->p_user)
494
495#define	tracing(p, sig)	(sigismember(&(p)->p_sigmask, sig))
496
497/* Macro to reduce unnecessary calls to issig() */
498
499#define	ISSIG(t, why)	ISSIG_FAST(t, ttolwp(t), ttoproc(t), why)
500
501/*
502 * Fast version of ISSIG.
503 *	1. uses register pointers to lwp and proc instead of reloading them.
504 *	2. uses bit-wise OR of tests, since the usual case is that none of them
505 *	   are true, this saves orcc's and branches.
506 *	3. load the signal flags instead of using sigisempty() macro which does
507 *	   a branch to convert to boolean.
508 */
509#define	ISSIG_FAST(t, lwp, p, why)		\
510	(ISSIG_PENDING(t, lwp, p) && issig(why))
511
512#define	ISSIG_PENDING(t, lwp, p)		\
513	((lwp)->lwp_cursig |			\
514	    sigcheck((p), (t)) |		\
515	    (p)->p_stopsig |			\
516	    (t)->t_dtrace_stop |		\
517	    (t)->t_dtrace_sig |			\
518	    ((t)->t_proc_flag & (TP_PRSTOP|TP_HOLDLWP|TP_CHKPT|TP_PAUSE)) | \
519	    ((p)->p_flag & (SEXITLWPS|SKILLED|SHOLDFORK1|SHOLDWATCH)))
520
521#define	ISSTOP(sig)	 (u.u_signal[sig-1] == SIG_DFL && \
522				sigismember(&stopdefault, sig))
523
524#define	ISHOLD(p)	((p)->p_flag & SHOLDFORK)
525
526#define	MUSTRETURN(p, t)	(ISHOLD(p) | (t)->t_activefd.a_stale)
527
528/*
529 * Determine if there are any watchpoints active in the process.
530 */
531#define	pr_watch_active(p)	(avl_numnodes(&(p)->p_warea) != 0)
532
533/* Reasons for calling issig() */
534
535#define	FORREAL		0	/* Usual side-effects */
536#define	JUSTLOOKING	1	/* Don't stop the process */
537
538/* 'what' values for stop(PR_SUSPENDED, what) */
539#define	SUSPEND_NORMAL	0
540#define	SUSPEND_PAUSE	1
541
542/* pseudo-flag to lwp_create() */
543#define	NOCLASS	(-1)
544
545/* LWP stats updated via lwp_stats_update() */
546typedef enum {
547	LWP_STAT_INBLK,
548	LWP_STAT_OUBLK,
549	LWP_STAT_MSGRCV,
550	LWP_STAT_MSGSND
551} lwp_stat_id_t;
552
553#ifdef _KERNEL
554
555/* user profiling functions */
556
557extern void profil_tick(uintptr_t);
558
559/* process management functions */
560
561extern int newproc(void (*)(), caddr_t, id_t, int, struct contract **);
562extern void vfwait(pid_t);
563extern void proc_detach(proc_t *);
564extern void freeproc(proc_t *);
565extern void setrun(kthread_t *);
566extern void setrun_locked(kthread_t *);
567extern void exit(int, int);
568extern int proc_exit(int, int);
569extern void proc_is_exiting(proc_t *);
570extern void relvm(void);
571extern void add_ns(proc_t *, proc_t *);
572extern void delete_ns(proc_t *, proc_t *);
573extern void upcount_inc(uid_t, zoneid_t);
574extern void upcount_dec(uid_t, zoneid_t);
575extern int upcount_get(uid_t, zoneid_t);
576#if defined(__x86)
577extern void ldt_dup(proc_t *, proc_t *);
578extern selector_t setup_thrptr(proc_t *, uintptr_t);
579extern void deferred_singlestep_trap(caddr_t);
580#endif
581
582extern void sigcld(proc_t *, sigqueue_t *);
583extern void sigcld_delete(k_siginfo_t *);
584extern void sigcld_repost(void);
585extern int fsig(k_sigset_t *, kthread_t *);
586extern void psig(void);
587extern void stop(int, int);
588extern int stop_on_fault(uint_t, k_siginfo_t *);
589extern int issig(int);
590extern int jobstopped(proc_t *);
591extern void psignal(proc_t *, int);
592extern void tsignal(kthread_t *, int);
593extern void sigtoproc(proc_t *, kthread_t *, int);
594extern void trapsig(k_siginfo_t *, int);
595extern int eat_signal(kthread_t *, int);
596extern int signal_is_blocked(kthread_t *, int);
597extern int sigcheck(proc_t *, kthread_t *);
598extern void sigdefault(proc_t *);
599
600extern void pid_setmin(void);
601extern pid_t pid_allocate(proc_t *, int);
602extern struct pid *pid_find(pid_t);
603extern int pid_rele(struct pid *);
604extern void pid_exit(proc_t *);
605extern void proc_entry_free(struct pid *);
606extern proc_t *prfind(pid_t);
607extern proc_t *prfind_zone(pid_t, zoneid_t);
608extern proc_t *pgfind(pid_t);
609extern proc_t *pgfind_zone(pid_t, zoneid_t);
610extern proc_t *sprlock(pid_t);
611extern proc_t *sprlock_zone(pid_t, zoneid_t);
612extern void sprlock_proc(proc_t *);
613extern void sprunlock(proc_t *);
614extern void pid_init(void);
615extern proc_t *pid_entry(int);
616extern int pid_slot(proc_t *);
617extern void signal(pid_t, int);
618extern void prsignal(struct pid *, int);
619extern int uread(proc_t *, void *, size_t, uintptr_t);
620extern int uwrite(proc_t *, void *, size_t, uintptr_t);
621
622extern void pgsignal(struct pid *, int);
623extern void pgjoin(proc_t *, struct pid *);
624extern void pgcreate(proc_t *);
625extern void pgexit(proc_t *);
626extern void pgdetach(proc_t *);
627extern int pgmembers(pid_t);
628
629extern	void	init_mstate(kthread_t *, int);
630extern	int	new_mstate(kthread_t *, int);
631extern	void	restore_mstate(kthread_t *);
632extern	void	term_mstate(kthread_t *);
633extern	void	estimate_msacct(kthread_t *, hrtime_t);
634extern	void	disable_msacct(proc_t *);
635extern	hrtime_t mstate_aggr_state(proc_t *, int);
636extern	void	syscall_mstate(int, int);
637
638extern	uint_t	cpu_update_pct(kthread_t *, hrtime_t);
639
640extern void	set_proc_pre_sys(proc_t *p);
641extern void	set_proc_post_sys(proc_t *p);
642extern void	set_proc_sys(proc_t *p);
643extern void	set_proc_ast(proc_t *p);
644extern void	set_all_proc_sys(void);
645
646/* thread function prototypes */
647
648extern	kthread_t	*thread_create(
649	caddr_t		stk,
650	size_t		stksize,
651	void		(*proc)(),
652	void		*arg,
653	size_t		len,
654	proc_t 		*pp,
655	int		state,
656	pri_t		pri);
657extern	void	thread_exit(void) __NORETURN;
658extern	void	thread_free(kthread_t *);
659extern	void	thread_rele(kthread_t *);
660extern	void	thread_join(kt_did_t);
661extern	int	reaper(void);
662extern	void	installctx(kthread_t *, void *, void (*)(), void (*)(),
663    void (*)(), void (*)(), void (*)(), void (*)());
664extern	int	removectx(kthread_t *, void *, void (*)(), void (*)(),
665    void (*)(), void (*)(), void (*)(), void (*)());
666extern	void	savectx(kthread_t *);
667extern	void	restorectx(kthread_t *);
668extern	void	forkctx(kthread_t *, kthread_t *);
669extern	void	lwp_createctx(kthread_t *, kthread_t *);
670extern	void	exitctx(kthread_t *);
671extern	void	freectx(kthread_t *, int);
672extern	void	installpctx(proc_t *, void *, void (*)(), void (*)(),
673    void (*)(), void (*)(), void (*)());
674extern	int	removepctx(proc_t *, void *, void (*)(), void (*)(),
675    void (*)(), void (*)(), void (*)());
676extern	void	savepctx(proc_t *);
677extern	void	restorepctx(proc_t *);
678extern	void	forkpctx(proc_t *, proc_t *);
679extern	void	exitpctx(proc_t *);
680extern	void	freepctx(proc_t *, int);
681extern	kthread_t *thread_unpin(void);
682extern	void	thread_init(void);
683extern	void	thread_load(kthread_t *, void (*)(), caddr_t, size_t);
684
685extern	void	tsd_create(uint_t *, void (*)(void *));
686extern	void	tsd_destroy(uint_t *);
687extern	void	*tsd_getcreate(uint_t *, void (*)(void *), void *(*)(void));
688extern	void	*tsd_get(uint_t);
689extern	int	tsd_set(uint_t, void *);
690extern	void	tsd_exit(void);
691extern	void	*tsd_agent_get(kthread_t *, uint_t);
692extern	int	tsd_agent_set(kthread_t *, uint_t, void *);
693
694/* lwp function prototypes */
695
696extern	klwp_t 		*lwp_create(
697	void		(*proc)(),
698	caddr_t		arg,
699	size_t		len,
700	proc_t		*p,
701	int		state,
702	int		pri,
703	const k_sigset_t *smask,
704	int		cid,
705	id_t		lwpid);
706extern	kthread_t *idtot(proc_t *, id_t);
707extern	void	lwp_hash_in(proc_t *, lwpent_t *);
708extern	void	lwp_hash_out(proc_t *, id_t);
709extern	lwpdir_t *lwp_hash_lookup(proc_t *, id_t);
710extern	void	lwp_create_done(kthread_t *);
711extern	void	lwp_exit(void);
712extern	void	lwp_pcb_exit(void);
713extern	void	lwp_cleanup(void);
714extern	int	lwp_suspend(kthread_t *);
715extern	void	lwp_continue(kthread_t *);
716extern	void	holdlwp(void);
717extern	void	stoplwp(void);
718extern	int	holdlwps(int);
719extern	int	holdwatch(void);
720extern	void	pokelwps(proc_t *);
721extern	void	continuelwps(proc_t *);
722extern	int	exitlwps(int);
723extern	void	lwp_ctmpl_copy(klwp_t *, klwp_t *);
724extern	void	lwp_ctmpl_clear(klwp_t *);
725extern	klwp_t	*forklwp(klwp_t *, proc_t *, id_t);
726extern	void	lwp_load(klwp_t *, gregset_t, uintptr_t);
727extern	void	lwp_setrval(klwp_t *, int, int);
728extern	void	lwp_forkregs(klwp_t *, klwp_t *);
729extern	void	lwp_freeregs(klwp_t *, int);
730extern	caddr_t	lwp_stk_init(klwp_t *, caddr_t);
731extern	void	lwp_stk_cache_init(void);
732extern	void	lwp_stk_fini(klwp_t *);
733extern	void	lwp_installctx(klwp_t *);
734extern	void	lwp_rtt(void);
735extern	void	lwp_rtt_initial(void);
736extern	int	lwp_setprivate(klwp_t *, int, uintptr_t);
737extern	void	lwp_stat_update(lwp_stat_id_t, long);
738extern	void	lwp_attach_brand_hdlrs(klwp_t *);
739
740/*
741 * Signal queue function prototypes. Must be here due to header ordering
742 * dependencies.
743 */
744extern void sigqfree(proc_t *);
745extern void siginfofree(sigqueue_t *);
746extern void sigdeq(proc_t *, kthread_t *, int, sigqueue_t **);
747extern void sigdelq(proc_t *, kthread_t *, int);
748extern void sigaddq(proc_t *, kthread_t *, k_siginfo_t *, int);
749extern void sigaddqa(proc_t *, kthread_t *, sigqueue_t *);
750extern void sigqsend(int, proc_t *, kthread_t *, sigqueue_t *);
751extern void sigdupq(proc_t *, proc_t *);
752extern int sigwillqueue(int, int);
753extern sigqhdr_t *sigqhdralloc(size_t, uint_t);
754extern sigqueue_t *sigqalloc(sigqhdr_t *);
755extern void sigqhdrfree(sigqhdr_t *);
756extern sigqueue_t *sigappend(k_sigset_t *, sigqueue_t *,
757	k_sigset_t *, sigqueue_t *);
758extern sigqueue_t *sigprepend(k_sigset_t *, sigqueue_t *,
759	k_sigset_t *, sigqueue_t *);
760extern void winfo(proc_t *, k_siginfo_t *, int);
761extern int wstat(int, int);
762extern int sendsig(int, k_siginfo_t *, void (*)());
763#if defined(_SYSCALL32_IMPL)
764extern int sendsig32(int, k_siginfo_t *, void (*)());
765#endif
766
767#endif	/* _KERNEL */
768
769#ifdef	__cplusplus
770}
771#endif
772
773#endif	/* _SYS_PROC_H */
774