xref: /illumos-gate/usr/src/cmd/prstat/prstat.h (revision 7c478bd9)
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, Version 1.0 only
6  * (the "License").  You may not use this file except in compliance
7  * with the License.
8  *
9  * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
10  * or http://www.opensolaris.org/os/licensing.
11  * See the License for the specific language governing permissions
12  * and limitations under the License.
13  *
14  * When distributing Covered Code, include this CDDL HEADER in each
15  * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
16  * If applicable, add the following below this CDDL HEADER, with the
17  * fields enclosed by brackets "[]" replaced with your own identifying
18  * information: Portions Copyright [yyyy] [name of copyright owner]
19  *
20  * CDDL HEADER END
21  */
22 /*
23  * Copyright 2004 Sun Microsystems, Inc.  All rights reserved.
24  * Use is subject to license terms.
25  */
26 
27 #ifndef	_PRSTAT_H
28 #define	_PRSTAT_H
29 
30 #pragma ident	"%Z%%M%	%I%	%E% SMI"
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 
73 /*
74  * Flags to keep track of process or lwp status
75  */
76 #define	LWP_ALIVE	0x0008		/* this pid/lwp still exists */
77 #define	LWP_REPRESENT	0x0010		/* this LWP represents the process */
78 
79 /*
80  * Possible list types
81  */
82 #define	LT_LWPS		0x0001
83 #define	LT_USERS	0x0002
84 #define	LT_TASKS	0x0004
85 #define	LT_PROJECTS	0x0008
86 #define	LT_ZONES	0x0010
87 
88 /*
89  * Linked list of per-process or per-lwp statistics
90  */
91 typedef struct lwp_info {
92 	psinfo_t	li_info;	/* data read from psinfo file */
93 	prusage_t	li_usage;	/* data read from usage file */
94 	ulong_t		li_key;		/* value of the key for this lwp */
95 	int		li_flags;	/* process/lwp flags */
96 	float		li_usr;		/* user level CPU time */
97 	float		li_sys;		/* system call CPU time */
98 	float		li_trp;		/* other system trap CPU time */
99 	float		li_tfl;		/* text page fault sleep time */
100 	float		li_dfl;		/* data page fault sleep time */
101 	float		li_lck;		/* user lock wait sleep time */
102 	float		li_slp;		/* all other sleep time */
103 	float		li_lat;		/* wait-cpu (latency) time */
104 	ulong_t		li_vcx;		/* voluntary context switches */
105 	ulong_t		li_icx;		/* involuntary context switches */
106 	ulong_t		li_scl;		/* system calls */
107 	ulong_t		li_sig;		/* received signals */
108 	struct lwp_info *li_next;	/* pointer to next lwp */
109 	struct lwp_info *li_prev;	/* pointer to previous lwp */
110 } lwp_info_t;
111 
112 /*
113  * Linked list of collective per-uid, per-taskid, or per-projid statistics
114  */
115 typedef struct id_info {
116 	uid_t		id_uid;		/* user id */
117 	taskid_t	id_taskid;	/* task id */
118 	projid_t	id_projid;	/* project id */
119 	zoneid_t	id_zoneid;	/* zone id */
120 	uint_t		id_nproc;	/* number of processes */
121 	size_t		id_size;	/* memory usage */
122 	size_t		id_rssize;	/* resident set size */
123 	ulong_t		id_time;	/* cpu time (in secs) */
124 	float		id_pctcpu;	/* percentage of cpu usage */
125 	float		id_pctmem;	/* percentage of memory usage */
126 	ulong_t		id_key;		/* sort key value */
127 	struct id_info *id_next;	/* pointer to next entry */
128 	struct id_info *id_prev;	/* pointer to previous entry */
129 } id_info_t;
130 
131 typedef	ulong_t	(*keyfunc_t)(void *);
132 
133 /*
134  * Per-list structure
135  */
136 typedef struct list {
137 	int		l_type;		/* list type */
138 	int		l_count;	/* number of entries in the list */
139 	void		*l_head;	/* pointer to the head of the list */
140 	void		*l_tail;	/* pointer to the tail of the list */
141 
142 	int		l_size;		/* number of allocated pointers */
143 	int		l_used;		/* number of used pointers */
144 	int		l_sortorder;	/* sorting order for the list */
145 	keyfunc_t	l_func;		/* pointer to key function */
146 	void		**l_ptrs;	/* pointer to an array of pointers */
147 } list_t;
148 
149 /*
150  * Command line options
151  */
152 typedef	struct optdesc {
153 	int		o_interval;	/* interval between updates */
154 	int		o_ntop;		/* number of lines in top half */
155 	int		o_nbottom;	/* number of lines in bottom half */
156 	int		o_count;	/* number of iterations */
157 	int		o_outpmode;	/* selected output mode */
158 	int		o_sortorder;	/* +1 ascending, -1 descending */
159 } optdesc_t;
160 
161 #ifdef	__cplusplus
162 }
163 #endif
164 
165 #endif	/* _PRSTAT_H */
166