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 * Copyright 2006 Sun Microsystems, Inc. All rights reserved. 23 * Use is subject to license terms. 24 */ 25 26 #ifndef _SYS_VM_USAGE_H 27 #define _SYS_VM_USAGE_H 28 29 #pragma ident "%Z%%M% %I% %E% SMI" 30 31 #include <sys/types.h> 32 33 #ifdef __cplusplus 34 extern "C" { 35 #endif 36 37 /* 38 * The flags passed to getvmusage() request how to aggregate rss/swap results. 39 * Results can be aggregated by zone, project, task, ruser, and/or euser. 40 * 41 * If VMUSAGE_ALL_* or VMUSAGE_COL_* are passed from a non-global-zone, the 42 * flag is treated as VMUSAGE_*. For example, VMUSAGE_ALL_ZONES would be 43 * treated as VMUSAGE_ZONE. 44 * 45 * If VMUSAGE_SYSTEM is passed from a non-global zone, a result of type 46 * VMUSAGE_SYSTEM will be returned, but it will only reflect the usage 47 * of the calling zone. 48 * 49 * VMUSAGE_* requests results for the calling zone. 50 * VMUSAGE_ALL_* requests results for all zones. 51 * VMUSAGE_COL_* requests results for all zones, but collapses out the zoneid. 52 * For example, VMUSAGE_COL_PROJECTS requests results for all 53 * projects in all zones, and project N in ANY zone is treated 54 * as the same project. 55 */ 56 #define VMUSAGE_SYSTEM 0x1 /* rss/swap for ALL processes */ 57 #define VMUSAGE_ZONE 0x2 /* rss/swap for caller's zone */ 58 #define VMUSAGE_PROJECTS 0x4 /* rss/swap for all projects in */ 59 /* caller's zone */ 60 #define VMUSAGE_TASKS 0x8 /* rss/swap for all tasks in */ 61 /* caller's zones */ 62 #define VMUSAGE_RUSERS 0x10 /* rss/swap for all users (by process */ 63 /* ruser) in the caller's zone */ 64 #define VMUSAGE_EUSERS 0x20 /* same as VMUSAGE_RUSERS, but by */ 65 /* euser */ 66 67 #define VMUSAGE_ALL_ZONES 0x40 /* rss/swap for all zones */ 68 #define VMUSAGE_ALL_PROJECTS 0x80 /* rss/swap for all projects in */ 69 /* all zones */ 70 #define VMUSAGE_ALL_TASKS 0x100 /* rss/swap for all tasks in all */ 71 /* zones */ 72 #define VMUSAGE_ALL_RUSERS 0x200 /* rss/swap for all users (by process */ 73 /* ruser) in all zones */ 74 #define VMUSAGE_ALL_EUSERS 0x400 /* same as VMUSAGE_ALL_RUSERS, but by */ 75 /* euser */ 76 77 #define VMUSAGE_COL_PROJECTS 0x800 /* rss/swap for all projects in */ 78 /* all zones. Collapse zoneid. */ 79 #define VMUSAGE_COL_RUSERS 0x1000 /* rss/swap for all users (by process */ 80 /* ruser), in all zones. Collapse */ 81 /* zoneid */ 82 #define VMUSAGE_COL_EUSERS 0x2000 /* same as VMUSAGE_COL_RUSERS, but by */ 83 /* euser */ 84 85 #define VMUSAGE_MASK 0x3fff /* all valid flags for getvmusage() */ 86 87 typedef struct vmusage { 88 id_t vmu_zoneid; /* zoneid, or ALL_ZONES for */ 89 /* VMUSAGE_COL_* results */ 90 /* ALL_ZONES means that the result */ 91 /* reflects swap and rss usage for */ 92 /* a projid/uid across all zones */ 93 uint_t vmu_type; /* Entity type of result. One of: */ 94 /* VMUSAGE_(SYSTEM|ZONE|PROJECTS| */ 95 /* TASKS|RUSERS|EUSERS) */ 96 id_t vmu_id; /* zoneid, projid, taskid, ... */ 97 size_t vmu_rss_all; /* total resident memory of entity */ 98 /* in bytes */ 99 size_t vmu_rss_private; /* total resident private memory */ 100 size_t vmu_rss_shared; /* total resident shared memory */ 101 size_t vmu_swap_all; /* total swap reserved, in bytes */ 102 size_t vmu_swap_private; /* swap reserved for private mappings */ 103 size_t vmu_swap_shared; /* swap reserved for shared mappings */ 104 105 } vmusage_t; 106 107 extern int getvmusage(uint_t flags, time_t age, vmusage_t *buf, size_t *nres); 108 109 #ifdef _KERNEL 110 111 int vm_getusage(uint_t, time_t, vmusage_t *, size_t *); 112 void vm_usage_init(); 113 114 #endif /* _KERNEL */ 115 116 #ifdef __cplusplus 117 } 118 #endif 119 120 #endif /* _SYS_VM_USAGE_H */ 121