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
38extern "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 */
96typedef 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 */
121typedef 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
139typedef	ulong_t	(*keyfunc_t)(void *);
140
141/*
142 * Per-list structure
143 */
144typedef 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 */
160typedef	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 */
174