1/****************************************************************************** 2 * sysctl.h 3 * 4 * System management operations. For use by node control stack. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to 8 * deal in the Software without restriction, including without limitation the 9 * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or 10 * sell copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 19 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING 21 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER 22 * DEALINGS IN THE SOFTWARE. 23 * 24 * Copyright (c) 2002-2006, K Fraser 25 */ 26 27#ifndef __XEN_PUBLIC_SYSCTL_H__ 28#define __XEN_PUBLIC_SYSCTL_H__ 29 30#if !defined(__XEN__) && !defined(__XEN_TOOLS__) 31#error "sysctl operations are intended for use by node control tools only" 32#endif 33 34#include "xen.h" 35#include "domctl.h" 36 37#define XEN_SYSCTL_INTERFACE_VERSION 0x00000006 38 39/* 40 * Read console content from Xen buffer ring. 41 */ 42#define XEN_SYSCTL_readconsole 1 43struct xen_sysctl_readconsole { 44 /* IN: Non-zero -> clear after reading. */ 45 uint8_t clear; 46 /* IN: Non-zero -> start index specified by @index field. */ 47 uint8_t incremental; 48 uint8_t pad0, pad1; 49 /* 50 * IN: Start index for consuming from ring buffer (if @incremental); 51 * OUT: End index after consuming from ring buffer. 52 */ 53 uint32_t index; 54 /* IN: Virtual address to write console data. */ 55 XEN_GUEST_HANDLE_64(char) buffer; 56 /* IN: Size of buffer; OUT: Bytes written to buffer. */ 57 uint32_t count; 58}; 59typedef struct xen_sysctl_readconsole xen_sysctl_readconsole_t; 60DEFINE_XEN_GUEST_HANDLE(xen_sysctl_readconsole_t); 61 62/* Get trace buffers machine base address */ 63#define XEN_SYSCTL_tbuf_op 2 64struct xen_sysctl_tbuf_op { 65 /* IN variables */ 66#define XEN_SYSCTL_TBUFOP_get_info 0 67#define XEN_SYSCTL_TBUFOP_set_cpu_mask 1 68#define XEN_SYSCTL_TBUFOP_set_evt_mask 2 69#define XEN_SYSCTL_TBUFOP_set_size 3 70#define XEN_SYSCTL_TBUFOP_enable 4 71#define XEN_SYSCTL_TBUFOP_disable 5 72 uint32_t cmd; 73 /* IN/OUT variables */ 74 struct xenctl_cpumap cpu_mask; 75 uint32_t evt_mask; 76 /* OUT variables */ 77 uint64_aligned_t buffer_mfn; 78 uint32_t size; 79}; 80typedef struct xen_sysctl_tbuf_op xen_sysctl_tbuf_op_t; 81DEFINE_XEN_GUEST_HANDLE(xen_sysctl_tbuf_op_t); 82 83/* 84 * Get physical information about the host machine 85 */ 86#define XEN_SYSCTL_physinfo 3 87 /* (x86) The platform supports HVM guests. */ 88#define _XEN_SYSCTL_PHYSCAP_hvm 0 89#define XEN_SYSCTL_PHYSCAP_hvm (1u<<_XEN_SYSCTL_PHYSCAP_hvm) 90 /* (x86) The platform supports HVM-guest direct access to I/O devices. */ 91#define _XEN_SYSCTL_PHYSCAP_hvm_directio 1 92#define XEN_SYSCTL_PHYSCAP_hvm_directio (1u<<_XEN_SYSCTL_PHYSCAP_hvm_directio) 93struct xen_sysctl_physinfo { 94 uint32_t threads_per_core; 95 uint32_t cores_per_socket; 96 uint32_t nr_cpus; 97 uint32_t nr_nodes; 98 uint32_t cpu_khz; 99 uint64_aligned_t total_pages; 100 uint64_aligned_t free_pages; 101 uint64_aligned_t scrub_pages; 102 uint32_t hw_cap[8]; 103 104 /* 105 * IN: maximum addressable entry in the caller-provided cpu_to_node array. 106 * OUT: largest cpu identifier in the system. 107 * If OUT is greater than IN then the cpu_to_node array is truncated! 108 */ 109 uint32_t max_cpu_id; 110 /* 111 * If not NULL, this array is filled with node identifier for each cpu. 112 * If a cpu has no node information (e.g., cpu not present) then the 113 * sentinel value ~0u is written. 114 * The size of this array is specified by the caller in @max_cpu_id. 115 * If the actual @max_cpu_id is smaller than the array then the trailing 116 * elements of the array will not be written by the sysctl. 117 */ 118 XEN_GUEST_HANDLE_64(uint32) cpu_to_node; 119 120 /* XEN_SYSCTL_PHYSCAP_??? */ 121 uint32_t capabilities; 122}; 123typedef struct xen_sysctl_physinfo xen_sysctl_physinfo_t; 124DEFINE_XEN_GUEST_HANDLE(xen_sysctl_physinfo_t); 125 126/* 127 * Get the ID of the current scheduler. 128 */ 129#define XEN_SYSCTL_sched_id 4 130struct xen_sysctl_sched_id { 131 /* OUT variable */ 132 uint32_t sched_id; 133}; 134typedef struct xen_sysctl_sched_id xen_sysctl_sched_id_t; 135DEFINE_XEN_GUEST_HANDLE(xen_sysctl_sched_id_t); 136 137/* Interface for controlling Xen software performance counters. */ 138#define XEN_SYSCTL_perfc_op 5 139/* Sub-operations: */ 140#define XEN_SYSCTL_PERFCOP_reset 1 /* Reset all counters to zero. */ 141#define XEN_SYSCTL_PERFCOP_query 2 /* Get perfctr information. */ 142struct xen_sysctl_perfc_desc { 143 char name[80]; /* name of perf counter */ 144 uint32_t nr_vals; /* number of values for this counter */ 145}; 146typedef struct xen_sysctl_perfc_desc xen_sysctl_perfc_desc_t; 147DEFINE_XEN_GUEST_HANDLE(xen_sysctl_perfc_desc_t); 148typedef uint32_t xen_sysctl_perfc_val_t; 149DEFINE_XEN_GUEST_HANDLE(xen_sysctl_perfc_val_t); 150 151struct xen_sysctl_perfc_op { 152 /* IN variables. */ 153 uint32_t cmd; /* XEN_SYSCTL_PERFCOP_??? */ 154 /* OUT variables. */ 155 uint32_t nr_counters; /* number of counters description */ 156 uint32_t nr_vals; /* number of values */ 157 /* counter information (or NULL) */ 158 XEN_GUEST_HANDLE_64(xen_sysctl_perfc_desc_t) desc; 159 /* counter values (or NULL) */ 160 XEN_GUEST_HANDLE_64(xen_sysctl_perfc_val_t) val; 161}; 162typedef struct xen_sysctl_perfc_op xen_sysctl_perfc_op_t; 163DEFINE_XEN_GUEST_HANDLE(xen_sysctl_perfc_op_t); 164 165#define XEN_SYSCTL_getdomaininfolist 6 166struct xen_sysctl_getdomaininfolist { 167 /* IN variables. */ 168 domid_t first_domain; 169 uint32_t max_domains; 170 XEN_GUEST_HANDLE_64(xen_domctl_getdomaininfo_t) buffer; 171 /* OUT variables. */ 172 uint32_t num_domains; 173}; 174typedef struct xen_sysctl_getdomaininfolist xen_sysctl_getdomaininfolist_t; 175DEFINE_XEN_GUEST_HANDLE(xen_sysctl_getdomaininfolist_t); 176 177/* Inject debug keys into Xen. */ 178#define XEN_SYSCTL_debug_keys 7 179struct xen_sysctl_debug_keys { 180 /* IN variables. */ 181 XEN_GUEST_HANDLE_64(char) keys; 182 uint32_t nr_keys; 183}; 184typedef struct xen_sysctl_debug_keys xen_sysctl_debug_keys_t; 185DEFINE_XEN_GUEST_HANDLE(xen_sysctl_debug_keys_t); 186 187/* Get physical CPU information. */ 188#define XEN_SYSCTL_getcpuinfo 8 189struct xen_sysctl_cpuinfo { 190 uint64_aligned_t idletime; 191}; 192typedef struct xen_sysctl_cpuinfo xen_sysctl_cpuinfo_t; 193DEFINE_XEN_GUEST_HANDLE(xen_sysctl_cpuinfo_t); 194struct xen_sysctl_getcpuinfo { 195 /* IN variables. */ 196 uint32_t max_cpus; 197 XEN_GUEST_HANDLE_64(xen_sysctl_cpuinfo_t) info; 198 /* OUT variables. */ 199 uint32_t nr_cpus; 200}; 201typedef struct xen_sysctl_getcpuinfo xen_sysctl_getcpuinfo_t; 202DEFINE_XEN_GUEST_HANDLE(xen_sysctl_getcpuinfo_t); 203 204#define XEN_SYSCTL_availheap 9 205struct xen_sysctl_availheap { 206 /* IN variables. */ 207 uint32_t min_bitwidth; /* Smallest address width (zero if don't care). */ 208 uint32_t max_bitwidth; /* Largest address width (zero if don't care). */ 209 int32_t node; /* NUMA node of interest (-1 for all nodes). */ 210 /* OUT variables. */ 211 uint64_aligned_t avail_bytes;/* Bytes available in the specified region. */ 212}; 213typedef struct xen_sysctl_availheap xen_sysctl_availheap_t; 214DEFINE_XEN_GUEST_HANDLE(xen_sysctl_availheap_t); 215 216#define XEN_SYSCTL_get_pmstat 10 217struct pm_px_val { 218 uint64_aligned_t freq; /* Px core frequency */ 219 uint64_aligned_t residency; /* Px residency time */ 220 uint64_aligned_t count; /* Px transition count */ 221}; 222typedef struct pm_px_val pm_px_val_t; 223DEFINE_XEN_GUEST_HANDLE(pm_px_val_t); 224 225struct pm_px_stat { 226 uint8_t total; /* total Px states */ 227 uint8_t usable; /* usable Px states */ 228 uint8_t last; /* last Px state */ 229 uint8_t cur; /* current Px state */ 230 XEN_GUEST_HANDLE_64(uint64) trans_pt; /* Px transition table */ 231 XEN_GUEST_HANDLE_64(pm_px_val_t) pt; 232}; 233typedef struct pm_px_stat pm_px_stat_t; 234DEFINE_XEN_GUEST_HANDLE(pm_px_stat_t); 235 236struct pm_cx_stat { 237 uint32_t nr; /* entry nr in triggers & residencies, including C0 */ 238 uint32_t last; /* last Cx state */ 239 uint64_aligned_t idle_time; /* idle time from boot */ 240 XEN_GUEST_HANDLE_64(uint64) triggers; /* Cx trigger counts */ 241 XEN_GUEST_HANDLE_64(uint64) residencies; /* Cx residencies */ 242}; 243 244struct xen_sysctl_get_pmstat { 245#define PMSTAT_CATEGORY_MASK 0xf0 246#define PMSTAT_PX 0x10 247#define PMSTAT_CX 0x20 248#define PMSTAT_get_max_px (PMSTAT_PX | 0x1) 249#define PMSTAT_get_pxstat (PMSTAT_PX | 0x2) 250#define PMSTAT_reset_pxstat (PMSTAT_PX | 0x3) 251#define PMSTAT_get_max_cx (PMSTAT_CX | 0x1) 252#define PMSTAT_get_cxstat (PMSTAT_CX | 0x2) 253#define PMSTAT_reset_cxstat (PMSTAT_CX | 0x3) 254 uint32_t type; 255 uint32_t cpuid; 256 union { 257 struct pm_px_stat getpx; 258 struct pm_cx_stat getcx; 259 /* other struct for tx, etc */ 260 } u; 261}; 262typedef struct xen_sysctl_get_pmstat xen_sysctl_get_pmstat_t; 263DEFINE_XEN_GUEST_HANDLE(xen_sysctl_get_pmstat_t); 264 265#define XEN_SYSCTL_cpu_hotplug 11 266struct xen_sysctl_cpu_hotplug { 267 /* IN variables */ 268 uint32_t cpu; /* Physical cpu. */ 269#define XEN_SYSCTL_CPU_HOTPLUG_ONLINE 0 270#define XEN_SYSCTL_CPU_HOTPLUG_OFFLINE 1 271 uint32_t op; /* hotplug opcode */ 272}; 273typedef struct xen_sysctl_cpu_hotplug xen_sysctl_cpu_hotplug_t; 274DEFINE_XEN_GUEST_HANDLE(xen_sysctl_cpu_hotplug_t); 275 276 277struct xen_sysctl { 278 uint32_t cmd; 279 uint32_t interface_version; /* XEN_SYSCTL_INTERFACE_VERSION */ 280 union { 281 struct xen_sysctl_readconsole readconsole; 282 struct xen_sysctl_tbuf_op tbuf_op; 283 struct xen_sysctl_physinfo physinfo; 284 struct xen_sysctl_sched_id sched_id; 285 struct xen_sysctl_perfc_op perfc_op; 286 struct xen_sysctl_getdomaininfolist getdomaininfolist; 287 struct xen_sysctl_debug_keys debug_keys; 288 struct xen_sysctl_getcpuinfo getcpuinfo; 289 struct xen_sysctl_availheap availheap; 290 struct xen_sysctl_get_pmstat get_pmstat; 291 struct xen_sysctl_cpu_hotplug cpu_hotplug; 292 uint8_t pad[128]; 293 } u; 294}; 295typedef struct xen_sysctl xen_sysctl_t; 296DEFINE_XEN_GUEST_HANDLE(xen_sysctl_t); 297 298#endif /* __XEN_PUBLIC_SYSCTL_H__ */ 299 300/* 301 * Local variables: 302 * mode: C 303 * c-set-style: "BSD" 304 * c-basic-offset: 4 305 * tab-width: 4 306 * indent-tabs-mode: nil 307 * End: 308 */ 309