b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * CDDL HEADER START
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov *
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * The contents of this file are subject to the terms of the
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Common Development and Distribution License (the "License").
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * You may not use this file except in compliance with the License.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov *
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * or http://www.opensolaris.org/os/licensing.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * See the License for the specific language governing permissions
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * and limitations under the License.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov *
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * When distributing Covered Code, include this CDDL HEADER in each
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * file and include the License file at usr/src/OPENSOLARIS.LICENSE.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * If applicable, add the following below this CDDL HEADER, with the
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * fields enclosed by brackets "[]" replaced with your own identifying
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * information: Portions Copyright [yyyy] [name of copyright owner]
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov *
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * CDDL HEADER END
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Copyright 2009 Sun Microsystems, Inc. All rights reserved.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Use is subject to license terms.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#ifndef _SYS_CAP_UTIL_H
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#define _SYS_CAP_UTIL_H
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#ifdef __cplusplus
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern "C" {
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#endif
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#include <sys/types.h>
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#include <sys/kcpc.h>
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#include <sys/cpc_impl.h>
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#include <sys/pghw.h>
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#include <sys/cmt.h>
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#ifdef _KERNEL
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Capacity and utilization flags for each CPU
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#define CU_CPU_CNTRS_ON 1 /* CPU performance counters are on */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#define CU_CPU_CNTRS_OFF_ON 2 /* Off -> on transition */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Macro that returns whether CPU performance counters turned on for given CPU
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#define CU_CPC_ON(cp) \
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov ((cp) != NULL && (cp)->cpu_cu_info != NULL && \
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov ((cp)->cpu_cu_info->cu_flag & CU_CPU_CNTRS_ON))
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Per counter statistics
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovtypedef struct cu_cntr_stats {
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov hrtime_t cs_time_running; /* running total of time counting */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov hrtime_t cs_time_stopped; /* ... time not counting */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov hrtime_t cs_time_start; /* start time of current sample */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint64_t cs_value_start; /* starting value for next sample */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint64_t cs_value_last; /* last value */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint64_t cs_value_total; /* running total */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint64_t cs_rate; /* observed rate since last */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint64_t cs_rate_max; /* maximum rate */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov kcpc_request_t *cs_cpc_req; /* corresponding CPC request */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov struct cpu *cs_cpu_start; /* CPU where starting value gotten */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov} cu_cntr_stats_t;
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Counter info for a PG hardware sharing relationship
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovtypedef struct cu_cntr_info {
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov cpu_t *ci_cpu; /* CPU being measured */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov pghw_t *ci_pg; /* hardware PG being measured */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov kstat_t *ci_kstat; /* kstats being exported */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov cu_cntr_stats_t *ci_stats; /* counter statistics */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint_t ci_nstats; /* number of statistics */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov} cu_cntr_info_t;
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Each CPU can have one or more CPC contexts for measuring capacity and
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * utilization
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov *
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * One CPC context is needed per CPU if the counter events needed to measure
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * capacity and utilization on each CPU can be programmed onto all the counters
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * on a CPU at the same time and there are fewer or same number of desired
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * counter events as counters on each CPU. Otherwise, the desired counter
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * events are assigned across multiple CPC contexts, so the contexts and their
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * counter events can be multiplexed onto the counters over time to get the
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * data for all of the counter events.
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovtypedef struct cu_cpc_ctx {
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov int cur_index; /* index for current context */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov int nctx; /* number of CPC contexts */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov kcpc_ctx_t **ctx_ptr_array; /* array of context pointers */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov size_t ctx_ptr_array_sz; /* size of array */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov} cu_cpc_ctx_t;
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Per CPU capacity and utilization info
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovtypedef struct cu_cpu_info {
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov struct cpu *cu_cpu; /* CPU for the statistics */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint_t cu_flag; /* capacity & utilization flag */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov hrtime_t cu_sample_time; /* when last sample taken */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov cu_cpc_ctx_t cu_cpc_ctx; /* performance counter contexts */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov cu_cntr_stats_t *cu_cntr_stats; /* counter statistics array */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint_t cu_ncntr_stats; /* number of counter statistics */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov uint_t cu_disabled; /* count of disable requests */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov /*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Per PG hardware sharing relationship counter info
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov cu_cntr_info_t *cu_cntr_info[PGHW_NUM_COMPONENTS];
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov} cu_cpu_info_t;
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * COMMON INTERFACE ROUTINES
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Setup capacity and utilization support
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_init(void);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Tear down capacity and utilization support
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern int cu_fini(void);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Program CPC for capacity and utilization on given CPU
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_cpc_program(struct cpu *, int *);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Unprogram CPC for capacity and utilization on given CPU
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_cpc_unprogram(struct cpu *, int *);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Update counter statistics on a given CPU
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern int cu_cpu_update(struct cpu *, boolean_t);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Update utilization and capacity data for CMT PG
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_pg_update(pghw_t *);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * Disable or enable capacity and utilization on all CPUs
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_disable(void);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern void cu_enable(void);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov/*
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov * PLATFORM SPECIFIC INTERFACE ROUTINES
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasovextern int cu_plat_cpc_init(cpu_t *, kcpc_request_list_t *, int);
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#endif /* _KERNEL */
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#ifdef __cplusplus
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov}
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#endif
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov
b885580b43755ee4ea1e280b85428893d2ba9291Alexander Kolbasov#endif /* _SYS_CAP_UTIL_H */