include/hw/riscv/numa.h

   1 /*
   2  * QEMU RISC-V NUMA Helper
   3  *
   4  * Copyright (c) 2020 Western Digital Corporation or its affiliates.
   5  *
   6  * This program is free software; you can redistribute it and/or modify it
   7  * under the terms and conditions of the GNU General Public License,
   8  * version 2 or later, as published by the Free Software Foundation.
   9  *
  10  * This program is distributed in the hope it will be useful, but WITHOUT
  11  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  12  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
  13  * more details.
  14  *
  15  * You should have received a copy of the GNU General Public License along with
  16  * this program.  If not, see <http://www.gnu.org/licenses/>.
  17  */
  18
  19 #ifndef RISCV_NUMA_H
  20 #define RISCV_NUMA_H
  21
  22 #include "hw/boards.h"
  23 #include "hw/sysbus.h"
  24 #include "sysemu/numa.h"
  25
  26 /**
  27  * riscv_socket_count:
  28  * @ms: pointer to machine state
  29  *
  30  * Returns: number of sockets for a numa system and 1 for a non-numa system
  31  */
  32 int riscv_socket_count(const MachineState *ms);
  33
  34 /**
  35  * riscv_socket_first_hartid:
  36  * @ms: pointer to machine state
  37  * @socket_id: socket index
  38  *
  39  * Returns: first hartid for a valid socket and -1 for an invalid socket
  40  */
  41 int riscv_socket_first_hartid(const MachineState *ms, int socket_id);
  42
  43 /**
  44  * riscv_socket_last_hartid:
  45  * @ms: pointer to machine state
  46  * @socket_id: socket index
  47  *
  48  * Returns: last hartid for a valid socket and -1 for an invalid socket
  49  */
  50 int riscv_socket_last_hartid(const MachineState *ms, int socket_id);
  51
  52 /**
  53  * riscv_socket_hart_count:
  54  * @ms: pointer to machine state
  55  * @socket_id: socket index
  56  *
  57  * Returns: number of harts for a valid socket and -1 for an invalid socket
  58  */
  59 int riscv_socket_hart_count(const MachineState *ms, int socket_id);
  60
  61 /**
  62  * riscv_socket_mem_offset:
  63  * @ms: pointer to machine state
  64  * @socket_id: socket index
  65  *
  66  * Returns: offset of ram belonging to given socket
  67  */
  68 uint64_t riscv_socket_mem_offset(const MachineState *ms, int socket_id);
  69
  70 /**
  71  * riscv_socket_mem_size:
  72  * @ms: pointer to machine state
  73  * @socket_id: socket index
  74  *
  75  * Returns: size of ram belonging to given socket
  76  */
  77 uint64_t riscv_socket_mem_size(const MachineState *ms, int socket_id);
  78
  79 /**
  80  * riscv_socket_check_hartids:
  81  * @ms: pointer to machine state
  82  * @socket_id: socket index
  83  *
  84  * Returns: true if hardids belonging to given socket are contiguous else false
  85  */
  86 bool riscv_socket_check_hartids(const MachineState *ms, int socket_id);
  87
  88 /**
  89  * riscv_socket_fdt_write_id:
  90  * @ms: pointer to machine state
  91  * @socket_id: socket index
  92  *
  93  * Write NUMA node-id FDT property for given FDT node
  94  */
  95 void riscv_socket_fdt_write_id(const MachineState *ms, void *fdt,
  96                                const char *node_name, int socket_id);
  97
  98 /**
  99  * riscv_socket_fdt_write_distance_matrix:
 100  * @ms: pointer to machine state
 101  * @socket_id: socket index
 102  *
 103  * Write NUMA distance matrix in FDT for given machine
 104  */
 105 void riscv_socket_fdt_write_distance_matrix(const MachineState *ms, void *fdt);
 106
 107 CpuInstanceProperties
 108 riscv_numa_cpu_index_to_props(MachineState *ms, unsigned cpu_index);
 109
 110 int64_t riscv_numa_get_default_cpu_node_id(const MachineState *ms, int idx);
 111
 112 const CPUArchIdList *riscv_numa_possible_cpu_arch_ids(MachineState *ms);
 113
 114 #endif /* RISCV_NUMA_H */