1 /* SPDX-License-Identifier: BSD-3-Clause
2 * Copyright(c) 2010-2018 Intel Corporation.
3 * Copyright(c) 2012-2014 6WIND S.A.
23 #include <sys/queue.h>
25 #if defined(RTE_ARCH_X86)
29 #include <rte_compat.h>
30 #include <rte_common.h>
31 #include <rte_debug.h>
32 #include <rte_memory.h>
33 #include <rte_launch.h>
35 #include <rte_eal_memconfig.h>
36 #include <rte_errno.h>
37 #include <rte_per_lcore.h>
38 #include <rte_lcore.h>
39 #include <rte_service_component.h>
41 #include <rte_random.h>
42 #include <rte_cycles.h>
43 #include <rte_string_fns.h>
44 #include <rte_cpuflags.h>
45 #include <rte_interrupts.h>
48 #include <rte_devargs.h>
49 #include <rte_version.h>
50 #include <rte_atomic.h>
51 #include <malloc_heap.h>
53 #include <rte_option.h>
55 #include "eal_private.h"
56 #include "eal_thread.h"
57 #include "eal_internal_cfg.h"
58 #include "eal_filesystem.h"
59 #include "eal_hugepages.h"
60 #include "eal_options.h"
63 #define MEMSIZE_IF_NO_HUGE_PAGE (64ULL * 1024ULL * 1024ULL)
65 #define SOCKET_MEM_STRLEN (RTE_MAX_NUMA_NODES * 10)
67 /* Allow the application to print its usage message too if set */
68 static rte_usage_hook_t rte_application_usage_hook = NULL;
70 /* early configuration structure, when memory config is not mmapped */
71 static struct rte_mem_config early_mem_config;
73 /* define fd variable here, because file needs to be kept open for the
74 * duration of the program, as we hold a write lock on it in the primary proc */
75 static int mem_cfg_fd = -1;
77 static struct flock wr_lock = {
80 .l_start = offsetof(struct rte_mem_config, memsegs),
81 .l_len = sizeof(early_mem_config.memsegs),
84 /* Address of global and public configuration */
85 static struct rte_config rte_config = {
86 .mem_config = &early_mem_config,
89 /* internal configuration (per-core) */
90 struct lcore_config lcore_config[RTE_MAX_LCORE];
92 /* internal configuration */
93 struct internal_config internal_config;
95 /* used by rte_rdtsc() */
96 int rte_cycles_vmware_tsc_map;
98 /* platform-specific runtime dir */
99 static char runtime_dir[PATH_MAX];
101 static const char *default_runtime_dir = "/var/run";
104 eal_create_runtime_dir(void)
106 const char *directory = default_runtime_dir;
107 const char *xdg_runtime_dir = getenv("XDG_RUNTIME_DIR");
108 const char *fallback = "/tmp";
113 /* try XDG path first, fall back to /tmp */
114 if (xdg_runtime_dir != NULL)
115 directory = xdg_runtime_dir;
117 directory = fallback;
119 /* create DPDK subdirectory under runtime dir */
120 ret = snprintf(tmp, sizeof(tmp), "%s/dpdk", directory);
121 if (ret < 0 || ret == sizeof(tmp)) {
122 RTE_LOG(ERR, EAL, "Error creating DPDK runtime path name\n");
126 /* create prefix-specific subdirectory under DPDK runtime dir */
127 ret = snprintf(runtime_dir, sizeof(runtime_dir), "%s/%s",
128 tmp, eal_get_hugefile_prefix());
129 if (ret < 0 || ret == sizeof(runtime_dir)) {
130 RTE_LOG(ERR, EAL, "Error creating prefix-specific runtime path name\n");
134 /* create the path if it doesn't exist. no "mkdir -p" here, so do it
137 ret = mkdir(tmp, 0700);
138 if (ret < 0 && errno != EEXIST) {
139 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
140 tmp, strerror(errno));
144 ret = mkdir(runtime_dir, 0700);
145 if (ret < 0 && errno != EEXIST) {
146 RTE_LOG(ERR, EAL, "Error creating '%s': %s\n",
147 runtime_dir, strerror(errno));
155 eal_clean_runtime_dir(void)
158 struct dirent *dirent;
159 int dir_fd, fd, lck_result;
160 static const char * const filters[] = {
166 dir = opendir(runtime_dir);
168 RTE_LOG(ERR, EAL, "Unable to open runtime directory %s\n",
174 /* lock the directory before doing anything, to avoid races */
175 if (flock(dir_fd, LOCK_EX) < 0) {
176 RTE_LOG(ERR, EAL, "Unable to lock runtime directory %s\n",
181 dirent = readdir(dir);
183 RTE_LOG(ERR, EAL, "Unable to read runtime directory %s\n",
188 while (dirent != NULL) {
192 /* skip files that don't match the patterns */
193 for (f_idx = 0; f_idx < RTE_DIM(filters); f_idx++) {
194 const char *filter = filters[f_idx];
196 if (fnmatch(filter, dirent->d_name, 0) == 0) {
202 dirent = readdir(dir);
206 /* try and lock the file */
207 fd = openat(dir_fd, dirent->d_name, O_RDONLY);
209 /* skip to next file */
211 dirent = readdir(dir);
215 /* non-blocking lock */
216 lck_result = flock(fd, LOCK_EX | LOCK_NB);
218 /* if lock succeeds, remove the file */
219 if (lck_result != -1)
220 unlinkat(dir_fd, dirent->d_name, 0);
222 dirent = readdir(dir);
225 /* closedir closes dir_fd and drops the lock */
233 RTE_LOG(ERR, EAL, "Error while clearing runtime dir: %s\n",
240 rte_eal_get_runtime_dir(void)
245 /* Return user provided mbuf pool ops name */
247 rte_eal_mbuf_user_pool_ops(void)
249 return internal_config.user_mbuf_pool_ops_name;
252 /* Return a pointer to the configuration structure */
254 rte_eal_get_configuration(void)
260 rte_eal_iova_mode(void)
262 return rte_eal_get_configuration()->iova_mode;
265 /* parse a sysfs (or other) file containing one integer value */
267 eal_parse_sysfs_value(const char *filename, unsigned long *val)
273 if ((f = fopen(filename, "r")) == NULL) {
274 RTE_LOG(ERR, EAL, "%s(): cannot open sysfs value %s\n",
279 if (fgets(buf, sizeof(buf), f) == NULL) {
280 RTE_LOG(ERR, EAL, "%s(): cannot read sysfs value %s\n",
285 *val = strtoul(buf, &end, 0);
286 if ((buf[0] == '\0') || (end == NULL) || (*end != '\n')) {
287 RTE_LOG(ERR, EAL, "%s(): cannot parse sysfs value %s\n",
297 /* create memory configuration in shared/mmap memory. Take out
298 * a write lock on the memsegs, so we can auto-detect primary/secondary.
299 * This means we never close the file while running (auto-close on exit).
300 * We also don't lock the whole file, so that in future we can use read-locks
301 * on other parts, e.g. memzones, to detect if there are running secondary
304 rte_eal_config_create(void)
306 void *rte_mem_cfg_addr;
309 const char *pathname = eal_runtime_config_path();
311 if (internal_config.no_shconf)
314 /* map the config before hugepage address so that we don't waste a page */
315 if (internal_config.base_virtaddr != 0)
316 rte_mem_cfg_addr = (void *)
317 RTE_ALIGN_FLOOR(internal_config.base_virtaddr -
318 sizeof(struct rte_mem_config), sysconf(_SC_PAGE_SIZE));
320 rte_mem_cfg_addr = NULL;
323 mem_cfg_fd = open(pathname, O_RDWR | O_CREAT, 0660);
325 rte_panic("Cannot open '%s' for rte_mem_config\n", pathname);
328 retval = ftruncate(mem_cfg_fd, sizeof(*rte_config.mem_config));
331 rte_panic("Cannot resize '%s' for rte_mem_config\n", pathname);
334 retval = fcntl(mem_cfg_fd, F_SETLK, &wr_lock);
337 rte_exit(EXIT_FAILURE, "Cannot create lock on '%s'. Is another primary "
338 "process running?\n", pathname);
341 rte_mem_cfg_addr = mmap(rte_mem_cfg_addr, sizeof(*rte_config.mem_config),
342 PROT_READ | PROT_WRITE, MAP_SHARED, mem_cfg_fd, 0);
344 if (rte_mem_cfg_addr == MAP_FAILED){
345 rte_panic("Cannot mmap memory for rte_config\n");
347 memcpy(rte_mem_cfg_addr, &early_mem_config, sizeof(early_mem_config));
348 rte_config.mem_config = rte_mem_cfg_addr;
350 /* store address of the config in the config itself so that secondary
351 * processes could later map the config into this exact location */
352 rte_config.mem_config->mem_cfg_addr = (uintptr_t) rte_mem_cfg_addr;
354 rte_config.mem_config->dma_maskbits = 0;
358 /* attach to an existing shared memory config */
360 rte_eal_config_attach(void)
362 struct rte_mem_config *mem_config;
364 const char *pathname = eal_runtime_config_path();
366 if (internal_config.no_shconf)
370 mem_cfg_fd = open(pathname, O_RDWR);
372 rte_panic("Cannot open '%s' for rte_mem_config\n", pathname);
375 /* map it as read-only first */
376 mem_config = (struct rte_mem_config *) mmap(NULL, sizeof(*mem_config),
377 PROT_READ, MAP_SHARED, mem_cfg_fd, 0);
378 if (mem_config == MAP_FAILED)
379 rte_panic("Cannot mmap memory for rte_config! error %i (%s)\n",
380 errno, strerror(errno));
382 rte_config.mem_config = mem_config;
385 /* reattach the shared config at exact memory location primary process has it */
387 rte_eal_config_reattach(void)
389 struct rte_mem_config *mem_config;
390 void *rte_mem_cfg_addr;
392 if (internal_config.no_shconf)
395 /* save the address primary process has mapped shared config to */
396 rte_mem_cfg_addr = (void *) (uintptr_t) rte_config.mem_config->mem_cfg_addr;
398 /* unmap original config */
399 munmap(rte_config.mem_config, sizeof(struct rte_mem_config));
401 /* remap the config at proper address */
402 mem_config = (struct rte_mem_config *) mmap(rte_mem_cfg_addr,
403 sizeof(*mem_config), PROT_READ | PROT_WRITE, MAP_SHARED,
405 if (mem_config == MAP_FAILED || mem_config != rte_mem_cfg_addr) {
406 if (mem_config != MAP_FAILED)
407 /* errno is stale, don't use */
408 rte_panic("Cannot mmap memory for rte_config at [%p], got [%p]"
409 " - please use '--base-virtaddr' option\n",
410 rte_mem_cfg_addr, mem_config);
412 rte_panic("Cannot mmap memory for rte_config! error %i (%s)\n",
413 errno, strerror(errno));
417 rte_config.mem_config = mem_config;
420 /* Detect if we are a primary or a secondary process */
422 eal_proc_type_detect(void)
424 enum rte_proc_type_t ptype = RTE_PROC_PRIMARY;
425 const char *pathname = eal_runtime_config_path();
427 /* if there no shared config, there can be no secondary processes */
428 if (!internal_config.no_shconf) {
429 /* if we can open the file but not get a write-lock we are a
430 * secondary process. NOTE: if we get a file handle back, we
431 * keep that open and don't close it to prevent a race condition
432 * between multiple opens.
434 if (((mem_cfg_fd = open(pathname, O_RDWR)) >= 0) &&
435 (fcntl(mem_cfg_fd, F_SETLK, &wr_lock) < 0))
436 ptype = RTE_PROC_SECONDARY;
439 RTE_LOG(INFO, EAL, "Auto-detected process type: %s\n",
440 ptype == RTE_PROC_PRIMARY ? "PRIMARY" : "SECONDARY");
445 /* copies data from internal config to shared config */
447 eal_update_mem_config(void)
449 struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
450 mcfg->legacy_mem = internal_config.legacy_mem;
451 mcfg->single_file_segments = internal_config.single_file_segments;
454 /* copies data from shared config to internal config */
456 eal_update_internal_config(void)
458 struct rte_mem_config *mcfg = rte_eal_get_configuration()->mem_config;
459 internal_config.legacy_mem = mcfg->legacy_mem;
460 internal_config.single_file_segments = mcfg->single_file_segments;
463 /* Sets up rte_config structure with the pointer to shared memory config.*/
465 rte_config_init(void)
467 rte_config.process_type = internal_config.process_type;
469 switch (rte_config.process_type){
470 case RTE_PROC_PRIMARY:
471 rte_eal_config_create();
472 eal_update_mem_config();
474 case RTE_PROC_SECONDARY:
475 rte_eal_config_attach();
476 rte_eal_mcfg_wait_complete(rte_config.mem_config);
477 rte_eal_config_reattach();
478 eal_update_internal_config();
481 case RTE_PROC_INVALID:
482 rte_panic("Invalid process type\n");
486 /* Unlocks hugepage directories that were locked by eal_hugepage_info_init */
488 eal_hugedirs_unlock(void)
492 for (i = 0; i < MAX_HUGEPAGE_SIZES; i++)
494 /* skip uninitialized */
495 if (internal_config.hugepage_info[i].lock_descriptor < 0)
497 /* unlock hugepage file */
498 flock(internal_config.hugepage_info[i].lock_descriptor, LOCK_UN);
499 close(internal_config.hugepage_info[i].lock_descriptor);
500 /* reset the field */
501 internal_config.hugepage_info[i].lock_descriptor = -1;
507 eal_usage(const char *prgname)
509 printf("\nUsage: %s ", prgname);
511 printf("EAL Linux options:\n"
512 " --"OPT_SOCKET_MEM" Memory to allocate on sockets (comma separated values)\n"
513 " --"OPT_SOCKET_LIMIT" Limit memory allocation on sockets (comma separated values)\n"
514 " --"OPT_HUGE_DIR" Directory where hugetlbfs is mounted\n"
515 " --"OPT_FILE_PREFIX" Prefix for hugepage filenames\n"
516 " --"OPT_BASE_VIRTADDR" Base virtual address\n"
517 " --"OPT_CREATE_UIO_DEV" Create /dev/uioX (usually done by hotplug)\n"
518 " --"OPT_VFIO_INTR" Interrupt mode for VFIO (legacy|msi|msix)\n"
519 " --"OPT_LEGACY_MEM" Legacy memory mode (no dynamic allocation, contiguous segments)\n"
520 " --"OPT_SINGLE_FILE_SEGMENTS" Put all hugepage memory in single files\n"
521 " --"OPT_MATCH_ALLOCATIONS" Free hugepages exactly as allocated\n"
523 /* Allow the application to print its usage message too if hook is set */
524 if ( rte_application_usage_hook ) {
525 printf("===== Application Usage =====\n\n");
526 rte_application_usage_hook(prgname);
530 /* Set a per-application usage message */
532 rte_set_application_usage_hook( rte_usage_hook_t usage_func )
534 rte_usage_hook_t old_func;
536 /* Will be NULL on the first call to denote the last usage routine. */
537 old_func = rte_application_usage_hook;
538 rte_application_usage_hook = usage_func;
544 eal_parse_socket_arg(char *strval, volatile uint64_t *socket_arg)
546 char * arg[RTE_MAX_NUMA_NODES];
549 uint64_t total_mem = 0;
551 len = strnlen(strval, SOCKET_MEM_STRLEN);
552 if (len == SOCKET_MEM_STRLEN) {
553 RTE_LOG(ERR, EAL, "--socket-mem is too long\n");
557 /* all other error cases will be caught later */
558 if (!isdigit(strval[len-1]))
561 /* split the optarg into separate socket values */
562 arg_num = rte_strsplit(strval, len,
563 arg, RTE_MAX_NUMA_NODES, ',');
565 /* if split failed, or 0 arguments */
569 /* parse each defined socket option */
571 for (i = 0; i < arg_num; i++) {
574 val = strtoull(arg[i], &end, 10);
576 /* check for invalid input */
578 (arg[i][0] == '\0') || (end == NULL) || (*end != '\0'))
585 /* check if we have a positive amount of total memory */
593 eal_parse_base_virtaddr(const char *arg)
599 addr = strtoull(arg, &end, 16);
601 /* check for errors */
602 if ((errno != 0) || (arg[0] == '\0') || end == NULL || (*end != '\0'))
605 /* make sure we don't exceed 32-bit boundary on 32-bit target */
607 if (addr >= UINTPTR_MAX)
611 /* align the addr on 16M boundary, 16MB is the minimum huge page
612 * size on IBM Power architecture. If the addr is aligned to 16MB,
613 * it can align to 2MB for x86. So this alignment can also be used
615 internal_config.base_virtaddr =
616 RTE_PTR_ALIGN_CEIL((uintptr_t)addr, (size_t)RTE_PGSIZE_16M);
622 eal_parse_vfio_intr(const char *mode)
627 enum rte_intr_mode value;
629 { "legacy", RTE_INTR_MODE_LEGACY },
630 { "msi", RTE_INTR_MODE_MSI },
631 { "msix", RTE_INTR_MODE_MSIX },
634 for (i = 0; i < RTE_DIM(map); i++) {
635 if (!strcmp(mode, map[i].name)) {
636 internal_config.vfio_intr_mode = map[i].value;
643 /* Parse the arguments for --log-level only */
645 eal_log_level_parse(int argc, char **argv)
650 const int old_optind = optind;
651 const int old_optopt = optopt;
652 char * const old_optarg = optarg;
657 while ((opt = getopt_long(argc, argvopt, eal_short_options,
658 eal_long_options, &option_index)) != EOF) {
662 /* getopt is not happy, stop right now */
666 ret = (opt == OPT_LOG_LEVEL_NUM) ?
667 eal_parse_common_option(opt, optarg, &internal_config) : 0;
669 /* common parser is not happy */
674 /* restore getopt lib */
680 /* Parse the argument given in the command line of the application */
682 eal_parse_args(int argc, char **argv)
687 char *prgname = argv[0];
688 const int old_optind = optind;
689 const int old_optopt = optopt;
690 char * const old_optarg = optarg;
696 while ((opt = getopt_long(argc, argvopt, eal_short_options,
697 eal_long_options, &option_index)) != EOF) {
700 * getopt didn't recognise the option, lets parse the
701 * registered options to see if the flag is valid
704 ret = rte_option_parse(argv[optind-1]);
713 ret = eal_parse_common_option(opt, optarg, &internal_config);
714 /* common parser is not happy */
720 /* common parser handled this option */
729 case OPT_HUGE_DIR_NUM:
731 char *hdir = strdup(optarg);
733 RTE_LOG(ERR, EAL, "Could not store hugepage directory\n");
735 /* free old hugepage dir */
736 if (internal_config.hugepage_dir != NULL)
737 free(internal_config.hugepage_dir);
738 internal_config.hugepage_dir = hdir;
742 case OPT_FILE_PREFIX_NUM:
744 char *prefix = strdup(optarg);
746 RTE_LOG(ERR, EAL, "Could not store file prefix\n");
748 /* free old prefix */
749 if (internal_config.hugefile_prefix != NULL)
750 free(internal_config.hugefile_prefix);
751 internal_config.hugefile_prefix = prefix;
755 case OPT_SOCKET_MEM_NUM:
756 if (eal_parse_socket_arg(optarg,
757 internal_config.socket_mem) < 0) {
758 RTE_LOG(ERR, EAL, "invalid parameters for --"
759 OPT_SOCKET_MEM "\n");
764 internal_config.force_sockets = 1;
767 case OPT_SOCKET_LIMIT_NUM:
768 if (eal_parse_socket_arg(optarg,
769 internal_config.socket_limit) < 0) {
770 RTE_LOG(ERR, EAL, "invalid parameters for --"
771 OPT_SOCKET_LIMIT "\n");
776 internal_config.force_socket_limits = 1;
779 case OPT_BASE_VIRTADDR_NUM:
780 if (eal_parse_base_virtaddr(optarg) < 0) {
781 RTE_LOG(ERR, EAL, "invalid parameter for --"
782 OPT_BASE_VIRTADDR "\n");
789 case OPT_VFIO_INTR_NUM:
790 if (eal_parse_vfio_intr(optarg) < 0) {
791 RTE_LOG(ERR, EAL, "invalid parameters for --"
799 case OPT_CREATE_UIO_DEV_NUM:
800 internal_config.create_uio_dev = 1;
803 case OPT_MBUF_POOL_OPS_NAME_NUM:
805 char *ops_name = strdup(optarg);
806 if (ops_name == NULL)
807 RTE_LOG(ERR, EAL, "Could not store mbuf pool ops name\n");
809 /* free old ops name */
810 if (internal_config.user_mbuf_pool_ops_name !=
812 free(internal_config.user_mbuf_pool_ops_name);
814 internal_config.user_mbuf_pool_ops_name =
819 case OPT_MATCH_ALLOCATIONS_NUM:
820 internal_config.match_allocations = 1;
824 if (opt < OPT_LONG_MIN_NUM && isprint(opt)) {
825 RTE_LOG(ERR, EAL, "Option %c is not supported "
827 } else if (opt >= OPT_LONG_MIN_NUM &&
828 opt < OPT_LONG_MAX_NUM) {
829 RTE_LOG(ERR, EAL, "Option %s is not supported "
831 eal_long_options[option_index].name);
833 RTE_LOG(ERR, EAL, "Option %d is not supported "
842 /* create runtime data directory */
843 if (internal_config.no_shconf == 0 &&
844 eal_create_runtime_dir() < 0) {
845 RTE_LOG(ERR, EAL, "Cannot create runtime directory\n");
850 if (eal_adjust_config(&internal_config) != 0) {
856 if (eal_check_common_options(&internal_config) != 0) {
863 argv[optind-1] = prgname;
867 /* restore getopt lib */
876 check_socket(const struct rte_memseg_list *msl, void *arg)
878 int *socket_id = arg;
883 return *socket_id == msl->socket_id;
887 eal_check_mem_on_local_socket(void)
891 socket_id = rte_lcore_to_socket_id(rte_config.master_lcore);
893 if (rte_memseg_list_walk(check_socket, &socket_id) == 0)
894 RTE_LOG(WARNING, EAL, "WARNING: Master core has no memory on local socket!\n");
898 sync_func(__attribute__((unused)) void *arg)
904 rte_eal_mcfg_complete(void)
906 /* ALL shared mem_config related INIT DONE */
907 if (rte_config.process_type == RTE_PROC_PRIMARY)
908 rte_config.mem_config->magic = RTE_MAGIC;
910 internal_config.init_complete = 1;
914 * Request iopl privilege for all RPL, returns 0 on success
915 * iopl() call is mostly for the i386 architecture. For other architectures,
916 * return -1 to indicate IO privilege can't be changed in this way.
919 rte_eal_iopl_init(void)
921 #if defined(RTE_ARCH_X86)
929 static int rte_eal_vfio_setup(void)
931 if (rte_vfio_enable("vfio"))
938 static void rte_eal_init_alert(const char *msg)
940 fprintf(stderr, "EAL: FATAL: %s\n", msg);
941 RTE_LOG(ERR, EAL, "%s\n", msg);
944 /* Launch threads, called at application init(). */
946 rte_eal_init(int argc, char **argv)
950 static rte_atomic32_t run_once = RTE_ATOMIC32_INIT(0);
952 static char logid[PATH_MAX];
953 char cpuset[RTE_CPU_AFFINITY_STR_LEN];
954 char thread_name[RTE_MAX_THREAD_NAME_LEN];
956 /* checks if the machine is adequate */
957 if (!rte_cpu_is_supported()) {
958 rte_eal_init_alert("unsupported cpu type.");
963 if (!rte_atomic32_test_and_set(&run_once)) {
964 rte_eal_init_alert("already called initialization.");
965 rte_errno = EALREADY;
969 p = strrchr(argv[0], '/');
970 strlcpy(logid, p ? p + 1 : argv[0], sizeof(logid));
971 thread_id = pthread_self();
973 eal_reset_internal_config(&internal_config);
975 /* set log level as early as possible */
976 eal_log_level_parse(argc, argv);
978 if (rte_eal_cpu_init() < 0) {
979 rte_eal_init_alert("Cannot detect lcores.");
984 fctret = eal_parse_args(argc, argv);
986 rte_eal_init_alert("Invalid 'command line' arguments.");
988 rte_atomic32_clear(&run_once);
992 if (eal_plugins_init() < 0) {
993 rte_eal_init_alert("Cannot init plugins");
995 rte_atomic32_clear(&run_once);
999 if (eal_option_device_parse()) {
1001 rte_atomic32_clear(&run_once);
1007 if (rte_eal_intr_init() < 0) {
1008 rte_eal_init_alert("Cannot init interrupt-handling thread");
1012 /* Put mp channel init before bus scan so that we can init the vdev
1013 * bus through mp channel in the secondary process before the bus scan.
1015 if (rte_mp_channel_init() < 0) {
1016 rte_eal_init_alert("failed to init mp channel");
1017 if (rte_eal_process_type() == RTE_PROC_PRIMARY) {
1023 /* register multi-process action callbacks for hotplug */
1024 if (rte_mp_dev_hotplug_init() < 0) {
1025 rte_eal_init_alert("failed to register mp callback for hotplug");
1029 if (rte_bus_scan()) {
1030 rte_eal_init_alert("Cannot scan the buses for devices");
1032 rte_atomic32_clear(&run_once);
1036 /* if no EAL option "--iova-mode=<pa|va>", use bus IOVA scheme */
1037 if (internal_config.iova_mode == RTE_IOVA_DC) {
1038 /* autodetect the IOVA mapping mode (default is RTE_IOVA_PA) */
1039 rte_eal_get_configuration()->iova_mode =
1040 rte_bus_get_iommu_class();
1042 /* Workaround for KNI which requires physical address to work */
1043 if (rte_eal_get_configuration()->iova_mode == RTE_IOVA_VA &&
1044 rte_eal_check_module("rte_kni") == 1) {
1045 rte_eal_get_configuration()->iova_mode = RTE_IOVA_PA;
1046 RTE_LOG(WARNING, EAL,
1047 "Some devices want IOVA as VA but PA will be used because.. "
1048 "KNI module inserted\n");
1051 rte_eal_get_configuration()->iova_mode =
1052 internal_config.iova_mode;
1055 if (internal_config.no_hugetlbfs == 0) {
1056 /* rte_config isn't initialized yet */
1057 ret = internal_config.process_type == RTE_PROC_PRIMARY ?
1058 eal_hugepage_info_init() :
1059 eal_hugepage_info_read();
1061 rte_eal_init_alert("Cannot get hugepage information.");
1063 rte_atomic32_clear(&run_once);
1068 if (internal_config.memory == 0 && internal_config.force_sockets == 0) {
1069 if (internal_config.no_hugetlbfs)
1070 internal_config.memory = MEMSIZE_IF_NO_HUGE_PAGE;
1073 if (internal_config.vmware_tsc_map == 1) {
1074 #ifdef RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT
1075 rte_cycles_vmware_tsc_map = 1;
1076 RTE_LOG (DEBUG, EAL, "Using VMWARE TSC MAP, "
1077 "you must have monitor_control.pseudo_perfctr = TRUE\n");
1079 RTE_LOG (WARNING, EAL, "Ignoring --vmware-tsc-map because "
1080 "RTE_LIBRTE_EAL_VMWARE_TSC_MAP_SUPPORT is not set\n");
1084 rte_srand(rte_rdtsc());
1086 if (rte_eal_log_init(logid, internal_config.syslog_facility) < 0) {
1087 rte_eal_init_alert("Cannot init logging.");
1089 rte_atomic32_clear(&run_once);
1094 if (rte_eal_vfio_setup() < 0) {
1095 rte_eal_init_alert("Cannot init VFIO");
1097 rte_atomic32_clear(&run_once);
1101 /* in secondary processes, memory init may allocate additional fbarrays
1102 * not present in primary processes, so to avoid any potential issues,
1103 * initialize memzones first.
1105 if (rte_eal_memzone_init() < 0) {
1106 rte_eal_init_alert("Cannot init memzone");
1111 if (rte_eal_memory_init() < 0) {
1112 rte_eal_init_alert("Cannot init memory");
1117 /* the directories are locked during eal_hugepage_info_init */
1118 eal_hugedirs_unlock();
1120 if (rte_eal_malloc_heap_init() < 0) {
1121 rte_eal_init_alert("Cannot init malloc heap");
1126 if (rte_eal_tailqs_init() < 0) {
1127 rte_eal_init_alert("Cannot init tail queues for objects");
1132 if (rte_eal_alarm_init() < 0) {
1133 rte_eal_init_alert("Cannot init interrupt-handling thread");
1134 /* rte_eal_alarm_init sets rte_errno on failure. */
1138 if (rte_eal_timer_init() < 0) {
1139 rte_eal_init_alert("Cannot init HPET or TSC timers");
1140 rte_errno = ENOTSUP;
1144 eal_check_mem_on_local_socket();
1146 eal_thread_init_master(rte_config.master_lcore);
1148 ret = eal_thread_dump_affinity(cpuset, sizeof(cpuset));
1150 RTE_LOG(DEBUG, EAL, "Master lcore %u is ready (tid=%zx;cpuset=[%s%s])\n",
1151 rte_config.master_lcore, (uintptr_t)thread_id, cpuset,
1152 ret == 0 ? "" : "...");
1154 RTE_LCORE_FOREACH_SLAVE(i) {
1157 * create communication pipes between master thread
1160 if (pipe(lcore_config[i].pipe_master2slave) < 0)
1161 rte_panic("Cannot create pipe\n");
1162 if (pipe(lcore_config[i].pipe_slave2master) < 0)
1163 rte_panic("Cannot create pipe\n");
1165 lcore_config[i].state = WAIT;
1167 /* create a thread for each lcore */
1168 ret = pthread_create(&lcore_config[i].thread_id, NULL,
1169 eal_thread_loop, NULL);
1171 rte_panic("Cannot create thread\n");
1173 /* Set thread_name for aid in debugging. */
1174 snprintf(thread_name, sizeof(thread_name),
1175 "lcore-slave-%d", i);
1176 ret = rte_thread_setname(lcore_config[i].thread_id,
1180 "Cannot set name for lcore thread\n");
1184 * Launch a dummy function on all slave lcores, so that master lcore
1185 * knows they are all ready when this function returns.
1187 rte_eal_mp_remote_launch(sync_func, NULL, SKIP_MASTER);
1188 rte_eal_mp_wait_lcore();
1190 /* initialize services so vdevs register service during bus_probe. */
1191 ret = rte_service_init();
1193 rte_eal_init_alert("rte_service_init() failed");
1194 rte_errno = ENOEXEC;
1198 /* Probe all the buses and devices/drivers on them */
1199 if (rte_bus_probe()) {
1200 rte_eal_init_alert("Cannot probe devices");
1201 rte_errno = ENOTSUP;
1206 /* Register mp action after probe() so that we got enough info */
1207 if (rte_vfio_is_enabled("vfio") && vfio_mp_sync_setup() < 0)
1211 /* initialize default service/lcore mappings and start running. Ignore
1212 * -ENOTSUP, as it indicates no service coremask passed to EAL.
1214 ret = rte_service_start_with_defaults();
1215 if (ret < 0 && ret != -ENOTSUP) {
1216 rte_errno = ENOEXEC;
1221 * Clean up unused files in runtime directory. We do this at the end of
1222 * init and not at the beginning because we want to clean stuff up
1223 * whether we are primary or secondary process, but we cannot remove
1224 * primary process' files because secondary should be able to run even
1225 * if primary process is dead.
1227 * In no_shconf mode, no runtime directory is created in the first
1228 * place, so no cleanup needed.
1230 if (!internal_config.no_shconf && eal_clean_runtime_dir() < 0) {
1231 rte_eal_init_alert("Cannot clear runtime directory\n");
1235 rte_eal_mcfg_complete();
1237 /* Call each registered callback, if enabled */
1244 mark_freeable(const struct rte_memseg_list *msl, const struct rte_memseg *ms,
1245 void *arg __rte_unused)
1247 /* ms is const, so find this memseg */
1248 struct rte_memseg *found;
1253 found = rte_mem_virt2memseg(ms->addr, msl);
1255 found->flags &= ~RTE_MEMSEG_FLAG_DO_NOT_FREE;
1260 int __rte_experimental
1261 rte_eal_cleanup(void)
1263 /* if we're in a primary process, we need to mark hugepages as freeable
1264 * so that finalization can release them back to the system.
1266 if (rte_eal_process_type() == RTE_PROC_PRIMARY)
1267 rte_memseg_walk(mark_freeable, NULL);
1268 rte_service_finalize();
1269 rte_mp_channel_cleanup();
1270 eal_cleanup_config(&internal_config);
1275 enum rte_lcore_role_t
1276 rte_eal_lcore_role(unsigned lcore_id)
1278 return rte_config.lcore_role[lcore_id];
1281 enum rte_proc_type_t
1282 rte_eal_process_type(void)
1284 return rte_config.process_type;
1287 int rte_eal_has_hugepages(void)
1289 return ! internal_config.no_hugetlbfs;
1292 int rte_eal_has_pci(void)
1294 return !internal_config.no_pci;
1297 int rte_eal_create_uio_dev(void)
1299 return internal_config.create_uio_dev;
1303 rte_eal_vfio_intr_mode(void)
1305 return internal_config.vfio_intr_mode;
1309 rte_eal_check_module(const char *module_name)
1311 char sysfs_mod_name[PATH_MAX];
1315 if (NULL == module_name)
1318 /* Check if there is sysfs mounted */
1319 if (stat("/sys/module", &st) != 0) {
1320 RTE_LOG(DEBUG, EAL, "sysfs is not mounted! error %i (%s)\n",
1321 errno, strerror(errno));
1325 /* A module might be built-in, therefore try sysfs */
1326 n = snprintf(sysfs_mod_name, PATH_MAX, "/sys/module/%s", module_name);
1327 if (n < 0 || n > PATH_MAX) {
1328 RTE_LOG(DEBUG, EAL, "Could not format module path\n");
1332 if (stat(sysfs_mod_name, &st) != 0) {
1333 RTE_LOG(DEBUG, EAL, "Module %s not found! error %i (%s)\n",
1334 sysfs_mod_name, errno, strerror(errno));
1338 /* Module has been found */