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         uint64_t page_sz; /**< Page size for all memsegs in this list. */
  34         int socket_id; /**< Socket ID for all memsegs in this list. */
  35         volatile uint32_t version; /**< version number for multiprocess sync. */
  36         size_t len; /**< Length of memory area covered by this memseg list. */
  37         struct rte_fbarray memseg_arr;
  38 };
  39
  40 /**
  41  * the structure for the memory configuration for the RTE.
  42  * Used by the rte_config structure. It is separated out, as for multi-process
  43  * support, the memory details should be shared across instances
  44  */
  45 struct rte_mem_config {
  46         volatile uint32_t magic;   /**< Magic number - Sanity check. */
  47
  48         /* memory topology */
  49         uint32_t nchannel;    /**< Number of channels (0 if unknown). */
  50         uint32_t nrank;       /**< Number of ranks (0 if unknown). */
  51
  52         /**
  53          * current lock nest order
  54          *  - qlock->mlock (ring/hash/lpm)
  55          *  - mplock->qlock->mlock (mempool)
  56          * Notice:
  57          *  *ALWAYS* obtain qlock first if having to obtain both qlock and mlock
  58          */
  59         rte_rwlock_t mlock;   /**< only used by memzone LIB for thread-safe. */
  60         rte_rwlock_t qlock;   /**< used for tailq operation for thread safe. */
  61         rte_rwlock_t mplock;  /**< only used by mempool LIB for thread-safe. */
  62
  63         rte_rwlock_t memory_hotplug_lock;
  64         /**< indicates whether memory hotplug request is in progress. */
  65
  66         /* memory segments and zones */
  67         struct rte_fbarray memzones; /**< Memzone descriptors. */
  68
  69         struct rte_memseg_list memsegs[RTE_MAX_MEMSEG_LISTS];
  70         /**< list of dynamic arrays holding memsegs */
  71
  72         struct rte_tailq_head tailq_head[RTE_MAX_TAILQ]; /**< Tailqs for objects */
  73
  74         /* Heaps of Malloc per socket */
  75         struct malloc_heap malloc_heaps[RTE_MAX_NUMA_NODES];
  76
  77         /* address of mem_config in primary process. used to map shared config into
  78          * exact same address the primary process maps it.
  79          */
  80         uint64_t mem_cfg_addr;
  81
  82         /* legacy mem and single file segments options are shared */
  83         uint32_t legacy_mem;
  84         uint32_t single_file_segments;
  85 } __attribute__((__packed__));
  86
  87
  88 inline static void
  89 rte_eal_mcfg_wait_complete(struct rte_mem_config* mcfg)
  90 {
  91         /* wait until shared mem_config finish initialising */
  92         while(mcfg->magic != RTE_MAGIC)
  93                 rte_pause();
  94 }
  95
  96 #ifdef __cplusplus
  97 }
  98 #endif
  99
 100 #endif /*__RTE_EAL_MEMCONFIG_H_*/