include/sys/procfs.h

   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  * Copyright 2014 Garrett D'Amore <garrett@damore.org>
  29  */
  30
  31 #ifndef _SYS_PROCFS_H
  32 #define _SYS_PROCFS_H
  33
  34 #ifdef  __cplusplus
  35 extern "C" {
  36 #endif
  37
  38 /*
  39  * This definition is temporary.  Structured proc is the preferred API,
  40  * and the older ioctl-based interface will be removed in a future version
  41  * of Solaris.  Until then, by default, including <sys/procfs.h> will
  42  * provide the older ioctl-based /proc definitions.  To get the structured
  43  * /proc definitions, either include <procfs.h> or define _STRUCTURED_PROC
  44  * to be 1 before including <sys/procfs.h>.
  45  */
  46 #ifndef _STRUCTURED_PROC
  47 #define _STRUCTURED_PROC        0
  48 #endif
  49
  50 #if !defined(_KERNEL) && _STRUCTURED_PROC == 0
  51
  52 #include <sys/old_procfs.h>
  53
  54 #else   /* !defined(_KERNEL) && _STRUCTURED_PROC == 0 */
  55
  56 #include <sys/feature_tests.h>
  57 #include <sys/types.h>
  58 #include <sys/time_impl.h>
  59 #include <sys/signal.h>
  60 #include <sys/siginfo.h>
  61 #include <sys/fault.h>
  62 #include <sys/syscall.h>
  63 #include <sys/pset.h>
  64 #include <sys/procfs_isa.h>
  65 #include <sys/priv.h>
  66 #include <sys/stat.h>
  67 #include <sys/param.h>
  68 #include <sys/secflags.h>
  69
  70 /*
  71  * System call interfaces for /proc.
  72  */
  73
  74 /*
  75  * Control codes (long values) for messages written to ctl and lwpctl files.
  76  */
  77 #define PCNULL   0L     /* null request, advance to next message */
  78 #define PCSTOP   1L     /* direct process or lwp to stop and wait for stop */
  79 #define PCDSTOP  2L     /* direct process or lwp to stop */
  80 #define PCWSTOP  3L     /* wait for process or lwp to stop, no timeout */
  81 #define PCTWSTOP 4L     /* wait for stop, with long millisecond timeout arg */
  82 #define PCRUN    5L     /* make process/lwp runnable, w/ long flags argument */
  83 #define PCCSIG   6L     /* clear current signal from lwp */
  84 #define PCCFAULT 7L     /* clear current fault from lwp */
  85 #define PCSSIG   8L     /* set current signal from siginfo_t argument */
  86 #define PCKILL   9L     /* post a signal to process/lwp, long argument */
  87 #define PCUNKILL 10L    /* delete a pending signal from process/lwp, long arg */
  88 #define PCSHOLD  11L    /* set lwp signal mask from sigset_t argument */
  89 #define PCSTRACE 12L    /* set traced signal set from sigset_t argument */
  90 #define PCSFAULT 13L    /* set traced fault set from fltset_t argument */
  91 #define PCSENTRY 14L    /* set traced syscall entry set from sysset_t arg */
  92 #define PCSEXIT  15L    /* set traced syscall exit set from sysset_t arg */
  93 #define PCSET    16L    /* set modes from long argument */
  94 #define PCUNSET  17L    /* unset modes from long argument */
  95 #define PCSREG   18L    /* set lwp general registers from prgregset_t arg */
  96 #define PCSFPREG 19L    /* set lwp floating-point registers from prfpregset_t */
  97 #define PCSXREG  20L    /* set lwp extra registers from prxregset_t arg */
  98 #define PCNICE   21L    /* set nice priority from long argument */
  99 #define PCSVADDR 22L    /* set %pc virtual address from long argument */
 100 #define PCWATCH  23L    /* set/unset watched memory area from prwatch_t arg */
 101 #define PCAGENT  24L    /* create agent lwp with regs from prgregset_t arg */
 102 #define PCREAD   25L    /* read from the address space via priovec_t arg */
 103 #define PCWRITE  26L    /* write to the address space via priovec_t arg */
 104 #define PCSCRED  27L    /* set process credentials from prcred_t argument */
 105 #define PCSASRS  28L    /* set ancillary state registers from asrset_t arg */
 106 #define PCSPRIV  29L    /* set process privileges from prpriv_t argument */
 107 #define PCSZONE  30L    /* set zoneid from zoneid_t argument */
 108 #define PCSCREDX 31L    /* as PCSCRED but with supplemental groups */
 109 /*
 110  * PCRUN long operand flags.
 111  */
 112 #define PRCSIG          0x01    /* clear current signal, if any */
 113 #define PRCFAULT        0x02    /* clear current fault, if any */
 114 #define PRSTEP          0x04    /* direct the lwp to single-step */
 115 #define PRSABORT        0x08    /* abort syscall, if in syscall */
 116 #define PRSTOP          0x10    /* set directed stop request */
 117
 118 /*
 119  * lwp status file.  /proc/<pid>/lwp/<lwpid>/lwpstatus
 120  */
 121 #define PRCLSZ          8       /* maximum size of scheduling class name */
 122 #define PRSYSARGS       8       /* maximum number of syscall arguments */
 123 typedef struct lwpstatus {
 124         int     pr_flags;       /* flags (see below) */
 125         id_t    pr_lwpid;       /* specific lwp identifier */
 126         short   pr_why;         /* reason for lwp stop, if stopped */
 127         short   pr_what;        /* more detailed reason */
 128         short   pr_cursig;      /* current signal, if any */
 129         short   pr_pad1;
 130         siginfo_t pr_info;      /* info associated with signal or fault */
 131         sigset_t pr_lwppend;    /* set of signals pending to the lwp */
 132         sigset_t pr_lwphold;    /* set of signals blocked by the lwp */
 133         struct sigaction pr_action;     /* signal action for current signal */
 134         stack_t pr_altstack;    /* alternate signal stack info */
 135         uintptr_t pr_oldcontext;        /* address of previous ucontext */
 136         short   pr_syscall;     /* system call number (if in syscall) */
 137         short   pr_nsysarg;     /* number of arguments to this syscall */
 138         int     pr_errno;       /* errno for failed syscall, 0 if successful */
 139         long    pr_sysarg[PRSYSARGS];   /* arguments to this syscall */
 140         long    pr_rval1;       /* primary syscall return value */
 141         long    pr_rval2;       /* second syscall return value, if any */
 142         char    pr_clname[PRCLSZ];      /* scheduling class name */
 143         timestruc_t pr_tstamp;  /* real-time time stamp of stop */
 144         timestruc_t pr_utime;   /* lwp user cpu time */
 145         timestruc_t pr_stime;   /* lwp system cpu time */
 146         int     pr_filler[11 - 2 * sizeof (timestruc_t) / sizeof (int)];
 147         int     pr_errpriv;     /* missing privilege */
 148         uintptr_t pr_ustack;    /* address of stack boundary data (stack_t) */
 149         ulong_t pr_instr;       /* current instruction */
 150         prgregset_t pr_reg;     /* general registers */
 151         prfpregset_t pr_fpreg;  /* floating-point registers */
 152 } lwpstatus_t;
 153
 154 /*
 155  * process status file.  /proc/<pid>/status
 156  */
 157 typedef struct pstatus {
 158         int     pr_flags;       /* flags (see below) */
 159         int     pr_nlwp;        /* number of active lwps in the process */
 160         pid_t   pr_pid;         /* process id */
 161         pid_t   pr_ppid;        /* parent process id */
 162         pid_t   pr_pgid;        /* process group id */
 163         pid_t   pr_sid;         /* session id */
 164         id_t    pr_aslwpid;     /* historical; now always zero */
 165         id_t    pr_agentid;     /* lwp id of the /proc agent lwp, if any */
 166         sigset_t pr_sigpend;    /* set of process pending signals */
 167         uintptr_t pr_brkbase;   /* address of the process heap */
 168         size_t  pr_brksize;     /* size of the process heap, in bytes */
 169         uintptr_t pr_stkbase;   /* address of the process stack */
 170         size_t  pr_stksize;     /* size of the process stack, in bytes */
 171         timestruc_t pr_utime;   /* process user cpu time */
 172         timestruc_t pr_stime;   /* process system cpu time */
 173         timestruc_t pr_cutime;  /* sum of children's user times */
 174         timestruc_t pr_cstime;  /* sum of children's system times */
 175         sigset_t pr_sigtrace;   /* set of traced signals */
 176         fltset_t pr_flttrace;   /* set of traced faults */
 177         sysset_t pr_sysentry;   /* set of system calls traced on entry */
 178         sysset_t pr_sysexit;    /* set of system calls traced on exit */
 179         char    pr_dmodel;      /* data model of the process (see below) */
 180         char    pr_pad[3];
 181         taskid_t pr_taskid;     /* task id */
 182         projid_t pr_projid;     /* project id */
 183         int     pr_nzomb;       /* number of zombie lwps in the process */
 184         zoneid_t pr_zoneid;     /* zone id */
 185         int     pr_filler[15];  /* 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 #define PRSECFLAGS_VERSION_1            1
 404 #define PRSECFLAGS_VERSION_CURRENT      PRSECFLAGS_VERSION_1
 405 typedef struct prsecflags {
 406         uint32_t pr_version;
 407         char pr_pad[4];
 408         secflagset_t pr_effective;
 409         secflagset_t pr_inherit;
 410         secflagset_t pr_lower;
 411         secflagset_t pr_upper;
 412 } prsecflags_t;
 413
 414 /*
 415  * Watchpoint interface.  PCWATCH and /proc/<pid>/watch
 416  */
 417 typedef struct prwatch {
 418         uintptr_t pr_vaddr;     /* virtual address of watched area */
 419         size_t  pr_size;        /* size of watched area in bytes */
 420         int     pr_wflags;      /* watch type flags */
 421         int     pr_pad;
 422 } prwatch_t;
 423
 424 /* pr_wflags */
 425 #define WA_READ         0x04    /* trap on read access */
 426 #define WA_WRITE        0x02    /* trap on write access */
 427 #define WA_EXEC         0x01    /* trap on execute access */
 428 #define WA_TRAPAFTER    0x08    /* trap after instruction completes */
 429
 430 /*
 431  * PCREAD/PCWRITE I/O interface.
 432  */
 433 typedef struct priovec {
 434         void    *pio_base;      /* buffer in controlling process */
 435         size_t  pio_len;        /* size of read/write request */
 436         off_t   pio_offset;     /* virtual address in target process */
 437 } priovec_t;
 438
 439 /*
 440  * Resource usage.  /proc/<pid>/usage /proc/<pid>/lwp/<lwpid>/lwpusage
 441  */
 442 typedef struct prusage {
 443         id_t            pr_lwpid;       /* lwp id.  0: process or defunct */
 444         int             pr_count;       /* number of contributing lwps */
 445         timestruc_t     pr_tstamp;      /* current time stamp */
 446         timestruc_t     pr_create;      /* process/lwp creation time stamp */
 447         timestruc_t     pr_term;        /* process/lwp termination time stamp */
 448         timestruc_t     pr_rtime;       /* total lwp real (elapsed) time */
 449         timestruc_t     pr_utime;       /* user level cpu time */
 450         timestruc_t     pr_stime;       /* system call cpu time */
 451         timestruc_t     pr_ttime;       /* other system trap cpu time */
 452         timestruc_t     pr_tftime;      /* text page fault sleep time */
 453         timestruc_t     pr_dftime;      /* data page fault sleep time */
 454         timestruc_t     pr_kftime;      /* kernel page fault sleep time */
 455         timestruc_t     pr_ltime;       /* user lock wait sleep time */
 456         timestruc_t     pr_slptime;     /* all other sleep time */
 457         timestruc_t     pr_wtime;       /* wait-cpu (latency) time */
 458         timestruc_t     pr_stoptime;    /* stopped time */
 459         timestruc_t     filltime[6];    /* filler for future expansion */
 460         ulong_t         pr_minf;        /* minor page faults */
 461         ulong_t         pr_majf;        /* major page faults */
 462         ulong_t         pr_nswap;       /* swaps */
 463         ulong_t         pr_inblk;       /* input blocks */
 464         ulong_t         pr_oublk;       /* output blocks */
 465         ulong_t         pr_msnd;        /* messages sent */
 466         ulong_t         pr_mrcv;        /* messages received */
 467         ulong_t         pr_sigs;        /* signals received */
 468         ulong_t         pr_vctx;        /* voluntary context switches */
 469         ulong_t         pr_ictx;        /* involuntary context switches */
 470         ulong_t         pr_sysc;        /* system calls */
 471         ulong_t         pr_ioch;        /* chars read and written */
 472         ulong_t         filler[10];     /* filler for future expansion */
 473 } prusage_t;
 474
 475 /*
 476  * Page data file.  /proc/<pid>/pagedata
 477  */
 478
 479 /* page data file header */
 480 typedef struct prpageheader {
 481         timestruc_t     pr_tstamp;      /* real time stamp */
 482         long            pr_nmap;        /* number of address space mappings */
 483         long            pr_npage;       /* total number of pages */
 484 } prpageheader_t;
 485
 486 /* page data mapping header */
 487 typedef struct prasmap {
 488         uintptr_t pr_vaddr;     /* virtual address of mapping */
 489         size_t  pr_npage;       /* number of pages in mapping */
 490         char    pr_mapname[PRMAPSZ];    /* name in /proc/<pid>/object */
 491         offset_t pr_offset;     /* offset into mapped object, if any */
 492         int     pr_mflags;      /* protection and attribute flags */
 493         int     pr_pagesize;    /* pagesize (bytes) for this mapping */
 494         int     pr_shmid;       /* SysV shmid, -1 if not SysV shared memory */
 495         int     pr_filler[1];   /* filler for future expansion */
 496 } prasmap_t;
 497
 498 /*
 499  * pr_npage bytes (plus 0-7 null bytes to round up to an 8-byte boundary)
 500  * follow each mapping header, each containing zero or more of these flags.
 501  */
 502 #define PG_REFERENCED   0x02            /* page referenced since last read */
 503 #define PG_MODIFIED     0x01            /* page modified since last read */
 504 #define PG_HWMAPPED     0x04            /* page is present and mapped */
 505
 506 /*
 507  * Open files.  Only in core files (for now).  Note that we'd like to use
 508  * the stat or stat64 structure, but both of these structures are unfortunately
 509  * not consistent between 32 and 64 bit modes.  To keep our lives simpler, we
 510  * just define our own structure with types that are not sensitive to this
 511  * difference.  Also, it turns out that pfiles omits a lot of info from the
 512  * struct stat (e.g. times, device sizes, etc.) so we don't bother adding those
 513  * here.
 514  */
 515 typedef struct prfdinfo {
 516         int             pr_fd;
 517         mode_t          pr_mode;
 518
 519         uid_t           pr_uid;
 520         gid_t           pr_gid;
 521
 522         major_t         pr_major;       /* think stat.st_dev */
 523         minor_t         pr_minor;
 524
 525         major_t         pr_rmajor;      /* think stat.st_rdev */
 526         minor_t         pr_rminor;
 527
 528         ino64_t         pr_ino;
 529         off64_t         pr_offset;
 530         off64_t         pr_size;
 531
 532         int             pr_fileflags;   /* fcntl(F_GETXFL), etc */
 533         int             pr_fdflags;     /* fcntl(F_GETFD), etc. */
 534
 535         char            pr_path[MAXPATHLEN];
 536 } prfdinfo_t;
 537
 538 /*
 539  * Header for /proc/<pid>/lstatus /proc/<pid>/lpsinfo /proc/<pid>/lusage
 540  */
 541 typedef struct prheader {
 542         long    pr_nent;        /* number of entries */
 543         long    pr_entsize;     /* size of each entry, in bytes */
 544 } prheader_t;
 545
 546 /*
 547  * Macros for manipulating sets of flags.
 548  * sp must be a pointer to one of sigset_t, fltset_t, or sysset_t.
 549  * flag must be a member of the enumeration corresponding to *sp.
 550  */
 551
 552 /* turn on all flags in set */
 553 #define prfillset(sp) \
 554         { register int _i_ = sizeof (*(sp))/sizeof (uint32_t); \
 555                 while (_i_) ((uint32_t *)(sp))[--_i_] = (uint32_t)0xFFFFFFFF; }
 556
 557 /* turn off all flags in set */
 558 #define premptyset(sp) \
 559         { register int _i_ = sizeof (*(sp))/sizeof (uint32_t); \
 560                 while (_i_) ((uint32_t *)(sp))[--_i_] = (uint32_t)0; }
 561
 562 /* turn on specified flag in set */
 563 #define praddset(sp, flag) \
 564         ((void)(((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) ? \
 565         (((uint32_t *)(sp))[((flag)-1)/32] |= (1U<<(((flag)-1)%32))) : 0))
 566
 567 /* turn off specified flag in set */
 568 #define prdelset(sp, flag) \
 569         ((void)(((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) ? \
 570             (((uint32_t *)(sp))[((flag)-1)/32] &= ~(1U<<(((flag)-1)%32))) : 0))
 571
 572 /* query: != 0 iff flag is turned on in set */
 573 #define prismember(sp, flag) \
 574         (((unsigned)((flag)-1) < 32*sizeof (*(sp))/sizeof (uint32_t)) && \
 575             (((uint32_t *)(sp))[((flag)-1)/32] & (1U<<(((flag)-1)%32))))
 576
 577 #if defined(_SYSCALL32)
 578
 579 /*
 580  * dev32_t version of PRNODEV
 581  */
 582 #define PRNODEV32 (dev32_t)(-1)
 583
 584 /*
 585  * Kernel view of /proc structures for _ILP32 programs.
 586  */
 587
 588 /*
 589  * _ILP32 lwp status file.  /proc/<pid>/lwp/<lwpid>/lwpstatus
 590  */
 591 typedef struct lwpstatus32 {
 592         int     pr_flags;       /* flags */
 593         id32_t  pr_lwpid;       /* specific lwp identifier */
 594         short   pr_why;         /* reason for lwp stop, if stopped */
 595         short   pr_what;        /* more detailed reason */
 596         short   pr_cursig;      /* current signal, if any */
 597         short   pr_pad1;
 598         siginfo32_t pr_info;    /* info associated with signal or fault */
 599         sigset_t pr_lwppend;    /* set of signals pending to the lwp */
 600         sigset_t pr_lwphold;    /* set of signals blocked by the lwp */
 601         struct sigaction32 pr_action;   /* signal action for current signal */
 602         stack32_t pr_altstack;  /* alternate signal stack info */
 603         caddr32_t pr_oldcontext;        /* address of previous ucontext */
 604         short   pr_syscall;     /* system call number (if in syscall) */
 605         short   pr_nsysarg;     /* number of arguments to this syscall */
 606         int     pr_errno;       /* errno for failed syscall, 0 if successful */
 607         int32_t pr_sysarg[PRSYSARGS];   /* arguments to this syscall */
 608         int32_t pr_rval1;       /* primary syscall return value */
 609         int32_t pr_rval2;       /* second syscall return value, if any */
 610         char    pr_clname[PRCLSZ];      /* scheduling class name */
 611         timestruc32_t pr_tstamp;        /* real-time time stamp of stop */
 612         timestruc32_t pr_utime; /* lwp user cpu time */
 613         timestruc32_t pr_stime; /* lwp system cpu time */
 614         int     pr_filler[11 - 2 * sizeof (timestruc32_t) / sizeof (int)];
 615         int     pr_errpriv;     /* missing privilege */
 616         caddr32_t pr_ustack;    /* address of stack boundary data (stack32_t) */
 617         uint32_t pr_instr;      /* current instruction */
 618         prgregset32_t pr_reg;   /* general registers */
 619         prfpregset32_t pr_fpreg; /* floating-point registers */
 620 } lwpstatus32_t;
 621
 622 /*
 623  * _ILP32 process status file.  /proc/<pid>/status
 624  */
 625 typedef struct pstatus32 {
 626         int     pr_flags;       /* flags */
 627         int     pr_nlwp;        /* number of active lwps in the process */
 628         pid32_t pr_pid;         /* process id */
 629         pid32_t pr_ppid;        /* parent process id */
 630         pid32_t pr_pgid;        /* process group id */
 631         pid32_t pr_sid;         /* session id */
 632         id32_t  pr_aslwpid;     /* historical; now always zero */
 633         id32_t  pr_agentid;     /* lwp id of the /proc agent lwp, if any */
 634         sigset_t pr_sigpend;    /* set of process pending signals */
 635         caddr32_t pr_brkbase;   /* address of the process heap */
 636         size32_t pr_brksize;    /* size of the process heap, in bytes */
 637         caddr32_t pr_stkbase;   /* address of the process stack */
 638         size32_t pr_stksize;    /* size of the process stack, in bytes */
 639         timestruc32_t pr_utime; /* process user cpu time */
 640         timestruc32_t pr_stime; /* process system cpu time */
 641         timestruc32_t pr_cutime;        /* sum of children's user times */
 642         timestruc32_t pr_cstime;        /* sum of children's system times */
 643         sigset_t pr_sigtrace;   /* set of traced signals */
 644         fltset_t pr_flttrace;   /* set of traced faults */
 645         sysset_t pr_sysentry;   /* set of system calls traced on entry */
 646         sysset_t pr_sysexit;    /* set of system calls traced on exit */
 647         char    pr_dmodel;      /* data model of the process */
 648         char    pr_pad[3];
 649         id32_t  pr_taskid;      /* task id */
 650         id32_t  pr_projid;      /* project id */
 651         int     pr_nzomb;       /* number of zombie lwps in the process */
 652         id32_t  pr_zoneid;      /* zone id */
 653         int     pr_filler[15];  /* reserved for future use */
 654         lwpstatus32_t pr_lwp;   /* status of the representative lwp */
 655 } pstatus32_t;
 656
 657 /*
 658  * _ILP32 lwp ps(1) information file.  /proc/<pid>/lwp/<lwpid>/lwpsinfo
 659  */
 660 typedef struct lwpsinfo32 {
 661         int     pr_flag;        /* lwp flags */
 662         id32_t  pr_lwpid;       /* lwp id */
 663         caddr32_t pr_addr;      /* internal address of lwp */
 664         caddr32_t pr_wchan;     /* wait addr for sleeping lwp */
 665         char    pr_stype;       /* synchronization event type */
 666         char    pr_state;       /* numeric lwp state */
 667         char    pr_sname;       /* printable character for pr_state */
 668         char    pr_nice;        /* nice for cpu usage */
 669         short   pr_syscall;     /* system call number (if in syscall) */
 670         char    pr_oldpri;      /* pre-SVR4, low value is high priority */
 671         char    pr_cpu;         /* pre-SVR4, cpu usage for scheduling */
 672         int     pr_pri;         /* priority, high value is high priority */
 673                         /* The following percent number is a 16-bit binary */
 674                         /* fraction [0 .. 1] with the binary point to the */
 675                         /* right of the high-order bit (1.0 == 0x8000) */
 676         ushort_t pr_pctcpu;     /* % of recent cpu time used by this lwp */
 677         ushort_t pr_pad;
 678         timestruc32_t pr_start; /* lwp start time, from the epoch */
 679         timestruc32_t pr_time;  /* usr+sys cpu time for this lwp */
 680         char    pr_clname[PRCLSZ];      /* scheduling class name */
 681         char    pr_name[PRFNSZ];        /* name of system lwp */
 682         processorid_t pr_onpro;         /* processor which last ran this lwp */
 683         processorid_t pr_bindpro;       /* processor to which lwp is bound */
 684         psetid_t pr_bindpset;   /* processor set to which lwp is bound */
 685         int     pr_lgrp;        /* lwp home lgroup */
 686         int     pr_filler[4];   /* reserved for future use */
 687 } lwpsinfo32_t;
 688
 689 /*
 690  * _ILP32 process ps(1) information file.  /proc/<pid>/psinfo
 691  */
 692 typedef struct psinfo32 {
 693         int     pr_flag;        /* process flags */
 694         int     pr_nlwp;        /* number of active lwps in the process */
 695         pid32_t pr_pid;         /* unique process id */
 696         pid32_t pr_ppid;        /* process id of parent */
 697         pid32_t pr_pgid;        /* pid of process group leader */
 698         pid32_t pr_sid;         /* session id */
 699         uid32_t pr_uid;         /* real user id */
 700         uid32_t pr_euid;        /* effective user id */
 701         gid32_t pr_gid;         /* real group id */
 702         gid32_t pr_egid;        /* effective group id */
 703         caddr32_t pr_addr;      /* address of process */
 704         size32_t pr_size;       /* size of process image in Kbytes */
 705         size32_t pr_rssize;     /* resident set size in Kbytes */
 706         size32_t pr_pad1;
 707         dev32_t pr_ttydev;      /* controlling tty device (or PRNODEV) */
 708         ushort_t pr_pctcpu;     /* % of recent cpu time used by all lwps */
 709         ushort_t pr_pctmem;     /* % of system memory used by process */
 710         timestruc32_t pr_start; /* process start time, from the epoch */
 711         timestruc32_t pr_time;  /* usr+sys cpu time for this process */
 712         timestruc32_t pr_ctime; /* usr+sys cpu time for reaped children */
 713         char    pr_fname[PRFNSZ];       /* name of execed file */
 714         char    pr_psargs[PRARGSZ];     /* initial characters of arg list */
 715         int     pr_wstat;       /* if zombie, the wait() status */
 716         int     pr_argc;        /* initial argument count */
 717         caddr32_t pr_argv;      /* address of initial argument vector */
 718         caddr32_t pr_envp;      /* address of initial environment vector */
 719         char    pr_dmodel;      /* data model of the process */
 720         char    pr_pad2[3];
 721         id32_t  pr_taskid;      /* task id */
 722         id32_t  pr_projid;      /* project id */
 723         int     pr_nzomb;       /* number of zombie lwps in the process */
 724         id32_t  pr_poolid;      /* pool id */
 725         id32_t  pr_zoneid;      /* zone id */
 726         id32_t  pr_contract;    /* process contract */
 727         int     pr_filler[1];   /* reserved for future use */
 728         lwpsinfo32_t pr_lwp;    /* information for representative lwp */
 729 } psinfo32_t;
 730
 731 /*
 732  * _ILP32 Memory-management interface.  /proc/<pid>/map /proc/<pid>/rmap
 733  */
 734 typedef struct prmap32 {
 735         caddr32_t pr_vaddr;     /* virtual address of mapping */
 736         size32_t pr_size;       /* size of mapping in bytes */
 737         char    pr_mapname[64]; /* name in /proc/<pid>/object */
 738         offset_t pr_offset;     /* offset into mapped object, if any */
 739         int     pr_mflags;      /* protection and attribute flags */
 740         int     pr_pagesize;    /* pagesize (bytes) for this mapping */
 741         int     pr_shmid;       /* SysV shmid, -1 if not SysV shared memory */
 742         int     pr_filler[1];   /* filler for future expansion */
 743 } prmap32_t;
 744
 745 /*
 746  * _ILP32 HAT memory-map interface.  /proc/<pid>/xmap
 747  */
 748 typedef struct prxmap32 {
 749         caddr32_t pr_vaddr;     /* virtual address of mapping */
 750         size32_t pr_size;       /* size of mapping in bytes */
 751         char    pr_mapname[PRMAPSZ];    /* name in /proc/<pid>/object */
 752         offset_t pr_offset;     /* offset into mapped object, if any */
 753         int     pr_mflags;      /* protection and attribute flags (see below) */
 754         int     pr_pagesize;    /* pagesize (bytes) for this mapping */
 755         int     pr_shmid;       /* SysV shmid, -1 if not SysV shared memory */
 756         dev32_t pr_dev;  /* st_dev from stat64() of mapped object, or PRNODEV */
 757         uint64_t pr_ino; /* st_ino from stat64() of mapped object, if any */
 758         uint32_t pr_rss;        /* pages of resident memory */
 759         uint32_t pr_anon;       /* pages of resident anonymous memory */
 760         uint32_t pr_locked;     /* pages of locked memory */
 761         uint32_t pr_pad;        /* currently unused */
 762         uint64_t pr_hatpagesize; /* pagesize of the hat mapping */
 763         uint32_t pr_filler[6];  /* filler for future expansion */
 764 } prxmap32_t;
 765
 766 /*
 767  * _ILP32 Process credentials.  PCSCRED and /proc/<pid>/cred
 768  */
 769 typedef struct prcred32 {
 770         uid32_t pr_euid;        /* effective user id */
 771         uid32_t pr_ruid;        /* real user id */
 772         uid32_t pr_suid;        /* saved user id (from exec) */
 773         gid32_t pr_egid;        /* effective group id */
 774         gid32_t pr_rgid;        /* real group id */
 775         gid32_t pr_sgid;        /* saved group id (from exec) */
 776         int     pr_ngroups;     /* number of supplementary groups */
 777         gid32_t pr_groups[1];   /* array of supplementary groups */
 778 } prcred32_t;
 779
 780 /*
 781  * _ILP32 Watchpoint interface.  PCWATCH and /proc/<pid>/watch
 782  */
 783 typedef struct prwatch32 {
 784         caddr32_t pr_vaddr;     /* virtual address of watched area */
 785         size32_t pr_size;       /* size of watched area in bytes */
 786         int     pr_wflags;      /* watch type flags */
 787         int     pr_pad;
 788 } prwatch32_t;
 789
 790 /*
 791  * _ILP32 PCREAD/PCWRITE I/O interface.
 792  */
 793 typedef struct priovec32 {
 794         caddr32_t pio_base;     /* buffer in controlling process */
 795         size32_t pio_len;       /* size of read/write request */
 796         off32_t pio_offset;     /* virtual address in target process */
 797 } priovec32_t;
 798
 799 /*
 800  * _ILP32 Resource usage.  /proc/<pid>/usage /proc/<pid>/lwp/<lwpid>/lwpusage
 801  */
 802 typedef struct prusage32 {
 803         id32_t          pr_lwpid;       /* lwp id.  0: process or defunct */
 804         int32_t         pr_count;       /* number of contributing lwps */
 805         timestruc32_t   pr_tstamp;      /* current time stamp */
 806         timestruc32_t   pr_create;      /* process/lwp creation time stamp */
 807         timestruc32_t   pr_term;        /* process/lwp termination time stamp */
 808         timestruc32_t   pr_rtime;       /* total lwp real (elapsed) time */
 809         timestruc32_t   pr_utime;       /* user level cpu time */
 810         timestruc32_t   pr_stime;       /* system call cpu time */
 811         timestruc32_t   pr_ttime;       /* other system trap cpu time */
 812         timestruc32_t   pr_tftime;      /* text page fault sleep time */
 813         timestruc32_t   pr_dftime;      /* data page fault sleep time */
 814         timestruc32_t   pr_kftime;      /* kernel page fault sleep time */
 815         timestruc32_t   pr_ltime;       /* user lock wait sleep time */
 816         timestruc32_t   pr_slptime;     /* all other sleep time */
 817         timestruc32_t   pr_wtime;       /* wait-cpu (latency) time */
 818         timestruc32_t   pr_stoptime;    /* stopped time */
 819         timestruc32_t   filltime[6];    /* filler for future expansion */
 820         uint32_t        pr_minf;        /* minor page faults */
 821         uint32_t        pr_majf;        /* major page faults */
 822         uint32_t        pr_nswap;       /* swaps */
 823         uint32_t        pr_inblk;       /* input blocks */
 824         uint32_t        pr_oublk;       /* output blocks */
 825         uint32_t        pr_msnd;        /* messages sent */
 826         uint32_t        pr_mrcv;        /* messages received */
 827         uint32_t        pr_sigs;        /* signals received */
 828         uint32_t        pr_vctx;        /* voluntary context switches */
 829         uint32_t        pr_ictx;        /* involuntary context switches */
 830         uint32_t        pr_sysc;        /* system calls */
 831         uint32_t        pr_ioch;        /* chars read and written */
 832         uint32_t        filler[10];     /* filler for future expansion */
 833 } prusage32_t;
 834
 835 /*
 836  * _ILP32 Page data file.  /proc/<pid>/pagedata
 837  */
 838
 839 /* _ILP32 page data file header */
 840 typedef struct prpageheader32 {
 841         timestruc32_t   pr_tstamp;      /* real time stamp */
 842         int32_t         pr_nmap;        /* number of address space mappings */
 843         int32_t         pr_npage;       /* total number of pages */
 844 } prpageheader32_t;
 845
 846 /* _ILP32 page data mapping header */
 847 typedef struct prasmap32 {
 848         caddr32_t pr_vaddr;     /* virtual address of mapping */
 849         size32_t pr_npage;      /* number of pages in mapping */
 850         char    pr_mapname[64]; /* name in /proc/<pid>/object */
 851         offset_t pr_offset;     /* offset into mapped object, if any */
 852         int     pr_mflags;      /* protection and attribute flags */
 853         int     pr_pagesize;    /* pagesize (bytes) for this mapping */
 854         int     pr_shmid;       /* SysV shmid, -1 if not SysV shared memory */
 855         int     pr_filler[1];   /* filler for future expansion */
 856 } prasmap32_t;
 857
 858 /*
 859  * _ILP32 Header for /proc/<pid>/lstatus /proc/<pid>/lpsinfo /proc/<pid>/lusage
 860  */
 861 typedef struct prheader32 {
 862         int32_t pr_nent;        /* number of entries */
 863         int32_t pr_entsize;     /* size of each entry, in bytes */
 864 } prheader32_t;
 865
 866 #endif  /* _SYSCALL32 */
 867
 868 #endif  /* !_KERNEL && _STRUCTURED_PROC == 0 */
 869
 870 #ifdef  __cplusplus
 871 }
 872 #endif
 873
 874 #endif  /* _SYS_PROCFS_H */