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