pghw.h revision b885580b43755ee4ea1e280b85428893d2ba9291
/*
* CDDL HEADER START
*
* The contents of this file are subject to the terms of the
* Common Development and Distribution License (the "License").
* You may not use this file except in compliance with the License.
*
* You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE
* See the License for the specific language governing permissions
* and limitations under the License.
*
* When distributing Covered Code, include this CDDL HEADER in each
* file and include the License file at usr/src/OPENSOLARIS.LICENSE.
* If applicable, add the following below this CDDL HEADER, with the
* fields enclosed by brackets "[]" replaced with your own identifying
* information: Portions Copyright [yyyy] [name of copyright owner]
*
* CDDL HEADER END
*/
/*
* Copyright 2009 Sun Microsystems, Inc. All rights reserved.
* Use is subject to license terms.
*/
#ifndef _PGHW_H
#define _PGHW_H
#ifdef __cplusplus
extern "C" {
#endif
#include <sys/processor.h>
/*
* Hardware that may be shared by a group of processors
*/
typedef enum pghw_type {
PGHW_IPIPE, /* Instruction Pipeline */
PGHW_CACHE, /* Cache (generally last level) */
PGHW_FPU, /* Floating Point Unit / Pipeline */
PGHW_MPIPE, /* Pipe to Memory */
PGHW_CHIP, /* Socket */
PGHW_POW_ACTIVE, /* Active Power Management Domain */
PGHW_POW_IDLE, /* Idle Power Management Domain */
} pghw_type_t;
/*
* for description of processor nodes
*
* From sharing point of view processor nodes are
* very similar to memory pipes, hence the #define below.
*/
#define PGHW_PROCNODE PGHW_MPIPE
/*
* Returns true if the hardware is a type of power management domain
*/
#define PGHW_IS_PM_DOMAIN(hw) \
/*
* Anonymous instance id
*/
/*
* Max length of PGHW kstat strings
*/
#define PGHW_KSTAT_STR_LEN_MAX 32
/*
* Platform specific handle
*/
typedef uintptr_t pghw_handle_t;
/*
* Representation of PG hardware utilization NOTE: All the sums listed below are
* the sums of running total of each item for each CPU in the PG (eg.
* sum(utilization) is sum of running total utilization of each CPU in PG)
*/
typedef struct pghw_util {
/*
* sum(time utilization counters on)
*/
/*
* sum(time utilization counters off)
*/
} pghw_util_t;
/*
* Processor Group (physical sharing relationship)
*/
typedef struct pghw {
/*
* pghw_generation should be updated by superclasses whenever PG changes
* significanly (e.g. new CPUs join or leave PG).
*/
/*
* The following fields are used by PGHW cu kstats
*/
char *pghw_cpulist; /* list of CPUs */
/*
* Generation number at kstat update time
*/
} pghw_t;
/*
* IDs associating a CPU with various physical hardware
*/
typedef struct cpu_physid {
} cpu_physid_t;
/*
* Physical PG initialization / CPU service hooks
*/
/*
* Physical ID cache creation / destruction
*/
extern void pghw_physid_create(cpu_t *);
extern void pghw_physid_destroy(cpu_t *);
/*
* CPU / PG hardware related seach operations
*/
/* Hardware sharing relationship platform interfaces */
/*
* String representation of the hardware type
*/
extern char *pghw_type_string(pghw_type_t);
extern char *pghw_type_shortstring(pghw_type_t);
/*
* What comprises a "core" may vary across processor implementations,
* and so the term itself is somewhat unstable. For this reason, there
* is no PGHW_CORE type, but we provide an interface here to allow platforms
* to express cpu <=> core mappings.
*/
#endif /* !_KERNEL && !_KMEMUSER */
#ifdef __cplusplus
}
#endif
#endif /* _PGHW_H */