1 /* $NetBSD: acpi_srat.h,v 1.3 2010/03/05 08:30:48 jruoho Exp $ */ 2 3 /* 4 * Copyright (c) 2009 The NetBSD Foundation, Inc. 5 * All rights reserved. 6 * 7 * This code is derived from software contributed to The NetBSD Foundation 8 * by Christoph Egger. 9 * 10 * Redistribution and use in source and binary forms, with or without 11 * modification, are permitted provided that the following conditions 12 * are met: 13 * 1. Redistributions of source code must retain the above copyright 14 * notice, this list of conditions and the following disclaimer. 15 * 2. Redistributions in binary form must reproduce the above copyright 16 * notice, this list of conditions and the following disclaimer in the 17 * documentation and/or other materials provided with the distribution. 18 * 19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS 20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS 23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 29 * POSSIBILITY OF SUCH DAMAGE. 30 */ 31 32 #ifndef _SYS_DEV_ACPI_ACPI_SRAT_H 33 #define _SYS_DEV_ACPI_ACPI_SRAT_H 34 35 typedef uint32_t acpisrat_nodeid_t; 36 37 struct acpisrat_cpu { 38 acpisrat_nodeid_t nodeid; 39 uint32_t apicid; 40 uint32_t sapiceid; 41 uint32_t flags; 42 43 /* clockdomain has a meaningful value when the ACPI MADT table has 44 * ACPI_MADT_TYPE_LOCAL_X2APIC and/or ACPI_MADT_TYPE_LOCAL_X2APIC_NMI 45 * entries or ACPI CPU device have a _CDM. 46 */ 47 uint32_t clockdomain; 48 }; 49 50 struct acpisrat_mem { 51 acpisrat_nodeid_t nodeid; 52 uint64_t baseaddress; 53 uint64_t length; 54 uint32_t flags; 55 }; 56 57 /* Returns true if ACPI SRAT table is available. 58 * 59 * If table does not exist, all functions below 60 * have undefined behaviour. 61 */ 62 bool acpisrat_exist(void); 63 64 /* Initializes parser. Must be the first function 65 * being called when table is available. 66 */ 67 int acpisrat_init(void); 68 69 /* Re-parse ACPI SRAT table. Useful after 70 * hotplugging cpu or RAM. 71 */ 72 int acpisrat_refresh(void); 73 74 /* Free allocated memory. Should be called 75 * when acpisrat is no longer of any use. 76 */ 77 int acpisrat_exit(void); 78 79 void acpisrat_dump(void); 80 81 /* Get number of NUMA nodes */ 82 uint32_t acpisrat_nodes(void); 83 84 /* Get number of cpus in the node. 85 * 0 means, this is a cpu-less node. 86 */ 87 uint32_t acpisrat_node_cpus(acpisrat_nodeid_t); 88 89 /* Get number of memory ranges in the node 90 * 0 means, this node has no RAM. 91 */ 92 uint32_t acpisrat_node_memoryranges(acpisrat_nodeid_t); 93 94 /* Retrieve cpu and memory info. */ 95 void acpisrat_cpu(acpisrat_nodeid_t, uint32_t cpunum, struct acpisrat_cpu *); 96 void acpisrat_mem(acpisrat_nodeid_t, uint32_t memrange, struct acpisrat_mem *); 97 98 #endif /* !_SYS_DEV_ACPI_ACPI_SRAT_H */ 99