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  * Copyright 2006 Sun Microsystems, Inc.  All rights reserved.
  23  * Use is subject to license terms.
  24  */
  25 
  26 /*      Copyright (c) 1984, 1986, 1987, 1988, 1989 AT&T     */
  27 /*        All Rights Reserved   */
  28 
  29 /*
  30  * Copyright (c) 2013, Joyent, Inc. All rights reserved.
  31  */
  32 
  33 #ifndef _SYS_PROC_PRDATA_H
  34 #define _SYS_PROC_PRDATA_H
  35 
  36 #include <sys/isa_defs.h>
  37 #include <sys/proc.h>
  38 #include <sys/vnode.h>
  39 #include <sys/prsystm.h>
  40 #include <sys/model.h>
  41 #include <sys/poll.h>
  42 #include <sys/list.h>
  43 
  44 #ifdef  __cplusplus
  45 extern "C" {
  46 #endif
  47 
  48 /*
  49  * Test for thread being stopped, not on an event of interest,
  50  * but with a directed stop in effect.
  51  */
  52 #define DSTOPPED(t)     \
  53         ((t)->t_state == TS_STOPPED && \
  54         ((t)->t_proc_flag & TP_PRSTOP))
  55 
  56 #define round4(r)       (((r) + 3) & (~3))
  57 #define round8(r)       (((r) + 7) & (~7))
  58 #define round16(r)      (((r) + 15) & (~15))
  59 #define roundlong(r)    (((r) + sizeof (long) - 1) & (~(sizeof (long) - 1)))
  60 
  61 #define PNSIZ   10                      /* max size of /proc name entries */
  62 #define PLNSIZ  10                      /* max size of /proc lwp name entries */
  63 
  64 /*
  65  * Common file object to which all /proc vnodes for a specific process
  66  * or lwp refer.  One for the process, one for each lwp.
  67  */
  68 typedef struct prcommon {
  69         kmutex_t        prc_mutex;      /* to wait for the proc/lwp to stop */
  70         kcondvar_t      prc_wait;       /* to wait for the proc/lwp to stop */
  71         ushort_t        prc_flags;      /* flags */
  72         uint_t          prc_writers;    /* number of write opens of prnodes */
  73         uint_t          prc_selfopens;  /* number of write opens by self */
  74         pid_t           prc_pid;        /* process id */
  75         model_t         prc_datamodel;  /* data model of the process */
  76         proc_t          *prc_proc;      /* process being traced */
  77         kthread_t       *prc_thread;    /* thread (lwp) being traced */
  78         int             prc_slot;       /* procdir slot number */
  79         id_t            prc_tid;        /* thread (lwp) id */
  80         int             prc_tslot;      /* lwpdir slot number, -1 if reaped */
  81         int             prc_refcnt;     /* this structure's reference count */
  82         struct pollhead prc_pollhead;   /* list of all pollers */
  83 } prcommon_t;
  84 
  85 /* prc_flags */
  86 #define PRC_DESTROY     0x01    /* process or lwp is being destroyed */
  87 #define PRC_LWP         0x02    /* structure refers to an lwp */
  88 #define PRC_SYS         0x04    /* process is a system process */
  89 #define PRC_POLL        0x08    /* poll() in progress on this process/lwp */
  90 #define PRC_EXCL        0x10    /* exclusive access granted (old /proc) */
  91 
  92 /*
  93  * Macros for mapping between i-numbers and pids.
  94  */
  95 #define pmkino(tslot, pslot, nodetype)          \
  96         (((((ino_t)(tslot) << nproc_highbit) |    \
  97         (ino_t)(pslot)) << 6) |                   \
  98         (nodetype) + 2)
  99 
 100 /* for old /proc interface */
 101 #define PRBIAS  64
 102 #define ptoi(n) ((int)(((n) + PRBIAS)))         /* pid to i-number */
 103 
 104 /*
 105  * Node types for /proc files (directories and files contained therein).
 106  */
 107 typedef enum prnodetype {
 108         PR_PROCDIR,             /* /proc                                */
 109         PR_SELF,                /* /proc/self                           */
 110         PR_PIDDIR,              /* /proc/<pid>                            */
 111         PR_AS,                  /* /proc/<pid>/as                 */
 112         PR_CTL,                 /* /proc/<pid>/ctl                        */
 113         PR_STATUS,              /* /proc/<pid>/status                     */
 114         PR_LSTATUS,             /* /proc/<pid>/lstatus                    */
 115         PR_PSINFO,              /* /proc/<pid>/psinfo                     */
 116         PR_LPSINFO,             /* /proc/<pid>/lpsinfo                    */
 117         PR_MAP,                 /* /proc/<pid>/map                        */
 118         PR_RMAP,                /* /proc/<pid>/rmap                       */
 119         PR_XMAP,                /* /proc/<pid>/xmap                       */
 120         PR_CRED,                /* /proc/<pid>/cred                       */
 121         PR_SIGACT,              /* /proc/<pid>/sigact                     */
 122         PR_AUXV,                /* /proc/<pid>/auxv                       */
 123 #if defined(__i386) || defined(__amd64)
 124         PR_LDT,                 /* /proc/<pid>/ldt                        */
 125 #endif
 126         PR_USAGE,               /* /proc/<pid>/usage                      */
 127         PR_LUSAGE,              /* /proc/<pid>/lusage                     */
 128         PR_PAGEDATA,            /* /proc/<pid>/pagedata                   */
 129         PR_WATCH,               /* /proc/<pid>/watch                      */
 130         PR_CURDIR,              /* /proc/<pid>/cwd                        */
 131         PR_ROOTDIR,             /* /proc/<pid>/root                       */
 132         PR_FDDIR,               /* /proc/<pid>/fd                 */
 133         PR_FD,                  /* /proc/<pid>/fd/nn                      */
 134         PR_OBJECTDIR,           /* /proc/<pid>/object                     */
 135         PR_OBJECT,              /* /proc/<pid>/object/xxx         */
 136         PR_LWPDIR,              /* /proc/<pid>/lwp                        */
 137         PR_LWPIDDIR,            /* /proc/<pid>/lwp/<lwpid>          */
 138         PR_LWPCTL,              /* /proc/<pid>/lwp/<lwpid>/lwpctl   */
 139         PR_LWPSTATUS,           /* /proc/<pid>/lwp/<lwpid>/lwpstatus        */
 140         PR_LWPSINFO,            /* /proc/<pid>/lwp/<lwpid>/lwpsinfo */
 141         PR_LWPUSAGE,            /* /proc/<pid>/lwp/<lwpid>/lwpusage */
 142         PR_XREGS,               /* /proc/<pid>/lwp/<lwpid>/xregs    */
 143         PR_TMPLDIR,             /* /proc/<pid>/lwp/<lwpid>/templates        */
 144         PR_TMPL,                /* /proc/<pid>/lwp/<lwpid>/templates/<id> */
 145         PR_SPYMASTER,           /* /proc/<pid>/lwp/<lwpid>/spymaster        */
 146 #if defined(__sparc)
 147         PR_GWINDOWS,            /* /proc/<pid>/lwp/<lwpid>/gwindows */
 148         PR_ASRS,                /* /proc/<pid>/lwp/<lwpid>/asrs             */
 149 #endif
 150         PR_PRIV,                /* /proc/<pid>/priv                       */
 151         PR_PATHDIR,             /* /proc/<pid>/path                       */
 152         PR_PATH,                /* /proc/<pid>/path/xxx                   */
 153         PR_CTDIR,               /* /proc/<pid>/contracts          */
 154         PR_CT,                  /* /proc/<pid>/contracts/<ctid>             */
 155         PR_SECFLAGS,            /* /proc/<pid>/secflags                   */
 156         PR_PIDFILE,             /* old process file                     */
 157         PR_LWPIDFILE,           /* old lwp file                         */
 158         PR_OPAGEDATA,           /* old page data file                   */
 159         PR_NFILES               /* number of /proc node types           */
 160 } prnodetype_t;
 161 
 162 typedef struct prnode {
 163         vnode_t         *pr_next;       /* list of all vnodes for process */
 164         uint_t          pr_flags;       /* private flags */
 165         kmutex_t        pr_mutex;       /* locks pr_files and child pr_flags */
 166         prnodetype_t    pr_type;        /* node type */
 167         mode_t          pr_mode;        /* file mode */
 168         ino_t           pr_ino;         /* node id (for stat(2)) */
 169         uint_t          pr_hatid;       /* hat layer id for page data files */
 170         prcommon_t      *pr_common;     /* common data structure */
 171         prcommon_t      *pr_pcommon;    /* process common data structure */
 172         vnode_t         *pr_parent;     /* parent directory */
 173         vnode_t         **pr_files;     /* contained files array (directory) */
 174         uint_t          pr_index;       /* position within parent */
 175         vnode_t         *pr_pidfile;    /* substitute vnode for old /proc */
 176         vnode_t         *pr_realvp;     /* real vnode, file in object,fd dirs */
 177         proc_t          *pr_owner;      /* the process that created this node */
 178         vnode_t         *pr_vnode;      /* pointer to vnode */
 179         struct contract *pr_contract;   /* contract pointer */
 180         int             pr_cttype;      /* active template type */
 181 } prnode_t;
 182 
 183 /*
 184  * Values for pr_flags.
 185  */
 186 #define PR_INVAL        0x01            /* vnode is invalidated */
 187 #define PR_ISSELF       0x02            /* vnode is a self-open */
 188 #define PR_AOUT         0x04            /* vnode is for an a.out path */
 189 #define PR_OFFMAX       0x08            /* vnode is a large file open */
 190 
 191 /*
 192  * Conversion macros.
 193  */
 194 #define VTOP(vp)        ((struct prnode *)(vp)->v_data)
 195 #define PTOV(pnp)       ((pnp)->pr_vnode)
 196 
 197 /*
 198  * Flags to prlock().
 199  */
 200 #define ZNO     0       /* Fail on encountering a zombie process. */
 201 #define ZYES    1       /* Allow zombies. */
 202 
 203 /*
 204  * Assign one set to another (possible different sizes).
 205  *
 206  * Assigning to a smaller set causes members to be lost.
 207  * Assigning to a larger set causes extra members to be cleared.
 208  */
 209 #define prassignset(ap, sp)                                     \
 210 {                                                               \
 211         register int _i_ = sizeof (*(ap))/sizeof (uint32_t);    \
 212         while (--_i_ >= 0)                                   \
 213                 ((uint32_t *)(ap))[_i_] =                       \
 214                     (_i_ >= sizeof (*(sp))/sizeof (uint32_t)) ?      \
 215                     0 : ((uint32_t *)(sp))[_i_];                \
 216 }
 217 
 218 /*
 219  * Determine whether or not a set (of arbitrary size) is empty.
 220  */
 221 #define prisempty(sp) \
 222         setisempty((uint32_t *)(sp), \
 223                 (uint_t)(sizeof (*(sp)) / sizeof (uint32_t)))
 224 
 225 /*
 226  * Resource usage with times as hrtime_t rather than timestruc_t.
 227  * Each member exactly matches the corresponding member in prusage_t.
 228  * This is for convenience of internal computation.
 229  */
 230 typedef struct prhusage {
 231         id_t            pr_lwpid;       /* lwp id.  0: process or defunct */
 232         int             pr_count;       /* number of contributing lwps */
 233         hrtime_t        pr_tstamp;      /* current time stamp */
 234         hrtime_t        pr_create;      /* process/lwp creation time stamp */
 235         hrtime_t        pr_term;        /* process/lwp termination time stamp */
 236         hrtime_t        pr_rtime;       /* total lwp real (elapsed) time */
 237         hrtime_t        pr_utime;       /* user level CPU time */
 238         hrtime_t        pr_stime;       /* system call CPU time */
 239         hrtime_t        pr_ttime;       /* other system trap CPU time */
 240         hrtime_t        pr_tftime;      /* text page fault sleep time */
 241         hrtime_t        pr_dftime;      /* data page fault sleep time */
 242         hrtime_t        pr_kftime;      /* kernel page fault sleep time */
 243         hrtime_t        pr_ltime;       /* user lock wait sleep time */
 244         hrtime_t        pr_slptime;     /* all other sleep time */
 245         hrtime_t        pr_wtime;       /* wait-cpu (latency) time */
 246         hrtime_t        pr_stoptime;    /* stopped time */
 247         hrtime_t        filltime[6];    /* filler for future expansion */
 248         uint64_t        pr_minf;        /* minor page faults */
 249         uint64_t        pr_majf;        /* major page faults */
 250         uint64_t        pr_nswap;       /* swaps */
 251         uint64_t        pr_inblk;       /* input blocks */
 252         uint64_t        pr_oublk;       /* output blocks */
 253         uint64_t        pr_msnd;        /* messages sent */
 254         uint64_t        pr_mrcv;        /* messages received */
 255         uint64_t        pr_sigs;        /* signals received */
 256         uint64_t        pr_vctx;        /* voluntary context switches */
 257         uint64_t        pr_ictx;        /* involuntary context switches */
 258         uint64_t        pr_sysc;        /* system calls */
 259         uint64_t        pr_ioch;        /* chars read and written */
 260         uint64_t        filler[10];     /* filler for future expansion */
 261 } prhusage_t;
 262 
 263 #if defined(_KERNEL)
 264 
 265 /* Exclude system processes from this test */
 266 #define PROCESS_NOT_32BIT(p)    \
 267         (!((p)->p_flag & SSYS) && (p)->p_as != &kas && \
 268         (p)->p_model != DATAMODEL_ILP32)
 269 
 270 extern  int     prnwatch;       /* number of supported watchpoints */
 271 extern  int     nproc_highbit;  /* highbit(v.v_nproc) */
 272 
 273 extern  struct vnodeops *prvnodeops;
 274 
 275 /*
 276  * Generic chained copyout buffers for procfs use.
 277  * In order to prevent procfs from making huge oversize kmem_alloc calls,
 278  * a list of smaller buffers can be concatenated and copied to userspace in
 279  * sequence.
 280  *
 281  * The implementation is opaque.
 282  *
 283  * A user of this will perform the following steps:
 284  *
 285  *      list_t  listhead;
 286  *      struct my *mp;
 287  *
 288  *      pr_iol_initlist(&listhead, sizeof (*mp), n);
 289  *      while (whatever) {
 290  *              mp = pr_iol_newbuf(&listhead, sizeof (*mp);
 291  *              ...
 292  *              error = ...
 293  *      }
 294  *
 295  * When done, depending on whether copyout() or uiomove() is supposed to
 296  * be used for transferring the buffered data to userspace, call either:
 297  *
 298  *      error = pr_iol_copyout_and_free(&listhead, &cmaddr, error);
 299  *
 300  * or else:
 301  *
 302  *      error = pr_iol_uiomove_and_free(&listhead, uiop, error);
 303  *
 304  * These two functions will in any case kmem_free() all list items, but
 305  * if an error occurred before they will not perform the copyout/uiomove.
 306  * If copyout/uiomove are done, the passed target address / uio_t
 307  * are updated. The error returned will either be the one passed in, or
 308  * the error that occurred during copyout/uiomove.
 309  */
 310 
 311 extern  void    pr_iol_initlist(list_t *head, size_t itemsize, int nitems);
 312 extern  void *  pr_iol_newbuf(list_t *head, size_t itemsize);
 313 extern  int     pr_iol_copyout_and_free(list_t *head, caddr_t *tgt, int errin);
 314 extern  int     pr_iol_uiomove_and_free(list_t *head, uio_t *uiop, int errin);
 315 
 316 #if defined(_SYSCALL32_IMPL)
 317 
 318 extern  int     prwritectl32(vnode_t *, struct uio *, cred_t *);
 319 extern  void    prgetaction32(proc_t *, user_t *, uint_t, struct sigaction32 *);
 320 extern  void    prcvtusage32(struct prhusage *, prusage32_t *);
 321 
 322 #endif  /* _SYSCALL32_IMPL */
 323 
 324 /* kludge to support old /proc interface */
 325 #if !defined(_SYS_OLD_PROCFS_H)
 326 extern  int     prgetmap(proc_t *, int, list_t *);
 327 extern  int     prgetxmap(proc_t *, list_t *);
 328 #if defined(_SYSCALL32_IMPL)
 329 extern  int     prgetmap32(proc_t *, int, list_t *);
 330 extern  int     prgetxmap32(proc_t *, list_t *);
 331 #endif  /* _SYSCALL32_IMPL */
 332 #endif /* !_SYS_OLD_PROCFS_H */
 333 
 334 extern  proc_t  *pr_p_lock(prnode_t *);
 335 extern  kthread_t *pr_thread(prnode_t *);
 336 extern  void    pr_stop(prnode_t *);
 337 extern  int     pr_wait_stop(prnode_t *, time_t);
 338 extern  int     pr_setrun(prnode_t *, ulong_t);
 339 extern  int     pr_wait(prcommon_t *, timestruc_t *, int);
 340 extern  void    pr_wait_die(prnode_t *);
 341 extern  int     pr_setsig(prnode_t *, siginfo_t *);
 342 extern  int     pr_kill(prnode_t *, int, cred_t *);
 343 extern  int     pr_unkill(prnode_t *, int);
 344 extern  int     pr_nice(proc_t *, int, cred_t *);
 345 extern  void    pr_setentryexit(proc_t *, sysset_t *, int);
 346 extern  int     pr_set(proc_t *, long);
 347 extern  int     pr_unset(proc_t *, long);
 348 extern  void    pr_sethold(prnode_t *, sigset_t *);
 349 extern  void    pr_setfault(proc_t *, fltset_t *);
 350 extern  int     prusrio(proc_t *, enum uio_rw, struct uio *, int);
 351 extern  int     prwritectl(vnode_t *, struct uio *, cred_t *);
 352 extern  int     prlock(prnode_t *, int);
 353 extern  void    prunmark(proc_t *);
 354 extern  void    prunlock(prnode_t *);
 355 extern  size_t  prpdsize(struct as *);
 356 extern  int     prpdread(proc_t *, uint_t, struct uio *);
 357 extern  size_t  oprpdsize(struct as *);
 358 extern  int     oprpdread(struct as *, uint_t, struct uio *);
 359 extern  void    prgetaction(proc_t *, user_t *, uint_t, struct sigaction *);
 360 extern  void    prgetusage(kthread_t *, struct prhusage *);
 361 extern  void    praddusage(kthread_t *, struct prhusage *);
 362 extern  void    prcvtusage(struct prhusage *, prusage_t *);
 363 extern  void    prscaleusage(prhusage_t *);
 364 extern  kthread_t *prchoose(proc_t *);
 365 extern  void    allsetrun(proc_t *);
 366 extern  int     setisempty(uint32_t *, uint_t);
 367 extern  int     pr_u32tos(uint32_t, char *, int);
 368 extern  vnode_t *prlwpnode(prnode_t *, uint_t);
 369 extern  prnode_t *prgetnode(vnode_t *, prnodetype_t);
 370 extern  void    prfreenode(prnode_t *);
 371 extern  void    pr_object_name(char *, vnode_t *, struct vattr *);
 372 extern  int     set_watched_area(proc_t *, struct watched_area *);
 373 extern  int     clear_watched_area(proc_t *, struct watched_area *);
 374 extern  void    pr_free_watchpoints(proc_t *);
 375 extern  proc_t  *pr_cancel_watch(prnode_t *);
 376 extern  struct seg *break_seg(proc_t *);
 377 
 378 /*
 379  * Machine-dependent routines (defined in prmachdep.c).
 380  */
 381 extern  void    prgetprregs(klwp_t *, prgregset_t);
 382 extern  void    prsetprregs(klwp_t *, prgregset_t, int);
 383 
 384 #if defined(_SYSCALL32_IMPL)
 385 extern  void    prgetprregs32(klwp_t *, prgregset32_t);
 386 extern  void    prgregset_32ton(klwp_t *, prgregset32_t, prgregset_t);
 387 extern  void    prgetprfpregs32(klwp_t *, prfpregset32_t *);
 388 extern  void    prsetprfpregs32(klwp_t *, prfpregset32_t *);
 389 extern  size_t  prpdsize32(struct as *);
 390 extern  int     prpdread32(proc_t *, uint_t, struct uio *);
 391 extern  size_t  oprpdsize32(struct as *);
 392 extern  int     oprpdread32(struct as *, uint_t, struct uio *);
 393 #endif  /* _SYSCALL32_IMPL */
 394 
 395 extern  void    prpokethread(kthread_t *t);
 396 extern  int     prgetrvals(klwp_t *, long *, long *);
 397 extern  void    prgetprfpregs(klwp_t *, prfpregset_t *);
 398 extern  void    prsetprfpregs(klwp_t *, prfpregset_t *);
 399 extern  void    prgetprxregs(klwp_t *, caddr_t);
 400 extern  void    prsetprxregs(klwp_t *, caddr_t);
 401 extern  int     prgetprxregsize(proc_t *);
 402 extern  int     prhasfp(void);
 403 extern  int     prhasx(proc_t *);
 404 extern  caddr_t prgetstackbase(proc_t *);
 405 extern  caddr_t prgetpsaddr(proc_t *);
 406 extern  int     prisstep(klwp_t *);
 407 extern  void    prsvaddr(klwp_t *, caddr_t);
 408 extern  int     prfetchinstr(klwp_t *, ulong_t *);
 409 extern  ushort_t prgetpctcpu(uint64_t);
 410 
 411 #endif  /* _KERNEL */
 412 
 413 #ifdef  __cplusplus
 414 }
 415 #endif
 416 
 417 #endif  /* _SYS_PROC_PRDATA_H */