1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2019 Intel Corporation
8 #include <rte_config.h>
9 #include <rte_eal_memconfig.h>
10 #include <rte_malloc_heap.h>
11 #include <rte_memory.h>
12 #include <rte_memzone.h>
13 #include <rte_pause.h>
14 #include <rte_spinlock.h>
15 #include <rte_rwlock.h>
16 #include <rte_tailq.h>
19 * Memory configuration shared across multiple processes.
21 struct rte_mem_config {
22 volatile uint32_t magic; /**< Magic number - sanity check. */
24 /**< Prevent secondary processes using different DPDK versions. */
27 uint32_t nchannel; /**< Number of channels (0 if unknown). */
28 uint32_t nrank; /**< Number of ranks (0 if unknown). */
31 * current lock nest order
32 * - qlock->mlock (ring/hash/lpm)
33 * - mplock->qlock->mlock (mempool)
35 * *ALWAYS* obtain qlock first if having to obtain both qlock and mlock
37 rte_rwlock_t mlock; /**< used by memzones for thread safety. */
38 rte_rwlock_t qlock; /**< used by tailqs for thread safety. */
39 rte_rwlock_t mplock; /**< used by mempool library for thread safety. */
40 rte_spinlock_t tlock; /**< used by timer library for thread safety. */
42 rte_rwlock_t memory_hotplug_lock;
43 /**< Indicates whether memory hotplug request is in progress. */
45 /* memory segments and zones */
46 struct rte_fbarray memzones; /**< Memzone descriptors. */
48 struct rte_memseg_list memsegs[RTE_MAX_MEMSEG_LISTS];
49 /**< List of dynamic arrays holding memsegs */
51 struct rte_tailq_head tailq_head[RTE_MAX_TAILQ];
52 /**< Tailqs for objects */
54 struct malloc_heap malloc_heaps[RTE_MAX_HEAPS];
55 /**< DPDK malloc heaps */
57 int next_socket_id; /**< Next socket ID for external malloc heap */
59 /* rte_mem_config has to be mapped at the exact same address in all
60 * processes, so we need to store it.
62 uint64_t mem_cfg_addr; /**< Address of this structure in memory. */
64 /* Primary and secondary processes cannot run with different legacy or
65 * single file segments options, so to avoid having to specify these
66 * options to all processes, store them in shared config and update the
67 * internal config at init time.
69 uint32_t legacy_mem; /**< stored legacy mem parameter. */
70 uint32_t single_file_segments;
71 /**< stored single file segments parameter. */
73 uint8_t dma_maskbits; /**< Keeps the more restricted dma mask. */
76 /* update internal config from shared mem config */
78 eal_mcfg_update_internal(void);
80 /* update shared mem config from internal config */
82 eal_mcfg_update_from_internal(void);
84 /* wait until primary process initialization is complete */
86 eal_mcfg_wait_complete(void);
88 /* check if DPDK version of current process matches one stored in the config */
90 eal_mcfg_check_version(void);
92 /* set mem config as complete */
94 eal_mcfg_complete(void);
96 #endif /* EAL_MEMCFG_H */