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