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