pghw.h revision 0e7515250c8395f368aa45fb9acae7c4f8f8b786
/*
* 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
* or http://www.opensolaris.org/os/licensing.
* 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
#if (defined(_KERNEL) || defined(_KMEMUSER))
#include <sys/cpuvar.h>
#include <sys/group.h>
#include <sys/processor.h>
#include <sys/bitmap.h>
#include <sys/atomic.h>
#include <sys/types.h>
#include <sys/kstat.h>
#include <sys/pg.h>
/*
* Hardware that may be shared by a group of processors
*/
typedef enum pghw_type {
PGHW_START,
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_MEMORY,
PGHW_POW_ACTIVE, /* Active Power Management Domain */
PGHW_POW_IDLE, /* Idle Power Management Domain */
PGHW_NUM_COMPONENTS
} pghw_type_t;
/*
* Returns true if the hardware is a type of power management domain
*/
#define PGHW_IS_PM_DOMAIN(hw) \
(hw == PGHW_POW_ACTIVE || hw == PGHW_POW_IDLE)
/*
* Anonymous instance id
*/
#define PGHW_INSTANCE_ANON ((id_t)0xdecafbad)
/*
* Max length of PGHW kstat strings
*/
#define PGHW_KSTAT_STR_LEN_MAX 32
/*
* Platform specific handle
*/
typedef uintptr_t pghw_handle_t;
/*
* Processor Group (physical sharing relationship)
*/
typedef struct pghw {
pg_t pghw_pg; /* processor group */
pghw_type_t pghw_hw; /* HW sharing relationship */
id_t pghw_instance; /* sharing instance identifier */
pghw_handle_t pghw_handle; /* hw specific opaque handle */
kstat_t *pghw_kstat; /* physical kstats exported */
} pghw_t;
/*
* IDs associating a CPU with various physical hardware
*/
typedef struct cpu_physid {
id_t cpu_chipid; /* CPU's physical processor */
id_t cpu_coreid; /* CPU's physical core */
id_t cpu_cacheid; /* CPU's cache id */
} cpu_physid_t;
/*
* Physical PG initialization / CPU service hooks
*/
void pghw_init(pghw_t *, cpu_t *, pghw_type_t);
void pghw_fini(pghw_t *);
void pghw_cpu_add(pghw_t *, cpu_t *);
pghw_t *pghw_place_cpu(cpu_t *, pghw_type_t);
/*
* Physical ID cache creation / destruction
*/
void pghw_physid_create(cpu_t *);
void pghw_physid_destroy(cpu_t *);
/*
* CPU / PG hardware related seach operations
*/
pghw_t *pghw_find_pg(cpu_t *, pghw_type_t);
pghw_t *pghw_find_by_instance(id_t, pghw_type_t);
group_t *pghw_set_lookup(pghw_type_t);
void pghw_kstat_create(pghw_t *);
int pghw_kstat_update(kstat_t *, int);
/* Hardware sharing relationship platform interfaces */
int pg_plat_hw_shared(cpu_t *, pghw_type_t);
int pg_plat_cpus_share(cpu_t *, cpu_t *, pghw_type_t);
id_t pg_plat_hw_instance_id(cpu_t *, pghw_type_t);
pghw_type_t pg_plat_hw_rank(pghw_type_t, 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.
*/
id_t pg_plat_get_core_id(cpu_t *);
#endif /* !_KERNEL && !_KMEMUSER */
#ifdef __cplusplus
}
#endif
#endif /* _PGHW_H */