usr/src/uts/common/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  */
  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 */