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 2009 Sun Microsystems, Inc.  All rights reserved.
  24  * Use is subject to license terms.
  25  *
  26  * Portions Copyright 2009 Chad Mynhier
  27  */
  28 
  29 #ifndef _PRSTAT_H
  30 #define _PRSTAT_H
  31 
  32 #include <sys/sysmacros.h>
  33 #include <sys/time.h>
  34 #include <sys/types.h>
  35 #include <procfs.h>
  36 
  37 #ifdef  __cplusplus
  38 extern "C" {
  39 #endif
  40 
  41 /*
  42  * FRC2PCT macro is used to convert 16-bit binary fractions in the range
  43  * 0.0 to 1.0 with binary point to the right of the high order bit
  44  * (i.e. 1.0 == 0x8000) to percentage value.
  45  */
  46 
  47 #define FRC2PCT(pp)     (((float)(pp))/0x8000*100)
  48 
  49 #define TIME2NSEC(__t)\
  50 (hrtime_t)(((hrtime_t)__t.tv_sec * (hrtime_t)NANOSEC) + (hrtime_t)__t.tv_nsec)
  51 #define TIME2SEC(__t)\
  52 (hrtime_t)(__t.tv_sec)
  53 
  54 /*
  55  * List of available output modes
  56  */
  57 #define OPT_PSINFO      0x0001          /* read process's data from "psinfo" */
  58 #define OPT_LWPS        0x0002          /* report about all lwps */
  59 #define OPT_USERS       0x0004          /* report about most active users */
  60 #define OPT_UNUSED      0x0008          /* reserved for future use */
  61 #define OPT_REALTIME    0x0010          /* real-time scheduling class flag */
  62 #define OPT_MSACCT      0x0020          /* microstate accounting flag */
  63 #define OPT_TERMCAP     0x0040          /* use termcap data to move cursor */
  64 #define OPT_SPLIT       0x0080          /* split-screen mode flag */
  65 #define OPT_TTY         0x0100          /* report results to tty or file */
  66 #define OPT_FULLSCREEN  0x0200          /* full-screen mode flag */
  67 #define OPT_USEHOME     0x0400          /* use 'home' to move cursor up */
  68 #define OPT_TASKS       0x0800          /* report about system tasks */
  69 #define OPT_PROJECTS    0x1000          /* report about system projects */
  70 #define OPT_ZONES       0x2000          /* report about zones */
  71 #define OPT_PSETS       0x4000          /* report for specified psets */
  72 #define OPT_LGRP        0x8000          /* report home lgroups */
  73 #define OPT_UDATE       0x20000         /* print unix timestamp */
  74 #define OPT_DDATE       0x40000         /* print timestamp in date(1) format */
  75 #define OPT_NORESOLVE   0x80000         /* no nsswitch lookups */
  76 
  77 /*
  78  * Flags to keep track of process or lwp status
  79  */
  80 #define LWP_ALIVE       0x0008          /* this pid/lwp still exists */
  81 #define LWP_REPRESENT   0x0010          /* this LWP represents the process */
  82 
  83 /*
  84  * Possible list types
  85  */
  86 #define LT_LWPS         0x0001
  87 #define LT_USERS        0x0002
  88 #define LT_TASKS        0x0004
  89 #define LT_PROJECTS     0x0008
  90 #define LT_ZONES        0x0010
  91 #define LT_LGRPS        0x0020
  92 
  93 /*
  94  * Linked list of per-process or per-lwp statistics
  95  */
  96 typedef struct lwp_info {
  97         psinfo_t        li_info;        /* data read from psinfo file */
  98         prusage_t       li_usage;       /* data read from usage file */
  99         ulong_t         li_key;         /* value of the key for this lwp */
 100         int             li_flags;       /* process/lwp flags */
 101         float           li_usr;         /* user level CPU time */
 102         float           li_sys;         /* system call CPU time */
 103         float           li_trp;         /* other system trap CPU time */
 104         float           li_tfl;         /* text page fault sleep time */
 105         float           li_dfl;         /* data page fault sleep time */
 106         float           li_lck;         /* user lock wait sleep time */
 107         float           li_slp;         /* all other sleep time */
 108         float           li_lat;         /* wait-cpu (latency) time */
 109         ulong_t         li_vcx;         /* voluntary context switches */
 110         ulong_t         li_icx;         /* involuntary context switches */
 111         ulong_t         li_scl;         /* system calls */
 112         ulong_t         li_sig;         /* received signals */
 113         struct lwp_info *li_next;       /* pointer to next lwp */
 114         struct lwp_info *li_prev;       /* pointer to previous lwp */
 115 } lwp_info_t;
 116 
 117 /*
 118  * Linked list of collective per-uid, per-taskid, per-projid or per-lgroup
 119  * statistics
 120  */
 121 typedef struct id_info {
 122         uid_t           id_uid;         /* user id */
 123         taskid_t        id_taskid;      /* task id */
 124         projid_t        id_projid;      /* project id */
 125         zoneid_t        id_zoneid;      /* zone id */
 126         int             id_lgroup;      /* lgroup id */
 127         uint_t          id_nproc;       /* number of processes */
 128         boolean_t       id_sizematch;   /* size/rssize from getvmusage() */
 129         size_t          id_size;        /* memory usage */
 130         size_t          id_rssize;      /* resident set size */
 131         ulong_t         id_time;        /* cpu time (in secs) */
 132         float           id_pctcpu;      /* percentage of cpu usage */
 133         float           id_pctmem;      /* percentage of memory usage */
 134         ulong_t         id_key;         /* sort key value */
 135         struct id_info *id_next;        /* pointer to next entry */
 136         struct id_info *id_prev;        /* pointer to previous entry */
 137 } id_info_t;
 138 
 139 typedef ulong_t (*keyfunc_t)(void *);
 140 
 141 /*
 142  * Per-list structure
 143  */
 144 typedef struct list {
 145         int             l_type;         /* list type */
 146         int             l_count;        /* number of entries in the list */
 147         void            *l_head;        /* pointer to the head of the list */
 148         void            *l_tail;        /* pointer to the tail of the list */
 149 
 150         int             l_size;         /* number of allocated pointers */
 151         int             l_used;         /* number of used pointers */
 152         int             l_sortorder;    /* sorting order for the list */
 153         keyfunc_t       l_func;         /* pointer to key function */
 154         void            **l_ptrs;       /* pointer to an array of pointers */
 155 } list_t;
 156 
 157 /*
 158  * Command line options
 159  */
 160 typedef struct optdesc {
 161         int             o_interval;     /* interval between updates */
 162         int             o_ntop;         /* number of lines in top half */
 163         int             o_nbottom;      /* number of lines in bottom half */
 164         int             o_count;        /* number of iterations */
 165         int             o_outpmode;     /* selected output mode */
 166         int             o_sortorder;    /* +1 ascending, -1 descending */
 167 } optdesc_t;
 168 
 169 #ifdef  __cplusplus
 170 }
 171 #endif
 172 
 173 #endif  /* _PRSTAT_H */