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 */