1e4b86885SCheng Sean Ye /* 2e4b86885SCheng Sean Ye * CDDL HEADER START 3e4b86885SCheng Sean Ye * 4e4b86885SCheng Sean Ye * The contents of this file are subject to the terms of the 5e4b86885SCheng Sean Ye * Common Development and Distribution License (the "License"). 6e4b86885SCheng Sean Ye * You may not use this file except in compliance with the License. 7e4b86885SCheng Sean Ye * 8e4b86885SCheng Sean Ye * You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE 9e4b86885SCheng Sean Ye * or http://www.opensolaris.org/os/licensing. 10e4b86885SCheng Sean Ye * See the License for the specific language governing permissions 11e4b86885SCheng Sean Ye * and limitations under the License. 12e4b86885SCheng Sean Ye * 13e4b86885SCheng Sean Ye * When distributing Covered Code, include this CDDL HEADER in each 14e4b86885SCheng Sean Ye * file and include the License file at usr/src/OPENSOLARIS.LICENSE. 15e4b86885SCheng Sean Ye * If applicable, add the following below this CDDL HEADER, with the 16e4b86885SCheng Sean Ye * fields enclosed by brackets "[]" replaced with your own identifying 17e4b86885SCheng Sean Ye * information: Portions Copyright [yyyy] [name of copyright owner] 18e4b86885SCheng Sean Ye * 19e4b86885SCheng Sean Ye * CDDL HEADER END 20e4b86885SCheng Sean Ye */ 21e4b86885SCheng Sean Ye /* 22074bb90dSTom Pothier * Copyright 2009 Sun Microsystems, Inc. All rights reserved. 23e4b86885SCheng Sean Ye * Use is subject to license terms. 242a613b59SRobert Mustacchi * Copyright (c) 2018, Joyent, Inc. 25*dd23d762SRobert Mustacchi * Copyright 2023 Oxide Computer Company 26e4b86885SCheng Sean Ye */ 27e4b86885SCheng Sean Ye 28e4b86885SCheng Sean Ye #ifndef _SYS_DEVFM_H 29e4b86885SCheng Sean Ye #define _SYS_DEVFM_H 30e4b86885SCheng Sean Ye 31e4b86885SCheng Sean Ye #include <sys/types.h> 32e4b86885SCheng Sean Ye #include <sys/nvpair.h> 33e4b86885SCheng Sean Ye 34e4b86885SCheng Sean Ye #ifdef __cplusplus 35e4b86885SCheng Sean Ye extern "C" { 36e4b86885SCheng Sean Ye #endif 37e4b86885SCheng Sean Ye 38*dd23d762SRobert Mustacchi #define FM_IOC_MAXBUFSZ 32768 /* 32 KiB */ 39*dd23d762SRobert Mustacchi #define FM_IOC_OUT_BUFSZ 32768 /* 32 KiB */ 40*dd23d762SRobert Mustacchi #define FM_IOC_OUT_MAXBUFSZ 1048576 /* 1 MiB */ 41e4b86885SCheng Sean Ye #define FM_DRV_VERSION 1 42e4b86885SCheng Sean Ye 43e4b86885SCheng Sean Ye #define FM_VERSIONS_VERSION "fm-versions-version" 44e4b86885SCheng Sean Ye #define FM_PAGE_OP_VERSION "page-operation-version" 45e4b86885SCheng Sean Ye #define FM_CPU_OP_VERSION "cpu-operation-version" 46e4b86885SCheng Sean Ye #define FM_CPU_INFO_VERSION "cpu-info-version" 47074bb90dSTom Pothier #define FM_TOPO_LEGACY_VERSION "topo-legacy-version" 48*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_VERSION "cache-info-version" 49e4b86885SCheng Sean Ye 50e4b86885SCheng Sean Ye /* 51e4b86885SCheng Sean Ye * FMA driver ioctl interfaces 52e4b86885SCheng Sean Ye */ 53e4b86885SCheng Sean Ye #define FM_IOC (0xFA << 16) 54e4b86885SCheng Sean Ye #define FM_IOC_VERSIONS (FM_IOC | 1) 55e4b86885SCheng Sean Ye #define FM_IOC_PAGE_RETIRE (FM_IOC | 2) 56e4b86885SCheng Sean Ye #define FM_IOC_PAGE_STATUS (FM_IOC | 3) 57e4b86885SCheng Sean Ye #define FM_IOC_PAGE_UNRETIRE (FM_IOC | 4) 58e4b86885SCheng Sean Ye 59e4b86885SCheng Sean Ye #if defined(__x86) 60e4b86885SCheng Sean Ye #define FM_IOC_PHYSCPU_INFO (FM_IOC | 5) 61e4b86885SCheng Sean Ye #define FM_IOC_CPU_RETIRE (FM_IOC | 6) 62e4b86885SCheng Sean Ye #define FM_IOC_CPU_STATUS (FM_IOC | 7) 63e4b86885SCheng Sean Ye #define FM_IOC_CPU_UNRETIRE (FM_IOC | 8) 64074bb90dSTom Pothier #define FM_IOC_GENTOPO_LEGACY (FM_IOC | 9) 65e4b86885SCheng Sean Ye #endif /* __x86 */ 66e4b86885SCheng Sean Ye 67*dd23d762SRobert Mustacchi /* 68*dd23d762SRobert Mustacchi * Information about caches. Each CPU that is in the physical CPU information 69*dd23d762SRobert Mustacchi * will be in here in the same ID order allowing one to map them directly. 70*dd23d762SRobert Mustacchi */ 71*dd23d762SRobert Mustacchi #define FM_IOC_CACHE_INFO (FM_IOC | 10) 72*dd23d762SRobert Mustacchi 73e4b86885SCheng Sean Ye /* 74e4b86885SCheng Sean Ye * Types 75e4b86885SCheng Sean Ye */ 76e4b86885SCheng Sean Ye typedef struct fm_ioc_data { 77e4b86885SCheng Sean Ye uint32_t fid_version; /* interface version */ 78e4b86885SCheng Sean Ye size_t fid_insz; /* size of packed input nvlist */ 79e4b86885SCheng Sean Ye caddr_t fid_inbuf; /* buf containing packed input nvl */ 80e4b86885SCheng Sean Ye size_t fid_outsz; /* size of packed output nvlist */ 81e4b86885SCheng Sean Ye caddr_t fid_outbuf; /* buf containing packed output nvl */ 82e4b86885SCheng Sean Ye } fm_ioc_data_t; 83e4b86885SCheng Sean Ye 84e4b86885SCheng Sean Ye #ifdef _KERNEL 85e4b86885SCheng Sean Ye typedef struct fm_ioc_data32 { 86e4b86885SCheng Sean Ye uint32_t fid_version; /* interface version */ 87e4b86885SCheng Sean Ye size32_t fid_insz; /* size of packed input nvlist */ 88e4b86885SCheng Sean Ye caddr32_t fid_inbuf; /* buf containing packed input nvl */ 89e4b86885SCheng Sean Ye size32_t fid_outsz; /* size of packed output nvlist */ 90e4b86885SCheng Sean Ye caddr32_t fid_outbuf; /* buf containing packed output nvl */ 91e4b86885SCheng Sean Ye } fm_ioc_data32_t; 92e4b86885SCheng Sean Ye #endif /* _KERNEL */ 93e4b86885SCheng Sean Ye 94e4b86885SCheng Sean Ye /* 95e4b86885SCheng Sean Ye * Constants 96e4b86885SCheng Sean Ye */ 978031591dSSrihari Venkatesan #define FM_PAGE_RETIRE_FMRI "fmri" 988031591dSSrihari Venkatesan #define FM_PHYSCPU_INFO_CPUS "cpus" 998031591dSSrihari Venkatesan #define FM_CPU_RETIRE_CHIP_ID "chip_id" 1008031591dSSrihari Venkatesan #define FM_PHYSCPU_INFO_NPROCNODES "procnodes_per_pkg" 1018031591dSSrihari Venkatesan #define FM_PHYSCPU_INFO_PROCNODE_ID "procnodeid" 1028031591dSSrihari Venkatesan #define FM_CPU_RETIRE_CORE_ID "core_id" 1038031591dSSrihari Venkatesan #define FM_CPU_RETIRE_STRAND_ID "strand_id" 1048031591dSSrihari Venkatesan #define FM_CPU_RETIRE_OLDSTATUS "oldstatus" 1058031591dSSrihari Venkatesan #define FM_GENTOPO_LEGACY "gentopolegacy" 106*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_NCPUS "ncpus" 107e4b86885SCheng Sean Ye 108e4b86885SCheng Sean Ye /* 109e4b86885SCheng Sean Ye * Properties set by FM_PHYSCPU_INFO 110e4b86885SCheng Sean Ye */ 111e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_VENDOR_ID "vendor_id" 112e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_FAMILY "family" 113e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_MODEL "model" 114e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_STEPPING "stepping" 115074bb90dSTom Pothier 116074bb90dSTom Pothier /* 117074bb90dSTom Pothier * When Multi-Chip-Module(MCM) support is added 118074bb90dSTom Pothier * chip_id should map to the processor package 119074bb90dSTom Pothier * and not the die in the processor package. 120074bb90dSTom Pothier * This is for FMA; kernel's perception of 121074bb90dSTom Pothier * chip_id could differ for MCM. 122074bb90dSTom Pothier */ 123e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_CHIP_ID "chip_id" 124074bb90dSTom Pothier 125e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_CORE_ID "core_id" 126e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_STRAND_ID "strand_id" 127074bb90dSTom Pothier #define FM_PHYSCPU_INFO_STRAND_APICID "strand_initial_apicid" 128074bb90dSTom Pothier #define FM_PHYSCPU_INFO_SMBIOS_ID "smbios_id" 129074bb90dSTom Pothier #define FM_PHYSCPU_INFO_CHIP_ROOTS "chip_roots" 130e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_CHIP_REV "chip_rev" 131e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_SOCKET_TYPE "socket_type" 132e4b86885SCheng Sean Ye #define FM_PHYSCPU_INFO_CPU_ID "cpuid" 1332a613b59SRobert Mustacchi #define FM_PHYSCPU_INFO_CHIP_IDENTSTR "chip_identstr" 134e4b86885SCheng Sean Ye 135*dd23d762SRobert Mustacchi /* 136*dd23d762SRobert Mustacchi * Information exposed by the cache information structure. This is currently 137*dd23d762SRobert Mustacchi * organized by the given caches available to a CPU. There is a given nvlist_t 138*dd23d762SRobert Mustacchi * array for each cache level. The majority of these entries are meant to be 139*dd23d762SRobert Mustacchi * generic across all platforms and derived from the underlying architecture's 140*dd23d762SRobert Mustacchi * metadata (CPUID, CLIDR_EL1, etc.). 141*dd23d762SRobert Mustacchi * 142*dd23d762SRobert Mustacchi * The FM_CACHE_INFO_ID value is manufactured by the kernel. CPU architectures 143*dd23d762SRobert Mustacchi * generally present cache information as specific to a logical CPU. This allows 144*dd23d762SRobert Mustacchi * systems to determine what level caches are shared between different CPUs by 145*dd23d762SRobert Mustacchi * comparing these entries across CPUs. Items prefixed with a given architecture 146*dd23d762SRobert Mustacchi * are specific to it and will not show up on other platforms. These exist so 147*dd23d762SRobert Mustacchi * topology modules can have more information than just the cache-id. While it's 148*dd23d762SRobert Mustacchi * helpful, it doesn't tell us what level of the CPU (or whether it's internal 149*dd23d762SRobert Mustacchi * or external) it exists at. This is going to be architecture and potentially 150*dd23d762SRobert Mustacchi * platform specific given that ARMv8-A/ARMv9-A doesn't define a way to get this 151*dd23d762SRobert Mustacchi * for example. 152*dd23d762SRobert Mustacchi * 153*dd23d762SRobert Mustacchi * It is expected that callers will always fill out the sets and ways 154*dd23d762SRobert Mustacchi * appropriately. If a cache is fully-associative, we expects the number of sets 155*dd23d762SRobert Mustacchi * to be populated and set to 1 that way consumers can attempt to have a uniform 156*dd23d762SRobert Mustacchi * experience here. 157*dd23d762SRobert Mustacchi */ 158*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_LEVEL "cache-level" /* uint32_t */ 159*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_TYPE "cache-type" /* uint32_t */ 160*dd23d762SRobert Mustacchi typedef enum { 161*dd23d762SRobert Mustacchi FM_CACHE_INFO_T_DATA = 1 << 0, 162*dd23d762SRobert Mustacchi FM_CACHE_INFO_T_INSTR = 1 << 1, 163*dd23d762SRobert Mustacchi FM_CACHE_INFO_T_UNIFIED = 1 << 2 164*dd23d762SRobert Mustacchi } fm_cache_info_type_t; 165*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_NSETS "cache-sets" /* uint64_t */ 166*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_NWAYS "cache-ways" /* uint32_t */ 167*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_LINE_SIZE "line-size" /* uint32_t */ 168*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_TOTAL_SIZE "total-size" /* uint64_t */ 169*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_FULLY_ASSOC "fully-associative" /* boolean (key) */ 170*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_ID "cache-id" /* uint64_t */ 171*dd23d762SRobert Mustacchi #define FM_CACHE_INFO_X86_APIC_SHIFT "x86-apic-shift" /* uint32_t */ 172*dd23d762SRobert Mustacchi 173e4b86885SCheng Sean Ye #ifdef __cplusplus 174e4b86885SCheng Sean Ye } 175e4b86885SCheng Sean Ye #endif 176e4b86885SCheng Sean Ye 177e4b86885SCheng Sean Ye #endif /* _SYS_DEVFM_H */ 178