xref: /titanic_52/usr/src/uts/common/sys/procfs.h (revision ee169c7e77bc5d28a401dde8533cbd38afd24ae1)
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 2012 DEY Storage Systems, Inc.  All rights reserved.
28  */
29 
30 #ifndef _SYS_PROCFS_H
31 #define	_SYS_PROCFS_H
32 
33 #ifdef	__cplusplus
34 extern "C" {
35 #endif
36 
37 /*
38  * This definition is temporary.  Structured proc is the preferred API,
39  * and the older ioctl-based interface will be removed in a future version
40  * of Solaris.  Until then, by default, including <sys/procfs.h> will
41  * provide the older ioctl-based /proc definitions.  To get the structured
42  * /proc definitions, either include <procfs.h> or define _STRUCTURED_PROC
43  * to be 1 before including <sys/procfs.h>.
44  */
45 #ifndef	_STRUCTURED_PROC
46 #define	_STRUCTURED_PROC	0
47 #endif
48 
49 #if !defined(_KERNEL) && _STRUCTURED_PROC == 0
50 
51 #include <sys/old_procfs.h>
52 
53 #else	/* !defined(_KERNEL) && _STRUCTURED_PROC == 0 */
54 
55 #include <sys/feature_tests.h>
56 #include <sys/types.h>
57 #include <sys/time_impl.h>
58 #include <sys/signal.h>
59 #include <sys/siginfo.h>
60 #include <sys/fault.h>
61 #include <sys/syscall.h>
62 #include <sys/pset.h>
63 #include <sys/procfs_isa.h>
64 #include <sys/priv.h>
65 #include <sys/stat.h>
66 #include <sys/param.h>
67 
68 /*
69  * System call interfaces for /proc.
70  */
71 
72 /*
73  * Control codes (long values) for messages written to ctl and lwpctl files.
74  */
75 #define	PCNULL   0L	/* null request, advance to next message */
76 #define	PCSTOP   1L	/* direct process or lwp to stop and wait for stop */
77 #define	PCDSTOP  2L	/* direct process or lwp to stop */
78 #define	PCWSTOP  3L	/* wait for process or lwp to stop, no timeout */
79 #define	PCTWSTOP 4L	/* wait for stop, with long millisecond timeout arg */
80 #define	PCRUN    5L	/* make process/lwp runnable, w/ long flags argument */
81 #define	PCCSIG   6L	/* clear current signal from lwp */
82 #define	PCCFAULT 7L	/* clear current fault from lwp */
83 #define	PCSSIG   8L	/* set current signal from siginfo_t argument */
84 #define	PCKILL   9L	/* post a signal to process/lwp, long argument */
85 #define	PCUNKILL 10L	/* delete a pending signal from process/lwp, long arg */
86 #define	PCSHOLD  11L	/* set lwp signal mask from sigset_t argument */
87 #define	PCSTRACE 12L	/* set traced signal set from sigset_t argument */
88 #define	PCSFAULT 13L	/* set traced fault set from fltset_t argument */
89 #define	PCSENTRY 14L	/* set traced syscall entry set from sysset_t arg */
90 #define	PCSEXIT  15L	/* set traced syscall exit set from sysset_t arg */
91 #define	PCSET    16L	/* set modes from long argument */
92 #define	PCUNSET  17L	/* unset modes from long argument */
93 #define	PCSREG   18L	/* set lwp general registers from prgregset_t arg */
94 #define	PCSFPREG 19L	/* set lwp floating-point registers from prfpregset_t */
95 #define	PCSXREG  20L	/* set lwp extra registers from prxregset_t arg */
96 #define	PCNICE   21L	/* set nice priority from long argument */
97 #define	PCSVADDR 22L	/* set %pc virtual address from long argument */
98 #define	PCWATCH  23L	/* set/unset watched memory area from prwatch_t arg */
99 #define	PCAGENT  24L	/* create agent lwp with regs from prgregset_t arg */
100 #define	PCREAD   25L	/* read from the address space via priovec_t arg */
101 #define	PCWRITE  26L	/* write to the address space via priovec_t arg */
102 #define	PCSCRED  27L	/* set process credentials from prcred_t argument */
103 #define	PCSASRS  28L	/* set ancillary state registers from asrset_t arg */
104 #define	PCSPRIV  29L	/* set process privileges from prpriv_t argument */
105 #define	PCSZONE  30L	/* set zoneid from zoneid_t argument */
106 #define	PCSCREDX 31L	/* as PCSCRED but with supplemental groups */
107 /*
108  * PCRUN long operand flags.
109  */
110 #define	PRCSIG		0x01	/* clear current signal, if any */
111 #define	PRCFAULT	0x02	/* clear current fault, if any */
112 #define	PRSTEP		0x04	/* direct the lwp to single-step */
113 #define	PRSABORT	0x08	/* abort syscall, if in syscall */
114 #define	PRSTOP		0x10	/* set directed stop request */
115 
116 /*
117  * lwp status file.  /proc/<pid>/lwp/<lwpid>/lwpstatus
118  */
119 #define	PRCLSZ		8	/* maximum size of scheduling class name */
120 #define	PRSYSARGS	8	/* maximum number of syscall arguments */
121 typedef struct lwpstatus {
122 	int	pr_flags;	/* flags (see below) */
123 	id_t	pr_lwpid;	/* specific lwp identifier */
124 	short	pr_why;		/* reason for lwp stop, if stopped */
125 	short	pr_what;	/* more detailed reason */
126 	short	pr_cursig;	/* current signal, if any */
127 	short	pr_pad1;
128 	siginfo_t pr_info;	/* info associated with signal or fault */
129 	sigset_t pr_lwppend;	/* set of signals pending to the lwp */
130 	sigset_t pr_lwphold;	/* set of signals blocked by the lwp */
131 	struct sigaction pr_action;	/* signal action for current signal */
132 	stack_t	pr_altstack;	/* alternate signal stack info */
133 	uintptr_t pr_oldcontext;	/* address of previous ucontext */
134 	short	pr_syscall;	/* system call number (if in syscall) */
135 	short	pr_nsysarg;	/* number of arguments to this syscall */
136 	int	pr_errno;	/* errno for failed syscall, 0 if successful */
137 	long	pr_sysarg[PRSYSARGS];	/* arguments to this syscall */
138 	long	pr_rval1;	/* primary syscall return value */
139 	long	pr_rval2;	/* second syscall return value, if any */
140 	char	pr_clname[PRCLSZ];	/* scheduling class name */
141 	timestruc_t pr_tstamp;	/* real-time time stamp of stop */
142 	timestruc_t pr_utime;	/* lwp user cpu time */
143 	timestruc_t pr_stime;	/* lwp system cpu time */
144 	int	pr_filler[11 - 2 * sizeof (timestruc_t) / sizeof (int)];
145 	int	pr_errpriv;	/* missing privilege */
146 	uintptr_t pr_ustack;	/* address of stack boundary data (stack_t) */
147 	ulong_t	pr_instr;	/* current instruction */
148 	prgregset_t pr_reg;	/* general registers */
149 	prfpregset_t pr_fpreg;	/* floating-point registers */
150 } lwpstatus_t;
151 
152 /*
153  * process status file.  /proc/<pid>/status
154  */
155 typedef struct pstatus {
156 	int	pr_flags;	/* flags (see below) */
157 	int	pr_nlwp;	/* number of active lwps in the process */
158 	pid_t	pr_pid;		/* process id */
159 	pid_t	pr_ppid;	/* parent process id */
160 	pid_t	pr_pgid;	/* process group id */
161 	pid_t	pr_sid;		/* session id */
162 	id_t	pr_aslwpid;	/* historical; now always zero */
163 	id_t	pr_agentid;	/* lwp id of the /proc agent lwp, if any */
164 	sigset_t pr_sigpend;	/* set of process pending signals */
165 	uintptr_t pr_brkbase;	/* address of the process heap */
166 	size_t	pr_brksize;	/* size of the process heap, in bytes */
167 	uintptr_t pr_stkbase;	/* address of the process stack */
168 	size_t	pr_stksize;	/* size of the process stack, in bytes */
169 	timestruc_t pr_utime;	/* process user cpu time */
170 	timestruc_t pr_stime;	/* process system cpu time */
171 	timestruc_t pr_cutime;	/* sum of children's user times */
172 	timestruc_t pr_cstime;	/* sum of children's system times */
173 	sigset_t pr_sigtrace;	/* set of traced signals */
174 	fltset_t pr_flttrace;	/* set of traced faults */
175 	sysset_t pr_sysentry;	/* set of system calls traced on entry */
176 	sysset_t pr_sysexit;	/* set of system calls traced on exit */
177 	char	pr_dmodel;	/* data model of the process (see below) */
178 	char	pr_pad[3];
179 	taskid_t pr_taskid;	/* task id */
180 	projid_t pr_projid;	/* project id */
181 	int	pr_nzomb;	/* number of zombie lwps in the process */
182 	zoneid_t pr_zoneid;	/* zone id */
183 	int	pr_filler[15];	/* reserved for future use */
184 	lwpstatus_t pr_lwp;	/* status of the representative lwp */
185 } pstatus_t;
186 
187 /*
188  * pr_flags (same values appear in both pstatus_t and lwpstatus_t pr_flags).
189  *
190  * These flags do *not* apply to psinfo_t.pr_flag or lwpsinfo_t.pr_flag
191  * (which are both deprecated).
192  */
193 /* The following flags apply to the specific or representative lwp */
194 #define	PR_STOPPED 0x00000001	/* lwp is stopped */
195 #define	PR_ISTOP   0x00000002	/* lwp is stopped on an event of interest */
196 #define	PR_DSTOP   0x00000004	/* lwp has a stop directive in effect */
197 #define	PR_STEP	   0x00000008	/* lwp has a single-step directive in effect */
198 #define	PR_ASLEEP  0x00000010	/* lwp is sleeping in a system call */
199 #define	PR_PCINVAL 0x00000020	/* contents of pr_instr undefined */
200 #define	PR_ASLWP   0x00000040	/* obsolete flag; never set */
201 #define	PR_AGENT   0x00000080	/* this lwp is the /proc agent lwp */
202 #define	PR_DETACH  0x00000100	/* this is a detached lwp */
203 #define	PR_DAEMON  0x00000200	/* this is a daemon lwp */
204 #define	PR_IDLE    0x00000400	/* lwp is a cpu's idle thread */
205 /* The following flags apply to the process, not to an individual lwp */
206 #define	PR_ISSYS   0x00001000	/* this is a system process */
207 #define	PR_VFORKP  0x00002000	/* process is the parent of a vfork()d child */
208 #define	PR_ORPHAN  0x00004000	/* process's process group is orphaned */
209 #define	PR_NOSIGCHLD 0x00008000	/* process will not generate SIGCHLD on exit */
210 #define	PR_WAITPID 0x00010000	/* only waitid(P_PID, pid) can reap the child */
211 /* The following process flags are modes settable by PCSET/PCUNSET */
212 #define	PR_FORK	   0x00100000	/* inherit-on-fork is in effect */
213 #define	PR_RLC	   0x00200000	/* run-on-last-close is in effect */
214 #define	PR_KLC	   0x00400000	/* kill-on-last-close is in effect */
215 #define	PR_ASYNC   0x00800000	/* asynchronous-stop is in effect */
216 #define	PR_MSACCT  0x01000000	/* micro-state usage accounting is in effect */
217 #define	PR_BPTADJ  0x02000000	/* breakpoint trap pc adjustment is in effect */
218 #define	PR_PTRACE  0x04000000	/* ptrace-compatibility mode is in effect */
219 #define	PR_MSFORK  0x08000000	/* micro-state accounting inherited on fork */
220 
221 /*
222  * See <sys/procfs_isa.h> for possible values of pr_dmodel.
223  */
224 
225 /*
226  * Reasons for stopping (pr_why).
227  */
228 #define	PR_REQUESTED	1
229 #define	PR_SIGNALLED	2
230 #define	PR_SYSENTRY	3
231 #define	PR_SYSEXIT	4
232 #define	PR_JOBCONTROL	5
233 #define	PR_FAULTED	6
234 #define	PR_SUSPENDED	7
235 #define	PR_CHECKPOINT	8
236 
237 /*
238  * lwp ps(1) information file.  /proc/<pid>/lwp/<lwpid>/lwpsinfo
239  */
240 #define	PRFNSZ		16	/* Maximum size of execed filename */
241 typedef struct lwpsinfo {
242 	int	pr_flag;	/* lwp flags (DEPRECATED; do not use) */
243 	id_t	pr_lwpid;	/* lwp id */
244 	uintptr_t pr_addr;	/* internal address of lwp */
245 	uintptr_t pr_wchan;	/* wait addr for sleeping lwp */
246 	char	pr_stype;	/* synchronization event type */
247 	char	pr_state;	/* numeric lwp state */
248 	char	pr_sname;	/* printable character for pr_state */
249 	char	pr_nice;	/* nice for cpu usage */
250 	short	pr_syscall;	/* system call number (if in syscall) */
251 	char	pr_oldpri;	/* pre-SVR4, low value is high priority */
252 	char	pr_cpu;		/* pre-SVR4, cpu usage for scheduling */
253 	int	pr_pri;		/* priority, high value is high priority */
254 			/* The following percent number is a 16-bit binary */
255 			/* fraction [0 .. 1] with the binary point to the */
256 			/* right of the high-order bit (1.0 == 0x8000) */
257 	ushort_t pr_pctcpu;	/* % of recent cpu time used by this lwp */
258 	ushort_t pr_pad;
259 	timestruc_t pr_start;	/* lwp start time, from the epoch */
260 	timestruc_t pr_time;	/* usr+sys cpu time for this lwp */
261 	char	pr_clname[PRCLSZ];	/* scheduling class name */
262 	char	pr_name[PRFNSZ];	/* name of system lwp */
263 	processorid_t pr_onpro;		/* processor which last ran this lwp */
264 	processorid_t pr_bindpro;	/* processor to which lwp is bound */
265 	psetid_t pr_bindpset;	/* processor set to which lwp is bound */
266 	int	pr_lgrp;	/* lwp home lgroup */
267 	int	pr_filler[4];	/* reserved for future use */
268 } lwpsinfo_t;
269 
270 /*
271  * process ps(1) information file.  /proc/<pid>/psinfo
272  */
273 #define	PRARGSZ		80	/* number of chars of arguments */
274 typedef struct psinfo {
275 	int	pr_flag;	/* process flags (DEPRECATED; do not use) */
276 	int	pr_nlwp;	/* number of active lwps in the process */
277 	pid_t	pr_pid;		/* unique process id */
278 	pid_t	pr_ppid;	/* process id of parent */
279 	pid_t	pr_pgid;	/* pid of process group leader */
280 	pid_t	pr_sid;		/* session id */
281 	uid_t	pr_uid;		/* real user id */
282 	uid_t	pr_euid;	/* effective user id */
283 	gid_t	pr_gid;		/* real group id */
284 	gid_t	pr_egid;	/* effective group id */
285 	uintptr_t pr_addr;	/* address of process */
286 	size_t	pr_size;	/* size of process image in Kbytes */
287 	size_t	pr_rssize;	/* resident set size in Kbytes */
288 	size_t	pr_pad1;
289 	dev_t	pr_ttydev;	/* controlling tty device (or PRNODEV) */
290 			/* The following percent numbers are 16-bit binary */
291 			/* fractions [0 .. 1] with the binary point to the */
292 			/* right of the high-order bit (1.0 == 0x8000) */
293 	ushort_t pr_pctcpu;	/* % of recent cpu time used by all lwps */
294 	ushort_t pr_pctmem;	/* % of system memory used by process */
295 	timestruc_t pr_start;	/* process start time, from the epoch */
296 	timestruc_t pr_time;	/* usr+sys cpu time for this process */
297 	timestruc_t pr_ctime;	/* usr+sys cpu time for reaped children */
298 	char	pr_fname[PRFNSZ];	/* name of execed file */
299 	char	pr_psargs[PRARGSZ];	/* initial characters of arg list */
300 	int	pr_wstat;	/* if zombie, the wait() status */
301 	int	pr_argc;	/* initial argument count */
302 	uintptr_t pr_argv;	/* address of initial argument vector */
303 	uintptr_t pr_envp;	/* address of initial environment vector */
304 	char	pr_dmodel;	/* data model of the process */
305 	char	pr_pad2[3];
306 	taskid_t pr_taskid;	/* task id */
307 	projid_t pr_projid;	/* project id */
308 	int	pr_nzomb;	/* number of zombie lwps in the process */
309 	poolid_t pr_poolid;	/* pool id */
310 	zoneid_t pr_zoneid;	/* zone id */
311 	id_t	pr_contract;	/* process contract */
312 	int	pr_filler[1];	/* reserved for future use */
313 	lwpsinfo_t pr_lwp;	/* information for representative lwp */
314 } psinfo_t;
315 
316 #define	PRNODEV	(dev_t)(-1)	/* non-existent device */
317 
318 /*
319  * Memory-map interface.  /proc/<pid>/map /proc/<pid>/rmap
320  */
321 #define	PRMAPSZ	64
322 typedef struct prmap {
323 	uintptr_t pr_vaddr;	/* virtual address of mapping */
324 	size_t	pr_size;	/* size of mapping in bytes */
325 	char	pr_mapname[PRMAPSZ];	/* name in /proc/<pid>/object */
326 	offset_t pr_offset;	/* offset into mapped object, if any */
327 	int	pr_mflags;	/* protection and attribute flags (see below) */
328 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
329 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
330 	int	pr_filler[1];	/* filler for future expansion */
331 } prmap_t;
332 
333 /*
334  * HAT memory-map interface.  /proc/<pid>/xmap
335  */
336 typedef struct prxmap {
337 	uintptr_t pr_vaddr;	/* virtual address of mapping */
338 	size_t	pr_size;	/* size of mapping in bytes */
339 	char	pr_mapname[PRMAPSZ];	/* name in /proc/<pid>/object */
340 	offset_t pr_offset;	/* offset into mapped object, if any */
341 	int	pr_mflags;	/* protection and attribute flags (see below) */
342 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
343 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
344 	dev_t	pr_dev;	/* st_dev from stat64() of mapped object, or PRNODEV */
345 	uint64_t pr_ino; /* st_ino from stat64() of mapped object, if any */
346 	size_t	pr_rss; 	/* pages of resident memory */
347 	size_t	pr_anon;	/* pages of resident anonymous memory */
348 	size_t	pr_locked;	/* pages of locked memory */
349 	size_t	pr_pad;		/* currently unused */
350 	uint64_t pr_hatpagesize; /* pagesize of the hat mapping */
351 #ifdef	_ILP32
352 	ulong_t	pr_filler[6];	/* filler for future expansion */
353 #else
354 	ulong_t pr_filler[7];	/* filler for future expansion */
355 #endif
356 } prxmap_t;
357 
358 
359 /* Protection and attribute flags */
360 #define	MA_READ		0x04	/* readable by the traced process */
361 #define	MA_WRITE	0x02	/* writable by the traced process */
362 #define	MA_EXEC		0x01	/* executable by the traced process */
363 #define	MA_SHARED	0x08	/* changes are shared by mapped object */
364 #define	MA_ANON		0x40	/* anonymous memory (e.g. /dev/zero) */
365 #define	MA_ISM		0x80	/* intimate shared mem (shared MMU resources) */
366 #define	MA_NORESERVE	0x100	/* mapped with MAP_NORESERVE */
367 #define	MA_SHM		0x200	/* System V shared memory */
368 #define	MA_RESERVED1	0x400	/* reserved for future use */
369 
370 /*
371  * These are obsolete and unreliable.
372  * They are included here only for historical compatibility.
373  */
374 #define	MA_BREAK	0x10	/* grown by brk(2) */
375 #define	MA_STACK	0x20	/* grown automatically on stack faults */
376 
377 /*
378  * Process credentials.  PCSCRED and /proc/<pid>/cred
379  */
380 typedef struct prcred {
381 	uid_t	pr_euid;	/* effective user id */
382 	uid_t	pr_ruid;	/* real user id */
383 	uid_t	pr_suid;	/* saved user id (from exec) */
384 	gid_t	pr_egid;	/* effective group id */
385 	gid_t	pr_rgid;	/* real group id */
386 	gid_t	pr_sgid;	/* saved group id (from exec) */
387 	int	pr_ngroups;	/* number of supplementary groups */
388 	gid_t	pr_groups[1];	/* array of supplementary groups */
389 } prcred_t;
390 
391 /*
392  * Process privileges.  PCSPRIV and /proc/<pid>/priv
393  */
394 typedef struct prpriv {
395 	uint32_t	pr_nsets;		/* number of privilege set */
396 	uint32_t	pr_setsize;		/* size of privilege set */
397 	uint32_t	pr_infosize;		/* size of supplementary data */
398 	priv_chunk_t	pr_sets[1];		/* array of sets */
399 } prpriv_t;
400 
401 /*
402  * Watchpoint interface.  PCWATCH and /proc/<pid>/watch
403  */
404 typedef struct prwatch {
405 	uintptr_t pr_vaddr;	/* virtual address of watched area */
406 	size_t	pr_size;	/* size of watched area in bytes */
407 	int	pr_wflags;	/* watch type flags */
408 	int	pr_pad;
409 } prwatch_t;
410 
411 /* pr_wflags */
412 #define	WA_READ		0x04	/* trap on read access */
413 #define	WA_WRITE	0x02	/* trap on write access */
414 #define	WA_EXEC		0x01	/* trap on execute access */
415 #define	WA_TRAPAFTER	0x08	/* trap after instruction completes */
416 
417 /*
418  * PCREAD/PCWRITE I/O interface.
419  */
420 typedef struct priovec {
421 	void	*pio_base;	/* buffer in controlling process */
422 	size_t	pio_len;	/* size of read/write request */
423 	off_t	pio_offset;	/* virtual address in target process */
424 } priovec_t;
425 
426 /*
427  * Resource usage.  /proc/<pid>/usage /proc/<pid>/lwp/<lwpid>/lwpusage
428  */
429 typedef struct prusage {
430 	id_t		pr_lwpid;	/* lwp id.  0: process or defunct */
431 	int		pr_count;	/* number of contributing lwps */
432 	timestruc_t	pr_tstamp;	/* current time stamp */
433 	timestruc_t	pr_create;	/* process/lwp creation time stamp */
434 	timestruc_t	pr_term;	/* process/lwp termination time stamp */
435 	timestruc_t	pr_rtime;	/* total lwp real (elapsed) time */
436 	timestruc_t	pr_utime;	/* user level cpu time */
437 	timestruc_t	pr_stime;	/* system call cpu time */
438 	timestruc_t	pr_ttime;	/* other system trap cpu time */
439 	timestruc_t	pr_tftime;	/* text page fault sleep time */
440 	timestruc_t	pr_dftime;	/* data page fault sleep time */
441 	timestruc_t	pr_kftime;	/* kernel page fault sleep time */
442 	timestruc_t	pr_ltime;	/* user lock wait sleep time */
443 	timestruc_t	pr_slptime;	/* all other sleep time */
444 	timestruc_t	pr_wtime;	/* wait-cpu (latency) time */
445 	timestruc_t	pr_stoptime;	/* stopped time */
446 	timestruc_t	filltime[6];	/* filler for future expansion */
447 	ulong_t		pr_minf;	/* minor page faults */
448 	ulong_t		pr_majf;	/* major page faults */
449 	ulong_t		pr_nswap;	/* swaps */
450 	ulong_t		pr_inblk;	/* input blocks */
451 	ulong_t		pr_oublk;	/* output blocks */
452 	ulong_t		pr_msnd;	/* messages sent */
453 	ulong_t		pr_mrcv;	/* messages received */
454 	ulong_t		pr_sigs;	/* signals received */
455 	ulong_t		pr_vctx;	/* voluntary context switches */
456 	ulong_t		pr_ictx;	/* involuntary context switches */
457 	ulong_t		pr_sysc;	/* system calls */
458 	ulong_t		pr_ioch;	/* chars read and written */
459 	ulong_t		filler[10];	/* filler for future expansion */
460 } prusage_t;
461 
462 /*
463  * Page data file.  /proc/<pid>/pagedata
464  */
465 
466 /* page data file header */
467 typedef struct prpageheader {
468 	timestruc_t	pr_tstamp;	/* real time stamp */
469 	long		pr_nmap;	/* number of address space mappings */
470 	long		pr_npage;	/* total number of pages */
471 } prpageheader_t;
472 
473 /* page data mapping header */
474 typedef struct prasmap {
475 	uintptr_t pr_vaddr;	/* virtual address of mapping */
476 	size_t	pr_npage;	/* number of pages in mapping */
477 	char	pr_mapname[PRMAPSZ];	/* name in /proc/<pid>/object */
478 	offset_t pr_offset;	/* offset into mapped object, if any */
479 	int	pr_mflags;	/* protection and attribute flags */
480 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
481 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
482 	int	pr_filler[1];	/* filler for future expansion */
483 } prasmap_t;
484 
485 /*
486  * pr_npage bytes (plus 0-7 null bytes to round up to an 8-byte boundary)
487  * follow each mapping header, each containing zero or more of these flags.
488  */
489 #define	PG_REFERENCED	0x02		/* page referenced since last read */
490 #define	PG_MODIFIED	0x01		/* page modified since last read */
491 #define	PG_HWMAPPED	0x04		/* page is present and mapped */
492 
493 /*
494  * Open files.  Only in core files (for now).  Note that we'd like to use
495  * the stat or stat64 structure, but both of these structures are unfortunately
496  * not consistent between 32 and 64 bit modes.  To keep our lives simpler, we
497  * just define our own structure with types that are not sensitive to this
498  * difference.  Also, it turns out that pfiles omits a lot of info from the
499  * struct stat (e.g. times, device sizes, etc.) so we don't bother adding those
500  * here.
501  */
502 typedef struct prfdinfo {
503 	int		pr_fd;
504 	mode_t		pr_mode;
505 
506 	uid_t		pr_uid;
507 	gid_t		pr_gid;
508 
509 	major_t		pr_major;	/* think stat.st_dev */
510 	minor_t		pr_minor;
511 
512 	major_t		pr_rmajor;	/* think stat.st_rdev */
513 	minor_t		pr_rminor;
514 
515 	ino64_t		pr_ino;
516 	off64_t		pr_offset;
517 	off64_t		pr_size;
518 
519 	int		pr_fileflags;	/* fcntl(F_GETXFL), etc */
520 	int		pr_fdflags;	/* fcntl(F_GETFD), etc. */
521 
522 	char		pr_path[MAXPATHLEN];
523 } prfdinfo_t;
524 
525 /*
526  * Header for /proc/<pid>/lstatus /proc/<pid>/lpsinfo /proc/<pid>/lusage
527  */
528 typedef struct prheader {
529 	long	pr_nent;	/* number of entries */
530 	long	pr_entsize;	/* size of each entry, in bytes */
531 } prheader_t;
532 
533 /*
534  * Macros for manipulating sets of flags.
535  * sp must be a pointer to one of sigset_t, fltset_t, or sysset_t.
536  * flag must be a member of the enumeration corresponding to *sp.
537  */
538 
539 /* turn on all flags in set */
540 #define	prfillset(sp) \
541 	{ register int _i_ = sizeof (*(sp))/sizeof (uint32_t); \
542 		while (_i_) ((uint32_t *)(sp))[--_i_] = (uint32_t)0xFFFFFFFF; }
543 
544 /* turn off all flags in set */
545 #define	premptyset(sp) \
546 	{ register int _i_ = sizeof (*(sp))/sizeof (uint32_t); \
547 		while (_i_) ((uint32_t *)(sp))[--_i_] = (uint32_t)0; }
548 
549 /* turn on specified flag in set */
550 #define	praddset(sp, flag) \
551 	((void)(((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) ? \
552 	(((uint32_t *)(sp))[((flag)-1)/32] |= (1U<<(((flag)-1)%32))) : 0))
553 
554 /* turn off specified flag in set */
555 #define	prdelset(sp, flag) \
556 	((void)(((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) ? \
557 	    (((uint32_t *)(sp))[((flag)-1)/32] &= ~(1U<<(((flag)-1)%32))) : 0))
558 
559 /* query: != 0 iff flag is turned on in set */
560 #define	prismember(sp, flag) \
561 	(((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) && \
562 	    (((uint32_t *)(sp))[((flag)-1)/32] & (1U<<(((flag)-1)%32))))
563 
564 #if defined(_SYSCALL32)
565 
566 /*
567  * dev32_t version of PRNODEV
568  */
569 #define	PRNODEV32 (dev32_t)(-1)
570 
571 /*
572  * Kernel view of /proc structures for _ILP32 programs.
573  */
574 
575 /*
576  * _ILP32 lwp status file.  /proc/<pid>/lwp/<lwpid>/lwpstatus
577  */
578 typedef struct lwpstatus32 {
579 	int	pr_flags;	/* flags */
580 	id32_t	pr_lwpid;	/* specific lwp identifier */
581 	short	pr_why;		/* reason for lwp stop, if stopped */
582 	short	pr_what;	/* more detailed reason */
583 	short	pr_cursig;	/* current signal, if any */
584 	short	pr_pad1;
585 	siginfo32_t pr_info;	/* info associated with signal or fault */
586 	sigset_t pr_lwppend;	/* set of signals pending to the lwp */
587 	sigset_t pr_lwphold;	/* set of signals blocked by the lwp */
588 	struct sigaction32 pr_action;	/* signal action for current signal */
589 	stack32_t pr_altstack;	/* alternate signal stack info */
590 	caddr32_t pr_oldcontext;	/* address of previous ucontext */
591 	short	pr_syscall;	/* system call number (if in syscall) */
592 	short	pr_nsysarg;	/* number of arguments to this syscall */
593 	int	pr_errno;	/* errno for failed syscall, 0 if successful */
594 	int32_t	pr_sysarg[PRSYSARGS];	/* arguments to this syscall */
595 	int32_t	pr_rval1;	/* primary syscall return value */
596 	int32_t	pr_rval2;	/* second syscall return value, if any */
597 	char	pr_clname[PRCLSZ];	/* scheduling class name */
598 	timestruc32_t pr_tstamp;	/* real-time time stamp of stop */
599 	timestruc32_t pr_utime;	/* lwp user cpu time */
600 	timestruc32_t pr_stime;	/* lwp system cpu time */
601 	int	pr_filler[11 - 2 * sizeof (timestruc32_t) / sizeof (int)];
602 	int	pr_errpriv;	/* missing privilege */
603 	caddr32_t pr_ustack;	/* address of stack boundary data (stack32_t) */
604 	uint32_t pr_instr;	/* current instruction */
605 	prgregset32_t pr_reg;	/* general registers */
606 	prfpregset32_t pr_fpreg; /* floating-point registers */
607 } lwpstatus32_t;
608 
609 /*
610  * _ILP32 process status file.  /proc/<pid>/status
611  */
612 typedef struct pstatus32 {
613 	int	pr_flags;	/* flags */
614 	int	pr_nlwp;	/* number of active lwps in the process */
615 	pid32_t	pr_pid;		/* process id */
616 	pid32_t	pr_ppid;	/* parent process id */
617 	pid32_t	pr_pgid;	/* process group id */
618 	pid32_t	pr_sid;		/* session id */
619 	id32_t	pr_aslwpid;	/* historical; now always zero */
620 	id32_t	pr_agentid;	/* lwp id of the /proc agent lwp, if any */
621 	sigset_t pr_sigpend;	/* set of process pending signals */
622 	caddr32_t pr_brkbase;	/* address of the process heap */
623 	size32_t pr_brksize;	/* size of the process heap, in bytes */
624 	caddr32_t pr_stkbase;	/* address of the process stack */
625 	size32_t pr_stksize;	/* size of the process stack, in bytes */
626 	timestruc32_t pr_utime;	/* process user cpu time */
627 	timestruc32_t pr_stime;	/* process system cpu time */
628 	timestruc32_t pr_cutime;	/* sum of children's user times */
629 	timestruc32_t pr_cstime;	/* sum of children's system times */
630 	sigset_t pr_sigtrace;	/* set of traced signals */
631 	fltset_t pr_flttrace;	/* set of traced faults */
632 	sysset_t pr_sysentry;	/* set of system calls traced on entry */
633 	sysset_t pr_sysexit;	/* set of system calls traced on exit */
634 	char	pr_dmodel;	/* data model of the process */
635 	char	pr_pad[3];
636 	id32_t	pr_taskid;	/* task id */
637 	id32_t	pr_projid;	/* project id */
638 	int	pr_nzomb;	/* number of zombie lwps in the process */
639 	id32_t	pr_zoneid;	/* zone id */
640 	int	pr_filler[15];	/* reserved for future use */
641 	lwpstatus32_t pr_lwp;	/* status of the representative lwp */
642 } pstatus32_t;
643 
644 /*
645  * _ILP32 lwp ps(1) information file.  /proc/<pid>/lwp/<lwpid>/lwpsinfo
646  */
647 typedef struct lwpsinfo32 {
648 	int	pr_flag;	/* lwp flags */
649 	id32_t	pr_lwpid;	/* lwp id */
650 	caddr32_t pr_addr;	/* internal address of lwp */
651 	caddr32_t pr_wchan;	/* wait addr for sleeping lwp */
652 	char	pr_stype;	/* synchronization event type */
653 	char	pr_state;	/* numeric lwp state */
654 	char	pr_sname;	/* printable character for pr_state */
655 	char	pr_nice;	/* nice for cpu usage */
656 	short	pr_syscall;	/* system call number (if in syscall) */
657 	char	pr_oldpri;	/* pre-SVR4, low value is high priority */
658 	char	pr_cpu;		/* pre-SVR4, cpu usage for scheduling */
659 	int	pr_pri;		/* priority, high value is high priority */
660 			/* The following percent number is a 16-bit binary */
661 			/* fraction [0 .. 1] with the binary point to the */
662 			/* right of the high-order bit (1.0 == 0x8000) */
663 	ushort_t pr_pctcpu;	/* % of recent cpu time used by this lwp */
664 	ushort_t pr_pad;
665 	timestruc32_t pr_start;	/* lwp start time, from the epoch */
666 	timestruc32_t pr_time;	/* usr+sys cpu time for this lwp */
667 	char	pr_clname[PRCLSZ];	/* scheduling class name */
668 	char	pr_name[PRFNSZ];	/* name of system lwp */
669 	processorid_t pr_onpro;		/* processor which last ran this lwp */
670 	processorid_t pr_bindpro;	/* processor to which lwp is bound */
671 	psetid_t pr_bindpset;	/* processor set to which lwp is bound */
672 	int	pr_lgrp;	/* lwp home lgroup */
673 	int	pr_filler[4];	/* reserved for future use */
674 } lwpsinfo32_t;
675 
676 /*
677  * _ILP32 process ps(1) information file.  /proc/<pid>/psinfo
678  */
679 typedef struct psinfo32 {
680 	int	pr_flag;	/* process flags */
681 	int	pr_nlwp;	/* number of active lwps in the process */
682 	pid32_t	pr_pid;		/* unique process id */
683 	pid32_t	pr_ppid;	/* process id of parent */
684 	pid32_t	pr_pgid;	/* pid of process group leader */
685 	pid32_t	pr_sid;		/* session id */
686 	uid32_t	pr_uid;		/* real user id */
687 	uid32_t	pr_euid;	/* effective user id */
688 	gid32_t	pr_gid;		/* real group id */
689 	gid32_t	pr_egid;	/* effective group id */
690 	caddr32_t pr_addr;	/* address of process */
691 	size32_t pr_size;	/* size of process image in Kbytes */
692 	size32_t pr_rssize;	/* resident set size in Kbytes */
693 	size32_t pr_pad1;
694 	dev32_t	pr_ttydev;	/* controlling tty device (or PRNODEV) */
695 	ushort_t pr_pctcpu;	/* % of recent cpu time used by all lwps */
696 	ushort_t pr_pctmem;	/* % of system memory used by process */
697 	timestruc32_t pr_start;	/* process start time, from the epoch */
698 	timestruc32_t pr_time;	/* usr+sys cpu time for this process */
699 	timestruc32_t pr_ctime;	/* usr+sys cpu time for reaped children */
700 	char	pr_fname[PRFNSZ];	/* name of execed file */
701 	char	pr_psargs[PRARGSZ];	/* initial characters of arg list */
702 	int	pr_wstat;	/* if zombie, the wait() status */
703 	int	pr_argc;	/* initial argument count */
704 	caddr32_t pr_argv;	/* address of initial argument vector */
705 	caddr32_t pr_envp;	/* address of initial environment vector */
706 	char	pr_dmodel;	/* data model of the process */
707 	char	pr_pad2[3];
708 	id32_t	pr_taskid;	/* task id */
709 	id32_t	pr_projid;	/* project id */
710 	int	pr_nzomb;	/* number of zombie lwps in the process */
711 	id32_t	pr_poolid;	/* pool id */
712 	id32_t	pr_zoneid;	/* zone id */
713 	id32_t	pr_contract;	/* process contract */
714 	int	pr_filler[1];	/* reserved for future use */
715 	lwpsinfo32_t pr_lwp;	/* information for representative lwp */
716 } psinfo32_t;
717 
718 /*
719  * _ILP32 Memory-management interface.  /proc/<pid>/map /proc/<pid>/rmap
720  */
721 typedef struct prmap32 {
722 	caddr32_t pr_vaddr;	/* virtual address of mapping */
723 	size32_t pr_size;	/* size of mapping in bytes */
724 	char	pr_mapname[64];	/* name in /proc/<pid>/object */
725 	offset_t pr_offset;	/* offset into mapped object, if any */
726 	int	pr_mflags;	/* protection and attribute flags */
727 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
728 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
729 	int	pr_filler[1];	/* filler for future expansion */
730 } prmap32_t;
731 
732 /*
733  * _ILP32 HAT memory-map interface.  /proc/<pid>/xmap
734  */
735 typedef struct prxmap32 {
736 	caddr32_t pr_vaddr;	/* virtual address of mapping */
737 	size32_t pr_size;	/* size of mapping in bytes */
738 	char	pr_mapname[PRMAPSZ];	/* name in /proc/<pid>/object */
739 	offset_t pr_offset;	/* offset into mapped object, if any */
740 	int	pr_mflags;	/* protection and attribute flags (see below) */
741 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
742 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
743 	dev32_t	pr_dev;  /* st_dev from stat64() of mapped object, or PRNODEV */
744 	uint64_t pr_ino; /* st_ino from stat64() of mapped object, if any */
745 	uint32_t pr_rss;	/* pages of resident memory */
746 	uint32_t pr_anon;	/* pages of resident anonymous memory */
747 	uint32_t pr_locked;	/* pages of locked memory */
748 	uint32_t pr_pad;	/* currently unused */
749 	uint64_t pr_hatpagesize; /* pagesize of the hat mapping */
750 	uint32_t pr_filler[6];	/* filler for future expansion */
751 } prxmap32_t;
752 
753 /*
754  * _ILP32 Process credentials.  PCSCRED and /proc/<pid>/cred
755  */
756 typedef struct prcred32 {
757 	uid32_t	pr_euid;	/* effective user id */
758 	uid32_t	pr_ruid;	/* real user id */
759 	uid32_t	pr_suid;	/* saved user id (from exec) */
760 	gid32_t	pr_egid;	/* effective group id */
761 	gid32_t	pr_rgid;	/* real group id */
762 	gid32_t	pr_sgid;	/* saved group id (from exec) */
763 	int	pr_ngroups;	/* number of supplementary groups */
764 	gid32_t	pr_groups[1];	/* array of supplementary groups */
765 } prcred32_t;
766 
767 /*
768  * _ILP32 Watchpoint interface.  PCWATCH and /proc/<pid>/watch
769  */
770 typedef struct prwatch32 {
771 	caddr32_t pr_vaddr;	/* virtual address of watched area */
772 	size32_t pr_size;	/* size of watched area in bytes */
773 	int	pr_wflags;	/* watch type flags */
774 	int	pr_pad;
775 } prwatch32_t;
776 
777 /*
778  * _ILP32 PCREAD/PCWRITE I/O interface.
779  */
780 typedef struct priovec32 {
781 	caddr32_t pio_base;	/* buffer in controlling process */
782 	size32_t pio_len;	/* size of read/write request */
783 	off32_t	pio_offset;	/* virtual address in target process */
784 } priovec32_t;
785 
786 /*
787  * _ILP32 Resource usage.  /proc/<pid>/usage /proc/<pid>/lwp/<lwpid>/lwpusage
788  */
789 typedef struct prusage32 {
790 	id32_t		pr_lwpid;	/* lwp id.  0: process or defunct */
791 	int32_t		pr_count;	/* number of contributing lwps */
792 	timestruc32_t	pr_tstamp;	/* current time stamp */
793 	timestruc32_t	pr_create;	/* process/lwp creation time stamp */
794 	timestruc32_t	pr_term;	/* process/lwp termination time stamp */
795 	timestruc32_t	pr_rtime;	/* total lwp real (elapsed) time */
796 	timestruc32_t	pr_utime;	/* user level cpu time */
797 	timestruc32_t	pr_stime;	/* system call cpu time */
798 	timestruc32_t	pr_ttime;	/* other system trap cpu time */
799 	timestruc32_t	pr_tftime;	/* text page fault sleep time */
800 	timestruc32_t	pr_dftime;	/* data page fault sleep time */
801 	timestruc32_t	pr_kftime;	/* kernel page fault sleep time */
802 	timestruc32_t	pr_ltime;	/* user lock wait sleep time */
803 	timestruc32_t	pr_slptime;	/* all other sleep time */
804 	timestruc32_t	pr_wtime;	/* wait-cpu (latency) time */
805 	timestruc32_t	pr_stoptime;	/* stopped time */
806 	timestruc32_t	filltime[6];	/* filler for future expansion */
807 	uint32_t	pr_minf;	/* minor page faults */
808 	uint32_t	pr_majf;	/* major page faults */
809 	uint32_t	pr_nswap;	/* swaps */
810 	uint32_t	pr_inblk;	/* input blocks */
811 	uint32_t	pr_oublk;	/* output blocks */
812 	uint32_t	pr_msnd;	/* messages sent */
813 	uint32_t	pr_mrcv;	/* messages received */
814 	uint32_t	pr_sigs;	/* signals received */
815 	uint32_t	pr_vctx;	/* voluntary context switches */
816 	uint32_t	pr_ictx;	/* involuntary context switches */
817 	uint32_t	pr_sysc;	/* system calls */
818 	uint32_t	pr_ioch;	/* chars read and written */
819 	uint32_t	filler[10];	/* filler for future expansion */
820 } prusage32_t;
821 
822 /*
823  * _ILP32 Page data file.  /proc/<pid>/pagedata
824  */
825 
826 /* _ILP32 page data file header */
827 typedef struct prpageheader32 {
828 	timestruc32_t	pr_tstamp;	/* real time stamp */
829 	int32_t		pr_nmap;	/* number of address space mappings */
830 	int32_t		pr_npage;	/* total number of pages */
831 } prpageheader32_t;
832 
833 /* _ILP32 page data mapping header */
834 typedef struct prasmap32 {
835 	caddr32_t pr_vaddr;	/* virtual address of mapping */
836 	size32_t pr_npage;	/* number of pages in mapping */
837 	char	pr_mapname[64];	/* name in /proc/<pid>/object */
838 	offset_t pr_offset;	/* offset into mapped object, if any */
839 	int	pr_mflags;	/* protection and attribute flags */
840 	int	pr_pagesize;	/* pagesize (bytes) for this mapping */
841 	int	pr_shmid;	/* SysV shmid, -1 if not SysV shared memory */
842 	int	pr_filler[1];	/* filler for future expansion */
843 } prasmap32_t;
844 
845 /*
846  * _ILP32 Header for /proc/<pid>/lstatus /proc/<pid>/lpsinfo /proc/<pid>/lusage
847  */
848 typedef struct prheader32 {
849 	int32_t	pr_nent;	/* number of entries */
850 	int32_t	pr_entsize;	/* size of each entry, in bytes */
851 } prheader32_t;
852 
853 #endif	/* _SYSCALL32 */
854 
855 #endif	/* !_KERNEL && _STRUCTURED_PROC == 0 */
856 
857 #ifdef	__cplusplus
858 }
859 #endif
860 
861 #endif	/* _SYS_PROCFS_H */
862