1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2018 Intel Corporation.
3 * Copyright(c) 2012-2014 6WIND S.A.
21 #include <sys/queue.h>
23 #if defined(RTE_ARCH_X86)
27 #include <rte_compat.h>
28 #include <rte_common.h>
29 #include <rte_debug.h>
30 #include <rte_memory.h>
31 #include <rte_launch.h>
33 #include <rte_eal_memconfig.h>
34 #include <rte_errno.h>
35 #include <rte_per_lcore.h>
36 #include <rte_lcore.h>
37 #include <rte_service_component.h>
39 #include <rte_random.h>
40 #include <rte_cycles.h>
41 #include <rte_string_fns.h>
42 #include <rte_cpuflags.h>
43 #include <rte_interrupts.h>
46 #include <rte_devargs.h>
47 #include <rte_version.h>
48 #include <rte_atomic.h>
49 #include <malloc_heap.h>
51 #include <rte_option.h>
53 #include "eal_private.h"
54 #include "eal_thread.h"
55 #include "eal_internal_cfg.h"
56 #include "eal_filesystem.h"
57 #include "eal_hugepages.h"
58 #include "eal_options.h"
61 #define MEMSIZE_IF_NO_HUGE_PAGE (64ULL * 1024ULL * 1024ULL)
63 #define SOCKET_MEM_STRLEN (RTE_MAX_NUMA_NODES * 10)
65 /* Allow the application to print its usage message too if set */
66 static rte_usage_hook_t rte_application_usage_hook = NULL;
68 /* early configuration structure, when memory config is not mmapped */
69 static struct rte_mem_config early_mem_config;
71 /* define fd variable here, because file needs to be kept open for the
72 * duration of the program, as we hold a write lock on it in the primary proc */
73 static int mem_cfg_fd = -1;
75 static struct flock wr_lock = {
78 .l_start = offsetof(struct rte_mem_config, memsegs),
79 .l_len = sizeof(early_mem_config.memsegs),
82 /* Address of global and public configuration */
83 static struct rte_config rte_config = {
84 .mem_config = &early_mem_config,
87 /* internal configuration (per-core) */
88 struct lcore_config lcore_config[RTE_MAX_LCORE];
90 /* internal configuration */
91 struct internal_config internal_config;
93 /* used by rte_rdtsc() */
94 int rte_cycles_vmware_tsc_map;
96 /* platform-specific runtime dir */
97 static char runtime_dir[PATH_MAX];
99 static const char *default_runtime_dir = "/var/run";
102 eal_create_runtime_dir(void)
104 const char *directory = default_runtime_dir;
105 const char *xdg_runtime_dir = getenv("XDG_RUNTIME_DIR");
106 const char *fallback = "/tmp";
111 /* try XDG path first, fall back to /tmp */
112 if (xdg_runtime_dir != NULL)
113 directory = xdg_runtime_dir;
115 directory = fallback;
117 /* create DPDK subdirectory under runtime dir */
118 ret = snprintf(tmp, sizeof(tmp), "%s/dpdk", directory);
119 if (ret < 0 || ret == sizeof(tmp)) {
120 RTE_LOG(ERR, EAL, "Error creating DPDK runtime path name\n");
124 /* create prefix-specific subdirectory under DPDK runtime dir */
125 ret = snprintf(runtime_dir, sizeof(runtime_dir), "%s/%s",
126 tmp, internal_config.hugefile_prefix);
127 if (ret < 0 || ret == sizeof(runtime_dir)) {
128 RTE_LOG(ERR, EAL, "Error creating prefix-specific runtime path name\n");
132 /* create the path if it doesn't exist. no "mkdir -p" here, so do it
135 ret = mkdir(tmp, 0700);
136 if (ret < 0 && errno != EEXIST) {
137 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
138 tmp, strerror(errno));
142 ret = mkdir(runtime_dir, 0700);
143 if (ret < 0 && errno != EEXIST) {
144 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
145 runtime_dir, strerror(errno));
153 eal_get_runtime_dir(void)
158 /* Return user provided mbuf pool ops name */
160 rte_eal_mbuf_user_pool_ops(void)
162 return internal_config.user_mbuf_pool_ops_name;
165 /* Return a pointer to the configuration structure */
167 rte_eal_get_configuration(void)
173 rte_eal_iova_mode(void)
175 return rte_eal_get_configuration()->iova_mode;
178 /* parse a sysfs (or other) file containing one integer value */
180 eal_parse_sysfs_value(const char *filename, unsigned long *val)
186 if ((f = fopen(filename, "r")) == NULL) {
187 RTE_LOG(ERR, EAL, "%s(): cannot open sysfs value %s\n",
192 if (fgets(buf, sizeof(buf), f) == NULL) {
193 RTE_LOG(ERR, EAL, "%s(): cannot read sysfs value %s\n",
198 *val = strtoul(buf, &end, 0);
199 if ((buf[0] == '\0') || (end == NULL) || (*end != '\n')) {
200 RTE_LOG(ERR, EAL, "%s(): cannot parse sysfs value %s\n",
210 /* create memory configuration in shared/mmap memory. Take out
211 * a write lock on the memsegs, so we can auto-detect primary/secondary.
212 * This means we never close the file while running (auto-close on exit).
213 * We also don't lock the whole file, so that in future we can use read-locks
214 * on other parts, e.g. memzones, to detect if there are running secondary
217 rte_eal_config_create(void)
219 void *rte_mem_cfg_addr;
222 const char *pathname = eal_runtime_config_path();
224 if (internal_config.no_shconf)
227 /* map the config before hugepage address so that we don't waste a page */
228 if (internal_config.base_virtaddr != 0)
229 rte_mem_cfg_addr = (void *)
230 RTE_ALIGN_FLOOR(internal_config.base_virtaddr -
231 sizeof(struct rte_mem_config), sysconf(_SC_PAGE_SIZE));
233 rte_mem_cfg_addr = NULL;
236 mem_cfg_fd = open(pathname, O_RDWR | O_CREAT, 0660);
238 rte_panic("Cannot open '%s' for rte_mem_config\n", pathname);
241 retval = ftruncate(mem_cfg_fd, sizeof(*rte_config.mem_config));
244 rte_panic("Cannot resize '%s' for rte_mem_config\n", pathname);
247 retval = fcntl(mem_cfg_fd, F_SETLK, &wr_lock);
250 rte_exit(EXIT_FAILURE, "Cannot create lock on '%s'. Is another primary "
251 "process running?\n", pathname);
254 rte_mem_cfg_addr = mmap(rte_mem_cfg_addr, sizeof(*rte_config.mem_config),
255 PROT_READ | PROT_WRITE, MAP_SHARED, mem_cfg_fd, 0);
257 if (rte_mem_cfg_addr == MAP_FAILED){
258 rte_panic("Cannot mmap memory for rte_config\n");
260 memcpy(rte_mem_cfg_addr, &early_mem_config, sizeof(early_mem_config));
261 rte_config.mem_config = rte_mem_cfg_addr;
263 /* store address of the config in the config itself so that secondary
264 * processes could later map the config into this exact location */
265 rte_config.mem_config->mem_cfg_addr = (uintptr_t) rte_mem_cfg_addr;
269 /* attach to an existing shared memory config */
271 rte_eal_config_attach(void)
273 struct rte_mem_config *mem_config;
275 const char *pathname = eal_runtime_config_path();
277 if (internal_config.no_shconf)
281 mem_cfg_fd = open(pathname, O_RDWR);
283 rte_panic("Cannot open '%s' for rte_mem_config\n", pathname);
286 /* map it as read-only first */
287 mem_config = (struct rte_mem_config *) mmap(NULL, sizeof(*mem_config),
288 PROT_READ, MAP_SHARED, mem_cfg_fd, 0);
289 if (mem_config == MAP_FAILED)
290 rte_panic("Cannot mmap memory for rte_config! error %i (%s)\n",
291 errno, strerror(errno));
293 rte_config.mem_config = mem_config;
296 /* reattach the shared config at exact memory location primary process has it */
298 rte_eal_config_reattach(void)
300 struct rte_mem_config *mem_config;
301 void *rte_mem_cfg_addr;
303 if (internal_config.no_shconf)
306 /* save the address primary process has mapped shared config to */
307 rte_mem_cfg_addr = (void *) (uintptr_t) rte_config.mem_config->mem_cfg_addr;
309 /* unmap original config */
310 munmap(rte_config.mem_config, sizeof(struct rte_mem_config));
312 /* remap the config at proper address */
313 mem_config = (struct rte_mem_config *) mmap(rte_mem_cfg_addr,
314 sizeof(*mem_config), PROT_READ | PROT_WRITE, MAP_SHARED,
316 if (mem_config == MAP_FAILED || mem_config != rte_mem_cfg_addr) {
317 if (mem_config != MAP_FAILED)
318 /* errno is stale, don't use */
319 rte_panic("Cannot mmap memory for rte_config at [%p], got [%p]"
320 " - please use '--base-virtaddr' option\n",
321 rte_mem_cfg_addr, mem_config);
323 rte_panic("Cannot mmap memory for rte_config! error %i (%s)\n",
324 errno, strerror(errno));
328 rte_config.mem_config = mem_config;
331 /* Detect if we are a primary or a secondary process */
333 eal_proc_type_detect(void)
335 enum rte_proc_type_t ptype = RTE_PROC_PRIMARY;
336 const char *pathname = eal_runtime_config_path();
338 /* if there no shared config, there can be no secondary processes */
339 if (!internal_config.no_shconf) {
340 /* if we can open the file but not get a write-lock we are a
341 * secondary process. NOTE: if we get a file handle back, we
342 * keep that open and don't close it to prevent a race condition
343 * between multiple opens.
345 if (((mem_cfg_fd = open(pathname, O_RDWR)) >= 0) &&
346 (fcntl(mem_cfg_fd, F_SETLK, &wr_lock) < 0))
347 ptype = RTE_PROC_SECONDARY;
350 RTE_LOG(INFO, EAL, "Auto-detected process type: %s\n",
351 ptype == RTE_PROC_PRIMARY ? "PRIMARY" : "SECONDARY");
356 /* copies data from internal config to shared config */
358 eal_update_mem_config(void)
360 struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
361 mcfg->legacy_mem = internal_config.legacy_mem;
362 mcfg->single_file_segments = internal_config.single_file_segments;
365 /* copies data from shared config to internal config */
367 eal_update_internal_config(void)
369 struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
370 internal_config.legacy_mem = mcfg->legacy_mem;
371 internal_config.single_file_segments = mcfg->single_file_segments;
374 /* Sets up rte_config structure with the pointer to shared memory config.*/
376 rte_config_init(void)
378 rte_config.process_type = internal_config.process_type;
380 switch (rte_config.process_type){
381 case RTE_PROC_PRIMARY:
382 rte_eal_config_create();
383 eal_update_mem_config();
385 case RTE_PROC_SECONDARY:
386 rte_eal_config_attach();
387 rte_eal_mcfg_wait_complete(rte_config.mem_config);
388 rte_eal_config_reattach();
389 eal_update_internal_config();
392 case RTE_PROC_INVALID:
393 rte_panic("Invalid process type\n");
397 /* Unlocks hugepage directories that were locked by eal_hugepage_info_init */
399 eal_hugedirs_unlock(void)
403 for (i = 0; i < MAX_HUGEPAGE_SIZES; i++)
405 /* skip uninitialized */
406 if (internal_config.hugepage_info[i].lock_descriptor < 0)
408 /* unlock hugepage file */
409 flock(internal_config.hugepage_info[i].lock_descriptor, LOCK_UN);
410 close(internal_config.hugepage_info[i].lock_descriptor);
411 /* reset the field */
412 internal_config.hugepage_info[i].lock_descriptor = -1;
418 eal_usage(const char *prgname)
420 printf("\nUsage: %s ", prgname);
422 printf("EAL Linux options:\n"
423 " --"OPT_SOCKET_MEM" Memory to allocate on sockets (comma separated values)\n"
424 " --"OPT_SOCKET_LIMIT" Limit memory allocation on sockets (comma separated values)\n"
425 " --"OPT_HUGE_DIR" Directory where hugetlbfs is mounted\n"
426 " --"OPT_FILE_PREFIX" Prefix for hugepage filenames\n"
427 " --"OPT_BASE_VIRTADDR" Base virtual address\n"
428 " --"OPT_CREATE_UIO_DEV" Create /dev/uioX (usually done by hotplug)\n"
429 " --"OPT_VFIO_INTR" Interrupt mode for VFIO (legacy|msi|msix)\n"
430 " --"OPT_LEGACY_MEM" Legacy memory mode (no dynamic allocation, contiguous segments)\n"
431 " --"OPT_SINGLE_FILE_SEGMENTS" Put all hugepage memory in single files\n"
433 /* Allow the application to print its usage message too if hook is set */
434 if ( rte_application_usage_hook ) {
435 printf("===== Application Usage =====\n\n");
436 rte_application_usage_hook(prgname);
440 /* Set a per-application usage message */
442 rte_set_application_usage_hook( rte_usage_hook_t usage_func )
444 rte_usage_hook_t old_func;
446 /* Will be NULL on the first call to denote the last usage routine. */
447 old_func = rte_application_usage_hook;
448 rte_application_usage_hook = usage_func;
454 eal_parse_socket_arg(char *strval, volatile uint64_t *socket_arg)
456 char * arg[RTE_MAX_NUMA_NODES];
459 uint64_t total_mem = 0;
461 len = strnlen(strval, SOCKET_MEM_STRLEN);
462 if (len == SOCKET_MEM_STRLEN) {
463 RTE_LOG(ERR, EAL, "--socket-mem is too long\n");
467 /* all other error cases will be caught later */
468 if (!isdigit(strval[len-1]))
471 /* split the optarg into separate socket values */
472 arg_num = rte_strsplit(strval, len,
473 arg, RTE_MAX_NUMA_NODES, ',');
475 /* if split failed, or 0 arguments */
479 /* parse each defined socket option */
481 for (i = 0; i < arg_num; i++) {
484 val = strtoull(arg[i], &end, 10);
486 /* check for invalid input */
488 (arg[i][0] == '\0') || (end == NULL) || (*end != '\0'))
495 /* check if we have a positive amount of total memory */
503 eal_parse_base_virtaddr(const char *arg)
509 addr = strtoull(arg, &end, 16);
511 /* check for errors */
512 if ((errno != 0) || (arg[0] == '\0') || end == NULL || (*end != '\0'))
515 /* make sure we don't exceed 32-bit boundary on 32-bit target */
517 if (addr >= UINTPTR_MAX)
521 /* align the addr on 16M boundary, 16MB is the minimum huge page
522 * size on IBM Power architecture. If the addr is aligned to 16MB,
523 * it can align to 2MB for x86. So this alignment can also be used
525 internal_config.base_virtaddr =
526 RTE_PTR_ALIGN_CEIL((uintptr_t)addr, (size_t)RTE_PGSIZE_16M);
532 eal_parse_vfio_intr(const char *mode)
537 enum rte_intr_mode value;
539 { "legacy", RTE_INTR_MODE_LEGACY },
540 { "msi", RTE_INTR_MODE_MSI },
541 { "msix", RTE_INTR_MODE_MSIX },
544 for (i = 0; i < RTE_DIM(map); i++) {
545 if (!strcmp(mode, map[i].name)) {
546 internal_config.vfio_intr_mode = map[i].value;
553 /* Parse the arguments for --log-level only */
555 eal_log_level_parse(int argc, char **argv)
560 const int old_optind = optind;
561 const int old_optopt = optopt;
562 char * const old_optarg = optarg;
567 while ((opt = getopt_long(argc, argvopt, eal_short_options,
568 eal_long_options, &option_index)) != EOF) {
572 /* getopt is not happy, stop right now */
576 ret = (opt == OPT_LOG_LEVEL_NUM) ?
577 eal_parse_common_option(opt, optarg, &internal_config) : 0;
579 /* common parser is not happy */
584 /* restore getopt lib */
590 /* Parse the argument given in the command line of the application */
592 eal_parse_args(int argc, char **argv)
597 char *prgname = argv[0];
598 const int old_optind = optind;
599 const int old_optopt = optopt;
600 char * const old_optarg = optarg;
606 while ((opt = getopt_long(argc, argvopt, eal_short_options,
607 eal_long_options, &option_index)) != EOF) {
610 * getopt didn't recognise the option, lets parse the
611 * registered options to see if the flag is valid
614 ret = rte_option_parse(argv[optind-1]);
623 ret = eal_parse_common_option(opt, optarg, &internal_config);
624 /* common parser is not happy */
630 /* common parser handled this option */
639 case OPT_HUGE_DIR_NUM:
640 internal_config.hugepage_dir = strdup(optarg);
643 case OPT_FILE_PREFIX_NUM:
644 internal_config.hugefile_prefix = strdup(optarg);
647 case OPT_SOCKET_MEM_NUM:
648 if (eal_parse_socket_arg(optarg,
649 internal_config.socket_mem) < 0) {
650 RTE_LOG(ERR, EAL, "invalid parameters for --"
651 OPT_SOCKET_MEM "\n");
656 internal_config.force_sockets = 1;
659 case OPT_SOCKET_LIMIT_NUM:
660 if (eal_parse_socket_arg(optarg,
661 internal_config.socket_limit) < 0) {
662 RTE_LOG(ERR, EAL, "invalid parameters for --"
663 OPT_SOCKET_LIMIT "\n");
668 internal_config.force_socket_limits = 1;
671 case OPT_BASE_VIRTADDR_NUM:
672 if (eal_parse_base_virtaddr(optarg) < 0) {
673 RTE_LOG(ERR, EAL, "invalid parameter for --"
674 OPT_BASE_VIRTADDR "\n");
681 case OPT_VFIO_INTR_NUM:
682 if (eal_parse_vfio_intr(optarg) < 0) {
683 RTE_LOG(ERR, EAL, "invalid parameters for --"
691 case OPT_CREATE_UIO_DEV_NUM:
692 internal_config.create_uio_dev = 1;
695 case OPT_MBUF_POOL_OPS_NAME_NUM:
696 internal_config.user_mbuf_pool_ops_name =
701 if (opt < OPT_LONG_MIN_NUM && isprint(opt)) {
702 RTE_LOG(ERR, EAL, "Option %c is not supported "
704 } else if (opt >= OPT_LONG_MIN_NUM &&
705 opt < OPT_LONG_MAX_NUM) {
706 RTE_LOG(ERR, EAL, "Option %s is not supported "
708 eal_long_options[option_index].name);
710 RTE_LOG(ERR, EAL, "Option %d is not supported "
719 /* create runtime data directory */
720 if (internal_config.no_shconf == 0 &&
721 eal_create_runtime_dir() < 0) {
722 RTE_LOG(ERR, EAL, "Cannot create runtime directory\n");
727 if (eal_adjust_config(&internal_config) != 0) {
733 if (eal_check_common_options(&internal_config) != 0) {
740 argv[optind-1] = prgname;
744 /* restore getopt lib */
753 check_socket(const struct rte_memseg_list *msl, void *arg)
755 int *socket_id = arg;
760 return *socket_id == msl->socket_id;
764 eal_check_mem_on_local_socket(void)
768 socket_id = rte_lcore_to_socket_id(rte_config.master_lcore);
770 if (rte_memseg_list_walk(check_socket, &socket_id) == 0)
771 RTE_LOG(WARNING, EAL, "WARNING: Master core has no memory on local socket!\n");
775 sync_func(__attribute__((unused)) void *arg)
781 rte_eal_mcfg_complete(void)
783 /* ALL shared mem_config related INIT DONE */
784 if (rte_config.process_type == RTE_PROC_PRIMARY)
785 rte_config.mem_config->magic = RTE_MAGIC;
787 internal_config.init_complete = 1;
791 * Request iopl privilege for all RPL, returns 0 on success
792 * iopl() call is mostly for the i386 architecture. For other architectures,
793 * return -1 to indicate IO privilege can't be changed in this way.
796 rte_eal_iopl_init(void)
798 #if defined(RTE_ARCH_X86)
806 static int rte_eal_vfio_setup(void)
808 if (rte_vfio_enable("vfio"))
815 static void rte_eal_init_alert(const char *msg)
817 fprintf(stderr, "EAL: FATAL: %s\n", msg);
818 RTE_LOG(ERR, EAL, "%s\n", msg);
821 /* Launch threads, called at application init(). */
823 rte_eal_init(int argc, char **argv)
827 static rte_atomic32_t run_once = RTE_ATOMIC32_INIT(0);
829 char cpuset[RTE_CPU_AFFINITY_STR_LEN];
830 char thread_name[RTE_MAX_THREAD_NAME_LEN];
832 /* checks if the machine is adequate */
833 if (!rte_cpu_is_supported()) {
834 rte_eal_init_alert("unsupported cpu type.");
839 if (!rte_atomic32_test_and_set(&run_once)) {
840 rte_eal_init_alert("already called initialization.");
841 rte_errno = EALREADY;
845 logid = strrchr(argv[0], '/');
846 logid = strdup(logid ? logid + 1: argv[0]);
848 thread_id = pthread_self();
850 eal_reset_internal_config(&internal_config);
852 /* set log level as early as possible */
853 eal_log_level_parse(argc, argv);
855 if (rte_eal_cpu_init() < 0) {
856 rte_eal_init_alert("Cannot detect lcores.");
861 fctret = eal_parse_args(argc, argv);
863 rte_eal_init_alert("Invalid 'command line' arguments.");
865 rte_atomic32_clear(&run_once);
869 if (eal_plugins_init() < 0) {
870 rte_eal_init_alert("Cannot init plugins");
872 rte_atomic32_clear(&run_once);
876 if (eal_option_device_parse()) {
878 rte_atomic32_clear(&run_once);
884 if (rte_eal_intr_init() < 0) {
885 rte_eal_init_alert("Cannot init interrupt-handling thread");
889 /* Put mp channel init before bus scan so that we can init the vdev
890 * bus through mp channel in the secondary process before the bus scan.
892 if (rte_mp_channel_init() < 0) {
893 rte_eal_init_alert("failed to init mp channel");
894 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
900 /* register multi-process action callbacks for hotplug */
901 if (rte_mp_dev_hotplug_init() < 0) {
902 rte_eal_init_alert("failed to register mp callback for hotplug");
906 if (rte_bus_scan()) {
907 rte_eal_init_alert("Cannot scan the buses for devices");
909 rte_atomic32_clear(&run_once);
913 /* autodetect the iova mapping mode (default is iova_pa) */
914 rte_eal_get_configuration()->iova_mode = rte_bus_get_iommu_class();
916 /* Workaround for KNI which requires physical address to work */
917 if (rte_eal_get_configuration()->iova_mode == RTE_IOVA_VA &&
918 rte_eal_check_module("rte_kni") == 1) {
919 rte_eal_get_configuration()->iova_mode = RTE_IOVA_PA;
920 RTE_LOG(WARNING, EAL,
921 "Some devices want IOVA as VA but PA will be used because.. "
922 "KNI module inserted\n");
925 if (internal_config.no_hugetlbfs == 0) {
926 /* rte_config isn't initialized yet */
927 ret = internal_config.process_type == RTE_PROC_PRIMARY ?
928 eal_hugepage_info_init() :
929 eal_hugepage_info_read();
931 rte_eal_init_alert("Cannot get hugepage information.");
933 rte_atomic32_clear(&run_once);
938 if (internal_config.memory == 0 && internal_config.force_sockets == 0) {
939 if (internal_config.no_hugetlbfs)
940 internal_config.memory = MEMSIZE_IF_NO_HUGE_PAGE;
943 if (internal_config.vmware_tsc_map == 1) {
944 #ifdef RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT
945 rte_cycles_vmware_tsc_map = 1;
946 RTE_LOG (DEBUG, EAL, "Using VMWARE TSC MAP, "
947 "you must have monitor_control.pseudo_perfctr = TRUE\n");
949 RTE_LOG (WARNING, EAL, "Ignoring --vmware-tsc-map because "
950 "RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT is not set\n");
954 rte_srand(rte_rdtsc());
956 if (rte_eal_log_init(logid, internal_config.syslog_facility) < 0) {
957 rte_eal_init_alert("Cannot init logging.");
959 rte_atomic32_clear(&run_once);
964 if (rte_eal_vfio_setup() < 0) {
965 rte_eal_init_alert("Cannot init VFIO");
967 rte_atomic32_clear(&run_once);
971 /* in secondary processes, memory init may allocate additional fbarrays
972 * not present in primary processes, so to avoid any potential issues,
973 * initialize memzones first.
975 if (rte_eal_memzone_init() < 0) {
976 rte_eal_init_alert("Cannot init memzone");
981 if (rte_eal_memory_init() < 0) {
982 rte_eal_init_alert("Cannot init memory");
987 /* the directories are locked during eal_hugepage_info_init */
988 eal_hugedirs_unlock();
990 if (rte_eal_malloc_heap_init() < 0) {
991 rte_eal_init_alert("Cannot init malloc heap");
996 if (rte_eal_tailqs_init() < 0) {
997 rte_eal_init_alert("Cannot init tail queues for objects");
1002 if (rte_eal_alarm_init() < 0) {
1003 rte_eal_init_alert("Cannot init interrupt-handling thread");
1004 /* rte_eal_alarm_init sets rte_errno on failure. */
1008 if (rte_eal_timer_init() < 0) {
1009 rte_eal_init_alert("Cannot init HPET or TSC timers");
1010 rte_errno = ENOTSUP;
1014 eal_check_mem_on_local_socket();
1016 eal_thread_init_master(rte_config.master_lcore);
1018 ret = eal_thread_dump_affinity(cpuset, sizeof(cpuset));
1020 RTE_LOG(DEBUG, EAL, "Master lcore %u is ready (tid=%zx;cpuset=[%s%s])\n",
1021 rte_config.master_lcore, (uintptr_t)thread_id, cpuset,
1022 ret == 0 ? "" : "...");
1024 RTE_LCORE_FOREACH_SLAVE(i) {
1027 * create communication pipes between master thread
1030 if (pipe(lcore_config[i].pipe_master2slave) < 0)
1031 rte_panic("Cannot create pipe\n");
1032 if (pipe(lcore_config[i].pipe_slave2master) < 0)
1033 rte_panic("Cannot create pipe\n");
1035 lcore_config[i].state = WAIT;
1037 /* create a thread for each lcore */
1038 ret = pthread_create(&lcore_config[i].thread_id, NULL,
1039 eal_thread_loop, NULL);
1041 rte_panic("Cannot create thread\n");
1043 /* Set thread_name for aid in debugging. */
1044 snprintf(thread_name, sizeof(thread_name),
1045 "lcore-slave-%d", i);
1046 ret = rte_thread_setname(lcore_config[i].thread_id,
1050 "Cannot set name for lcore thread\n");
1054 * Launch a dummy function on all slave lcores, so that master lcore
1055 * knows they are all ready when this function returns.
1057 rte_eal_mp_remote_launch(sync_func, NULL, SKIP_MASTER);
1058 rte_eal_mp_wait_lcore();
1060 /* initialize services so vdevs register service during bus_probe. */
1061 ret = rte_service_init();
1063 rte_eal_init_alert("rte_service_init() failed");
1064 rte_errno = ENOEXEC;
1068 /* Probe all the buses and devices/drivers on them */
1069 if (rte_bus_probe()) {
1070 rte_eal_init_alert("Cannot probe devices");
1071 rte_errno = ENOTSUP;
1076 /* Register mp action after probe() so that we got enough info */
1077 if (rte_vfio_is_enabled("vfio") && vfio_mp_sync_setup() < 0)
1081 /* initialize default service/lcore mappings and start running. Ignore
1082 * -ENOTSUP, as it indicates no service coremask passed to EAL.
1084 ret = rte_service_start_with_defaults();
1085 if (ret < 0 && ret != -ENOTSUP) {
1086 rte_errno = ENOEXEC;
1090 rte_eal_mcfg_complete();
1092 /* Call each registered callback, if enabled */
1099 mark_freeable(const struct rte_memseg_list *msl, const struct rte_memseg *ms,
1100 void *arg __rte_unused)
1102 /* ms is const, so find this memseg */
1103 struct rte_memseg *found;
1108 found = rte_mem_virt2memseg(ms->addr, msl);
1110 found->flags &= ~RTE_MEMSEG_FLAG_DO_NOT_FREE;
1115 int __rte_experimental
1116 rte_eal_cleanup(void)
1118 /* if we're in a primary process, we need to mark hugepages as freeable
1119 * so that finalization can release them back to the system.
1121 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
1122 rte_memseg_walk(mark_freeable, NULL);
1123 rte_service_finalize();
1128 enum rte_lcore_role_t
1129 rte_eal_lcore_role(unsigned lcore_id)
1131 return rte_config.lcore_role[lcore_id];
1134 enum rte_proc_type_t
1135 rte_eal_process_type(void)
1137 return rte_config.process_type;
1140 int rte_eal_has_hugepages(void)
1142 return ! internal_config.no_hugetlbfs;
1145 int rte_eal_has_pci(void)
1147 return !internal_config.no_pci;
1150 int rte_eal_create_uio_dev(void)
1152 return internal_config.create_uio_dev;
1156 rte_eal_vfio_intr_mode(void)
1158 return internal_config.vfio_intr_mode;
1162 rte_eal_check_module(const char *module_name)
1164 char sysfs_mod_name[PATH_MAX];
1168 if (NULL == module_name)
1171 /* Check if there is sysfs mounted */
1172 if (stat("/sys/module", &st) != 0) {
1173 RTE_LOG(DEBUG, EAL, "sysfs is not mounted! error %i (%s)\n",
1174 errno, strerror(errno));
1178 /* A module might be built-in, therefore try sysfs */
1179 n = snprintf(sysfs_mod_name, PATH_MAX, "/sys/module/%s", module_name);
1180 if (n < 0 || n > PATH_MAX) {
1181 RTE_LOG(DEBUG, EAL, "Could not format module path\n");
1185 if (stat(sysfs_mod_name, &st) != 0) {
1186 RTE_LOG(DEBUG, EAL, "Module %s not found! error %i (%s)\n",
1187 sysfs_mod_name, errno, strerror(errno));
1191 /* Module has been found */