lib/librte_eal/common/include/rte_eal_memconfig.h

   1 /* SPDX-License-Identifier: BSD-3-Clause
   2  * Copyright(c) 2010-2014 Intel Corporation
   3  */
   4
   5 #ifndef _RTE_EAL_MEMCONFIG_H_
   6 #define _RTE_EAL_MEMCONFIG_H_
   7
   8 #include <rte_config.h>
   9 #include <rte_tailq.h>
  10 #include <rte_memory.h>
  11 #include <rte_memzone.h>
  12 #include <rte_malloc_heap.h>
  13 #include <rte_rwlock.h>
  14 #include <rte_pause.h>
  15 #include <rte_fbarray.h>
  16
  17 #ifdef __cplusplus
  18 extern "C" {
  19 #endif
  20
  21 /**
  22  * memseg list is a special case as we need to store a bunch of other data
  23  * together with the array itself.
  24  */
  25 struct rte_memseg_list {
  26         RTE_STD_C11
  27         union {
  28                 void *base_va;
  29                 /**< Base virtual address for this memseg list. */
  30                 uint64_t addr_64;
  31                 /**< Makes sure addr is always 64-bits */
  32         };
  33         int socket_id; /**< Socket ID for all memsegs in this list. */
  34         uint64_t page_sz; /**< Page size for all memsegs in this list. */
  35         volatile uint32_t version; /**< version number for multiprocess sync. */
  36         struct rte_fbarray memseg_arr;
  37 };
  38
  39 /**
  40  * the structure for the memory configuration for the RTE.
  41  * Used by the rte_config structure. It is separated out, as for multi-process
  42  * support, the memory details should be shared across instances
  43  */
  44 struct rte_mem_config {
  45         volatile uint32_t magic;   /**< Magic number - Sanity check. */
  46
  47         /* memory topology */
  48         uint32_t nchannel;    /**< Number of channels (0 if unknown). */
  49         uint32_t nrank;       /**< Number of ranks (0 if unknown). */
  50
  51         /**
  52          * current lock nest order
  53          *  - qlock->mlock (ring/hash/lpm)
  54          *  - mplock->qlock->mlock (mempool)
  55          * Notice:
  56          *  *ALWAYS* obtain qlock first if having to obtain both qlock and mlock
  57          */
  58         rte_rwlock_t mlock;   /**< only used by memzone LIB for thread-safe. */
  59         rte_rwlock_t qlock;   /**< used for tailq operation for thread safe. */
  60         rte_rwlock_t mplock;  /**< only used by mempool LIB for thread-safe. */
  61
  62         rte_rwlock_t memory_hotplug_lock;
  63         /**< indicates whether memory hotplug request is in progress. */
  64
  65         /* memory segments and zones */
  66         struct rte_fbarray memzones; /**< Memzone descriptors. */
  67
  68         struct rte_memseg_list memsegs[RTE_MAX_MEMSEG_LISTS];
  69         /**< list of dynamic arrays holding memsegs */
  70
  71         struct rte_tailq_head tailq_head[RTE_MAX_TAILQ]; /**< Tailqs for objects */
  72
  73         /* Heaps of Malloc per socket */
  74         struct malloc_heap malloc_heaps[RTE_MAX_NUMA_NODES];
  75
  76         /* address of mem_config in primary process. used to map shared config into
  77          * exact same address the primary process maps it.
  78          */
  79         uint64_t mem_cfg_addr;
  80 } __attribute__((__packed__));
  81
  82
  83 inline static void
  84 rte_eal_mcfg_wait_complete(struct rte_mem_config* mcfg)
  85 {
  86         /* wait until shared mem_config finish initialising */
  87         while(mcfg->magic != RTE_MAGIC)
  88                 rte_pause();
  89 }
  90
  91 #ifdef __cplusplus
  92 }
  93 #endif
  94
  95 #endif /*__RTE_EAL_MEMCONFIG_H_*/