sysctl.h revision ad09f8b827db90c9a0093f0b6382803fa64a5fd1
843e19887f64dde75055cf8842fc4db2171eff45johnlev/******************************************************************************
843e19887f64dde75055cf8842fc4db2171eff45johnlev * System management operations. For use by node control stack.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Permission is hereby granted, free of charge, to any person obtaining a copy
843e19887f64dde75055cf8842fc4db2171eff45johnlev * of this software and associated documentation files (the "Software"), to
843e19887f64dde75055cf8842fc4db2171eff45johnlev * deal in the Software without restriction, including without limitation the
843e19887f64dde75055cf8842fc4db2171eff45johnlev * rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
843e19887f64dde75055cf8842fc4db2171eff45johnlev * sell copies of the Software, and to permit persons to whom the Software is
843e19887f64dde75055cf8842fc4db2171eff45johnlev * furnished to do so, subject to the following conditions:
843e19887f64dde75055cf8842fc4db2171eff45johnlev * The above copyright notice and this permission notice shall be included in
843e19887f64dde75055cf8842fc4db2171eff45johnlev * all copies or substantial portions of the Software.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
843e19887f64dde75055cf8842fc4db2171eff45johnlev * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
843e19887f64dde75055cf8842fc4db2171eff45johnlev * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
843e19887f64dde75055cf8842fc4db2171eff45johnlev * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
843e19887f64dde75055cf8842fc4db2171eff45johnlev * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
843e19887f64dde75055cf8842fc4db2171eff45johnlev * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
843e19887f64dde75055cf8842fc4db2171eff45johnlev * DEALINGS IN THE SOFTWARE.
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Copyright (c) 2002-2006, K Fraser
843e19887f64dde75055cf8842fc4db2171eff45johnlev#error "sysctl operations are intended for use by node control tools only"
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee#define XEN_SYSCTL_INTERFACE_VERSION 0x00000006
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Read console content from Xen buffer ring.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN: Non-zero -> clear after reading. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN: Non-zero -> start index specified by @index field. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * IN: Start index for consuming from ring buffer (if @incremental);
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * OUT: End index after consuming from ring buffer.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN: Virtual address to write console data. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN: Size of buffer; OUT: Bytes written to buffer. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_readconsole xen_sysctl_readconsole_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev/* Get trace buffers machine base address */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN/OUT variables */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variables */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_tbuf_op xen_sysctl_tbuf_op_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Get physical information about the host machine
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* (x86) The platform supports HVM guests. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee#define XEN_SYSCTL_PHYSCAP_hvm (1u<<_XEN_SYSCTL_PHYSCAP_hvm)
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* (x86) The platform supports HVM-guest direct access to I/O devices. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee#define XEN_SYSCTL_PHYSCAP_hvm_directio (1u<<_XEN_SYSCTL_PHYSCAP_hvm_directio)
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * IN: maximum addressable entry in the caller-provided cpu_to_node array.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * OUT: largest cpu identifier in the system.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * If OUT is greater than IN then the cpu_to_node array is truncated!
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * If not NULL, this array is filled with node identifier for each cpu.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * If a cpu has no node information (e.g., cpu not present) then the
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * sentinel value ~0u is written.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * The size of this array is specified by the caller in @max_cpu_id.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * If the actual @max_cpu_id is smaller than the array then the trailing
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * elements of the array will not be written by the sysctl.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* XEN_SYSCTL_PHYSCAP_??? */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_physinfo xen_sysctl_physinfo_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Get the ID of the current scheduler.
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variable */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_sched_id xen_sysctl_sched_id_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev/* Interface for controlling Xen software performance counters. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev/* Sub-operations: */
843e19887f64dde75055cf8842fc4db2171eff45johnlev#define XEN_SYSCTL_PERFCOP_reset 1 /* Reset all counters to zero. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev#define XEN_SYSCTL_PERFCOP_query 2 /* Get perfctr information. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev uint32_t nr_vals; /* number of values for this counter */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_perfc_desc xen_sysctl_perfc_desc_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev uint32_t nr_counters; /* number of counters description */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* counter information (or NULL) */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* counter values (or NULL) */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_perfc_op xen_sysctl_perfc_op_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* IN variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlev /* OUT variables. */
843e19887f64dde75055cf8842fc4db2171eff45johnlevtypedef struct xen_sysctl_getdomaininfolist xen_sysctl_getdomaininfolist_t;
843e19887f64dde75055cf8842fc4db2171eff45johnlevDEFINE_XEN_GUEST_HANDLE(xen_sysctl_getdomaininfolist_t);
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab/* Inject debug keys into Xen. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* IN variables. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rabtypedef struct xen_sysctl_debug_keys xen_sysctl_debug_keys_t;
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab/* Get physical CPU information. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* IN variables. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rab /* OUT variables. */
a576ab5b6e08c47732b3dedca9eaa8a8cbb85720rabtypedef struct xen_sysctl_getcpuinfo xen_sysctl_getcpuinfo_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t min_bitwidth; /* Smallest address width (zero if don't care). */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t max_bitwidth; /* Largest address width (zero if don't care). */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee int32_t node; /* NUMA node of interest (-1 for all nodes). */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* OUT variables. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_aligned_t avail_bytes;/* Bytes available in the specified region. */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_sysctl_availheap xen_sysctl_availheap_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xen_sysctl_availheap_t);
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_aligned_t freq; /* Px core frequency */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_aligned_t residency; /* Px residency time */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_aligned_t count; /* Px transition count */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE_64(uint64) trans_pt; /* Px transition table */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint32_t nr; /* entry nr in triggers & residencies, including C0 */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee uint64_aligned_t idle_time; /* idle time from boot */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE_64(uint64) triggers; /* Cx trigger counts */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee XEN_GUEST_HANDLE_64(uint64) residencies; /* Cx residencies */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* other struct for tx, etc */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_sysctl_get_pmstat xen_sysctl_get_pmstat_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xen_sysctl_get_pmstat_t);
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * Status codes. Must be greater than 0 to avoid confusing
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee * sysctl callers that see 0 as a plain successful return.
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybee /* IN variables */
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart Maybeetypedef struct xen_sysctl_cpu_hotplug xen_sysctl_cpu_hotplug_t;
349b53dd4e695e3d833b5380540385145b2d3ae8Stuart MaybeeDEFINE_XEN_GUEST_HANDLE(xen_sysctl_cpu_hotplug_t);
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * Get/set xen power management, include
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * 1. cpufreq governors and related parameters
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * cpufreq para name of this structure named
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * same as sysfs file name of native linux
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* IN/OUT variable */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* for all governors */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* OUT variable */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson XEN_GUEST_HANDLE_64(uint32) scaling_available_frequencies;
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson XEN_GUEST_HANDLE_64(char) scaling_available_governors;
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* for specific governor */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson/* Get physical CPU topology information. */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* IN: maximum addressable entry in
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * the caller-provided cpu_to_core/socket.
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* OUT: number of cpus returned
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * If OUT is greater than IN then the cpu_to_core/socket is truncated!
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* cpufreq command type */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson #define GET_CPUFREQ_AVGFREQ (CPUFREQ_PARA | 0x04)
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* get CPU topology */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* set/reset scheduler power saving option */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson #define XEN_SYSCTL_pm_op_set_sched_opt_smt 0x21
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* cpuidle max_cstate access command */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* set scheduler migration cost value */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson #define XEN_SYSCTL_pm_op_set_vcpu_migration_delay 0x24
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson #define XEN_SYSCTL_pm_op_get_vcpu_migration_delay 0x25
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* IN: range of page to be offlined */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson /* OUT: result of page offline request */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * bit 0~15: result flags
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson * bit 16~31: owner
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson/* The result is invalid, i.e. HV does not handle it */
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson#define PG_OFFLINE_STATUS_OFFLINE_PENDING (0x1UL << 3)
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson/* only valid when PG_OFFLINE_FAILED */
843e19887f64dde75055cf8842fc4db2171eff45johnlev uint32_t interface_version; /* XEN_SYSCTL_INTERFACE_VERSION */
843e19887f64dde75055cf8842fc4db2171eff45johnlev struct xen_sysctl_getdomaininfolist getdomaininfolist;
ad09f8b827db90c9a0093f0b6382803fa64a5fd1Mark Johnson struct xen_sysctl_page_offline_op page_offline;
843e19887f64dde75055cf8842fc4db2171eff45johnlev#endif /* __XEN_PUBLIC_SYSCTL_H__ */
843e19887f64dde75055cf8842fc4db2171eff45johnlev * Local variables:
843e19887f64dde75055cf8842fc4db2171eff45johnlev * c-set-style: "BSD"
843e19887f64dde75055cf8842fc4db2171eff45johnlev * c-basic-offset: 4
843e19887f64dde75055cf8842fc4db2171eff45johnlev * tab-width: 4
843e19887f64dde75055cf8842fc4db2171eff45johnlev * indent-tabs-mode: nil