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